View source for Styctap/Ladderlog Events

<b>[[styctap|<- Back]]</b>

This section is for the ladderlog command that go to the ladderlog.txt file, located in your …/var/ folder. Below are the list of ladderlog commands that can be found in the server/client under

<code>LADDERLOG_WRITE_</code>

Some of these commands are enabled by default but others needs enabling. (You can enable all with <code>LADDERLOG_WRITE_ALL 1</code>)

Another setting requirement for the use of ladderlog is <code>LADDERLOG_ENABLED</code>. This is enabled by default for servers in recent revisions, however it’s noted here for reference.

<code>LADDERLOG_ENABLED 1</code>

== CURRENT_MAP ==

<code>CURRENT_MAP &lt;size_factor&gt; [size_multiplier] {map_file}</code>

Outputs the currently played map in the server/client. Is outputted during the time when the round is about to begin.<br />
Example: <code>CURRENT_MAP -3 0.353553 Anonymous/polygon/regular/square-1.0.1.aamap.xml</code>

== MATCH_ENDED ==

<code>MATCH_ENDED time</code>

At the time the match has ended, this will be go to the file.

== ONLINE_PLAYER ==

<code>ONLINE_PLAYER &lt;name&gt; &lt;id&gt; &lt;r&gt; &lt;g&gt; &lt;b&gt; &lt;access_level&gt; &lt;did_login?&gt; [&lt;ping&gt; &lt;team&gt;]</code>

Get the online player’s data.

== PLAYER_COLORED_NAME ==

<code>PLAYER_COLORED_NAME [log_name] [colored_name]</code>

Output that player’s name that has colors and only appears in the clients.

== PLAYER_ENTERED_ ==

=== PLAYER_ENTERED_GRID ===

<code>PLAYER_ENTERED_GRID [log_name] [ip_address] [screen_name]</code>

Sends to the ladderlog if this player has entered the grid after entering the server.

=== PLAYER_ENTERED_SPECTATOR ===

<code>PLAYER_ENTERED_SPECTATOR [log_name] [ip_address] [screen_name]</code>

Sends to the ladderlog if this player has entered the spectator state after entering the server.

== PLAYER_GRIDPOS ==

<code>PLAYER_GRIDPOS [log_name] [posx] [posy] [dirx] [diry] [cycle_speed] {used_rubber} {total_rubber}</code>

Sends this command to ladderlog indicating the player’s current position, direction and the speed they are travelling at.

== ZONE_GRIDPOS ==

<code>ZONE_GRIDPOS {effect} {id} {name} {radius} {expansion_speed} {x} {y} {xdir} {ydir} {r} {g} {b}</code>

Send this command to ladderlog indicating the zone’s curent position, direction and the rest of details provided above.

== PLAYER_{LOGIN|LOGOUT} ==

'''Note:'''<br />
The effects of login and logout only get affected when the next round begins. Meaning, the output of these ladderlog events is basically informing ladderlog this user has logged in or out during the round.

=== PLAYER_LOGIN ===

<code>PLAYER_LOGIN &lt;name&gt; &lt;authenticated name=&quot;&quot;&gt;</code>

Sends to the ladderlog when a player has logged in using their <code>@authority</code>

=== PLAYER_LOGOUT ===

<code>PLAYER_LOGOUT &lt;authenticated name=&quot;&quot;&gt; &lt;name&gt;</code>

Sends to the ladderlog when a player has logged out of their <code>@authority</code> account.

== PLAYER_RENAMED ==

<code>PLAYER_RENAMED &lt;old name&gt; &lt;new name&gt; &lt;ip&gt; &lt;did_login?&gt; &lt;screen name&gt;</code>

Sends to the ladderlog when a player goes through the renaming process (login/out or just name changed).

== ROUND_STARTED ==

<code>ROUND_STARTED time</code>

This command goes to the file at the moment the round has started!

== ROUND_ENDED ==

<code>ROUND_ENDED time</code>

The time of game play when the round has finally finished!

== SOCCER_BALL_PLAYER_ENTERED ==

<code>SOCCER_BALL_PLAYER_ENTERED [player_auth_name] [team]</code>

This ladderlog command outputs the player’s login name and the team they are currently in.

== SOCCER_GOAL_PLAYER_ENTERED ==

<code>SOCCER_GOAL_PLAYER_ENTERED [player_auth_name] [player_team] [team owner of the goal]</code>

Outputs the player’s login name, their team and the team owner of the goal zone.

== TEAM_COLORED_NAME ==

<code>TEAM_COLORED_NAME [team_name][team_colored_name]</code>

Exactly like <code>PLAYER_COLORED_NAME</code> but this is the output for teams instead.

== ZONE_CREATED ==

<code>ZONE_CREATED [effect] [id] [name] [x] [y] [xdir] [ydir]</code>

Descriptions:

'''<code>[effect]</code>''' - Is the zone’s effect which decides what sort of zone it will be (death, win, target, fortress, object, teleport, etc…) '''<code>[id]</code>''' - Is the zone’s id, obviously '''<code>[name]</code>''' - Is the zone’s name. It will be blank by default if no name was given. '''<code>[x]</code>''' - Is the zone’s x location along the x-axes. Consider this as a spawn position of x. '''<code>[y]</code>''' - Is the zone’s y location along the y-axes. Consider this as a spawn position of y. '''<code>[xdir]</code>''' - Is the travelling direction along the x-axes. This also judges at what speed zone is travelling at. '''<code>[ydir]</code>''' - Is the travelling direction along the y-axes. This also judges at what speed zone is travelling at.

Sends an output when a zone was created when the map is being loaded/parsed.