PAWN egy script nyelv, amelyet nem csak SA:MP-ben használnak, és a Source-Engine alapú játékokban is elfutathat.
Az SA:MP környezetben a PAWN a legelterjedtebb, ezért létezik a SAMP-API is.
Ez a cikk a SAMP-API alapjait mutatja be, és a legfrissebb szervercsomaggal kezdjük.
A SAMP szerver csomag és főbb mappák
Az oldalról a legújabb SAMP 0.3z Windows Server csomag elérhető.
A csomag hét mappát és hat fájlt tartalmaz, és a Server.cfg a legfontosabb.
A Filterscripts mappa a PAWN scriptek számára szolgál, a Gamemodes mappában tárolódnak a scriptek.
Includes - innen kerülnek be az include fájlok, NPCModes - botokra szükséges, Pawno - a PAWN IDE és a compiler, Plugins - külső pluginek.
A PAWNO az IDE, amelyben a Gamemodes-okat készítjük, és a szerver csomagban ez van előre.
Az IDE-ben a „STRG+N” megnyomásával nyílik meg az üres GAMEMODE, amit azután szerkesztünk.
A PAWN alapfogalmai és a szintaxis
Funkciók - más néven native-ek - alkotják a Gamemode alapját, ezek a szerver által végrehajtott parancsok.
Callbackek jelentik, ha egy esemény történik, például OnPlayerSpawn vagy OnPlayerConnect.
Paraméterek adják meg, mit vár a függvény, és hogy mit adjon vissza - például GetVehiclePos vagy GetPlayerPos.
Integer, Float, String és Boolean a leggyakoribb típusok; a Float például a pozíciókhoz, a String pedig nevekhez használható.
Operátorokkal és if-else szerkezetekkel dolgozunk, hogy feltételeket írjunk le, például összehasonlításokat és elágazásokat.
Az if-else-if szerkezetek segítenek több feltétel kezelésében a kód logikájában.
Paraméterek és típusok példákkal
A GetVehiclePos(vehicleid, Float:x, Float:y, Float:z) példában a paraméterek típusa és a sorrend fontos.
Integer: egyszerű egész szám, a Float: lebegőpontos számok, String: karakterláncok, Boolean: igaz vagy hamis.
Első parancsok és parancsfeldolgozás
Az OCMD parancsokat gyakran használjuk, és szükség van egy Include-ra, például az ocmd-re, hogy a parancsokat könnyen kezeljük.
Az alapstruktúra:
ocmd:Command(playerid,params[]){ // Stuff }
A parancs célja, hogy a játékosnak életerőt adjon a SetPlayerHealth native hívásával, például: SetPlayerHealth(playerid,100.0);
A paramétereknél vesszővel kell elválasztani a változókat, és pontosvesszőzni kell a végén.
Return 1 adja vissza a parancsot a szervernek, jelezve, hogy a script végzett a parancs végrehajtásával.
A parancs teszteléséhez a kódot le kell fordítani (Compile) és a gamemod-ot a server.cfg-ben be kell állítani.
Dinamikus parancsok és sscanf2
Dinamizmust adnak a parancsoknak az értékek variálhatósága érdekében, például autó spawnolásnál a modell, szín és hely koordináták megadása.
A sscanf2 segít a felhasználói input feldolgozásában, ellenőrizve a megadott paraméterek típusa és mennyisége szerint.
Ha hiányzik egy paraméter, a SendClientMessage-jel értesítjük a játékost, hogy hogyan használja a parancsot.
Változók deklarálása és típusok kezelése
new vID,f1,f2;float x,y,z; a változók deklarálása és a típusok meghatározása mindennapos feladat.
GetPlayerPos(playerid, x, y, z) lekéri a játékos pozícióját, amelyet a CreateVehicle-nak adunk meg.
Autó spawnolása dinamikusan
pixel pontosan a koordinátákon történő autóspawnoláshoz szükség van a modell azonosítójára, a színekre és a spawn-pozícióra.
CreateVehicle(vID, x, y, z, 0, f1, f2, -1) hívással hozzuk létre az autót, majd PutPlayerInVehicle(playerid, car, 0) a játékost a járműbe ülteti.
További hasznos megfigyelések PAWN-ról és SA-MP-ről
PAWN a SA-MP környezetben elterjedten használatos, és lehetőséget ad a játékosok adatbázisokkal való dolgozására - SQLite és MySQL támogatott.
A PAWN nyelv egyszerű, gyakorlatias C-szerű szintaxissal rendelkezik, amely gyorsan tanulható a kezdők számára.
Végül a PAWN kódok tipikus problémáinak megoldásában a tutorialok és a fórumok hasznos források lehetnek, és a szkriptelés folyamatos frissítésre szorul.

Az SA-MP szerver konfigurálását és a PAWN nyelv alapjainak elsajátítását összefogó útmutatók segítenek abban, hogyan lehet egy alap Gamemode-ot gyorsan összerakni és tesztelni a szerveren.
Remek kiindulópont a saját scriptelésbe, hogy megértsük a SA-MP fejlesztői környezetét és a PAWN nyelv sajátosságait.