- Dokumentacja
- Gracze
Kategoria
Gracze
Wszystkie funkcje i zdarzenia Lua z kategorii Gracze, po stronie serwera i klienta.
Funkcje serwera 79
countZwraca liczbę graczy w drużynie.Players In Team forceWymusza otwarcie mapy u gracza (albo u wszystkich:Player Map root).getZwraca graczy, którzy żyją i są w świecie.Alive Players getZwraca graczy, którzy nie żyją albo jeszcze się nie odrodzili.Dead Players getZwraca nazwy składników interfejsu gry, które można chować osobno:Hud Component Names ammo,armour(alboarmor),breath,clock,health,money,weapon,wanted,area_name,vehicle_name,radio,radar,all.getZwraca konto gracza. Gdy gracz nie jest zalogowany, zwraca konto gościa.Player Account getZwraca ostatnie informacje antycheata zgłoszone przez klienta przy wejściu.Player ACInfo getZwraca poziom ryzyka gracza z ochrony przed cheatami (Trilogy Protect): tabelę z polamiPlayer ACRisk points(punkty ryzyka),violations(liczba wykrytych naruszeń) ibyRule(liczba naruszeń dla każdej reguły). Tylko do odczytu: skrypt może na tej podstawie np. powiadomić administrację, ale nie wpływa na kicki i bany ochrony.getZwraca poziom gracza zPlayer Admin Level admins.xml:"player","moderator","admin"albo"owner".getZwraca wartość ogłaszaną dla gracza (np. na liście serwerów).Player Announce Value getZwraca pancerz gracza (0-100).Player Armour getZwraca poziom rozmycia ruchu ustawiony graczowi (0-255, domyślnie 36).Player Blur Level getZwraca liczbę graczy na serwerze.Player Count getZwraca właściwość wyglądu składnika interfejsu ustawioną przezPlayer Hud Component Property setPlayerHudComponentProperty.getZwraca, ile milisekund gracz nic nie robi (nie rusza się ani nie naciska klawiszy).Player Idle Time getZwraca adres IP gracza.Player IP getZwraca język gracza wybrany w launcherze (ten sam, który klient widzi wPlayer Localization getLocalization). Przydaje się do wysyłania komunikatów każdemu w jego języku. Gracz ze starszym klientem dostaje polski.getZwraca prostokąt świata widoczny na otwartej mapie gracza.Player Map Bounding Box getZwraca krycie mapy gracza (0-255).Player Map Opacity getZwraca kolor tabliczki z nickiem nad głową gracza.Player Nametag Color getZwraca wygląd tabliczek ustawiony graczowi przezPlayer Nametag Style setPlayerNametagStyle(tabela z polamienabled,distance,showDistance,scale,color,background).getZwraca graczy, których wartość danych pod kluczem jest równa podanej.Players By Data getZwraca poziom komunikatów debugowania skryptów, które gracz widzi (0-3).Player Script Debug Level getZwraca Client ID gracza: stały identyfikator urządzenia, którego nie da się podrobić. Służy do banów i wiązania kont.Player Serial getZwraca graczy w drużynie.Players In Team getZwraca drużynę gracza.Player Team getZwraca wersję klienta gracza.Player Version getZwraca listę odbiorców głosu gracza.Player Voice Broadcast To getZwraca kanał głosowy gracza ustawiony przezPlayer Voice Channel setPlayerVoiceChannel.getZwraca listę graczy, których ten gracz nie słyszy (ustawioną przezPlayer Voice Ignore From setPlayerVoiceIgnoreFrom).getZwraca losowego gracza z serwera.Random Player giveDodaje graczowi pieniądze.Player Money isSprawdza, czy gracz jest zwolniony z wykrywania cheatów przezPlayer ACExempt setPlayerACExempt.isSprawdza, czy gracz jest wciąż na serwerze. Przydaje się w opóźnionych funkcjach.Player Connected isSprawdza, czy gracz ma widoczny celownik. Celownika gra nie pozwala schować osobno, więc jest widoczny, dopóki widoczny jest cały HUD (Player Crosshair Visible "all").isSprawdza, czy gracz trafił już do świata (po pierwszym odrodzeniu).Player In World isZwracaPlayer Loading true, dopóki gracz nie trafił pierwszy raz do świata. Po pierwszym odrodzeniu na stałefalse. W odróżnieniu odisPlayerSpawnednie wraca dotruepo śmierci.isSprawdza, czy gracz może otworzyć mapę.Player Map Enabled isSprawdza, czy mapa jest graczowi wymuszona przezPlayer Map Forced forcePlayerMap.isSprawdza, czy gracz ma teraz otwartą mapę.Player Map Visible isSprawdza, czy gracz jest wyciszony na czacie.Player Muted isSprawdza, czy gracz ma włączone radio gry w pojeździe.Player Radio Enabled isSprawdza, czy u gracza działa spowolnienie czasu: przy kole broni (Player Slow Motion Enabled "wheel"), przy akrobacjach ("stunt") albo oba ("all").isSprawdza, czy gracz jest w świecie i żyje. Po śmierci zwracaPlayer Spawned falseaż do kolejnego odrodzenia.isSprawdza, czy gracz męczy się przy bieganiu (domyślnie nie).Player Stamina Enabled redirectPrzenosi gracza na inny serwer. Bez adresu łączy go ponownie z tym samym.Player resendProsi klienta o ponowne przesłanie informacji antycheata.Player ACInfo resendProsi klienta o ponowne przesłanie listy modyfikacji gry.Player Mod Info resetPrzywraca domyślny wygląd składnika interfejsu (jedną właściwość albo wszystkie).Player Hud Component Property setWyłącza albo włącza wykrywanie cheatów dla gracza. Użyj, gdy zasób celowo daje graczowi latanie, wspomaganie celowania albo nietypowy ruch, żeby ochrona nie uznała tego za oszustwo. Administratorzy są zwolnieni automatycznie. Zwolnienie trwa do wyjścia gracza z serwera.Player ACExempt setUstawia wartość ogłaszaną dla gracza, np. punkty widoczne na liście serwerów.Player Announce Value setUstawia pancerz gracza (0-100).Player Armour setUstawia rozmycie ruchu u gracza (0-255,Player Blur Level rootdla wszystkich).setZapisuje wygląd składnika interfejsu: jedną właściwość albo całą tabelę. Właściwości:Player Hud Component Property posX,posY,size,fillColor,fillColorSecondary,textColor,alignment,drawBlackBorder,drawPercentage,blinkingTimeLimit,textOutline,textShadow,useFontTexture.setPozwala albo zabrania graczowi otwierać mapę.Player Map Enabled setZapisuje krycie mapy gracza (0-255).Player Map Opacity setUstawia pieniądze gracza. Licznik w grze pokazuje stan z serwera.Player Money setWycisza albo odcisza gracza na czacie.Player Muted setZmienia nick gracza. WywołujePlayer Name onPlayerChangeNick.setUstawia kolor tabliczki z nickiem nad głową gracza (widzą go wszyscy; ma pierwszeństwo przed kolorem zPlayer Nametag Color setPlayerNametagStyle). Ten kolor ma też nick gracza na czacie.setPokazuje albo chowa tabliczkę z nickiem gracza.Player Nametag Showing setUstawia wygląd wbudowanych tabliczek nad głowami innych graczy, które widzi ten gracz (albo wszyscy:Player Nametag Style root). Podajesz tylko pola do zmiany, reszta zostaje. Pola:enabled(bool,falsechowa wbudowane tabliczki, np. gdy zasób rysuje własne przezdxDrawText),distance(metry, 0 = bez limitu),showDistance(bool, dopisek „12 m” za nickiem),scale(0.4–4, wielkość napisu),color(kolor ztocoloralbofalse= kolor domyślny),background(kolor tła ztocoloralbofalse= bez tła). Kolor, tekst i ukrycie pojedynczego gracza (setPlayerNametagColor,setPlayerNametagText,setPlayerNametagShowing) mają pierwszeństwo przed stylem. Po ponownym wejściu na serwer ustaw styl od nowa.setZmienia tekst tabliczki z nickiem.Player Nametag Text falseprzywraca nick.setWłącza albo wyłącza radio gry w pojeździe graczowi (albo wszystkim:Player Radio Enabled root). Wyłączone daje ciszę zamiast stacji GTA, pod własne radio skryptu.setUstawia, które komunikaty debugowania skryptów gracz widzi (0 żadne, 1 błędy, 2 i ostrzeżenia, 3 wszystko).Player Script Debug Level setWłącza albo wyłącza spowolnienie czasu u gracza: przy kole broni (Player Slow Motion Enabled "wheel"), przy akrobacjach ("stunt") albo oba.setWłącza albo wyłącza zmęczenie przy bieganiu graczowi (albo wszystkim:Player Stamina Enabled root). Domyślnie wyłączone, więc postać biega bez zadyszki.setPrzypisuje gracza do drużyny.Player Team nilalbofalsewypisuje go z drużyny. WywołujeonPlayerTeamChange.setUstala, kto słyszy głos gracza: jeden element, lista elementów alboPlayer Voice Broadcast To nil(wszyscy).setUstawia kanał głosowy gracza. W trybiePlayer Voice Channel "channels"gracze z tym samym kanałem słyszą się w każdym miejscu mapy, jak przez radio, a gracze w pobliżu dalej słyszą się normalnie w 3D. W innych trybach kanał nie ma wpływu.nilalbo pusty napis usuwa gracza z kanału.setUstala, kogo gracz nie słyszy.Player Voice Ignore From setWycisza gracza na czacie głosowym albo zdejmuje wyciszenie. Głos wyciszonego gracza nie jest nikomu przesyłany. Wyciszenie ustawione tą funkcją ma pierwszeństwo przedPlayer Voice Muted mutedByDefaultz ustawień serwera.setUstawia poziom poszukiwania gracza (0-6 gwiazdek).Player Wanted Level setWłącza albo wyłącza rozmowę głosową na serwerze.Voice Enabled setZmienia jedno ustawienie rozmowy głosowej. Zmiana działa od razu u wszystkich graczy. Nazwy i zakresy są takie jak wVoice Setting getVoiceSettings; liczby spoza zakresu są przycinane (np.range500 daje 250).pushToTalkKeyto nazwa klawisza jak wbindKey("z","lalt","mouse4","f5") i jest tylko domyślnym klawiszem: gracz, który wybrał własny w menu ESC, zachowuje swój.setZmienia kilka ustawień rozmowy głosowej naraz. Pozostałe zostają bez zmian. Gdy któraś wartość jest zła, nic nie jest zmieniane.Voice Settings spawnOdradza gracza w podanym miejscu: pozycja, obrót, skin, wnętrze i wymiar.Player takeOdejmuje graczowi pieniądze.Player Money takeRobi zrzut ekranu gry gracza (JPEG, bez nakładki). Wynik przychodzi w zdarzeniuPlayer Screen Shot onPlayerScreenShot.
Funkcje klienta 2
getZwraca, jak głośno gracz teraz mówi:Player Voice Level -1gdy milczy, a gdy mówi stopień od0(cicho) do3(głośno). Przydaje się do własnych wskaźników mowy.getZwraca klawisz mówienia lokalnego gracza: jego własny z menu ESC albo, gdy go nie wybrał, domyślny klawisz serwera. Druga wartość to nazwa do pokazania na ekranie.Voice Push To Talk Key
Funkcje wspólne 19
getZwraca gracza, na którego komputerze działa skrypt. To samo daje zmiennaLocal Player localPlayer. Na serwerze zwracafalse.getSzuka gracza po nicku. Na kliencie wielkość liter nie ma znaczenia.Player From Name getZwraca pieniądze gracza. Stan trzyma serwer, licznik w grze go tylko pokazuje.Player Money getZwraca nick gracza.Player Name getZwraca tekst tabliczki z nickiem (domyślnie nick).Player Nametag Text getZwraca ping gracza w milisekundach.Player Ping getZwraca wszystkich graczy. To samo coPlayers getElementsByType("player").getZwraca poziom poszukiwania gracza (0-6 gwiazdek). Gwiazdki nadaje tylko serwer, gra sama ich nie daje.Player Wanted Level getZwraca wszystkie ustawienia rozmowy głosowej serwera jako tabelę. Klucze:Voice Settings enabled(włączona),mode("proximity"– słychać w pobliżu,"global"– wszyscy słyszą wszystkich,"channels"– w pobliżu plus kanały),range(zasięg w metrach, 3–250, domyślnie 40),minDistance(do tej odległości głos ma pełną głośność, domyślnie 2),falloff(spadek głośności z odległością:"linear","inverse","exponential"),wallDamping(tłumienie przez ściany 0–1, domyślnie 0.75),pushToTalk,pushToTalkKey(domyślny klawisz mówienia,"z"),bitrate(jakość w kb/s, 8–64, domyślnie 32),occlusion,reverb,vehicleMuffle(stłumienie w zamkniętym aucie),indicator(ikonka nad mówiącym) imutedByDefault(nowi gracze wyciszeni). Klient dostaje tę samą tabelę co serwer.isSprawdza, czy podpowiedzi i poradniki z gry są u gracza włączone (Player Help Texts Enabled setPlayerHelpTextsEnabled). U klienta sprawdza lokalnego gracza.isSprawdza, czy składnik interfejsu gry jest u gracza widoczny (według ustawień zPlayer Hud Component Visible setPlayerHudComponentVisible). Składnik bez własnego ustawienia ma stan"all".isSprawdza, czy tabliczka z nickiem gracza jest widoczna.Player Nametag Showing isSprawdza, czy gracz właśnie mówi przez czat głosowy. U klienta dla lokalnego gracza oznacza to, że jego mikrofon właśnie nadaje.Player Talking isSprawdza, czy gracz jest wyciszony na czacie głosowym: przezPlayer Voice Muted setPlayerVoiceMutedalbo, jeśli tej funkcji nie użyto, przez ustawienie serweramutedByDefault. Działa też u klienta.isSprawdza, czy gracz widzi po śmierci ekran WASTED z gry.Player Wasted Screen Enabled isSprawdza, czy rozmowa głosowa jest na serwerze włączona.Voice Enabled setWłącza albo wyłącza podpowiedzi i poradniki z gry (ramka pomocy San Andreas, np. przy pierwszym wyciąganiu kierowcy z auta). Domyślnie są wyłączone. Na serwerze podajesz gracza alboPlayer Help Texts Enabled root(wszyscy), u klienta zmiana dotyczy tylko tego gracza.setPokazuje albo chowa składnik interfejsu gry. Każdy składnik działa osobno: schowanie pieniędzy zostawia zdrowie, pancerz, broń, zegar i resztę HUD na miejscu.Player Hud Component Visible "all"dotyczy wszystkich naraz (razem z radarem) i kasuje wcześniejsze ustawienia pojedynczych składników. Składniki:ammo,armour(alboarmor),breath,clock,health,money,weapon,wanted,area_name,vehicle_name,radio,radar,all. Ustawienie zostaje po śmierci i odrodzeniu; po ponownym wejściu na serwer ustaw je od nowa (np. wonPlayerJoin).setWłącza ekran WASTED z gry (napis i czerwona zasłona) po śmierci gracza. Domyślnie wyłączony.Player Wasted Screen Enabled
Zdarzenia serwera 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
Zdarzenia klienta 7
onAnimacja innego gracza. Zdarzenie jest zarejestrowane, ale obecny klient nie wysyła jeszcze tych meldunków, więc na razie nie przychodzi.Client Player Anim onGra innego gracza zgłosiła trafienie: tabelaClient Player Hit dataz numerem elementu celu (target), obrażeniami (damage), bronią (w) i częścią ciała (bp).onInny gracz dołączył do serwera.Client Player Join onInny gracz wyszedł z serwera.Client Player Quit onGracz (lokalny albo inny) pojawił się w świecie.Client Player Spawn onGracz (lokalny albo inny) zginął.Client Player Wasted onGracz oddał strzał z broni palnej: Ty albo inny gracz w pobliżu, którego strzały widać w Twojej grze. Przychodzi raz na każdy pocisk, z punktem wylotu i punktem trafienia. Gra zbiera strzały tylko wtedy, gdy któryś skrypt nasłuchuje tego zdarzenia.Client Player Weapon Fire