.rec file
.rec files
The rec files are the files recorded by the VCMP server using the plugin-npc04relxx. Normally, the files are created by recording a player's action. They then can be used by the npc scripts for playback so that the npcs reproduce exactly the same actions. Only rec files in the npscripts/recordings directory can be accessed by the npc scripts, while the rec files created normally lie in a folder also named 'recordings' in the server directory.
General Structure
The .rec file format consists of a header, followed by a non-separated sequence of data blocks. Every data block completely describes the player state at a specific moment, and so the NPC's actions are stored fluently. The data is stored as bytes in little endian order. Single data values can be 1, 2 or 4 bytes long, and so either are bytes, shorts, integers or floats in IEEE-754 format. ).
HEADER[8]DATABLOCK[76]DATABLOCK[76]... ( for on foot recordings, datablock size is 76 in v.1.3 )
File Header
The .rec file header got the same structure for both vehicle and on-foot recordings. It is 8 bytes long, where the first 4 bytes are an integer. It is 1000 for recordings created by the first version (April 2022) of the program, whereas in release v1.4 it is 1001. The other 4 bytes represent an integer which is 1 for on foot recordings and 2 for vehicle recordings.
| Offset* | type | meaning |
|---|---|---|
| 0-3 | integer | File identifier, always e9 03 00 00 |
| 4-7 | integer | 1 for onfoot recordings, 2 for vehicle recordings |
[*]Offset is relative to the beginning of the file.
Data blocks
On-foot data
| Offset* | type | meaning | |||
|---|---|---|---|---|---|
| 0-3 | unsigned integer | time in ms when to apply this block's data | |||
| 4-7 | unsigned integer | the players keys | |||
| 8-11 | float | player's position x co-ordinate | |||
| 12-15 | float | player's position y co-ordinate | |||
| 16-19 | float | player's position z co-ordinate | |||
| 20-23 | float | player's Angle | |||
| 24 | unsigned char | Health | |||
| 25 | unsigned char | Armour | |||
| 26 | unsigned char | Weapon | |||
| 27 | bool | IsCrouching | 28-31 | float | player's speed x co-ordinate |
| 32-35 | float | player's speed y co-ordinate | |||
| 36-39 | float | player's speed z co-ordinate | |||
| 37 | bool | IsAiming | |||
| 38-41 | float | player's aim direction x co-ordinate | |||
| 42-45 | float | player's aim direction y co-ordinate | |||
| 46-49 | float | player's aim direction z co-ordinate | |||
| 50-53 | float | player's aim position x co-ordinate | |||
| 54- 57 | float | player's aim position y co-ordinate | |||
| 58 -61 | float | player's aim position z co-ordinate | |||
| 62 (new) | bool | IsReloading | |||
| 63-64 (new) | unsigned short | ammo |