Scripts For Samp Server

• FiveM is a modification for Grand Theft Auto V enabling you to play multiplayer on customized dedicated servers, powered by Cfx.re. FiveM Scripts, MLO, YMAP, Reviews, Tutorials, Installation Guides. All what your Server and Players need.
• Discussion on SA-MP Release von Server Script's within the Grand Theft Auto forum part of the Other Online Games category., 16:18 #1.

• Free Samp Server
• Script Samp Server
• Scripts For Samp Servers
• Samp Roleplay Scripts
• Samp Servers English
• Samp Rp Servers

San Andreas Multiplayer Zombie Servers list, find the best SAMP servers of zombie type / gamemode. Ranked by status, players online & players votes.

INTRO:
This guide is based on other tutorials and on my own experience. It is created specially for new scripters and people who want to learn SA-MP Pawn scripting, it explains just basic scripting and how to start.
* Note: this guide is based on the one I made for SA-MP forum in the first months of 2015; if you read this later, some elements may have changed or updated.
Based on:
Nicholas tutorial
Kwarde tutorial
Wiki SA-MP
Own knowledge.
INDEX:
STARTING
Explaining each file (basic ones)
scriptfiles
plugins
pawno
npcmodes
include
gamemodes
filterscripts
announce.exe
samp-npc.exe
samp-server.exe
server.cfg
CONFIGURATION
PAWN SCRIPTING
Publics
public OnGameModeInit()
public OnGameModeExit()
public OnPlayerRequestClass(playerid, classid)
public OnPlayerConnect(playerid)
public OnPlayerSpawn(playerid)
public OnPlayerDeath(playerid)
public OnPlayerDisconnect(playerid, reason)
public OnPlayerText(playerid)
public OnPlayerUpdate(playerid)
Functions
SetPlayerPos(playerid, X, Y, Z);
TextDrawCreate(X, Y, text[])
Dialog Function (menus & others)
ShowPlayerDialog(playerid, dialogid, style, caption[], info[], button1[], button2[]);
Message box style (sends a message to the player)
Input style (allows players to input text into the dialog)
List style (menu, show the player a list of options)
Password style (allows players to input text into the dialog without revealing it)
CREATING AND REMOVING OBJECTS
Map editor (1 & 2)
Start using it
Creating objects
Removing objects
MTA map editor
Start using it
Delux GTA Map Converter v2
Creating Objects
Streamer installation
START PRACTICING
STARTING:
First we must download the SA-MP Windows Server from SA-MP.com
After doing this we will open the files contained in the download and after decompressing it, we will see our server files & folders...
Basic files & folders:
scriptfiles, plugins, pawno, npcmodes, include, gamemodes, filterscripts, announce.exe, samp-npc.exe, samp-server.exe & server.cfg
Other files:
Text files that include terms & a configuration guide (samp-license.txt & server-readme.txt respectively).
Explaining each file (basic ones):
scriptfiles: this folder contains information called inside your script or logs created by your script, usually used as a database.
plugins: this folder contains additional codes that give more options in SA-MP programming, usually programmed in other languages. This guide will not give detailed information about plugins as they are more advanced.
pawno: contains the basic program to start scripting in SA-MP; also has the 'include' folder that contains basic includes to start our script (SA-MP basic functions). We can also add our own includes and add them to our script.
npcmodes: this contains information about NPCs (script & rec); this guide will not give detailed information about NPCs as they are more advanced.
include: this contains codes that can be included inside your script.
gamemodes: contains basic gamemodes and we must place our gamemode if we create one.
filterscripts: contains additional codes apart from your gamemode, not included in it and can be called by using rcon commands.
announce.exe: this will allow us to show our server on Masterlist.
samp-npc.exe: this will allow us to use NPCs.
samp-server.exe: we start our server with this.
server.cfg: our server configuration.
CONFIGURATION:
First we must open the file 'server.cfg' and edit our server configuration.
After opening it, you will find:

You can edit your configuration based on this:

You can also read more information about server.cfg configuration.
Configuration example (this guide is based on this configuration):

PAWN SCRIPTING:
After changing our configuration we will start scripting our gamemode.
In this case we will use a basic mode you can download here.
Put it inside the 'gamemodes' folder.
After doing this open the pawno folder inside your server and open the file 'pawno.exe'.
Press 'File/Open' (or just press CTRL + O) and open our basic mode, placed inside the gamemodes folder.
Inside we have this:

This is the basic SA-MP include, it will be included in every script you create in SA-MP.
This message will be shown in console when we open our server with samp-server.exe:

The blue text is the message that will be shown.
You can edit the text that you want to be shown in console when your gamemode starts, just editing the blue text; for example:

* Note: Every code must have opening and closing brackets to start and end the function (all codes).
Example:
Opening brackets = Red
Closing brackets = Green
main()
{
print('My first mode!');
}
* Note: It is very important to press F5 after editing or creating a script! This will update the AMX file and all changes will be saved ('if there is not mistake', but in special cases may happen programming mistakes that will not figure in the compilation and will affect your server). If everything is okay you will see something like:
If not there is a mistake and you need to fix it.
Publics:
Publics are basic functions called while your server is running. SA-MP counts with basic publics called in most gamemodes. Most basic public names describe when the public is executed.
Some basic publics are called in special moments, for example while spawning; you can add a function to that moment.
Example; if we want to set players health to 50 when spawning it would be something like:

* Note: we can not use identical publics in the same script; for example two OnPlayerSpawn publics; if we want to add an extra function we must add it inside the same public or inside a filterscript. Base on the last example, we will add a message while spawning:

Here are some basic publics that are mostly used by scripters:
public OnGameModeInit() - Called when your mode starts.
Additional information: http://wiki.sa-mp.com/wiki/OnGameModeInit
Basic structure:

Example code:

AddPlayerClass is a function that adds skin options to class selection; for example if we want to add Sweet's Skin we should add this to our code:

Free Samp Server

The number '270' is the skin ID of Sweet.
public OnGameModeExit() - Called when your mode ends; it is not necessary in all scripts (optional in most cases).
Additional information: http://wiki.sa-mp.com/wiki/OnGameModeExit
Basic structure:

Example code:

public OnPlayerRequestClass(playerid, classid) - Called when you choose your skin.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerRequestClass
Basic structure:

Example code:

SetPlayerFacingAngle sets the angle where the player is looking; it's structure is:

More information about SetPlayerFacingAngle.
public OnPlayerConnect(playerid) - Called when a player connects.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerConnect
Basic structure:

Example code:

PlayAudioStreamForPlayer is a function that plays an audio stream for a player. It's basic structure is:

* Note: audio links must be in a specific format to be played; for example thislink.
You can find music in many websites. For example in this website.
public OnPlayerSpawn(playerid) - Used after class selection, while spawning. This are the functions that will affect you when spawning.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerSpawn
Basic structure:

Example code:

SendClientMessage is a function that sends a message to the player; it's structure is:

More information about SendClientMessage.
public OnPlayerDeath(playerid) - Called when you die. This function will affect you when you die.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerDeath
Basic structure:

Example code:

GameTextForPlayer is a function that sends a screen message to the player; it's structure is:

More information about GameTextForPlayer.
public OnPlayerDisconnect(playerid, reason) - Called when a player disconnects.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerDisconnect
Basic structure:

Example code:

public OnPlayerText(playerid) - Called when a player sends a message (chat).
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerText
Basic structure:

Example code:

This function is the format assigned to SendClientMessageToAll. When it is send, it will follow that format:



Name, playerid & text are the values assigned to %s, %d and %s.
public OnPlayerUpdate(playerid) - Called everytime a client/player updates the server with their status.
Additional information: http://wiki.sa-mp.com/wiki/OnPlayerUpdate
Basic structure:

Example code:

'if' is used to determine that if something is happening, the server will execute that function.
It would mean something like:
If he is using minigun, kick him!
* Note: using 'if' in OnPlayerUpdate may cause lag, this is just an example.
Using return means that the function ends there, with 'Kick(playerid);'. If you have other code down that function, it will not be executed.
For example:

Functions:
Basically, most functions names (native functions) describe what the function does; you can find many of them here.
Some basic functions that might be used in a basic gamemode:
SetPlayerPos(playerid, X, Y, Z); - Sets a player position (X, Y & Z are the place where the player will be moved).
Additional information: http://wiki.sa-mp.com/wiki/SetPlayerPos
Example code:

You can save your current position by using the command /Save inside the game (default command by SA-MP). After using this you must go to 'GTA San Andreas User FilesSAMP' and then open the file 'savedpositions.txt'. There you will find something like:

Then just copy the red values:

* Note: obviously our values are not red, it is just for the example.
Then paste those values inside your SetPlayerPos function; like this:

Script Samp Server

You can also use this system that will do it for you.
TextDrawCreate(X, Y, text[]) - Creates a textdraw (X & Y are the coords in the screen and 'text' is the text that will be shown).
Additional information: http://wiki.sa-mp.com/wiki/TextDrawCreate
Example of textdraw:

An easy way to use this function is using a Textdraw Creator.
To show a textdraw to a player you should use the function TextDrawShowForPlayer.
Example of use (based on the last example):

To hide a textdraw to a player you must use the function TextDrawHideForPlayer.
Example:

And to destroy a textdraw you use the function TextDrawDestroy.
Example:

Dialog Function (menus & others):
ShowPlayerDialog(playerid, dialogid, style, caption[], info[], button1[], button2[]); - Shows the player a dialog box.
Additional information: http://wiki.sa-mp.com/wiki/ShowPlayerDialog
* Note: Every dialog needs a unique 'dialogid'; unless you do not use that ID inside the public OnDialogResponse (filterscripts and include dialogs must also use a unique dialogid).
There are 4 types of dialog:

Scripts For Samp Servers

Message box style (sends a message to the player):
Example code (with cancel button):

Every lines has characters; the first line has 77 characters, so we put 77 at the end.
In the second line we have to count the characters in that line plus the characters in all the lines before that line. In this case is 153; so we put 153 at the end.
Example code (without cancel button):

The function 'strcat' concatenates (joins together) our Menu string and our text.
* Note: You can use special websites to count characters.
When counting characters you just count the characters inside the '; for example:

The n character also counts.
We can also add a function when we press 'Accept' or 'Cancel' inside the public OnDialogResponse.
For example:

We add a message function inside the public OnDialogResponse:

* Note: When using OnDialogResponse every dialog needs a number. In this case we used number 1:

Input style (allows players to input text into the dialog):
Example code:

Samp Roleplay Scripts

After creating our code we must create a function to that code; so we will use the public OnDialogResponse:
Example code:

'if' is used to determine that if something is happening, the server will execute that function.
It would mean something like:
If he is using minigun, kick him!
* Note: using 'if' in OnPlayerUpdate may cause lag, this is just an example.
Using return means that the function ends there, with 'Kick(playerid);'. If you have other code down that function, it will not be executed.
For example:

Functions:
Basically, most functions names (native functions) describe what the function does; you can find many of them here.
Some basic functions that might be used in a basic gamemode:
SetPlayerPos(playerid, X, Y, Z); - Sets a player position (X, Y & Z are the place where the player will be moved).
Additional information: http://wiki.sa-mp.com/wiki/SetPlayerPos
Example code:

You can save your current position by using the command /Save inside the game (default command by SA-MP). After using this you must go to 'GTA San Andreas User FilesSAMP' and then open the file 'savedpositions.txt'. There you will find something like:

Then just copy the red values:

* Note: obviously our values are not red, it is just for the example.
Then paste those values inside your SetPlayerPos function; like this:

Script Samp Server

You can also use this system that will do it for you.
TextDrawCreate(X, Y, text[]) - Creates a textdraw (X & Y are the coords in the screen and 'text' is the text that will be shown).
Additional information: http://wiki.sa-mp.com/wiki/TextDrawCreate
Example of textdraw:

An easy way to use this function is using a Textdraw Creator.
To show a textdraw to a player you should use the function TextDrawShowForPlayer.
Example of use (based on the last example):

To hide a textdraw to a player you must use the function TextDrawHideForPlayer.
Example:

And to destroy a textdraw you use the function TextDrawDestroy.
Example:

Dialog Function (menus & others):
ShowPlayerDialog(playerid, dialogid, style, caption[], info[], button1[], button2[]); - Shows the player a dialog box.
Additional information: http://wiki.sa-mp.com/wiki/ShowPlayerDialog
* Note: Every dialog needs a unique 'dialogid'; unless you do not use that ID inside the public OnDialogResponse (filterscripts and include dialogs must also use a unique dialogid).
There are 4 types of dialog:

Scripts For Samp Servers

Message box style (sends a message to the player):
Example code (with cancel button):

Every lines has characters; the first line has 77 characters, so we put 77 at the end.
In the second line we have to count the characters in that line plus the characters in all the lines before that line. In this case is 153; so we put 153 at the end.
Example code (without cancel button):

The function 'strcat' concatenates (joins together) our Menu string and our text.
* Note: You can use special websites to count characters.
When counting characters you just count the characters inside the '; for example:

The n character also counts.
We can also add a function when we press 'Accept' or 'Cancel' inside the public OnDialogResponse.
For example:

We add a message function inside the public OnDialogResponse:

* Note: When using OnDialogResponse every dialog needs a number. In this case we used number 1:

Input style (allows players to input text into the dialog):
Example code:

Samp Roleplay Scripts

After creating our code we must create a function to that code; so we will use the public OnDialogResponse:
Example code:

List style (menu, show the player a list of options):
Example code (creating a weapon menu):


The n symbol is used to separate the elements of the list.
To give the weapon we use the public OnDialogResponse:

Structure of the function GivePlayerWeapon:

Additional information about this function: http://wiki.sa-mp.com/wiki/GivePlayerWeapon
Password style (allows players to input text into the dialog without revealing it):
It has the same structure of 'Input style'; mostly used in account systems (it is a bit advanced for this tutorial).
If you want to create an account system you can read this tutorials:
Kush account system guide (Y_INI).
Lorenc_ account system guide (SQLite using rBits).
CREATING AND REMOVING OBJECTS:
There are many programs to create maps for your server; the most known are:
Map editor 1
Map editor 2
MTA map editor
Game Object ID List: http://wiki.sa-mp.com/wiki/Model_ID
Map editor (1 & 2):
Both have the same structure; so this is an explanation for both.
Start using it:
- After dowloading it, you must open the file 'editor.exe' and press the button 'LOAD'.
- It will load the game map (GTA-SA); you can move your camera by moving your mouse while clicking the right mouse button. You can move around the map with the mouse scroll or with the keys 'W, A, S & D' while pressing the right mouse button.
Creating objects:
- Move to the place where you want to add your mapping, then press the button 'Objects' inside the menu (the menu on the right of the window).
- Press 'Add' and search the object you want to add (ID or name); then press double click on it and press the button 'Add'.
- After doing it press on the object shown on the right of the window and after doing it press 'insert'.
- You can move the object by using the 'Movement' panel.
- After mapping you can get the code and add it to your GM by pressing 'Show Code'. Copy the code and paste it inside the public OnGameModeInit.
Example code:

Additional information: http://wiki.sa-mp.com/wiki/CreateObject
Removing objects:
- Move around the map and search the object you want to delete.
- Click on it and press 'Supr'.
- After deleting the object press 'Show Code'. Paste the code inside the public OnPlayerConnect.
Example code:

Additional information: http://wiki.sa-mp.com/wiki/RemoveBuildingForPlayer
MTA map editor:
This program is easier than the other editor.
You can download it here.
* Note: It is able to create objects but not to delete them from the original map.
Start using it:
- After downloading it, open the file MTA.exe
- Click on the map editor.
- To move around the map use the camera and the keys 'W, A, S & D'.
- To create objects press 'F' and click on the cube object (in the bottom):
- Search or select your object and place it on the map.
* Note: You can move it down and up by clicking on the object and using the keys 'Page Down (pg dn)' and 'Page Up (pg up)'. To rotate it use 'Shift + Scroll'. To change it's angle use 'CTRL + Page Down/Page Up' or 'CTRL + Arrow keys'.
- To save your map press the save button:
- To get the object code you can use a MTA converter:
Delux GTA Map Converter v2 (2015)
Delux GTA Map Converter v2:
- Instead of IPL file format choose PAWN Code for SA-MP. Search your map inside your MTA folder; it is usually inside modsdeathmatchresources.
- Copy your code.
Creating Objects:
After having the code of the object(s), you must add it inside the public OnGameModeInit or OnFilterScriptInit.
Example code:

But SA-MP has an object limit of 1000 objects. If you want to optimize your script or you want to add more objects you should use the plugin Streamer.
Streamer installation:
- Dowload it from the streamer plugin thread.
- After downloading it, paste the file 'streamer.so' or 'streamer.dll' inside the plugins folder (or just paste the plugins folder, the download one, inside your server folder).
- Copy the include 'streamer.inc' inside your pawno includes folder.
- Edit the file 'server.cfg' inside your server folder and add this line if you are using Windows:

If you are using Linux add:

- Copy this code down all the includes (include example: #include ), inside every script that uses streamer:

* Note: This code is based on the Streamer plugin update from 2015 (v2.7.4).
- After doing this edit the object code you have. Instead of using 'CreateObject' use 'CreateDynamicObject'.
Example:
Instead of using a normal code...

Samp Servers English

Use this:

* Note: You can edit your 'CreateObject' code faster by using a '.txt' file. Paste the code inside of it; press 'CTRL + R', search 'CreateObject' and replace it with 'CreateDynamicObject' (use this if your map is very big).
- After doing this open the PWN file where you want to add the objects (usually inside the gamemode) and paste your code.
Example code:

Samp Rp Servers

Additional information about Streamer plugin.
START PRACTICING:
Now you know this, you can practice by editing other scripts or you can try creating your own script.
A good way of starting is editing other gamemodes!
If there is any mistake in this guide or something should be added, just post it.
* Note: this is an small guide compared to all the basic information of SA-MP that a new scripter should know; this guide will be updated according to post suggestions on this thread.
Guide credits: Ygzeb (David Talledo)