Podstawy pisania pluginów AMXX

[naven]

Wstep
Poradnik ten pisałem dawno temu, gdy sam umiałem tyle co zawarte w tym poradniku. Jest to poradnik dla ludzi, którzy nie znają programowania w żadnym języku. Jeśli znasz inny język, ten poradnik na mało Ci się przyda
Na początku należy ściągnąć AMXX Pro Studio, jest on w każdej paczce AMXX, można go też ściągnąć tutaj AMXX Studio
Pluginy AMXX są pisane w języku o nazwie pawn


W poradniku tym, będę opisywał rzeczy bezpośrednio w kodzie używając komentarzy. Komentarze w kodzie są bardzo przydatne szczególnie jeśli nie tworzysz dla siebie.

Komentarzy używa się w następujący sposób

zwykły kod
//komentarz jedno-liniowy
zwykły kod
/* a oto komentarz wielo-liniony
pierwsza linia komentarza
druga linia komentarza

trzecia
czwarta
*/ 

Otwierając AMXX Studio otrzymujemy taki kod:

/* Plugin generated by AMXX-Studio */

#include <amxmodx>
#include <amxmisc>

#define PLUGIN "new plugin"    //definiujemy tutaj nazwę...
#define VERSION "1.0"        //...wersję...
#define AUTHOR "author"        //... oraz autora pluginu, będą one się wyświetlać w konsoli po wpisaniu amx_plugins
                            //warto też wspomnieć, iż tekst który ma przed sobą "//" jest komentarzem- jest ignorowany przez kompilator, można to również zastąpić 2 innymi znakami: "/*"- początek komentowanego tekstu, "*/"- koniec komentarza
public plugin_init() {         //jedna z ważniejszych części pluginu, tutaj 'mówimy' kompilatorowi co będzie robił plugin.
    register_plugin(PLUGIN, VERSION, AUTHOR)
    
    // Add your code here... tutaj dodajemy dowolny kod, o tym dalej :)
} 

Jak widać wszystyko jest ustawione domyślnie, można to zmienić w ustawieniach: tools/settings/misc


Co oznacza #define?
Przykład:

#define AUTHOR "naven" 

wartość AUTHOR w cudzysłowiu(naven) będzie zastępować AUTHOR w poniższym kodzie- jako autor pluginu będzie podany naven

    register_plugin(PLUGIN, VERSION, AUTHOR) 

Funkcje
Funkcje są zawsze przypisane do jakiejś komendy lub eventa(DeathMsg itd.)
Oto przykład rejestrowania funkcji:

register_clcmd("komenda", "funkcja") 

Co jest czym
register_clcmd- client command, czyli komenda wykonywana przez klienta(gracza) np say /admin czy znany z serwerów pokemod +pokeskill
register_concmd- komenda w konsoli, np amx_kick, amx_ban itd.
Jest tego znacznie więcej, dochodzą do tego także eventy, być może opiszę je w innym poradniku.


Kiedy mam dawać cudzysłów?
Cudzysłowów używa się, gdy coś nie ma wartości string(string to wartość zmienna ale ma ograniczone wartości), lub id gracza
Przykładem jest client_print(pokazuje wiadomość graczowi):

client_print(id, print_chat, "wiadomosc w cudzyslowiu") //id oraz wartość string print_chat nie sa w cudzyslowiu, natomiast wiadomosc- nie jest string i musi go mieć 

Wartości string client_printa
print_chat - wiadomość na czacie,
print_console - wiadomość w konsoli,
print_notify - wiadomość konsoli w dev,
print_center - napis na środku ekranu.

Czym jest id?
id mówi właściwie na czym ma wykonać komendę(na jakim graczu, 0= na wszystkich)

Przykład
Powiedzmy, że chcemy, aby graczowi po wpisaniu na czacie siema wyświetlała się na czacie odpowiedź- witamy cię!

//nie potrzebujemy tutaj autora, wersji oraz co to będzie za plugin, dlatego to ignorujemy
//jednak potrzebne nam są moduły z których będziemy korzystać:
#include <amxmodx>         //to są 2 moduły podstawowe
#include <amxmisc>        //jeśli chcesz korzystać z bardziej zaawansowanych musisz dodać inne moduły

public plugin_init() {
    register_plugin("test", "1.0", "naven")         //jako że zignorowaliśmy defines, możemy zarejestrować plugin teraz
    register_clcmd("say siema", "funkcja_siema")    //rejestrujemy client command dla gracza dla funkcji funkcja_siema
    }                                                //nie zapomnij zamknąć plugin_init klamrą(to bardzo ważne, ponieważ kompilator pomyśli, że jeszcze nie skończyłeś tego)
//teraz naciskamy na magiczny przycisk public function u górze kompilatora(można pisac, ale tak szybciej;p), pojawia nam się to:
//public Function() //tutaj musi być nazwa naszej funkcji oraz id gracza(w nawiasie)- id jest pobierane z wykonaniem clcmd say siema
//{
            //tutaj będzie to, co chcemy zrobić graczowi
//}
// będzie to wyglądać następująco:
public funkcja_siema(id) //mówimy kompilatorowi, że teraz ma zająć się funkcją funkcja_siema, oraz pobieramy id
{
    client_print(id, print_chat, "Witamy cie!") //musimy podac id! to samo id, które wcześniej pobralismy, print_chat opisane wyżej, trzecim argumentem jest wiadomość wyświetlana graczowi
} 

Podam również przykład, że gdy jeden gracz coś napisze, widzą go wszyscy(plugin_init taki sam jak wyżej)

public funkcja_siema()        //nie musimy pobierać id, bo będzie to dla wszystkich graczy
{
    client_print(0, print_chat, "Witamy cie!")// w tym przypadku id to liczba 0- wiadomość ta wyświetla się wszystkim graczom
} 

Podsumowanie
jak pewnie zaważyłeś, użyłem funkcji client_print, jest wiele takich funkcji i to właśnie na tym opiera się pisanie pluginów AMXX

Wszystkie wartości string funcji znajdziesz tutaj: AMX Mod X Documentation
Wszystyko o pisaniu pluginów(po angielsku) znajdziesz tutaj: AMX Mod X Documentation

Poradnik napisany przez naven dla wiaderko.com. Zakaz kopiowania na inne fora!

[Mow mi 0 :**]

string funkcji to tu: AMXX.pl :: Nieoficjalny polski support AMX Mod X :: Dokumentacja ... sry za linka ale tu jest po PL

[powerman3]

Przyda się :)

[Kenobi]

Jest to po prostu zedytowany język C++ lub C.
Sam programuje w Delphi (troszkę lepsze jak dla mnie :P )

[szumi112]

Jak mam już kod

#include <amxmodx>

/*---------------EDIT ME------------------*/
#define ADMIN_CHECK ADMIN_KICK

static const COLOR[] = "^x04" //green
static const CONTACT[] = ""
/*----------------------------------------*/

new maxplayers
new gmsgSayText

public plugin_init() {
register_plugin("Admin Check", "1.51", "OneEyed")
maxplayers = get_maxplayers()
gmsgSayText = get_user_msgid("SayText")
register_clcmd("say", "handle_say")
register_cvar("amx_contactinfo", CONTACT, FCVAR_SERVER)
}

public handle_say(id) {
new said[192]
read_args(said,192)
if( ( containi(said, "who") != -1 && containi(said, "admin") != -1 ) || contain(said, "/admin") != -1 || contain(said, "/adm") != -1 )
set_task(0.1,"print_adminlist",id)
return PLUGIN_CONTINUE
}
//pobrano z cs-puchatek.pl
public print_adminlist(user)
{
new adminnames[33][32]
new message[256]
new contactinfo[256], contact[112]
new id, count, x, len

for(id = 1 ; id <= maxplayers ; id++)
if(is_user_connected(id))
if(get_user_flags(id) & ADMIN_CHECK)
get_user_name(id, adminnames[count++], 31)

len = format(message, 255, "%s Admini w grze: ",COLOR)
if(count > 0) {
for(x = 0 ; x < count ; x++) {
len += format(message[len], 255-len, "%s%s ", adminnames[x], x < (count-1) ? ", ":"")
if(len > 96 ) {
print_message(user, message)
len = format(message, 255, "%s ",COLOR)
}
}
print_message(user, message)
}
else {
len += format(message[len], 255-len, "Brak adminow online.")
print_message(user, message)
}

get_cvar_string("amx_contactinfo", contact, 63)
if(contact[0]) {
format(contactinfo, 111, "%s Kontakt z adminem serwera -- %s", COLOR, contact)
print_message(user, contactinfo)
}
}

print_message(id, msg[]) {
message_begin(MSG_ONE, gmsgSayText, {0,0,0}, id)
write_byte(id)
write_string(msg)
message_end()
}

to, wystarczy ten tekst wkleić zamiast tamtego ??

[naven]

Musisz skompilować od nowa i wrzucić na nowo

[wesner]

Tego mi trzeba bylo. Dzieki!!!

[assfaairzzz]

Stawiasz budynek bez fundamentów. Skąd świeżak ma wiedzieć, żę // to komentarz jedno linijkowy i skąd w ogóle ma wiedzieć co to komentarz? Niestety można go rozumieć na kilka sposobów. W tym przypadku oznacza fragment tekstu nie brany pod uwagę przez kompilator.

/*
Komentarz
wielo
linijkowy
brany pod uwage od znaku / i*
do znaku * i /
*/ 

// komentarz, który zajmuje jedną linie 

Wszystko w komentarzach jest brane jako tekst, który ma zostać pominięty oprócz */ w komentarzu wielolinijkowym.

[naven]

Pisałem to dawno temu, a że to są komentarze ująłem chyba w którymś poradniku.

[assfaairzzz]

Podstawy pisania pluginów AMXX to pierwsze do czego zajrzy świeżak :) Mimo wszystko prosiłbym o dodanie wzmianki o komentarzach.

[naven]

Dodane.

[StormRage]

Dzięki
Mam jednak pytanie / problem

/* Plugin generated by AMXX-Studio */

#include <amxmodx>
#include <amxmisc>

#define PLUGIN "Vipy"
#define VERSION "1.0"
#define AUTHOR "StormRage"


public plugin_init() {
    register_plugin(Vipy, 1.0, StormRage)
    
    // Add your code here...
}
register_clcmd("say /vips", "funkcja") 

Co mam w funkcji wpisać żeby wyświetlało listę osób z wybraną flagą ( vipowską^^ )

Oraz jakie linijki dodać czy coś aby wgrać modele, które będą tylko dla vipów?

Chcę aby tt mieli taki model
http://www.fpsbanana.com/models/1316
A CT taki
http://www.fpsbanana.com/models/1407

Proszę o odpowiedź ;)

Oraz: zrobiłem sobie /zasady , wszystko śmiga ale jak robie plik tekstowy, to tam nie zalicza spacji nawet jak robie te fajne kwadraciki <3

[peku33]

register_plugin(Vipy, 1.0, StormRage)

wszystkie stałe owijamy w "costam"
cs_set_user_model(id, "modelname"); - zmiana modelu
if(get_user_flags(id) & ADMIN_LEVEL_H) - sprawdzenie czy vip
{
}

[naven]

No i register_clcmd do inita...

[StormRage]

if(get_user_flags(id) & ADMIN_LEVEL_H) - sprawdzenie czy vip
{
}

W nawiasie mam podać, jaką flagę musi mieć osoba, a id zostawić puste/0 czy jak? &admin_level też ma być skopiowane/coś tam muszę wpisać?

[naven]

ADMIN_LEVEL_H to już flaga adminowa, jak wpiszesz 0 zamiast id gracza to nic tym nie zrobisz

[krejzoL.]

neven ja pisałem z innego poradnika nie mogę go zmienić na amxx. plik jakieś błedy mi wychodza sprawdziłbyś mi go?


Oto on to mam w programie AMXX Studia

/* Plugin generated by AMXX-Studio */

#include <amxmodx>
#include <amxmisc>

#define PLUGIN "Sterydy"
#define VERSION "1.0"
#define AUTHOR "krejzoL"


public plugin_init() {
	register_plugin(PLUGIN, VERSION, AUTHOR)
	
	register_clcmd("say /moc", "steroids"
}


public steroids(id)
{
	set_user_health(id, 200)
	
	set_user_gravity(id,0.50)
	
	client_print(id, print_chat,"Właśnie zażyłeś sterdy")

	
}

new plugin_on
new price

public plugin_init() 
{
	register_plugin(PLUGIN, VERSION, AUTHOR)
	register_clcmd("say /moc", "steroids")
	plugin_on = register_cvar("amx_tutorial_plugin", "1")
	price = register_cvar("amx_tutorial_price", "4000")
	
}

public steroids(id)
{
	 
	 
	 
	 new money = cs_get_user_money(id)
	 
	 
	 
	 
	 
	 
	 if (plugin_on == 1)
	 {
	 	set_user_health(id, 150)
		set_user_gravity(id,0.50)
		client_print(id, print_chat,"You just purchased some steroids, dude!")
		
		
		
		
		
		
		cs_set_user_money(id, money - price)
	}

}

[StormRage]

To co w ID mam wpisać? ^^^^

---------- Post dodany 14-11-2010 o godzinie 22:44 ----------

Aa a jak chce żeb yct i tt mieli inny model?

[naven]

Musisz pobrać id pętlą np.
Zamiana modeli graczy, terrorystów oraz CT

Krejzol, nie zaincludowałeś bibliotek z których korzystasz(fun i cstrike), zamykaj nawiasy, plugin_init może być tylko jeden

[krejzoL.]

A mógłbyś mi to bardziej wytłumaczyć zrobiłbyś mi dobrze i bym luknął co i jak? Po prostu porównałbym sobie