Table of Contents
CFAnim (Animator for Gridarta) is a server plugin to make animations for NPCs.
It uses a simple text file format, described below.
Not all commands are actually implemented, and the plugin overall status is experimental - maybe it can crash the server.
There is an example map in /test/cfanim, with associated scripts /test/cfanim.animation and /test/cfanim.button.
more details?
Animation file specification
Plugin animator file specs
Section [Config]
This must be the first section. It defines the overall animation configuration.
Parameters:
| name | meaning |
|---|---|
| name | “anystring” |
| victimtype | player must be a player, object is an object, any means it doesn’t matter, byname means the victim is the name of the object to animate |
| victim | who for the object containing the event object, activator for the object which caused who to activate, who_owner and activator_owner for the containing object, object’s name for an arbitrary object (in which case victimtype should be byname) |
| unique | yes or no |
| always_delete | yes or no |
| parallel | yes or no |
| paralyzed | yes or no |
| time_representation | second or tick |
| errors_allowed | yes or no |
| verbose | yes or no |
| animation | Animation |
| invisible | yes or no |
| wizard | yes or no |
explain all parameters, make sure they work
Section [Animation]
This is the actual animation definition. Each line is a move, in the format:
time command parameters #comment #not a comment. wrong line!! time command parameters time command parameters
Commands available:
| command | parameters | description |
|---|---|---|
| north | Moves in the specified direction | |
| north_east | Moves in the specified direction | |
| east | Moves in the specified direction | |
| south_east | Moves in the specified direction | |
| south | Moves in the specified direction | |
| south_west | Moves in the specified direction | |
| west | Moves in the specified direction | |
| north_west | Moves in the specified direction | |
| fire_north | Fire in the specified direction | |
| fire_north_east | Fire in the specified direction | |
| fire_east | Fire in the specified direction | |
| fire_south_east | Fire in the specified direction | |
| fire_south | Fire in the specified direction | |
| fire_south_west | Fire in the specified direction | |
| fire_west | Fire in the specified direction | |
| fire_north_west | Fire in the specified direction | |
| turn_north | Turn in the specified direction | |
| turn_north_east | Turn in the specified direction | |
| turn_east | Turn in the specified direction | |
| turn_south_east | Turn in the specified direction | |
| turn_south | Turn in the specified direction | |
| turn_south_west | Turn in the specified direction | |
| turn_west | Turn in the specified direction | |
| turn_north_west | Turn in the specified direction | |
| say | saywhat: string | Says saywhat (behaviour depend on victim being object or player |
| apply | Apply first applyable object on ground | |
| apply_object | object_name | Apply object object_name (ground checked first then inventory) |
| drop_object | object_name | Drop object object_name from inventory |
| pickup | Pickup first object on ground | |
| pickup_object | object_name | Pickup object_name from ground |
| ghosted | yes or no | Player leave its corpse at the current location and become a soul. Usefull for camera effects. Puts the invisible and wizards flag to yes |
| invisible | yes or no | Show or hide player |
| wizard | yes or no | Can or not walk through walls and monster (dungeon master) |
| teleport | x y mapname | Teleport object ot mapname at position x,y |
| notice | noticewhat | Put a beautifull text (noticewhat) in Navy in the console of player |
| moveto | x y | Will make the object move towards the specified point in its map till it reaches the spot. One move per animation tick |
