.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 or rec version, ec 03 00 00 (e9 03 00 00 in npcclient v1.5 and e8 03 00 00 in npcclient v1.1 ) (ea 03 00 00 in rec files produced by npcclient v1.7 beta)
4-7	integer	1 for onfoot recordings, 2 for vehicle recordings
8-11 ^	integer	Flags
12-35 ^$(if Flags&1 is 1)	integer	(From 1005) Name field

[*]Offset is relative to the beginning of the file.
[^]This field exist from rec version 1005 onwards only.
[$]The existence of these bytes are depend on other values.

Data blocks (v4)

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
40	bool	IsAiming
41-44	float	player's aim direction x co-ordinate
45-48	float	player's aim direction y co-ordinate
49-52	float	player's aim direction z co-ordinate
53-56	float	player's aim position x co-ordinate
57-60	float	player's aim position y co-ordinate
61-64	float	player's aim position z co-ordinate
65 (new)	bool	IsReloading
66-67 (new)	unsigned short	ammo
68	unsigned char	player's Action
69	unsigned char	Reserved for future use

[*]Offset is relative to the datablock

Vehicle data

---

Offset*	type	meaning
0-3	unsigned integer	time in ms when to apply this block's data
4-5	unsigned short	Vehicle ID
6-9	unsigned integer	player's keys
10-13	float	vehicle rotation quaternion x component
14-17	float	vehicle rotation quaternion y component
18-21	float	vehicle rotation quaternion z component
22-25	float	vehicle rotation quaternion w component
26-29	float	vehicle position x co-ordinate
30-33	float	vehicle position y co-ordinate
34-37	float	vehicle position z co-ordinate
38-41	float	vehicle speed x component
42-45	float	vehicle speed y component
46-49	float	vehicle speed z component
50-53	float	vehicle Health
54	unsigned char	player Health
55	unsigned char	player Armour
56	unsigned char	player Current Weapon
57-60	unsigned integer	vehicle Damage
61-64	float	Turret x
65-68	float	Turret y
69-70 (new)	unsigned short	Ammo

[*]Offset is relative to the datablock

Note: Thanks to samp-npc-wiki-rec-file-data

Version 1005 (not yet released)

For structure of new rec files from v1.8, see .rec_file_1005