Crossfire Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
**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''.

FIXME 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'' |

FIXME explain all parameters, make sure they work

===== Section [Animation] =====
This is the actual animation definition. Each line is a move, in the format:

<code>
time command parameters
#comment
 #not a comment. wrong line!!
time command parameters
time command parameters
</code>

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 |
Crossfire Wiki

User Tools

Site Tools

Page Tools
