[Tutorial Windows ] Pawn - Limbajul de programare al jocurilor.

[Dexter. @ GOV.RO]

L E A G U E C S

R O M Â N I A

___

T U T O R I A L

P A W N

____________

Pawn este un limbaj de programare folosit pentru a crea scripturi pentru jocuri precum Counter-Strike 1.6 sau alte jocuri care rulează pe AMX Mod X sau SourceMod. Începem prin a învăța sintaxa de bază, cum ar fi variabile, funcții, condiții, și bucle. De exemplu:

Pasul 1: Crearea unui fișier script

• Creează un fișier .sma pe care îl vei folosi pentru a scrie scriptul tău.

Pasul 2: Scriptul de bază

• Iată un exemplu simplu de script care afișează un mesaj atunci când jucătorul se alătură serverului:

#include <amxmodx>
#include <fakemeta>

public plugin_init()
{
    register_plugin("Exemplu Plugin", "1.0", "Autor");

    // Când un jucător intră pe server, se va apela această funcție
    register_event("player_connect", "onPlayerConnect", "b");
}

public onPlayerConnect(id)
{
    client_print(id, print_chat, "Bine ai venit pe server!");
}

În secțiunea client_print, se poate utiliza orice mesaj considerați dumnevoastră util.

Pasul 3: Compilarea scriptului

• Pentru a transforma scriptul într-un plugin funcțional, trebuie să-l compilezi folosind AMX Mod X Compiler. După compilare, vei obține un fișier .amxx pe care îl vei încărca pe serverul tău.

Pasul 4: Testarea

• După ce ai încărcat pluginul, intră pe server și verifică dacă mesajul este afișat când un jucător se alătură serverului.

Includerea fișierelor de header (precum #include <amxmodx> și #include <fakemeta>) este esențială pentru a utiliza funcțiile și constantelor definite în acele biblioteci. În programarea cu Pawn pentru AMX Mod X, fișierele de header sunt folosite pentru a adăuga funcționalități suplimentare, iar aceste funcționalități sunt esențiale pentru interacțiunea cu serverul de joc și pentru dezvoltarea de pluginuri.

1. #include <amxmodx>

• Acest fișier include funcțiile și constantele de bază necesare pentru a crea și rula pluginuri pentru AMX Mod X. Fără acest fișier, funcțiile fundamentale cum ar fi register_plugin, client_print, și altele nu vor fi recunoscute de compilator, deoarece aceste funcții sunt definite în bibliotecă și nu fac parte din sintaxa de bază a limbajului Pawn.
• register_plugin(): Permite înregistrarea pluginului, astfel încât AMX Mod X să știe ce pluginuri să încarce.
• client_print(): Permite trimiterea unui mesaj către un jucător. Este o funcție fundamentală pentru interacțiunea cu utilizatorii.
• Constante și variabile predefinite: AmxModX furnizează constante care sunt utilizate în multe funcții, de exemplu, pentru tipul de mesaj (ca print_chat).

2. #include <fakemeta>

• Aceasta este o bibliotecă suplimentară care oferă funcții avansate pentru manipularea interacțiunii cu serverul de joc, jucătorii și evenimentele de pe server. De obicei, FakeMeta este folosită pentru a oferi funcționalități de nivel înalt și pentru a înregistra evenimente care nu sunt suportate nativ de AMX Mod X.
• Evenimente și manipularea jucătorilor: Unele evenimente, cum ar fi player_connect, sunt gestionate prin FakeMeta, ceea ce permite o mai bună personalizare a interacțiunii cu jucătorii. Chiar dacă AMX Mod X poate avea un set de evenimente predefinite, FakeMeta extinde aceleași funcționalități.

De ce sunt necesare aceste include-uri:

• Definirea funcțiilor: Fără includerea acestor fișiere, compilatorul nu va ști ce sunt funcțiile ca register_plugin() și client_print(), iar va arunca erori de tipul "undefined symbol".
• Acces la funcționalități avansate: Atât AMX Mod X cât și FakeMeta adaugă funcții ce nu sunt disponibile în limbajul de bază Pawn. De exemplu, manipularea evenimentelor sau interacțiunea directă cu serverul necesită aceste biblioteci.
• Modularitate: Aceste fișiere ajută la organizarea și reutilizarea funcționalităților deja existente în cadrul comunității de dezvoltatori AMX Mod X.
• În concluzie, includerea acestor fișiere este esențială pentru a putea utiliza funcții predefinite, optimizări și librării externe care îți permit să creezi pluginuri complexe și să interacționezi cu serverul de joc la un nivel mai avansat.

În cadrul unui tutorial, alegerea limbajului de programare Pawn poate fi justificată pe baza mai multor factori care țin de caracteristicile și avantajele acestuia. Iată câteva motive posibile pentru care ai putea alege Pawn:

• Simplitatea și ușurința în învățare: Pawn este un limbaj de programare relativ simplu, ceea ce îl face accesibil pentru începători. Sintaxa sa este similară cu limbaje mai populare, precum C, dar cu o complexitate mai mică, ceea ce face mai ușor pentru utilizatori să înțeleagă conceptele de bază.
• Performanță: Deși este un limbaj interpretat, Pawn poate fi eficient din punct de vedere al performanței în anumite aplicații, în special în dezvoltarea de scripturi pentru jocuri, precum SA-MP (San Andreas Multiplayer), care folosește acest limbaj.
• Ușor de integrat cu alte sisteme: Pawn permite integrarea rapidă cu aplicații externe și cu sisteme de bază, ceea ce îl face un limbaj ideal pentru proiecte de scriptare sau automatizare.
• Popularitate în comunități specifice: Pawn este larg utilizat în anumite comunități de dezvoltatori, mai ales în domenii cum ar fi modificările de jocuri (de exemplu, serverele multiplayer de la GTA San Andreas). Astfel, alegerea acestui limbaj poate fi o alegere strategică dacă tutorialul vizează o anumită nișă de utilizatori pasionați de personalizarea jocurilor.
• Documentație și resurse disponibile: Există multe resurse și comunități online care sprijină dezvoltatorii care lucrează cu Pawn, facilitând accesul la tutoriale și exemple.

 

Cu următoarea ocazie, o să mai învățăm ceva tot despre pawn, rugămintea mea dacă sunteți doritori să învățați, după modelul pe care vi l-am prezentat, realizați un plugin de tip 'welcome-info' cu un alt mesaj și încărcați-l pe server.

Încărcarea se face în felul următor;

1. Se compilează pluginul .sma și acesta o să devină .amxx

2. În fișierele /plugins se adaugă fișierul .amxx

Se caută calea addons/amxmodx/configs/plugins.ini   și se adaugă linia următoare;

pawn.amxx (unde pawn - este numele fișierului pe care l-ați compilat), iar după aceea efectuăm un restart la server și pluginul nostru o să fie funcțional.