Difference between revisions of "Replay file"
From Worms Knowledge Base
(→User Input) |
(→User Input) |
||
| Line 96: | Line 96: | ||
| '''Using self-managed weapon''' (sheep, skunk, ...) after having launched it. | | '''Using self-managed weapon''' (sheep, skunk, ...) after having launched it. | ||
| 02 <u>2C 01</u> 02 02 02 <u>2C 01</u> : Player 1 has its skunk start to fart, then makes it explode 3 frames later. | | 02 <u>2C 01</u> 02 02 02 <u>2C 01</u> : Player 1 has its skunk start to fart, then makes it explode 3 frames later. | ||
| + | |- | ||
| + | | 2F | ||
| + | | ww yy | ||
| + | | '''Setting Fuse''' (Grenades and related weapons). ww represents team and worm (as detailed in action 32) and yy is the fuse (00-04). | ||
| + | | 02 33 21 06 01 02 <u>2F 21 04</u> : First worm of the second team (21) selects a grenade (06) and sets its fuse to 5s (04) | ||
| + | |- | ||
| + | | 30 | ||
| + | | ww yy | ||
| + | | '''Setting herd size''' (Cows and related weapons). ww represents team and worm (as detailed in action 32) and yy is the size of the herd (01-06). | ||
| + | | 02 33 21 34 01 02 <u>30 21 02</u> : First worm of the second team (21) selects a Mad Cow (34) and sets its Herd size to 2 cows (02) | ||
| + | |- | ||
| + | | 31 | ||
| + | | ww yy | ||
| + | | '''Setting bounce height''' (Grenades and related weapons). ww represents team and worm (as detailed in action 32) and yy is the Bounce height (00 for MIN and 01 for MAX bounce). | ||
| + | | 02 33 21 06 01 02 2F 21 00 02 <u>31 21 01</u> : First worm of the second team (21) selects a Grenade (06), sets its fuse to 1s (00), and it's bounce height to MAX (01) | ||
|- | |- | ||
| 32 | | 32 | ||
| Line 151: | Line 166: | ||
|} | |} | ||
| − | Related to action 33 : '''Weapon selection'''. zz determines weapon selected | + | Related to action 33 : '''Weapon selection'''. zz determines weapon selected. |
Those weapons indices are in the same order than visible in right-click menu, starting from Bazooka and with utilities being sent at the end. Note that Super sheep and aqua sheep are 2 different weapons (F5 line has 6 columns, even if only 5 of them are visible) | Those weapons indices are in the same order than visible in right-click menu, starting from Bazooka and with utilities being sent at the end. Note that Super sheep and aqua sheep are 2 different weapons (F5 line has 6 columns, even if only 5 of them are visible) | ||
{| border="1" cellspacing="0" | {| border="1" cellspacing="0" | ||
Revision as of 17:45, 7 September 2006
Replay (.WAgame) files were introduced to Worms Armageddon with Deadcode's 3.6.19.15 beta update, which was released on 20 February, 2004. The files represent self-contained recordings of games, which can be played on any computer with the corresponding software updates installed.
Recordings of all games played (including offline, mission and training games) are saved automatically to the User\Games folder. File names consist of a date/time stamp, the game type, and the participating players.
The files contain all the information needed to play the replay flawlessly. This includes the game version which was emulated during the game, the map and the scheme, the participating teams (including the custom flags and graves), and the random seed used for random in-game events (such as random initial placement of worms and objects).
File format
The rest of this article needs to be reviewed by an expert who has more experience in this domain.
The file starts with two signature bytes ("WA"), after which follows a word with the file version. W:A 3.6.26.5 saves replays in the version 12 format (0x000C).
After this, two DWORDs follow. The first represends the map data length, and the second - the map type. The map type can be 1 for Monochrome map (.bit), 2 for Seed-generated monochrome map, or 3 for Colour map. The map data follows, its length being the 2nd DWORD in the file (see above).
Following the map data is a DWORD containing the chunk length (0x0000000C), then a null byte, then the game's starting time in time_t format. After that, there are 7 bytes which may have something to do with the scheme format. After that is the scheme data. Following it are the players, the teams, and after some null padding are the message sequences (user input) which is piped to the game engine to play back the replay.
User Input
Generalities
After the padding mentioned above, the game starts with a 09 xx xx xx xx 00. The four xx bytes are still to be determined. Each new turn is initiated by that 00 byte, and before advancing, the game engine will wait until all pending actions are stabilized (Mines triggered, flames falling, animals running, ...). Each turn is divided in frames, at a rate of 50 frames per second. Those frames are seperated by a 02 byte. A frame can be empty, or contain the actions taken at that very moment. Each 25 frames, the word 0C 1E is inserted. Its purpose is yet unknown, and it is sometimes followed by a 03 or 04, for unknown reasons too. Each time an weapon is used, a checksum gets inserted into the following frame.
Actions
Actions are usually constituted by 2 Bytes, the first one coding for the action, and the second one coding for the active team (01-06). However, it is not possible to change the "Active team" byte to move another worm while it's not his turn. For example, the action 1E corresponds to the left arrow ; the action 21 to the down arrow. If the active worm is in the third team, the frame will look like "02 1E 03 21 03" (New frame, pressing left and pressing up). Some actions are more complex, and require therefore additional arguments. Those are typically inserted before or after the "Active team" byte. Here is a list of actions codes, along with their arguments when applicable.
| Code | Arguments | Action | Example |
|---|---|---|---|
| 08 | xx yy 00 00 zz zz zz zz | Checksum. yy is a value incremented at each checksum computation. xx and the 4 zz bytes are still to be determined. | 02 08 xx yy 00 00 zz zz zz zz |
| 0F | xx yy FF tt .. tt 00 | Discussion (in chatbox). tt .. tt is the text string, xx and yy represent sender and receiver of the text. More details about this have still to be added. | 00 0F 01 01 FF tt .. tt 00 |
| 11 | xx xx xx xx | Mouse placing. The 4 xx bytes represent the position of the mouse on the screen. | 02 11 01 xx xx xx xx : Player 1 has placed the mouse at xx xx xx xx |
| 12 | xx | Orienting a girder. xx represent the new orientation of the girder. (01-0F) | 02 12 01 0B 01 : Player 1 oriented the girder to a long topright inclined girder. |
| 1E | Left arrow (In all its in-game usages) | 02 1E 02 21 02 : Player 2 had Up-Left pressed in that frame. | |
| 1F | Right arrow | ||
| 20 | Up arrow (In all its in-game usages) | ||
| 21 | Down arrow | ||
| 24 | Releasing (unmounting) of the ninja rope ; Forward Jump ; Backward jump if used twice (Not in the same frame). | 02 24 04 02 02 02 02 24 04 02 02 : Player 4 pressed Enter twice, with a 3 frames interval, to backjump | |
| 25 | Up jump, Backflip if used twice (Not in the same frame) | 02 25 04 02 02 02 02 24 04 02 02 : Player 4 pressed Backspace-Enter, with a 3 frames interval, to backjump | |
| 26 | Usage (launching) of a weapon, from the ground or from any utility (Rope, parachute, ...) allowing weapon drops. It can appear several times for weapons having multiple shots (shotgun, rope, ...), but not in the same frame. It triggers a checksum except in the case of a ninja rope being re-fired from the air. | 02 26 01 02 08 xx yy 00 00 zz zz zz zz 02 20 01 02 20 01 02 20 01 02 20 01 02 20 01 02 24 01 02 26 01 : Player 1 fires the ninja rope, causing a checksum, then shortens it during 5 frames, then releases it and fires it again. The second firing won't generate any checksum. | |
| 27 | Releasing of a power-managed weapon (Bazooka, grenade). | 02 26 02 02 02 02 02 02 02 02 27 02 : Player 2 presses space to fire a bazooka, and releases space 7 frames later. (Note the possible confusion between frame separator 02 and "Active team" 02.) | |
| 2C | Using self-managed weapon (sheep, skunk, ...) after having launched it. | 02 2C 01 02 02 02 2C 01 : Player 1 has its skunk start to fart, then makes it explode 3 frames later. | |
| 2F | ww yy | Setting Fuse (Grenades and related weapons). ww represents team and worm (as detailed in action 32) and yy is the fuse (00-04). | 02 33 21 06 01 02 2F 21 04 : First worm of the second team (21) selects a grenade (06) and sets its fuse to 5s (04) |
| 30 | ww yy | Setting herd size (Cows and related weapons). ww represents team and worm (as detailed in action 32) and yy is the size of the herd (01-06). | 02 33 21 34 01 02 30 21 02 : First worm of the second team (21) selects a Mad Cow (34) and sets its Herd size to 2 cows (02) |
| 31 | ww yy | Setting bounce height (Grenades and related weapons). ww represents team and worm (as detailed in action 32) and yy is the Bounce height (00 for MIN and 01 for MAX bounce). | 02 33 21 06 01 02 2F 21 00 02 31 21 01 : First worm of the second team (21) selects a Grenade (06), sets its fuse to 1s (00), and it's bounce height to MAX (01) |
| 32 | ww 01 zz xx xx xx xx 26 nn | Mouse click: ww represents team number and worm number, zz represents the action involved by the click, xx are the coordinates, and nn the "Active team" number (Note the 26 nn of weapon usage). | 02 32 23 01 01 xx xx xx xx 26 02 : Player 2 (nn = 02) places (zz=01 : initial placement) the 3rd worm of the 2nd team (ww = 23) at the position xx xx xx xx. This generates a Checksum (due to the 26 nn being there too) |
| 33 | ww zz 01 | Weapon selection. ww represents team number and worm number (the same way ww from action 32 does) and zz is the weapon code | 02 33 14 0B 01 : Active player (Note: The syntax doesn't mention player number) selects a Shotgun (zz=0B) for the 4th worm of team 1 |
Tables
Related to action 0F : Game chat. xx and yy represent sender and receiver (Not sure about that anymore)
| xx | yy | Result |
|---|---|---|
| 00 | 00 | Player 1 talking |
| 01 | 01 | Player 2 talking |
| Lex, | Help | Me ! |
Related to action 32 : Mouse click. zz determines the action for which the click is for.
| zz | Purpose |
|---|---|
| 01 | Initial worm placement |
| 0B | Girder placement |
Related to action 33 : Weapon selection. zz determines weapon selected. Those weapons indices are in the same order than visible in right-click menu, starting from Bazooka and with utilities being sent at the end. Note that Super sheep and aqua sheep are 2 different weapons (F5 line has 6 columns, even if only 5 of them are visible)
| zz | Weapon |
|---|---|
| 01 | Bazooka |
| 02 | Homing missile |
| 03 | Mortar |
| 04 | Homing pigeon |
| 05 | Sheep launcher |
| 06 | Grenade |
| 07 | Cluster bomb |
| 08 | Banana bomb |
| 09 | Battle axe |
| 0A | Earthquake |
| 0B | Shotgun |
| 0C | Handgun |
| 0D | Uzi |
| 0E | Minigun |
| 0F | Long bow |
| 10 | Fire punch |
| 11 | Dragon punch |
| 12 | Kamikaze |
| 13 | Suicide bomber |
| 14 | Prod |
| 15 | Dynamite |
| 16 | Mine |
| 17 | Sheep |
| 18 | Super sheep |
| 19 | Aqua sheep |
| 1A | Allmighty Mole |
| 1B | Air strike |
| 1C | Napalm strike |
| 1D | Mail strike |
| 1E | Mine strike |
| 1F | Allmighty Mole strike |
| 20 | Blowtorch |
| 21 | Drill |
| 22 | Girder |
| 23 | Baseball bat |
| 24 | Girder kit |
| 25 | Ninja rope |
| 26 | Bungee |
| 27 | Parachute |
| 28 | Teleport |
| 29 | Scale of justice |
| 2A | Super banana bomb |
| 2B | Holy hand grenade |
| 2C | Flamethrower |
| 2D | Salvation army |
| 2E | Martin Brown Bomb |
| 2F | Petrol bomb |
| 30 | Skunk |
| 31 | Ming vase |
| 32 | Sheep strike |
| 33 | Mike's carpet bomb |
| 34 | Mad cow |
| 35 | Old lady |
| 36 | Concrete donkey |
| 37 | Indian nuclear test |
| 38 | Armageddon |
| 39 | Skip go |
| 3A | Surrender |
| 3B | Worm select |
| 3C | Freeze |
| 3D | Patsy's magic bullet |
| 3E | Jetpack |
| 3F | Low gravity |
| 40 | Fast walk |
| 41 | Laser sight |
| 42 | Invisibility |
Security
The format incorporates periodic checksums, embedded into specific actions. This allows to detect modifications to the replay, causing warning messages during playback.
The tool-assisted versions of W:A save replays in an encrypted format, which is playable only with the tool-assisted version. Only Deadcode can decrypt them, thus making them playable with normal versions of W:A.
