Mudprogi

Triggery (use_prog) Ifchecki (operatory) Komendy (kolory) Formatki (odmiana zamków, zmienne specjalne) Dość zaawansowany przykład questa

Ostatnia modyfikacja: 11.02.2010 - dodany ifcheck otypeeqbychar

Składnia

Program składa się z dwóch części - warunku wyzwolenia (triggera) i treści. Trigger określa, w jakiej sytuacji (fight, death itp.) ma być sprawdzany warunek i jednocześnie podaje treść tego warunku (konkretne słowa, procentową szansę itp.) Spis dostępnych triggerów znaduje się poniżej.

Treść proga, czyli to, co ma się wykonać jeśli warunek zostanie spełniony, może zawierać ifchecki - czyli dodatkowe warunki rozróżniające jakieś cechy gracza, moba czy elementy losowe, mpkomendy - czyli specjalne komendy dostępne tylko w progach (np. odpowiedniki komend immoskich), oraz zwykłe komendy i sociale.

Bardzo przydatnym narzędziem przy pisaniu bardziej skomplikowanych progów są zmienne, do ustawienia na mobie, graczu i/lub globalnie.

Triggery

Tak oznaczone są nazwy progów, kursywą argumenty tekstowe, grubszą czcionką liczby oznaczające szansę wyjścia progu (0-100%), takim kolorem inne liczby. Pola opcjonalne są w [nawiasach].
Litery MOR oznaczają, że trigger może być stosowany u mobów (M), na obiektach (O), lub w lokacjach (R).

Dodatkowo istnieje sub_prog, który tak naprawdę nie jest triggerem, ale tylko informacją, że tu znajduje się podprogram. Jest też timer_prog - wywoływany komendą mptimerprog z możliwością ustawienia opóźnienia na wykonanie.
Argumentem dla obu jest nazwa podprogramu.

Kiedy jest sprawdzany use_prog:

Ifchecki

Ifchecki to dodatkowe warunki pozwalające na rozgałęzianie proga. Ogólna składnia takiego warunku to:

if nazwa_ifchecka(argumentL) operator argumentR
...treść...
else
...treść...
endif

Zamiast if można też używać jego "zaprzeczenia" ifnot. Sekcja else może być całkowicie pominięta, jeśli nie przewiduje się tam żadnych poleceń.
If-y mogą być zagnieżdżone (dostajemy wtedy iloczyn logiczny AND). Sumę logiczną OR można uzyskać, umieszczając zaraz pod linijką z if linię:
or nazwa_ifchecka(argumentL) operator argumentR
Linii takich może być wiele, można też używać ornot. Dla or-ów nie trzeba dostawiać dodatkowych endif-ów.

ArgumentL to najczęściej jedna ze zmiennych ("dolarów") wskazujących na osobę czy przedmiot. Nieliczne ifchecki nie wymagają tego argumentu, można tam wtedy wstawić 0.

ArgumentR to liczba, zmienna, lub ciąg znaków, z którym ma być dokonane porównanie. Część ifchecków nie wymaga tego argumentu, pomija się wtedy i jego, i operator.

Operator określa jak ma wyglądać porównanie.

• Dla liczb mogą to być standardowe matematyczne relacje:
• == lub = (równy),
• = lub <> (różny),
• > (większy),
• >= (większy lub równy),
• < (mniejszy),
• <= (mniejszy lub równy),
• oraz operatory binarne, przydatne przy działaniach na bitwektorach:|  i & (suma i iloczyn wartości ifchecka i argumentR),
• dla ciągów znaków mogą to być:
• == lub = (identyczne ciągi),
• / (argumentR zawiera się w wyniku ifchecka),
• | (argumentR jest początkiem wyniku ifchecka),
• \ (argumentR jest końcówką wyniku ifchecka),
• oraz ich zaprzeczenia: != lub <>, !/, !|, !\.

Spis ifchecków jest poniżej. Nazwy tych, które działają na pewno (są przykłady na mudzie albo sama ich używałam) są takie, argumenty tekstowe są oznaczone kursywą, liczbowe grubszą czcionką, przy czym vnumy są wyróżnione kolorem. PC/NPC oznacza konieczność wstawienia odpowiedniego "dolara".

Komendy

Komendy przeznaczone do użycia w progach. Działające na pewno są oznaczone na biało, argumenty liczbowe są pogrubione, vnumy podkreślone kolorem, argumenty tekstowe pisane kursywą, argumenty opcjonalne w nawiasach. Jeśli jest wybór spomiędzy kilku określonych opcji argumentu oznaczone jest to np. tak: tak/nie, (w liście argumentów) lub tak (w opisie).

Kolory do echa (wystarczy podać tyle liter, ile trzeba by mieć jednoznacznie określony kolor):

• _whi White
• _yel Yellow
• _blu Blue
• _dbl Dark Blue
• _lbl Light Blue
• _cya Cyan
• _gre Green
• _dgr Dark Green
• _cha Charcoal
• _dch Dark Charcoal
• _pur Purple
• _red Red
• _ora Orange
• _bro Brown
• _pin Pink
• _bla Black

Formatki

Formatki to swego rodzaju zmienne oznaczające postacie lub obiekty występujące w programie.
Postać triggerująca to postać, która wykonała akcję wyzwalającą trigger, drugi aktor to postać występująca w kontekście, np. Monck daje miecz GraveirowiMonck triggeruje, Graveir jest drugim aktorem. Podobnie jest z obiektami, np. Thorgil wkłada fiolkę do plecakaThorgil triggeruje, fiolka jest pierwszym obiektem, plecak drugim.

Odmiana przypadków:

Zmienne specjalne:

• Do użycia w speech, whisper i tell progach, triggerowanych na _all_: #text, np.: mpvset $i napis "$fv(#text)"
• Zmienna przechowująca ostatnio wylosowaną liczbę (przez rand lub mprand): #lastrand, np.: mpvset $i wynik $fv(#lastrand)
• Liczbowe dostępne dla graczy i mobów: #level, #hp, #max_hp, #mana, #max_mana, #move, #max_move, #gold, #money0, #money1, #money2, #exp, #carry_weight, #carry_number, #speaking, #alignment, #position, #height, #weight, #wimpy, #mental_state, #sv_poison, #sv_wand, #sv_para, #sv_breath, #sv_spell, #ac, #hitroll, #damroll, #str, #int, #wis, #dex, #con, #cha, #lck, #perm_str, #perm_int, #perm_wis, #perm_dex, #perm_con, #perm_cha, #perm_lck, #age, #trust, #cur_room
• Liczbowe dostępne tylko dla graczy: #pkills, #pdeaths, #mkills, #mdeaths, #illegal_pk, #qp, #all_qp, #clan_lev, #sir, #sir_deserved, #sir_paid, #favor, #drunk, #full, #thirst, #blood, #pkt
• Tekstowe dostępne tylko dla graczy: #clan, #deity