Multi Theft Auto Deathmatch Scripting Tutorial I – teleporty & markery

Witamy w pierwszej odsłonie poradnika, który ma na celu zaznajomić Was z naszym silnikiem skryptowym. Nasze rady pomogą nauczyć Cię pisać w języku LUA używając różnych naszych funkcji. Krok po kroku będziemy analizować małe fragmenty kodu wyjaśniając wszystko. Będziemy również załączać materiały dodatkowe, w postaci krótkich filmów instruktażowych oraz zrzutów ekranu.

Własne teleporty

Napiszemy skrypt, który pozwoli ustawiać i zapamiętywać własne punkty teleportacyjne, dla każdego z graczy osobno. Dokładniej pozwolimy graczom tworzyć punkty docelowe, oraz punkty startowe. Gracze będą mogli przemieszczać się między nimi tzw. portale.

Dodawanie skryptu do gry oraz uruchamianie go

Skrypty w MTA całkowicie opierają się na tzw. zdarzeniach. Zdarzenia są dynamiczne, zmienne. Możemy wprowadzać oraz tworzyć własne zdarzenia, ale w tym przykładzie posłużymy się wbudowanymi funkcjami, których MTA ma około czterdziestu. Zdarzenia są wykonywane podczas całej gry. Gdy jemy lecząc się, to jest zdarzenie Każde zdarzenie składa się z funkcji powiązanych między sobą (odwołując się do funkcji addEventHandler).

Stworzymy pierwszą własną funkcją Script_onResourceLoad, która automatycznie załaduje się, gdy serwer będzie się odwoływać do danych, które znajdują się na mapie używając zdarzenia onResourceLoad. W dalszej części pokażemy, jak to ładowania danych przebiega.

Potem utworzymy globalne zdarzenie, które będzie włączało lub wyłączało nasz skrypt. Odwołamy się do funkcji bindKey żeby przypisać klawiszowi „I” funkcję „modeIO„, którą również utworzymy.

Oczywiście, funkcja powinna być dostępna dla wszystkich graczy, więc trzeba utworzyć pętlę dla…-wykonaj…, z języka programowania pętlą for-loop;:

Zauważcie, że funkcja kończy się słówkiem end z angielska koniec;.

Ale o czymś zapomnieliśmy. Powyższa funkcja przypisze klawisz „I” tylko raz dla obecnych graczy. Co zrobić z dopiero co dołączonymi? Możemy użyć zdarzenia onPlayerJoin, które zwraca wszystkich graczy, którzy się dołączają do gry:

Pamiętajmy, że oryginalne funkcje klawiszy nadal będą aktywne! Nie wolno nam przypisać tej funkcji do lewego przycisku myszy. Po co stawiać teleport, gdy się strzela?

Funkcja modeIO

Ustawianie punktu docelowego może być trudne do zrobienia za pomocą klawiatury. Właściwie POTRZEBUJEMY kursora myszy, by to zrobić. Na szczęście, MTA ma kilka wbudowanych funkcji przeznaczonych do pracy z myszą, włączając showCursor (pokaż kursor), którą zastosujemy. Najpierw jednak napiszmy funkcję ‘modeIO’, o której było wcześniej.

Teraz, gdy mamy większość pracy za sobą, przypiszemy każdą funkcję klawiszom myszy (gdy kursor będzie widoczny). MTA posiada wbudowane zdarzenie onPlayerClick które pozwala uzyskać dokładne współrzędne miejsca położenia kursora w momencie kliknięcia.

Napiszmy więc główną funkcję Script_onPlayerClick, którą przypiszemy do zdarzenia onPlayerClick podczas gdy kursor jest widoczny:

Tworzenie markera

Zanim to zrobimy musisz zrozumieć jak działa hierarchia wydarzeń w grze (podobnie jak w innych, podobnie zbudowanych, grach). MTA używa elementów do wszystkiego: pól, obiektów, pojazdów, graczy itd. To są elementy gry. To dobrze, bo można łatwo je powiązać I używać i nie trzeba sprawdzać typu obiektu, który zostanie „oskryptowany”. Na przykład: Jeżeli chcesz usunąć albo ustawić pozycję pola, pojazdu lub obiektu, po prostu odwołujesz się do destroyElement albo setElementPosition.

My chcemy stworzyć tylko dwa pola (oddzielne dla każdego gracza, własne): „pole początkowe” i „docelowe”. Skrypt będzie prosty, ale o ogromnej funkcjonalności. Dla każdego id gracza będziemy przechowywać dwa pola, używając setElementData.

Jeżeli gracz naciśnie lewy przycisk (I będzie widoczny kursor), stworzymy miejsce „startu”, które będzie naszym portalem. Jeżeli gracz naciśnie prawy przycisk, stworzymy pole „docelowe”.

Użyliśmy setElementData żeby zapisać dane każdego pola. W dalszej części pokażemy jak łatwo się do tych danych odwołać.

setElementData oraz jej bliźniacza funkcja pobierająca dane getElementData pracują na elementach. Przypisują każdy typ danych danemu elementowi (graczowi, pojazdowi). Można te dane zmieniać używając setElementData oraz odwoływać się do nich przez getElementData.

Musimy też stworzyć możliwość stawiania teleportów wszędzie, gdzie gracz chce.

Teleportacja

Wszystkie pola są już oskryptowane. Czas wykryć kiedy gracz wejdzie w obszar danego pola możemy użyć wbudowanego zdarzenia onMarkerHit. Zwróci pole, które jest wywoływane:

Teraz posłużymy się danymi uzyskanymi przez wcześniej napisaną funkcję Script_onPlayerClick Sprawdzimy, jaki to typ pola (startowe, czy docelowe). Gdy gracz znajdzie się w obrębie danego pola:

Czyszczenie niepotrzebnych danych po procesie teleportacji

Należy pamiętać o usunięciu wszystkich danych, jeżeli gracz opuści serwer. Wcześniej używaliśmy zdarzenia onPlayerJoin żeby wykryć, czy gracz dołączył się od gry. Jest również wbudowanie zdarzenie o przeciwnym zadaniu: onPlayerQuit: