From Tronwiki
Revision as of 15:57, 17 December 2007 by P4 (Talk | contribs)
Jump to: navigation, search


Settings - Authentication, etc

RENAME_ENABLED <1> [<player>]

set (the default value and all players flags) or a specific player flag. default value is 1.

RENAME_PLAYER <player> <newname>

to rename the player from script


force a player to spectator mode immediately. means the player is also killed if he's in the game.

LOGIN_REQUIRED <1> [<player>]

set (the default value and all players flags) or a specific player flag . default value is 0.

ALLOW_PLAYER_TO_JOIN player_name 1|0

set the player flag to allow him join the game


set the flag for the selected player


set the default value for player joining the server


to set the default flag for player joining the server. if 0, players can't rename ...


set the default value + all players flags

Spawn Zone

The ability to spawn all different types of zones via the command line or a script.
Zones no longer need to be specified in the map and can be spawned either via the console using /admin SPAWN_ZONE ... or using a script.

Possible types:

win - As soon as a player touches the zone he/his team win the round immediately.
death - Touch the zone you die.
ball - acts like a hockey puck, the should be some kind of goal you need to aim for. In the shape of a fortress zone. 
flag - you can pick up a flag, it will stick to you for a specified period. Take it back to your base in ctf.
fortress - capture the enemies fortress/s and protect your own.
zombie - I deathzone that is locked onto a player. Sometimes you can shoot them and get rid of them.
target - can be used as a trigger for your script for many uses. A race checkpoint perhaps, or a deathzone generator.
 SPAWN_ZONE <win|death|ball|target> <x> <y> <size> <growth> <xdir> <ydir> <interactive> <r> <g> <b> <target_size>
 SPAWN_ZONE <fortress|flag> <team> <x> <y> <size> <growth> <xdir> <ydir> <interactive> <r> <g> <b> <target_size>
 SPAWN_ZONE zombie <player> <x> <y> <size> <growth> <xdir> <ydir> <interactive> <r> <g> <b> <target_size>
 SPAWN_ZONE zombieOwner <player> <owner> <x> <y> <size> <growth> <xdir> <ydir> <interactive> <r> <g> <b> <target_size>
Instead of <x> <y> one can write: L <x1> <y1> <x2> <y2> [...] Z
This will allow you to have the zone follow a set path. It will continue to use the same initial speed.

optional: if you wanr to give zones a name you can include:
SPAWN_ZONE n zone_name TARGET .....

If you give more than one zone the same name you can influence all zones of the same name simultaneously. 


<team> must be the team name or anything else if you want to ignore the param. It is mandatory for flag and fortress type. If you spell it incorrectly, it links the zone to the closest player team(default behavior).

cordinates (x,y)

<pos_x>, <pos_y>, self explanatory. Of course it depends of the map


<size> is the radius of the zone


<growth> is the growing factor of the zone.


<dir_x>, <dir_y> is the speed vector, to make the zone move all alone Wink


<bouncing_flag> is a boolean. true or false (still case sensitive). If true, it makes the zone bounce on the rim walls


<red>, <green>, <blue> are the colour component for the zone between 0 and 15. If not specified, it will be white. If the zone is linked to a team, the color will be the team color whatever you set here.

Special Settings for Target Zone


default: -1. -1 means no limit. A positive value means the zone will collapse alone after n sec even if no one conquers it.


default: 10. value <=0 means no limit. a positive value means the zone will remains n sec before collapsing after the first player enter the zone.


default: 10. means the first player will win 10 pts.


default: 2. means the score for next player will be decrease by 2. second player will get 8 pts, 3rd 6 pts ...


default: 1. means the last target conquest declare winner (first player entering the last target zone is the winner) So if you want infinite zone, just to catch the enter/left message, just set them to -1, -1, 0, 0, 0 ... and here it is, you have a switch in your map !


spawn_zone death 200 300 10 0.5 0 30 true 0 0 15 20

This would spawn a death zone with the following attributes...

coordinate x=200, y=300
size radius=10
speed along x=0
speed along y=30
It will bounce of walls
max radius it will grow to=20

Special Settings for Influencing Zones

SET_ZONE_POSITION <zone> <x> <y>

Allow you to set a new position for a zone or group of zones, relative to its current

spawn_zone n group1 target 100 100 10
spawn_zone n group1 target 100 200 10
spawn_zone n group1 target 100 300 10
set_zone_position group1 50 0 50 50 0 50 0 0

will make the 3 zones describe a square.

The speed is fixed by the first move : it will be done in 1s. So if you try

set_zone_position zoneA 100 0 100 100 0 100 0 0
set_zone_position zoneA 50 0 100 0 100 100 0 100 0 0

the 2 cases discribe the same square but the 2nd one will be 2 times slower

this is a route using spawn_zone functionnality so :

set_zone_position zoneA 100 100

will move the zone to 100,100 then back to it original location.
To stop it, I've made the route to stop if 2 points next to each other are identical. so:

set_zone_position zoneA 100 100 100 100

will stop the zone at the desired location(100,100).


kill the specified zone or group of zones.

SET_ZONE_RADIUS <zone> <radius> <growth_rate>

Change the radius and growth rate of zone or group of zones.

Universal Settings available


default is false set it to 1 and the server stop at the end of the round and wait for the script to turn this setting back to 0 ...
Make sure you have it under control by your script, or it will render your server unusable.
it can be useful in many cases :

  • map rotation/mode rotation at the end so we know if round was win or draw
  • preparing the next map for race script so the script is not impacting the game (it use to be the case for race to winzone on marathon)
  • updating the ladder
  • sending messages to users


Default 100000. Unlike CYCLE_SPEED_MIN, which is "Minimal speed of your cycle, measured relative to CYCLE_SPEED". This is an int which is the actual maximum speed of your cycle. Things get ugly if you set CYCLE_SPEED_MAX < CYCLE_SPEED, but then they would.

RESPAWN_PLAYER <playername> <messageflag> <posx> <posy> <dirx> <diry>

  • <playername> - name of the player to be respawned
  • <messageflag> - should the message be displayed
  • <posx> <posy> - position of the spawn point
  • <dirx> <diry> - direction of driving

PLAYER_KILLED <playername> <ip> <posx> <posy> <dirx> <diry>

Personal tools