a_samp.inc

native print( const  string[] )

Print some text to the console.

Parameters

See also

printf, format

native printf( const  format[],   {Float,_}:... )

Print a string produced according to the formatting string format.

Parameters

See also

print, format

native format(   output[],   len, const  format[],   {Float,_}:... )

Produces a string according to the formatting string format and stores the result to output[].

Parameters

Example code

new string[256];
format(string, sizeof(string), "*** %s died.", name);

See also

print, printf

native SendClientMessage(   playerid,   color, const  message[] )

Send a message to a single client.

Parameters

Example code

SendClientMessage(playerid, COLOR_RED, 'Testing');

See also

SendClientMessageToAll

native SendClientMessageToAll(   color, const  message[] )

Send a message to all clients spawned.

Parameters

Example code

SendClientMessageToAll(COLOR_RED, 'Testing');

See also

SendClientMessageToAll

native GameTextForAll( const  string[],   time,   style )

Set the game text for all players spawned.

Parameters

Styles

Gametext special strings

Example code

// Produces "Fly like a bird" in red letters
GameTextForAll("~r~Fly like a bird.", 3000, 5);

See also

GameTextForPlayer

Credits to

mike

native GameTextForPlayer(   playerid, const  string[],   time,   style )

Set the game text for a single player.

For a style / gametext type reference see GameTextForAll.

Parameters

Example code

GameTextForPlayer(playerid, "~r~Fly like a bird.", 3000, 5);

See also

GameTextForAll

native SetTimer( funcname[], interval, repeating )

Set off a timer to trigger a function.

Parameters

Example code

SetTimer("DefenceWin", 600000, 0);  // After 10 minutes, DefenceWin() is triggered.

See also

KillTimer

native KillTimer( timerid )

Kill a timer that has been set using SetTimer.

Parameters

Example code

// Setting up the timer
new gRoundTimer;
new gRoundTime = 600000;  // Round time - 10 mins
gRoundTimer = SetTimer("DefenceWin", gRoundTime, 0);

// Killing the timer
KillTimer(gRoundTimer);

See also

SetTimer

native GetTickCount()

Returns the number of milliseconds since the OS was started.

Useful for timing.

native SetGameModeText( const  string[] )

Sets the game mode title that is displayed in the server browser.

Parameters

Example code

SetGameModeText("Area 51 Break-in");

native SetTeamCount( count )

Sets the number of teams allowed.

Parameters

Example code

SetTeamCount(2);  // Allows two teams

native AddPlayerClass( modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, weapon1, weapon1_ammo, weapon2, weapon2_ammo, weapon3, weapon3_ammo )

Makes a player model avaliable for selection, define its spawn point and its weapons including ammunition.

For a complete, human readable list of all model IDs please look here: http://tinyurl.com/ojjdy

Parameters

Example code

AddPlayerClass(117,-1617.5673,1390.0602,7.1747,333.2159,4,1,23,170,30,300);

See also

<AddPlayerClassEx>

native AddStaticVehicle( modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, color1, color2 )

Add a vehicle at a given spawn point with the defined colors.

For a complete, humand readable listing of all vehicle IDs please look here: http://tinyurl.com/j5sow

For a handy color chart please look here: http://tinyurl.com/hthuf

Parameters

Example code

AddStaticVehicle(454,-1427.9684,1470.6309,0.5181,135.1407,-1,-1);
AddStaticVehicle(473,-1579.3042,1318.4962,-0.5421,249.5810,56,15);

See also

CreateVehicle, <AddStaticVehicleEx>

native AddStaticPickup( model, type, Float:X, Float:Y, Float:Z )

Add a pickup item at given coordinates.

For a listing of pickup types please click here: http://tinyurl.com/hkrhb

Parameters

native ShowNameTags( show )

Set whether name tags should be shown or not.

Name tags mean the player names that are written over the model’s head by default.

Parameters

Example code

// Show name tags (default setting)
ShowNameTags(1);
// Hide name tags
ShowNameTags(0);

See also

ShowPlayerMarkers

native ShowPlayerMarkers( show )

Set whether players markers (on the map) should be shown or not.

Parameters

Example code

// Show player markers (default setting)
ShowPlayerMarkers(1);
// Hide player markers
ShowPlayerMarkers(0);

See also

ShowNameTags

native GameModeExit()

Exit the game mode.

native SetWorldTime( hour )

Set the game clock to a certain time and freeze it.

Parameters

Example code

// Set the clock to 10 a.m.
SetWorldTime(10);

native GetWeaponName(   weaponid, const  weapon[],   len )

Gets the name of a weapon from its ID an stores it in weapon[].

Parameters

Example code

// Taken from an OnPlayerDeath(playerid, killerid, reason) where reason is the weapon ID
new deathreason[20];
GetWeaponName(reason, deathreason, 20);
format(string, sizeof(string), "*** %s died. (%s)", name, deathreason);

See also

GetPlayerName

native IsPlayerAdmin( playerid )

Determines whether the given player is an administrator.

Parameters

Example code

if(IsPlayerAdmin(playerid) == 1) {
  Kick(badguy);
  SendClientMessage(playerid, COLOR_BLUE, 'Kick okay.');
} else {
  SendClientMessage(playerid, COLOR_RED, 'Permission denied, you are not an admin!');
}

See also

Kick, Ban

native Kick( playerid )

Kicks the player with the given ID.

Remember to perform a check with IsPlayerAdmin if you want to restrict normal users from kicking people!

Parameters

Example code

if(IsPlayerAdmin(playerid) == 1) {
  Kick(badguy);
  SendClientMessage(playerid, COLOR_BLUE, 'Kick okay.');
} else {
  SendClientMessage(playerid, COLOR_RED, 'Permission denied, you are not an admin!');
}

See also

IsPlayerAdmin, Ban

native Ban( playerid )

Bans the player with the given ID.

Remember to perform a check with IsPlayerAdmin if you want to restrict normal users from banning people!

Parameters

Example code

if(IsPlayerAdmin(playerid) == 1) {
  Ban(badguy);
  SendClientMessage(playerid, COLOR_BLUE, 'Ban okay.');
} else {
  SendClientMessage(playerid, COLOR_RED, 'Permission denied, you are not an admin!');
}

See also

IsPlayerAdmin, Kick

native SetSpawnInfo( playerid, team, skin, Float:x, Float:y, Float:z, Float:rotation, weapon1, weapon1_ammo, weapon2, weapon2_ammo, weapon3, weapon3_ammo )

Sets some spawn parameters (including team, skin, spawning position, weapons and ammo) for a given player.

Parameters

native SpawnPlayer( playerid )

Spawns the given player.

Parameters

native SetPlayerTeam( playerid, teamid )

Add a player to the given team.

Parameters

See also

GetPlayerTeam

native GetPlayerTeam( playerid )

Returns the teamID of the player.

Parameters

Example code

if(GetPlayerTeam(playerid) == 255) {
  // player is in no team
}

See also

SetPlayerTeam

native SetPlayerSkin( playerid, skinid )

Apply a given skin to a player.

Parameters

native SetPlayerScore( playerid, score )

Set the score of a single player to a given value.

Parameters

Example code

// Set score to 500
SetPlayerScore(500);

See also

GetPlayerScore

native GetPlayerScore( playerid )

Returns the current score of the given player.

Parameters

Example code

new score[10];
score = GetPlayerScore(playerid);
SendClientMessage(playerid, COLOR_BLUE, score);

See also

SetPlayerScore

native GetPlayerPos( playerid, & Float:x, & Float:y, & Float:z )

Get the x,y and z coordinates of a given player.

Parameters

Example code

new Float:x;
new Float:y;
new Float:z;
GetPlayerPos(playerid, x, y, z);
new string[30];
format(string, 30, "You are at %f %f %f", x, y, z);

See also

SetPlayerPos

native SetPlayerPos( playerid, Float:x, Float:y, Float:z )

Set the x,y and z coordinates of a given player.

Parameters

See also

GetPlayerPos

native GetPlayerHealth( playerid, & Float:health )

Get the health value of a given player and store it in health.

Parameters

Example code

new healthvalue;
healthvalue = GetPlayerHealth(playerid, healthvalue);
SendClientMessage(playerid, COLOR_RED, healthvalue);

See also

SetPlayerHealth

native SetPlayerHealth( playerid, Float:health )

Set the health value of a given player.

Setting health to 0 kills the player.

Parameters

Example code

// Kill a player
SetPlayerHealth(playerid, 0);
// Set health to 20
SetPlayerHealth(playerid, 20);

See also

GetPlayerHealth

native PutPlayerInVehicle( playerid, vehicleid, seatid )

Put a player into a given vehicle onto a given seat.

Parameters

See also

RemovePlayerFromVehicle, IsPlayerInVehicle, IsPlayerInAnyVehicle, GetPlayerVehicleID

native RemovePlayerFromVehicle( playerid )

Removes a player from his vehicle.

Parameters

See also

PutPlayerInVehicle, IsPlayerInVehicle, IsPlayerInAnyVehicle, GetPlayerVehicleID

native IsPlayerInVehicle( playerid, vehicleid )

Determines whether a player is in a given vehicle.

Parameters

Example code

if(IsPlayerInVehicle(playerid, vehicleid)) {
  RemovePlayerFromVehicle(playerid);
} else {
  SendClientMessage(playerid, COLOR_RED, "Player is not in that vehicle!");
}

See also

PutPlayerInVehicle, RemovePlayerFromVehicle, IsPlayerInAnyVehicle, GetPlayerVehicleID

native IsPlayerInAnyVehicle( playerid )

Determines whether a player is in any vehicle.

Parameters

Example code

if(IsPlayerInAnyVehicle(playerid)) {
  RemovePlayerFromVehicle(playerid);
} else {
  SendClientMessage(playerid);
}

See also

PutPlayerInVehicle, RemovePlayerFromVehicle, IsPlayerInVehicle, GetPlayerVehicleID

native GetPlayerName(   playerid, const  name[],   len )

Get a player’s name from his ID and store it in name[].

Parameters

See also

GetWeaponName

native SetPlayerColor( playerid, color )

Set the player color for a given playerid.

Parameters

Example code

SetPlayerColor(playerid, COLOR_BLUE);

See also

GetPlayerColor

native GetPlayerColor( playerid )

Get the color of a given playerid.

Parameters

See also

GetPlayerColor

native GetPlayerVehicleID( playerid )

Get the ID of the vehicle of a given player.

Parameters

See also

PutPlayerInVehicle, RemovePlayerFromVehicle, IsPlayerInVehicle, IsPlayerInAnyVehicle

native SetPlayerCheckpoint( playerid, Float:x, Float:y, Float:z, Float:size )

Set a checkpoint for a given player.

Parameters

See also

DisablePlayerCheckpoint, IsPlayerInCheckpoint

native DisablePlayerCheckpoint( playerid )

Disable the currently active checkpoint for the given player.

Parameters

Example code

// Set up a checkpoint
SetPlayerCheckpoint(playerid, x, y, z, 20);
// Disable it again
DisablePlayerCheckpoint(playerid);

See also

SetPlayerCheckpoint, IsPlayerInCheckpoint

native IsPlayerInCheckpoint( playerid )

Determines whether the given player is in the checkpoint or not.

Parameters

Example code

if(IsPlayerInCheckpoint(playerid)) {
  SetGameTextForPlayer(playerid, "~r~You have reached the checkpoint!", 3000, 5);
}

See also

SetPlayerCheckpoint, DisablePlayerCheckpoint

native SetPlayerInterior( playerid, interiorid )

Sets the interior ID.

For a list of (some) interiors please look here: http://tinyurl.com/en55t

If you want to teleport to an interior, you need to use SetPlayerPos and SetPlayerInterior.

Parameters

native SetPlayerCameraPos( playerid, Float:x, Float:y, Float:z )

Place the camera at given position.

Parameters

See also

SetPlayerCameraLookAt, SetCameraBehindPlayer, SetPlayerFacingAngle

native SetPlayerCameraLookAt( playerid, Float:x, Float:y, Float:z )

Set the camera to look at a given position.

Parameters

See also

SetPlayerCameraPos, SetCameraBehindPlayer, SetPlayerFacingAngle

native SetCameraBehindPlayer( playerid )

Set the camera behind the player.

Parameters

See also

SetPlayerCameraPos, SetPlayerCameraLookAt, SetPlayerFacingAngle

native TogglePlayerControllable( playerid, toggle )

Toggle whether the player is controllable or not.

Parameters

native PlayerPlaySound( playerid, soundid, Float:x, Float:y, Float:z )

Plays the sound with the given soundid.  The sound is “placed” at the given coordinates.

For a list of soundIDs please click here: http://tinyurl.com/nzbkk

Parameters

native SetPlayerWorldBounds( playerid, Float:x_max, Float:x_min, Float:y_max, Float:y_min )

Sets rectangular world bounds.

(The user cannot move outside these bounds.)

Parameters

Example

 +---------(1)
 |          |     (0) ... x_min | y_min
 |          |     (1) ... x_max | y_max
(0)---------+

native GivePlayerMoney( playerid, money )

Gives a certain amount of money to a player.

Parameters

See also

GetPlayerMoney, ResetPlayerMoney

native SetPlayerFacingAngle( playerid, Float:ang )

Turns the player at a given angle so he faces into another direction.

Parameters

See also

SetPlayerCameraPos, SetPlayerCameraLookAt, SetCameraBehindPlayer

native GetPlayerMoney( playerid )

Get the current amount of money from a player.

Parameters

See also

GivePlayerMoney, ResetPlayerMoney

native ResetPlayerMoney( playerid )

Reset a given players money to 0.

Parameters

See also

GivePlayerMoney, GetPlayerMoney

native IsPlayerConnected( playerid )

Checks whether a player is connected or not.

Parameters

See also

GetPlayerState

native GetPlayerState( playerid )

Check the current state of a player.

For a complete list of states please look at OnPlayerStateChange.

Parameters

See also

IsPlayerConnected

native ResetPlayerWeapons( playerid )

Resets all weapons of a given player (player will have no weapons).

Parameters

See also

GivePlayerWeapon

native GivePlayerWeapon( playerid, weaponid, ammo )

Gives a player a weapon with the given amount of ammunition.

Parameters

See also

ResetPlayerWeapons

native CreateVehicle( vehicletype, Float:x, Float:y, Float:z, Float:rotation, color1, color2, respawn_delay )

Create a new vehicle at given coordinates with given colors.

For a handy color chart please look here: http://tinyurl.com/hthuf

Note that this function creates vehicles at runtime!

If you are looking for vehicle spawns please take a look at AddStaticVehicle.

Parameters

See also

AddStaticVehicle, GetVehiclePos, SetVehiclePos, SetVehicleZAngle, SetVehicleParamsForPlayer

native GetVehiclePos( vehicleid, & Float:x, & Float:y, & Float:z )

Locate a vehicle and store its coordinates.

Parameters

See also

CreateVehicle, SetVehiclePos, SetVehicleZAngle, SetVehicleParamsForPlayer

native SetVehiclePos( vehicleid, Float:x, Float:y, Float:z )

Set the coordiates of a vehicle.

Note that this will only work if somebody is actually inside the vehicle.

Parameters

See also

CreateVehicle, GetVehiclePos, SetVehicleZAngle, SetVehicleParamsForPlayer

Thanks to

DracoBlue

native SetVehicleZAngle( vehicleid, Float:z_angle )

Set the rotation of a vehicle.

Parameters

See also

CreateVehicle, GetVehiclePos, SetVehiclePos, SetVehicleParamsForPlayer

native SetVehicleParamsForPlayer( vehicleid, playerid, objective, doorslocked )

Set some player-specific parameters for a vehicle.

Parameters

See also

CreateVehicle, GetVehiclePos, SetVehiclePos, SetVehicleZAngle

native SetVehicleToRespawn( vehicleid )

Makes a vehicle respawn.

Parameters

native AddVehicleComponent( vehicleid, componentid )

Tune a vehicle with a given component.

A list of components should be avaliable shortly.

Parameters

See also

ChangeVehicleColor, ChangeVehiclePaintjob

native ChangeVehicleColor( vehicleid, color1, color2 )

Changes the colors of a given vehicle.

Parameters

See also

AddVehicleComponent, ChangeVehiclePaintjob

native ChangeVehiclePaintjob( vehicleid, paintjobid )

Change the paintjob on a given vehicle.

Parameters

See also

AddVehicleComponent, ChangeVehicleColor