- Dokumentacja
- Elementy
Kategoria
Elementy
Wszystkie funkcje i zdarzenia Lua z kategorii Elementy, po stronie serwera i klienta.
Funkcje serwera 30
addZapisuje gracza na zmiany jednej wartości danych elementu. Działa z wartościami ustawionymi w trybieElement Data Subscriber "subscribe": dostają je tylko zapisani gracze, co oszczędza ruch sieciowy.cloneTworzy kopię elementu (pojazdu, obiektu, NPC, znacznika itd.) w podanym miejscu.Element getZwraca prędkość obrotu elementu wokół osi X, Y i Z.Element Angular Velocity getTo samo coElement Bone Attachment Details getElementBoneAttachment(inna nazwa dla zgodności ze skryptami).getZwraca n-ty element danego typu (od 0).Element By Index getZwraca n-te dziecko elementu (od 0).Element Child getZwraca dzieci elementu w drzewie, opcjonalnie tylko danego typu.Element Children getZwraca liczbę dzieci elementu.Element Children Count getZwraca strefę kolizji przypisaną do znacznika albo pickupa.Element Col Shape getZwraca graczy zapisanych na wartość danych elementu.Element Data Subscribers getZwraca rodzica elementu w drzewie elementów.Element Parent getZwraca gracza, który liczy fizykę elementu (pojazdu, obiektu, NPC) i wysyła jego stan do innych.Element Syncer getZwraca nazwę strefy mapy, w której stoi element (np. „Ganton”), albo samego miasta.Element Zone Name hasSprawdza, czy gracz jest zapisany na wartość danych elementu.Element Data Subscriber isSprawdza, czy wywołania funkcji na elemencie przechodzą na jego dzieci (domyślnie tak).Element Call Propagation Enabled isSprawdza, czy ścianki modelu elementu są rysowane z obu stron.Element Double Sided isSprawdza, czy element jest obiektem niskiego LOD (uproszczony model widoczny z daleka).Element Low LOD isSprawdza, czy element się pali.Element On Fire isSprawdza, czy element jest widoczny dla gracza (zob.Element Visible To setElementVisibleTo).removeWypisuje gracza z odbiorców wartości danych elementu.Element Data Subscriber setUstawia prędkość obrotu elementu wokół osi X, Y i Z.Element Angular Velocity setWłącza albo wyłącza przekazywanie wywołań funkcji z elementu na jego dzieci.Element Call Propagation Enabled setPrzypisuje strefę kolizji do znacznika albo pickupa.Element Col Shape nilusuwa przypisanie.setWłącza rysowanie ścianek modelu z obu stron.Element Double Sided setOznacza obiekt jako model niskiego LOD.Element Low LOD setPodpala albo gasi element. Z czasem w milisekundach ogień sam zgaśnie.Element On Fire setZmienia rodzica elementu w drzewie. Usunięcie rodzica usuwa też dzieci.Element Parent setUstawia promień bryły elementu używany w zapytaniach o geometrię (np. linie wzroku, strefy).Element Radius setWskazuje gracza, który ma liczyć fizykę elementu.Element Syncer truealbonilprzywraca wybór automatyczny.setPokazuje albo chowa element wybranemu graczowi. Dotyczy blipów, znaczników, wyświetlaczy tekstu i podobnych.Element Visible To
Funkcje klienta 14
getZwraca pozycję kości postaci w świecie.Element Bone Position getZwraca prostopadłościan obejmujący model elementu, względem jego środka.Element Bounding Box getZwraca odległość od środka ciężkości elementu do spodu jego modelu. Przydaje się do stawiania elementów na ziemi.Element Distance From Centre Of Mass To Base Of Model getZwraca poświatę ustawioną przezElement Highlight setElementHighlight.getZwraca, jak mocno element jest oświetlony (0 ciemno, 1 jasno).Element Lighting isSprawdza, czy dwa elementy mogą się zderzyć.Element Collidable With isSprawdza, czy element istnieje tylko u tego gracza (utworzony skryptem klienta, nie zna go serwer).Element Local isSprawdza, czy element jest widoczny na ekranie gracza.Element On Screen isSprawdza, czy element może znikać, gdy gracz się oddali (strumieniowanie).Element Streamable isSprawdza, czy element jest wczytany u tego gracza.Element Streamed In isSprawdza, czy to gracz lokalny liczy fizykę elementu.Element Syncer isSprawdza, czy element czeka na wczytanie terenu pod sobą (wtedy jest zatrzymany w powietrzu).Element Waiting For Ground To Load setWłącza albo wyłącza kolizję między dwoma elementami, tylko u tego gracza i w obie strony. Przydaje się do trybu ducha: Twoje auto przenika przez auta innych graczy, ale dalej zderza się ze ścianami, beczkami i resztą mapy.Element Collidable With setRozjaśnia cały model elementu kolorem (poświata) tylko u tego gracza: NPC, gracza (także własną postać), pojazd albo obiekt. Wołane zElement Highlight falsezamiast koloru zdejmuje poświatę.
Funkcje wspólne 54
attachPrzyczepia element do innego. Przyczepiony element porusza się i obraca razem z tym, do którego go przyczepiono. Obiekt przyczepiony do pojazdu prowadzi sama gra w tej samej klatce co fizykę pojazdu, więc jedzie z nim co do milimetra także przy dużej prędkości i na zakrętach.Elements createTworzy element własnego typu, na przykładElement "dom"albo"strefa". Wisi pod korzeniem bieżącego zasobu i znika, gdy zasób się zatrzyma. Przydaje się do grupowania elementów i przechowywania danych.destroyUsuwa element razem z jego dziećmi. Na kliencie usuwa też elementy GUI.Element detachOdczepia element od tego, do którego był przyczepiony.Elements getZwraca elementy przyczepione do elementu.Attached Elements getZwraca przezroczystość elementu (0 niewidoczny, 255 pełny).Element Alpha getZwraca przesunięcie i obrót przyczepionego elementu względem tego, do którego go przyczepiono.Element Attached Offsets getZwraca element, do którego ten jest przyczepiony.Element Attached To getZwraca dane przyczepienia elementu do kości postaci.Element Bone Attachment getZwraca przesunięcie elementu przyczepionego do kości.Element Bone Position Offset getZwraca obrót elementu przyczepionego do kości (w stopniach).Element Bone Rotation Offset getSzuka elementu po identyfikatorze tekstowym (z mapyElement By ID .mapalbo zsetElementID).getSprawdza, czy element ma włączone kolizje (domyślnie tak).Element Collisions Enabled getZwraca wartość danych elementu pod kluczem. Dane ustawiaElement Data setElementData; dane rozsyłane widać też na kliencie.getZwraca wymiar elementu. Elementy w różnych wymiarach się nie widzą.Element Dimension getZwraca zdrowie elementu: postaci 0-100 (do 176 z pełną wytrzymałością), pojazdu 0-1000 (poniżej 250 się pali).Element Health getZwraca identyfikator tekstowy elementu.Element ID getZwraca numer interioru elementu (0 to świat zewnętrzny).Element Interior getZwraca macierz elementu (pozycja i obrót). Domyślnie tablicę 4x4, a zElement Matrix legacy = falseobiektMatrix.getZwraca model elementu. Dla graczaElement Model -1oznacza CJ-a w stroju wybranym w launcherze, a0czystego CJ-a.getZwraca pozycję elementu w świecie: gracza, pojazdu, obiektu albo znacznika.Element Position getZwraca promień bryły elementu (domyślny dla typu, gdy nie został ustawiony).Element Radius getZwraca obrót elementu w stopniach.Element Rotation getZwraca wszystkie elementy danego typu, opcjonalnie tylko pod wskazanym elementem (np.Elements By Type resourceRoot).getZwraca elementy w strefie kolizji, opcjonalnie tylko jednego typu.Elements Within Col Shape getZwraca elementy, które są teraz w znaczniku (marker): gracze, pojazdy, postacie, obiekty, pickupy i inne znaczniki. ZnacznikElements Within Marker checkpointto koło bez limitu wysokości, pozostałe typy to kula o promieniu równym rozmiarowi znacznika. Można ograniczyć wynik do jednego typu.getZwraca elementy w promieniu od punktu, opcjonalnie tylko danego typu i wymiaru.Elements Within Range getZwraca typ elementu, np.Element Type "player","vehicle","ped","object". Elementy GUI mają typy z przedrostkiem"gui-".getZwraca prędkość elementu. Jednostka: 1 to 50 m/s, więc km/h to długość wektora razy 180.Element Velocity hasSprawdza, czy element ma ustawioną wartość pod kluczem. W odróżnieniu odElement Data getElementDataodróżnia brak wartości odfalse.isSprawdza, czy wartość jest istniejącym elementem. Używaj przed działaniem na elemencie, który mógł zostać usunięty.Element isSprawdza, czy element jest przyczepiony do innego.Element Attached isSprawdza, czy element jest przyczepiony do kości postaci.Element Attached To Bone isSprawdza, czy element jest zamrożony (nie rusza się).Element Frozen isSprawdza, czy element jest w wodzie.Element In Water isSprawdza, czy element jest teraz w strefie kolizji.Element Within Col Shape isSprawdza, czy element jest w znaczniku.Element Within Marker removeUsuwa wartość danych elementu pod kluczem (u wszystkich graczy).Element Data setUstawia przezroczystość elementu (0 niewidoczny, 255 pełny). Działa na graczach, pedach, obiektach i pojazdach (pojazd razem z kołami).Element Alpha setZmienia przesunięcie i obrót przyczepionego elementu.Element Attached Offsets setZmienia przesunięcie elementu przyczepionego do kości, bez ponownego przyczepiania. Element od razu przesuwa się względem kości.Element Bone Position Offset setZmienia obrót elementu przyczepionego do kości, bez ponownego przyczepiania.Element Bone Rotation Offset setWłącza albo wyłącza kolizje elementu.Element Collisions Enabled setZapisuje wartość pod kluczem w elemencie. Domyślnie wartość trafia do wszystkich graczy, co wywołujeElement Data onElementDataChange.setPrzenosi element do innego wymiaru. Elementy w różnych wymiarach się nie widzą.Element Dimension setZamraża albo odmraża element. Zamrożony element nie rusza się.Element Frozen setUstawia zdrowie elementu.Element Health 0zabija gracza albo NPC i wywołujeonPlayerWasted/onPedWasted.setUstawia identyfikator tekstowy elementu.Element ID setPrzenosi element do interioru. Gracz w interiorze widzi tylko budynki i elementy z tego samego numeru.Element Interior setUstawia pozycję i obrót elementu z macierzy (tablica 4x4 albo obiektElement Matrix Matrix).setZmienia model elementu. Dla gracza i NPC możesz podać też wariant ubrania i skóry (0-3); bez nich serwer losuje wariant, żeby wszyscy widzieli to samo.Element Model setPrzenosi element w podane miejsce. Na serwerze działa dla każdego elementu. Na kliencie przesuwa własną postać (do 50 m zwykłe przesunięcie w tej samej klatce,Element Position getElementPositionod razu zwraca nowe miejsce, więc można to wołać co klatkę, np. noclip; dalej teleport z wczytaniem okolicy), a także obiekty, dźwięki i strefy kolizji klienta. Obiekt przesuwany co klatkę wonClientPreRenderstoi w nowym miejscu na tym samym obrazie.setUstawia obrót elementu w stopniach. Na kliencie obraca własną postać w tej samej klatce (bez teleportu) oraz obiekty klienta.Element Rotation setUstawia prędkość elementu (1 to 50 m/s). Na kliencie działa dla własnej postaci i pojazdu; na ziemi animacja postaci gasi ruch poziomy, pionowy działa zawsze.Element Velocity
Zdarzenia serwera 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
Zdarzenia klienta 5
onNoweZmieniły się dane elementu - przez setElementData na serwerze albo w skrypcie klienta.Client Element Data Change onElement przeszedł do innego wymiaru.Client Element Dimension Change onElement przeszedł do innego wnętrza.Client Element Interior Change onElement pojawił się w pobliżu gracza (gra go wczytała i rysuje).Client Element Stream In onElement oddalił się i gra przestała go rysować.Client Element Stream Out