Temat: [Lua] Od zera do skryptera, czyli LUA: PODSTAWY i Actions*

Witam, postanowiłem napisać poradnik tak, by ułatwić wszystkim zrozumienie LUA.

LUA jest językiem skryptowym powstałym po to, by ułatwić pracę na OTS. Zamiast grzebać w C++ można grzebać w LUA co znaaaacznie przyspiesza i ułatwia całą robotę :)

Do rzeczy!
Na OTS jest kilka rodzajów 'zdarzeń':
To chyba na tyle.

Najłatwiej będzie na początek zrobić coś w actions.
W folderze tym jest plik actions.xml

No ok, stwórzmy pierwszy skrypt. Niech to będzie dźwignia. Załóżmy, że gdy ją pociągniemy, otrzymamy jabłko.

Wobec tego otwieramy actions.xml prawym przyciskiem myszki i 'edit with notepad++'.

http://sourceforge.net/projects/notepad-plus/

Aby dodać swój skrypt wystarczy linijka:

itemid określa id, co widać w cudzysłowiu. event nie zmieniamy a w value mamy ścieżkę do danego skryptu. Prościutkie.

No ale chwila. Załóżmy, że mamy dwie dźwignie na OTS. Jak rózróżnić wówczas, o którą nam chodzi?

Action ID jest czymś w rodzaju zmiennej, którą może posiadać KAŻDY item na OTS. Możesz jej ustalić 0, 100, 15123, ile chcesz.

Gdy damy dźwigni action ID np. 2566 będzie to wyglądać wówczas tak:

No ok, jeśli nasza dźwignia ma taki action id już w edytorze map, dodaliśmy tę linijkę (musi być dodana powyżej '</actions>'), to czas na skrypt.

Wchodzimy do foldera 'scripts' i tworzymy nowy plik tekstowy. Zmieniamy nazwę i wpisujemy 'skrypt.lua'.
Uwaga! Musisz mieć ustawioną możliwość widzenia rozszerzenia pliku, tzn. dla skryptow .lua, dla dokumentów tekstowych .txt, inaczej skrypt ci się nie załaduje, bo będzie txt!

Ok, prawym na nasz skrypt i edit with notepad++.

Cóż, na razie jest pusty :) No bo jaki ma być? Czas go zapełnić.

Po pierwsze: Musimy go zabezpieczyć, jeśli by nam odbiło i pomyłkowo dalibyśmy innemu itemowi ten sam action ID. Załóżmy miecz jakiś by był z tym samym action id i gracz, który dawałby na niego 'use' dostawałby jabłko o.O. No ale to zaraz.

Wszystkie skrypty actions skupiają się w środku funkcji onUse:

To, co widzisz w nawiasie to parametry funkcji, tzn. dane, którymi możemy operować.
- cid oznacza gracza, który tę funkcję wywołuje, najprościej mówiąc CID = ja.
- item to najprościej ujmując przedmiot, którego dotyczy cała akcja. W tym przypadku dźwignia.
- fromPosition - pozycja w postaci tablicy, z której dano use
- itemEx - w przypadku np. kilofu (pick), gdzie use zamiast na niego, dajemy np. na ziemię, wykorzystując owy kilof.
- toPosition - pozycja w postaci tablicy, miejsca docelowego, na które dano use

No ok, to chyba było banalne na razie. Zatem teraz pora na owe zabezpieczenie. Musimy przekazać OTSowi, że nam w tym przypadku chodzi tylko i wyłącznie o dźwignię. Odrzuci to wszystkie inne przedmioty i weźmie tylko pod uwagę dźwignie, które będą miały action id 2566.

Mamy już najprostszy skrypt, co prawda nic nie robi, ale mamy :) Każdy IF musi mieć jeden end dla siebie, funkcja również, co widać. znaczek 'równa się', czyli '=' jest napisany podwójnie, to nie błąd, podwójne równa się oznacza przyrównywanie, pojedyncze oznacza nadpisanie wartości.

X == Y <- sprawdza, czy X jest równy Y
X = Y < - nadpisuje X wartością Y

No dobra, teraz wprowadźmy coś do środka. ID jabłka to 2674.
Funkcja dająca item... to doPlayerGiveItem(uid, item, count)

Ok, teraz znowu widzimy nawias a w nim parametry. uid to id gracza, czyli wpiszemy... cid :), item to jabłko, czyli 2674 a count to ilość, dajmy 1: doPlayerGiveItem(cid, 2674, 1)

Wyjaśnię to najprościej z możliwych: jeśli pociągniesz za dźwignię z action id 2566, ots zauważy to i otworzy nasz skrypt, dalej jest filtrowanie, JEŚLI ID PRZEDMIOTU TO 1945, daj graczowi jabłko.

Zapisujemy, wchodzimy na OTS, idziemy do naszej dźwigni i pociągamy :)

if oznacza jeżeli, ale istnieją też inne operatory:

To są podstawowe, o innych może napiszę :)

Ok, przeróbmy nasz skrypt tak, by sprawdzał lvl gracza.

Od razu zaznaczam, że wszystko, co jest napisane po -- jest komentarzem i nie jest brane pod uwagę przez nasz OTS.

Myślę, że ten skrypt jest zrozumiały.

Przedstawię teraz zmienne i powiem mniej więcej, po co są.

Po co jest zmienna? Przykładowo mamy skrypt, w którym jest dwadzieścia miejsc, w których musimy podać np. id naszego jabłuszka :) Zamiast podawać 20x 2674 możemy wyżej dać i wszędzie zamiast 2674 wpisac po prostu... jablko :) Jakież to banalne.

No ok, ale teraz co, gdy mamy więcej warunków, nie tylko level 20 i każdy inny przypadek?

Z pomocą przychodzi else if :)

Mam nadzieję, że to nie było trudne.

To są podstawy podstaw LUA

Jak ktoś chce WSZYSTKIE funkcje LUA to polecam np.
http://forum..pl/showthread.php?t=504
http://otland.net/f55/lua-functions-list-14039/

W następnym poradniku opiszę MOVEMENTS

Kiedyś też tak myślałem ^^ Pouczę się jeszcze lua i też napiszę artykuł o lua :P Ale opiszę takie funkcję, o których istnieniu 90% z was nigdy nie słyszała :P

Ja? Gdzie?

Ty. Tu.
Wszystkie funkcje lua powiadasz? Zabrzmiało to tak, że wykuję na pamięć funkcję do otsa i będę master z lua ;]
A słyszałeś o takiej funkcji unpack? :)

Przecież to oczywiste, że ja tu piszę pod kątem OTSa. Kogo tu interesuje LUA, który jest językiem skryptowym całkiem innych aplikacji?

A LUA używam również we własnym programie, który piszę.

Lua ma wiele zastosowań, niekoniecznie OTS, chociaż jest tu popularnym językiem interpretowanym.

Nie chce mi się sprawdzać, ale pewnie coś związanego z formatowaniem strumieni bajtów?

Dodam od siebie, że w celu nauczenia się składni czystego języka Lua, polecam stronę http://lua.org/ - znajdują się tam funkcje biblioteki standardowej (którą Pimpek tak szpanuje), parę (dość skomplikowanych niestety) przykładów instrukcji manipulujących wykonywaniem kodu (oprócz ifów jest sporo więcej), oraz wszelkie informacje potrzebne, aby osadzić skrypty *.lua w swoim programie napisanym w C / C++ (popularnie zwie się to API).

Lua to dość prymitywny, proceduralny (to małe kłamstwo - czytajcie dalej :P) aczkolwiek całkowicie wystarczający do pracy z OpenTibią język skryptowy. Został wybrany ze względu na swoją lekkość i zadowalającą szybkość. Warto jednak zauważyć, że jest dość specyficzny - umożliwiający programowanie strukturalne, lecz robiący to w stylu bodajże (nie pamiętam dokładnie, proszę mnie poprawić jak coś) Smalltalka - z użyciem metatablic. Świetnym skrypterem Lua jest Jiddo - ten od starego już NPC systemu. Myślę, że jeżeli interesuje Cię ta tematyka i masz już dość dobrze opanowane podstawy, warto poczytać kod tego systemu, aby dowiedzieć się więcej na temat skomplikowanego tematu, jakim jest programowanie strukturalne w języku Lua. Przyda się to w pisaniu kodu w stylu DRY (nie powtarzaj sie).

PS Zostawiam ten temat, chociaż osobiście skłaniałbym się do poradnika Tairensa pod względem przydatności - niemniej jednak - doskonała robota. Dlatego też niech zostaną oba :).

Pozdrawiam
Killavus