StartRecordingPlayerData
The parameter flags was added in v1.8 (not released as of 19.Dec.2023) and will not work in previous versions. See StartRecordingPlayerData
Description:
Starts recording player movements to a file which can be reproduced by an NPC
Parameters:
(playerid, recordtype=3, recordname="", flags=60)
playerid : The ID of the player whose actions to be recorded
recordtype : The type of the recording.
recordname : The name of the file which will store the data. The file will be saved in recordings or npcscripts/recordings with an automatically added .rec extension. If this parameter is empty string or is omitted, plugin will create file based on system time, date and name of player. Provide recdir 2 in server.cfg to save in npcscripts/recordings.
flags : Specify one or more value combined from flags by using 'bitwise OR'. 0 means nothing will be recorded.
Return Values:
true, on success and false, on failure. Failure means the player is not connected.
Example
function onPlayerCommand(player,cmd,text)
{
if(cmd=="ofrecord")
{
if(player.IsAdmin==false)
{
ClientMessage("You need Admin privilege to use this command",player,255,255,255);
return;
}
if(player.Vehicle)
{
ClientMessage("You cannot be in vehicle when using this command",player,255, 255, 255);
return;
}
if(!text)
{
ClientMessage("Usage: /ofrecord filename",player,255, 255, 255);
return;
}
local success=StartRecordingPlayerData(player.ID, PLAYER_RECORDING_TYPE_ONFOOT, text);
if(success)
ClientMessage("[Recording]Started",player,255, 255, 255);
else
ClientMessage("Command Failed", player, 255, 255, 255);
}else if (cmd=="vrecord")
{
if(player.IsAdmin==false)
{
ClientMessage("You need Admin privilege to use this command",player,255,255,255);
return;
}
if(!player.Vehicle)
{
ClientMessage("You must be in a vehicle to use this command",player,255, 255, 255);
return;
}
if(!text)
{
ClientMessage("Usage: /vrecord filename",player, 255, 255, 255);
return;
}
local success=StartRecordingPlayerData(player.ID, PLAYER_RECORDING_TYPE_DRIVER, text);
if(success)
ClientMessage("[Recording]Started",player, 255, 255, 255);
else
ClientMessage("Command Failed", player,255, 255, 255);
}else if(cmd=="stoprecord")
{
local success=StopRecordingPlayerData(player.ID);
if(success)
ClientMessage("[Recording]Stopped",player, 255, 255, 255);
else
ClientMessage("Command Failed", player,255, 255, 255);
}
}Related Functions
The following functions may be helpful as they relate to this function in one way or another.