- Dokumentacja
- Zdarzenia serwera
Zdarzenia serwera
Zdarzenia wywoływane na serwerze. Podpinasz je przez addEventHandler w skrypcie serwera.
Bronie 2
onGracz oddał strzał z broni palnej. Przychodzi raz na każdy pocisk, z punktem, z którego padł strzał, i punktem, w który trafił (ściana, ziemia, postać albo koniec zasięgu). Gra zgłasza strzały tylko wtedy, gdy któryś zasób nasłuchuje tego zdarzenia, więc bez nasłuchu nic nie kosztuje.Player Weapon Fire onBroń skryptowa (Weapon Fire createWeapon) oddała strzał przezfireWeapon.
Czat i konsola 6
onNa czat idzie wiadomość (od gracza albo ze skryptu). Możesz ją wstrzymać.Chat Message onKtoś wpisał tekst w konsoli: gracz w konsoli gry (F8) albo administrator w konsoli serwera.Console onPojawił się komunikat debugowania (błąd, ostrzeżenie alboDebug Message outputDebugString). Przydaje się do zbierania błędów skryptów w jednym miejscu.onGracz napisał wiadomość na czacie (zwykłą alboPlayer Chat /me). Możesz ją zablokować, np. żeby wysłać własną, sformatowaną.onGracz wpisał komendę (zanim wykona jąPlayer Command addCommandHandler). Możesz ją zablokować.onGracz wysłał prywatną wiadomość do innego gracza.Player Private Message
Elementy 7
onZmieniły się dane elementu (Element Data Change setElementDataalboremoveElementData), także od klienta.onElement zaraz zostanie usunięty (jeszcze istnieje).Element Destroy onElement przeszedł do innego wymiaru.Element Dimension Change onElement przeszedł do innego wnętrza.Element Interior Change onZmienił się model elementu (np. skin gracza albo model auta).Element Model Change onGracz zaczął liczyć fizykę pojazdu albo obiektu (został jego synchronizatorem).Element Start Sync onGracz przestał liczyć fizykę elementu.Element Stop Sync
Gracze 27
onPrzychodzi zaraz poPlayer ACInfo onPlayerJoinz informacjami o modyfikacjach gry gracza. Lista wykrytych modyfikacji jest pusta, bo klient ich jeszcze nie wykrywa.onGracz zmienił nick (np.Player Change Nick setPlayerName).onSkrypt klienta próbował zmienić chroniony klucz danych elementu: klucz ustawiony przez serwer zPlayer Changes Protected Data setElementData(..., "deny")albo każdy klucz, gdyserver-config.jsonma"element_data_client_changes": "deny". Zmiana jest odrzucona, a gracz dostaje z powrotem wartość serwera.onGracz łączy się z serwerem, zanim powstanie jego element. Możesz odrzucić połączenie, np. za nick albo bana.Player Connect onZmienił się element pod stopami gracza (pojazd albo obiekt, na którym stoi).Player Contact onGracz dostał obrażenia: od broni, upadku, pojazdu albo wybuchu. Przy wybuchu granatu albo rakietyPlayer Damage attackerto gracz, który go spowodował.onGracz wszedł na serwer. Dobre miejsce na powitanie, logowanie i pierwsze odrodzenie.Player Join onPrzychodzi poPlayer Mod Info onPlayerACInfo, tylko gdy klient znalazł w katalogu gry pliki spoza gry: paczki.pak/.utoc/.ucaswContent/Paksinne niżpakchunk0ipakchunk1albo wtyczki.asi. Możesz na tej podstawie wyrzucić gracza.onGracz został wyciszony (Player Mute setPlayerMuted). Wyciszony gracz nie pisze na czacie.onPołączenie gracza się zacięło (statusPlayer Network Status 0, brak danych ponad 12 sekund) albo wróciło (1).onGracz opuścił serwer. Element gracza jeszcze istnieje, więc możesz zapisać jego dane. Powody są po polsku, np.Player Quit "rozlaczony"albo"przekroczony czas oczekiwania".onGracz wczytał grę i pierwszy raz pojawił się w świecie. To dobre miejsce na powitanie, bo gracz już widzi ekran.Player Ready onZasób wystartował u gracza (po jegoPlayer Resource Start onClientResourceStart), raz na start zasobu. Od tej chwili możesz wysyłać do niegotriggerClientEventz tego zasobu.onPrzychodzi wynikPlayer Screen Shot takePlayerScreenShot: obraz JPEG klatki gry gracza (bez nakładki skryptów) albo informacja, że się nie udało.onGracz pojawił się w świecie (pierwszy raz albo po śmierci), np. poPlayer Spawn spawnPlayer.onGracz zabija kogoś po cichu nożem od tyłu. Możesz zablokować zabójstwo; inaczej ofiara dostajePlayer Stealth Kill onPlayerWastedzstealth=true.onGracz poruszył się w sposób niemożliwy w grze (teleport albo zbyt duża prędkość). Teleporty skryptem, spawn i wejścia do wnętrz się nie liczą. Działa tylko, gdy w konfiguracji serwera jestPlayer Suspicious Move "anticheat": true. Serwer sam nic nie cofa i nikogo nie wyrzuca, o karze decyduje skrypt (automatyczne wyrzucanie po progu włącza"anticheat_kick": true).onGracz celuje w coś innego: gracza, postać, obiekt, pojazd albo w nic. Sprawdzane co 250 ms.Player Target onGracz zmienił drużynę (Player Team Change setPlayerTeam).onGracz wysyła za dużo zdarzeń i akcji (ponad 100 na sekundę). Może to być błąd skryptu klienta albo próba zalania serwera.Player Trigger Event Threshold onGracz wywołał zdarzenie, którego serwer nie zna albo które nie pozwala na wywołanie od klienta (Player Trigger Invalid Event addEvent(nazwa, true)).onGracz został odciszony.Player Unmute onGracz zaczął mówić przez czat głosowy (początek wypowiedzi). Możesz ją zablokować: wtedy nikt nie usłyszy tej wypowiedzi, aż gracz przestanie mówić.Player Voice Start onGracz skończył mówić przez czat głosowy. Zachodzi też, gdy głos gracza przestał dochodzić (np. utrata połączenia). Nie zachodzi dla wypowiedzi zablokowanej wPlayer Voice Stop onPlayerVoiceStart.onGracz zginął: od broni, w wypadku, w wybuchu albo przez skrypt.Player Wasted onZnacznik GPS gracza zniknął: zdjęty na mapie, skryptem albo gracz dojechał na miejsce.Player Waypoint Remove onGracz ma nowy znacznik GPS gry (potwierdzony przez jego grę): postawiony prawym kliknięciem na mapie ESC albo skryptem.Player Waypoint Set
Konta 3
Obiekty 4
onObiekt mapy gry został uszkodzony (np. urwany hydrant).Map Object Break onGracz ruszył obiekt mapy gry (np. hydrant albo beczkę), a nie obiekt stworzony skryptem.Map Object Move onObiekt stworzony skryptem został zniszczony w grze (np. rozbity płot). Beczka wybuchowa przy tym wybucha dla wszystkich.Object Break onObiekt wrócił na miejsce i jest naprawiony (Object Respawn respawnObject).
Ogień 3
Pickupy 5
onGracz wszedł w pickup. Możesz zablokować zebranie.Pickup Hit onPickup pojawił się ponownie po czasie odnowienia.Pickup Spawn onGracz zebrał pickup (dostał zdrowie, pancerz albo broń).Pickup Use onGracz wszedł w pickup (wersja od strony gracza).Player Pickup Hit onGracz zebrał pickup (wersja od strony gracza).Player Pickup Use
Pociski 1
Pojazdy 13
onInna nazwaPlayer Enter Vehicle onPlayerVehicleEnter: gracz wsiadł do pojazdu.onInna nazwaPlayer Exit Vehicle onPlayerVehicleExit: gracz wysiadł z pojazdu.onGracz wsiadł do pojazdu.Player Vehicle Enter onGracz wysiadł z pojazdu (sam, wyciągnięty albo skryptem).Player Vehicle Exit onPrzyczepa albo naczepa została doczepiona do pojazdu.Trailer Attach onPrzyczepa została odczepiona.Trailer Detach onPojazd stracił zdrowie (zgłasza to gra jego kierowcy albo właściciela).Vehicle Damage onKtoś wsiadł do pojazdu (wersja widziana od strony pojazdu).Vehicle Enter onKtoś wysiadł z pojazdu (wersja widziana od strony pojazdu).Vehicle Exit onPojazd wybuchł.Vehicle Explode onPojazd odrodził się (Vehicle Respawn respawnVehiclealbo automatycznie).onGracz zaczyna wsiadać do pojazdu (podchodzi do drzwi). Możesz go zatrzymać, np. przy zamkniętym aucie frakcji.Vehicle Start Enter onGracz zaczyna wysiadać (około 2 sekundy przedVehicle Start Exit onVehicleExit); przy wyciąganiujackerto wyciągający. Możesz go zatrzymać w aucie.
Postacie 6
onPostać (NPC) dostała obrażenia.Ped Damage onNPC-kierowca stoi ponad 8 s poza postojem (korek, czerwone światło, gracz zastawił drogę). Przychodzi co 8 s, dopóki auto nie ruszy.Ped Drive Blocked onNPC-kierowca dojechał do ostatniego punktu trasy (bezPed Drive Finished loop) albo do celu zsetPedDriveTo.onNPC-kierowca dojechał do punktu trasy zPed Drive Point Reached setPedDriveRoute(w promieniustopRadius).onNPC doszedł do celu zPed Reached Target setPedWalkTo(w promieniuradius). Marsz jest już zakończony, więc w obsłudze możesz od razu wysłać go dalej.onPostać (NPC) zginęła.Ped Wasted
Strefy kolizji 4
Wejście i sterowanie 2
Zasoby 6
onW czasie działania serwera pojawił się nowy folder zasobu (Resource Load State Change unloaded->loaded) albo zniknął (loaded->unloaded).onZasób zaraz wystartuje. Możesz wstrzymać start.Resource Pre Start onZasób wystartował. Podpięte doResource Start resourceRootprzychodzi tylko dla własnego zasobu, dorootdla każdego.onZasób zmienił stan:Resource State Change loaded->starting->running->stopping->loaded.onZasób się zatrzymuje. Dobre miejsce na zapis danych.Resource Stop onZmieniło się ustawienie zasobu (Setting Change setalbo panel administratora).