.rec file: Difference between revisions

From NPC for VCMP 0.4 Servers
Jump to navigation Jump to search
No edit summary
Line 132: Line 132:
|}
|}
[*]Offset is relative to the datablock
[*]Offset is relative to the datablock


Note: Thanks to [https://team.sa-mp.com/wiki/.rec_file.html samp-npc-wiki-rec-file-data]
Note: Thanks to [https://team.sa-mp.com/wiki/.rec_file.html samp-npc-wiki-rec-file-data]
==Version 1005 (not yet released)==
For structure of new rec files which are yet to be released, see [[.rec_file_1005]]

Revision as of 08:37, 19 December 2023

.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 which are yet to be released, see .rec_file_1005