- Dokumentacja
- Pojazdy
Kategoria
Pojazdy
Wszystkie funkcje i zdarzenia Lua z kategorii Pojazdy, po stronie serwera i klienta.
Funkcje serwera 130
addZapisuje dla pojazdu zestaw własnych świateł syreny: liczbę punktów, typ i flagi. Po nim położenie i kolor każdego punktu ustawiaVehicle Sirens setVehicleSirens.areZwraca wartość ustawioną przezVehicle Doors Undamageable setVehicleDoorsUndamageable(domyślniefalse).attachDoczepia przyczepę albo naczepę do pojazdu ciągnącego (ciężarówki, ciągnika, holownika) u wszystkich graczy. Wywołuje zdarzenieTrailer To Vehicle onTrailerAttachna przyczepie; jeśli jakiś skrypt je anuluje (cancelEvent), przyczepa nie zostanie doczepiona. Gracze mogą też doczepiać naczepy normalnie w grze, cofając na nie ciężarówką.blowNiszczy pojazd: zdrowie spada do 0, silnik gaśnie, pojazd staje się wrakiem (Vehicle isVehicleBlown=true) i wywołuje zdarzenieonVehicleExplode. Domyślnie wszyscy gracze widzą też wybuch. Jeśli odradzanie pojazdu jest włączone (toggleVehicleRespawn, domyślnie nie), wrak wraca na swoje miejsce startowe po czasie zsetVehicleRespawnDelay(domyślnie 10 s); bez odradzania wrak znika po czasie zsetVehicleWreckDelay(domyślnie 20 s). Wysadzenie już zniszczonego pojazdu nic nie robi.detachOdczepia przyczepę od pojazdu ciągnącego u wszystkich graczy i wywołujeTrailer From Vehicle onTrailerDetachna przyczepie. Można podać konkretną przyczepę; wtedy funkcja zadziała tylko, jeśli to właśnie ona jest doczepiona.getZwraca nazwy wszystkich pól handlingu przyjmowanych przezHandling Field Names setVehicleHandlingisetModelHandling:mass,turnMass,dragCoeff,centerOfMass,percentSubmerged,tractionMultiplier,tractionLoss,tractionBias,numberOfGears,maxVelocity,engineAcceleration,engineInertia,driveType,engineType,brakeDeceleration,brakeBias,ABS,steeringLock, polasuspension*,seatOffsetDistance,collisionDamageMultiplier,monetary,modelFlags,handlingFlags,headLight,tailLight,animGroup.getZwraca wartość zapisaną przezHeli Blade Collisions Enabled setHeliBladeCollisionsEnabled(domyślnietrue).getZwraca zmiany handlingu ustawione dla modelu przezModel Handling setModelHandling(bez wartości fabrycznych).getZwraca liczbę miejsc pasażerskich modelu po uwzględnieniu limitu zModel Max Passengers setModelMaxPassengers.getZwraca kierunek jazdy zapisany przezTrain Direction setTrainDirection(domyślnietrue).getZwraca położenie na torze zapisane przezTrain Position setTrainPosition(domyślnie 0).getZwraca prędkość zapisaną przezTrain Speed setTrainSpeed(domyślnie 0).getZwraca numer toru zapisany przezTrain Track setTrainTrack(domyślnie 0).getZwraca ustawienie ruchomej części zapisane przezVehicle Adjustable Property setVehicleAdjustableProperty(domyślnie 0).getZwraca dwa numery palety ustawione przezVehicle Color Id setVehicleColorId. Gdy pojazd ma kolory RGB zsetVehicleColor(albo jeszcze żadnych), zwracafalse; wtedy użyjgetVehicleColor.getZwraca przesunięcie części zapisane przezVehicle Component Position setVehicleComponentPosition(0, 0, 0, gdy nie ustawiono).getZwraca obrót części zapisany przezVehicle Component Rotation setVehicleComponentRotation(0, 0, 0, gdy nie ustawiono).getZwraca skalę części zapisaną przezVehicle Component Scale setVehicleComponentScale(1, 1, 1, gdy nie ustawiono).getZwraca położenie punktu pomocniczego pojazdu zapisane przezVehicle Dummy Position setVehicleDummyPosition.getZwraca punkty wsiadania pojazdu: ustawione przezVehicle Entry Points setVehicleEntryPointsalbo cztery przybliżone punkty po bokach pojazdu (dla foteli 0-3) w obecnym położeniu pojazdu.getZwraca kierunek grawitacji pojazdu zapisany przezVehicle Gravity setVehicleGravity(domyślnie 0, 0, -1).getZwraca, po ilu milisekundach porzucony pojazd wraca na punkt odrodzenia (domyślnie 60000, 0 = wyłączone).Vehicle Idle Respawn Delay getZwraca wartość zapisaną przezVehicle Landing Gear Down setVehicleLandingGearDown(domyślnietrue).getZwraca fabryczne położenie punktu pomocniczego modelu. DlaVehicle Model Dummy Default Position seat_frontiseat_rearpodaje fabryczne miejsce przedniego i tylnego fotela z gry.getZwraca położenie punktu pomocniczego modelu ustawione przezVehicle Model Dummy Position setVehicleModelDummyPosition.getZwraca położenie wylotu spalin modelu ustawione przezVehicle Model Exhaust Fumes Position setVehicleModelExhaustFumesPosition.getZwraca wzór tablicy ustawiony przezVehicle Plate Design setVehiclePlateDesign(-1 = gra wybiera sama).getZwraca, po ilu milisekundach od zniszczenia wrak tego pojazdu się odrodzi (domyślnie 10000).Vehicle Respawn Delay getZwraca współrzędne miejsca, w którym pojazd pojawi się przy odrodzeniu.Vehicle Respawn Position getZwraca obrót, z jakim pojazd pojawi się przy odrodzeniu.Vehicle Respawn Rotation getZwraca prędkość wirnika zapisaną przezVehicle Rotor Speed setVehicleRotorSpeed(domyślnie 0).getZwraca wartość zapisaną przezVehicle Rotor State setVehicleRotorState(domyślnietrue).getZwraca ustawienia syren zVehicle Siren Params addVehicleSirensjako tabelę:SirenCount,SirenTypeiFlags(["360"],DoLOSCheck,UseRandomiser,Silent).getZwraca listę punktów syren zapisanych przezVehicle Sirens addVehicleSirensisetVehicleSirens. Każdy punkt to tabela z polamix,y,z,Red,Green,Blue,Alpha,Min_Alpha.getZwraca wszystkie istniejące pojazdy danego modelu, np. wszystkie taksówki na mapie.Vehicles Of Type getZwraca przyczepę, którą ciągnie podany pojazd.Vehicle Towed By Vehicle getZwraca pojazd, który ciągnie podaną przyczepę.Vehicle Towing Vehicle getZwraca prędkość obrotu pojazdu wokół osi x, y, z. To ta sama funkcja coVehicle Turn Velocity getElementAngularVelocity.getZwraca obrót wieżyczki zapisany przezVehicle Turret Position setVehicleTurretPosition(poziomy, pionowy w radianach; domyślnie 0, 0).getZwraca przyczepność koła: 0 = pełna, 1 = poślizg, 2 = brak.Vehicle Wheel Friction State getZwraca mnożnik rozmiaru kół zapisany przezVehicle Wheel Scale setVehicleWheelScale(domyślnie 1).getZwraca obroty kół zapisane przezVehicle Wheels Rotation setVehicleWheelsRotation.getZwraca, po ilu milisekundach od wybuchu wrak tego pojazdu zniknie (dlaVehicle Wreck Delay root: wartość domyślna, początkowo 20000).isSprawdza, czy wagon jest lokomotywą prowadzącą skład.Train Chain Engine isZwraca wartość zapisaną przezTrain Derailable setTrainDerailable(domyślnietrue).isZwraca wartość zapisaną przezTrain Derailed setTrainDerailed(domyślniefalse).isSprawdza, czy pojazd jest odporny na uszkodzenia (Vehicle Damage Proof setVehicleDamageProof).isZwraca wartość ustawioną przezVehicle Fuel Tank Explodable setVehicleFuelTankExplodable(domyślniefalse).isSprawdza, czy pojazd ma włączone automatyczne odradzanie (Vehicle Respawnable toggleVehicleRespawn). Domyślniefalse: wrak takiego pojazdu nie wraca, tylko znika po czasie zsetVehicleWreckDelay.isZwraca wartość zapisaną przezVehicle Smoke Trail Enabled setVehicleSmokeTrailEnabled(domyślniefalse).isZwraca, czy szyba została oznaczona jako opuszczona przezVehicle Window Open setVehicleWindowOpen.removeUsuwa z pojazdu własne syreny dodane przezVehicle Sirens addVehicleSirens.resetPrzywraca fabryczne (albo odziedziczone po modelu bazowym) miejsce jednego fotela modelu albo, bez numeru fotela, wszystkich jego foteli.Model Seat Position resetKasuje przesunięcie części zapisane przezVehicle Component Position setVehicleComponentPosition.resetKasuje obrót części zapisany przezVehicle Component Rotation setVehicleComponentRotation.resetKasuje skalę części zapisaną przezVehicle Component Scale setVehicleComponentScale.resetKasuje wszystkie punkty pomocnicze pojazdu zapisane przezVehicle Dummy Positions setVehicleDummyPosition.resetZaczyna od nowa odliczanie do odrodzenia wraku: wrak odrodzi się po pełnym czasie zVehicle Explosion Time setVehicleRespawnDelay, licząc od teraz. Gdy pojazd nie jest wrakiem czekającym na odrodzenie, funkcja nic nie zmienia.resetZeruje licznik bezczynności pojazdu, tak jakby ktoś właśnie z niego wysiadł. Odliczanie do powrotu porzuconego pojazdu (Vehicle Idle Time setVehicleIdleRespawnDelay) zaczyna się od nowa. Przydaje się np. gdy gracz zaparkował auto w garażu i chcesz mu dać więcej czasu.resetPrzywraca wszystkie lampy pojazdu do stanuVehicle Lamp States 'auto', czyli działania jak w grze. Kasuje wszystko, co ustawiłosetVehicleLampState.respawnNatychmiast odradza pojazd w jego punkcie odrodzenia (miejsce utworzenia albo to zVehicle setVehicleRespawnPosition). Wszyscy pasażerowie zostają wysadzeni z pojazdu, prędkość jest zerowana, zdrowie wraca do 1000, a uszkodzenia drzwi, paneli, lamp i kół znikają. Wywołuje zdarzenieonVehicleRespawn. Działa także dla pojazdu, który nie jest wrakiem.setZapisuje, czy wirnik helikoptera ma ciąć to, w co uderzy (postacie, inne pojazdy).Heli Blade Collisions Enabled setZapisuje własną listę części pasujących do modelu pojazdu, np. dla nowego modelu zModel Compatible Upgrades engineRequestModel.setZmienia handling wszystkich pojazdów danego modelu naraz, u każdego gracza, także tych utworzonych później. Zmiany pojedynczego auta zModel Handling setVehicleHandlingmają pierwszeństwo przed ustawieniem modelu.setOgranicza liczbę miejsc pasażerskich modelu: gracze nie wsiądą na fotele o wyższym numerze (serwer anuluje wsiadanie). Działa też dla nowych modeli zModel Max Passengers engineRequestModel. Nie można dodać miejsc, których model bazowy nie ma.nilalbofalsezdejmuje limit.setPrzesuwa miejsce siedzenia w pojeździe dla całego modelu, u wszystkich graczy: gdzie siedzi postać i w którą stronę jest obrócona. Najczęściej służy do ustawienia foteli w nowych pojazdach zModel Seat Position engineRequestModeliengineReplaceModel, które domyślnie mają fotele jak auto bazowe. Liczba miejsc się nie zmienia.setKopiuje miejsca siedzenia z innego modelu na wskazany model, np. nowy pojazd zModel Seats From engineRequestModelma siedzieć jak w Sultanie. Bez numeru fotela kopiuje wszystkie fotele, które ma wzorzec.setZapisuje, czy pociąg może się wykoleić (np. przy zbyt szybkim zakręcie).Train Derailable setZapisuje, czy pociąg jest wykolejony.Train Derailed setZapisuje kierunek jazdy pociągu po torze.Train Direction setZapisuje położenie pociągu na torze jako odległość od początku toru.Train Position setZapisuje prędkość pociągu po torze.Train Speed setZapisuje numer toru, po którym jedzie pociąg.Train Track setZapisuje ustawienie ruchomej części pojazdu: łyżki spychacza, wideł wózka widłowego, ramienia dźwigu, dyszy Hydry.Vehicle Adjustable Property setUstawia kolory pojazdu numerami z palety pojazdów San Andreas (0-127), tak jak w klasycznej grze i w plikach carcols. Numer 0 to czarny, 1 biały, 3 czerwony, 6 żółty… (nazwy i barwy podaVehicle Color Id getVehiclePaletteColor). Podanie jednego numeru ustawia oba główne kolory na ten sam.setZapisuje przesunięcie nazwanej części modelu pojazdu (np. maski) względem jej pozycji w modelu.Vehicle Component Position setZapisuje obrót nazwanej części modelu pojazdu w stopniach (x, y, z).Vehicle Component Rotation setZapisuje skalę nazwanej części modelu pojazdu w trzech osiach (1 = rozmiar oryginalny).Vehicle Component Scale setZapisuje pozycję, obrót i skalę części modelu jednym wywołaniem. Każdy z trzech argumentów to wektor albo tabelaVehicle Component Transform { x, y, z }; pominięty (nil) zostaje bez zmian.setZapisuje numer biegu pojazdu.Vehicle Current Gear setCzyni pojazd odpornym na uszkodzenia u wszystkich graczy: kolizje, strzały i wybuchy nie odbierają mu zdrowia ani nie psują karoserii. Przydatne dla pojazdów wystawowych, autobusów miejskich albo pojazdów w strefie bezpiecznej.Vehicle Damage Proof setUstawia zabrudzenie karoserii widoczne u wszystkich graczy: 0 = lśniąco czysta, 1 = mocno zakurzona. Przydaje się w myjniach i przy autach porzuconych na pustyni. Nowy pojazd zVehicle Dirt Level createVehiclejest czysty.setOtwiera drzwi, maskę albo bagażnik pojazdu w podanym stopniu u wszystkich graczy: 0 = zamknięte, 1 = otwarte na oścież, 0,5 = w połowie. Przydatne np. w warsztacie (otwarta maska) albo przy przeszukaniu bagażnika. Numeracja drzwi jak wVehicle Door Open Ratio setVehicleDoorState.setUstawia stan jednych drzwi (albo maski czy bagażnika) pojazdu u wszystkich graczy: zamknięte, uchylone, wgniecione albo urwane. Numer drzwi: 0 maska, 1 bagażnik, 2 przednie lewe, 3 przednie prawe, 4 tylne lewe, 5 tylne prawe. Pojazd bez danych drzwi po prostu tego nie pokaże.Vehicle Door State setZapisuje, czy drzwi pojazdu mają być nie do urwania.Vehicle Doors Undamageable setZapisuje położenie punktu pomocniczego (dummy) dla jednego pojazdu, np. wydechu albo świateł.Vehicle Dummy Position setMontuje w pojeździe silnik opisany parametrami jak w prawdziwym aucie (moc, moment, pojemność, paliwo, masa, biegi) i sam przelicza z nich pola handlingu: masę, prędkość maksymalną, przyspieszenie, bezwładność silnika, typ paliwa, liczbę biegów i przyczepność. Silnik dużo mocniejszy od fabrycznego zmniejsza przyczepność (koła buksują). Zużycie obniża moc o maksymalnie 30%.Vehicle Engine nilprzywraca silnik fabryczny. Dobre do systemów tuningu i wymiany silników na serwerach RP.setZapisuje własne punkty wsiadania do pojazdu (tabela punktówVehicle Entry Points { x, y, z, seat }).setZapisuje, czy zbiornik paliwa pojazdu ma wybuchać od strzału (strzał w bak wysadza auto).Vehicle Fuel Tank Explodable setZapisuje własny kierunek grawitacji dla pojazdu jako wektor (domyślnie 0, 0, -1, czyli w dół). Pozwala to np. jeździć po ścianach.Vehicle Gravity setZmienia kolor światła reflektorów pojazdu u wszystkich graczy, np. ksenonowy niebieski albo żółty. Wpływa na barwę świecących kloszy i plamy światła przed autem.Vehicle Head Light Color setNoweUstawia próg zdrowia pojazdu: strzały, ogień, wybuchy i zderzenia nie zbiją zdrowia poniżej tej wartości. Próg 250 lub wyższy sprawia, że auto nie zapali się ani nie wybuchnie od obrażeń. Skrypt może dalej zejść niżej przez setElementHealth albo blowVehicle. 0 wyłącza próg.Vehicle Health Floor setUstawia, po ilu milisekundach porzucony pojazd sam wraca na punkt odrodzenia. „Porzucony” znaczy: nikt w nim nie siedzi i stoi dalej niż 0,5 m od punktu odrodzenia. Licznik zeruje się, gdy ktoś wsiądzie. Domyślnie 60000 ms; 0 wyłącza powrót porzuconych aut. Odliczanie działa dla pojazdów, którym ustawiono odradzanie dowolną funkcją z tej grupy (np. tą) albo które były wrakiem; świeżo utworzone, nieskonfigurowane auto nie wraca samo.Vehicle Idle Respawn Delay setWłącza kierunkowskazy pojazdu, które migają u wszystkich graczy. Na pojazdach z własnego modelu (Vehicle Indicators engineReplaceModel) migają lampy oznaczone w modelu kolorami kierunkowskazów SA. Auta z gry nie mają osobnych kierunkowskazów, dlatego miga przód na pomarańczowo i tył czerwonym kloszem. Pojedynczą lampę ustawiasetVehicleLampState.setZapala, gasi albo oddaje grze jedną lampę (lub grupę lamp) pojazdu, u wszystkich graczy. Dzięki temu skrypt może np. zapalić światło STOP przy hamowaniu na serwerze, światło cofania albo zostawić świecący jeden reflektor. StanVehicle Lamp State 'auto'oznacza, że lampa działa jak zwykle w grze. Kierunkowskaz ustawiony na'on'świeci stale; miganie dajesetVehicleIndicators. Auta z gry nie mają lamp cofania ani osobnych kierunkowskazów (przedni świeci na pomarańczowo, tylny czerwonym kloszem); własne modele zengineReplaceModelmają wszystkie lampy.setWysuwa albo chowa podwozie samolotu. Zmiana trafia do gry każdego gracza, który ma ten samolot wczytany, także po jego ponownym wczytaniu. Pilot może potem zmienić podwozie klawiszem, jak zwykle w grze.Vehicle Landing Gear Down setZbija albo naprawia jedną lampę pojazdu u wszystkich graczy. Numery: 0 przednia lewa, 1 przednia prawa, 2 tylna lewa, 3 tylna prawa. Zbita lampa nie świeci, nawet przy włączonych światłach.Vehicle Light State setZapisuje liczbę miejsc pasażerskich modelu na serwerze. Zwykle robi to automatycznie klient gry; skrypt może podać ją wcześniej, żebyVehicle Max Passengers getVehicleMaxPassengersznało ją od startu.setZapisuje położenie punktu pomocniczego (dummy) dla całego modelu pojazdu. PunktyVehicle Model Dummy Position seat_frontiseat_rearprzesuwają w grze fotele (przednie i tylne) u wszystkich graczy; pozostałe punkty są zapamiętywane dla skryptów.setZapisuje położenie wylotu spalin dla całego modelu pojazdu (układ pojazdu, metry).Vehicle Model Exhaust Fumes Position setZapisuje włączenie albo wyłączenie nitro. Włączenie zużywa jeden ładunek zVehicle Nitro Activated setVehicleNitroCount(przy -1 ładunki się nie kończą); bez ładunków funkcja zwracafalse.setZapisuje liczbę ładunków nitro pojazdu, zużywanych przezVehicle Nitro Count setVehicleNitroActivated.setZapisuje poziom naładowania nitro (jak pasek nitro w grze).Vehicle Nitro Level setNakłada na pojazd jedną z fabrycznych naklejek (paintjob) z warsztatów Loco Low Co. i Wheel Arch Angels, widoczną u wszystkich graczy. Paintjoby mają tylko niektóre modele (np. Elegy, Jester, Savanna, Blade); na innych nic się nie zmieni. Naklejka zakrywa kolor główny.Vehicle Paintjob setUstawia stopień uszkodzenia jednego elementu karoserii u wszystkich graczy. Numery: 0 przedni lewy błotnik, 1 przedni prawy błotnik, 2 tylny lewy, 3 tylny prawy, 4 przednia szyba, 5 przedni zderzak, 6 tylny zderzak. Stan 0 = cały, 3 = mocno zniszczony (zderzak może odpaść).Vehicle Panel State setWybiera wzór graficzny tablicy rejestracyjnej (tło i barwy stanu) u wszystkich graczy. Normalnie gra dobiera wzór według miasta, w którym pojazd powstał; ta funkcja pozwala go ustawić na stałe.Vehicle Plate Design setNoweUstawia, na co pojazd jest odporny: kule, ogień, wybuchy, zderzenia i ciosy. Działa u wszystkich graczy. WszystkoVehicle Proofs falseprzywraca zwykłe zachowanie. Odporność na wszystko naraz daje też setVehicleDamageProof.setUstawia, po ilu milisekundach od zniszczenia wrak pojazdu odrodzi się na swoim punkcie odrodzenia. Domyślnie 10000 ms (10 s). Działa tylko przy włączonym odradzaniu (Vehicle Respawn Delay toggleVehicleRespawn). Nowy czas dotyczy kolejnych wybuchów; dla wraku już czekającego użyjresetVehicleExplosionTime.setUstawia miejsce (i opcjonalnie obrót), w którym pojazd pojawi się przy odrodzeniu: po zniszczeniu, po porzuceniu i przyVehicle Respawn Position respawnVehicle. Domyślnie to miejsce utworzenia pojazdu. Pojazd nie jest przenoszony od razu.setUstawia obrót, z jakim pojazd pojawi się przy odrodzeniu (pozycja odrodzenia się nie zmienia).Vehicle Respawn Rotation setZapisuje prędkość obrotu wirnika helikoptera albo śmigła samolotu.Vehicle Rotor Speed setZapisuje, czy wirnik helikoptera ma się kręcić.Vehicle Rotor State setUstawia położenie i kolor jednego punktu syreny dodanego przezVehicle Sirens addVehicleSirens.setWłącza albo wyłącza syrenę i koguty pojazdu uprzywilejowanego (policja, karetka, straż) u wszystkich graczy, tak jak robi to gracz klawiszem klaksonu w grze. Na pojazdach bez syreny nic nie widać.Vehicle Sirens On setZapisuje, czy za samolotem (np. Stuntplane, Cropduster) ma się ciągnąć smuga dymu.Vehicle Smoke Trail Enabled setZmienia kolor tylnych lamp pojazdu u wszystkich graczy (domyślnie czerwony).Vehicle Tail Light Color setZapala albo gasi lampkę „TAXI” na dachu taksówki u wszystkich graczy (modele z lampką: Taxi 420, Cabbie 438). Zapalona lampka zwykle znaczy, że taksówka jest wolna.Vehicle Taxi Light On setUstawia prędkość obrotu pojazdu wokół osi x, y, z, np. żeby wprawić auto w obrót. To ta sama funkcja coVehicle Turn Velocity setElementAngularVelocity.setZapisuje obrót wieżyczki pojazdu (czołg Rhino, wóz SWAT, wóz strażacki): poziomy i pionowy, w radianach.Vehicle Turret Position setWybiera warianty wyglądu modelu pojazdu, czyli fabryczne dodatki z gry: bagażnik dachowy, inna skrzynia pickupa, ładunek, osłony. Każdy model ma własną liczbę wariantów (wiele nie ma żadnych). Bez argumentów wariant jest losowany. Zmiana jest widoczna u wszystkich graczy.Vehicle Variant setNoweZmienia przyczepność kół pojazdu mnożnikiem (1 = zwykła, 0.5 = połowa, 1.5 = o połowę więcej). Każdy zasób ma swój mnożnik, a auto dostaje ich iloczyn. 1 zdejmuje mnożnik zasobu, a zatrzymanie zasobu zdejmuje jego mnożniki samo.Vehicle Wheel Grip setZapisuje mnożnik rozmiaru kół pojazdu (1 = normalne).Vehicle Wheel Scale setZapisuje obrót każdego z czterech kół pojazdu w stopniach.Vehicle Wheels Rotation setUstawia stan kół pojazdu u wszystkich graczy: całe, przebite (flak) albo odpadnięte. Kolejność argumentów: przednie lewe, tylne lewe, przednie prawe, tylne prawe. Dla motocykla liczą się dwa pierwsze (przód, tył). Podaj -1 alboVehicle Wheel States nil, żeby nie zmieniać danego koła.setZapisuje, czy szyba pojazdu jest opuszczona. Numery szyb 0-3.Vehicle Window Open setNowePrzyciemnia szyby pojazdu u wszystkich graczy i może je lekko podbarwić. Najciemniej jest 80% - większa wartość też daje 80%, bo szyba ma dalej wyglądać jak szyba: zostają odbicia i trochę widać przez nią wnętrze. Kolor tylko podbarwia szkło, główną robotę robi przyciemnienie. Przyciemnienie 0 bez koloru przywraca zwykłe szyby.Vehicle Window Tint setUstawia, po ilu milisekundach od wybuchu wrak pojazdu znika z mapy (element zostaje usunięty, z wywołaniemVehicle Wreck Delay onElementDestroy; siedzący w nim gracze wypadają). Domyślnie 20000 ms (20 s); 0 = wrak zostaje na zawsze. Podanyrootzmienia wartość domyślną dla wszystkich pojazdów bez własnego ustawienia. Nie dotyczy pojazdów z włączonym odradzaniem (toggleVehicleRespawn) — te wracają naprawione na punkt odrodzenia.fixVehicleprzed upływem czasu zatrzymuje znikanie. Zmiana dla wraku już czekającego liczy czas od nowa.spawnOdradza pojazd jednorazowo w podanym miejscu, tak jakVehicle respawnVehicle: wysadza pasażerów, naprawia pojazd i zeruje prędkość. Zapisany punkt odrodzenia się nie zmienia, więc kolejne automatyczne odrodzenia nadal wracają do starego miejsca.spawnTworzy element obiektu w miejscu pojazdu i nadaje mu prędkość pojazdu z lekkim losowym rozrzutem, tak jakby część odpadła. Obiekt znika po podanym czasie. Numer części zapisuje w danych elementuVehicle Flying Component flyingComponent.toggleWłącza albo wyłącza automatyczne odradzanie pojazdu. Domyślnie wyłączone: pojazd ze skryptu nie wraca sam. Gdy jest włączone, wrak wraca naprawiony na punkt odrodzenia po czasie zVehicle Respawn setVehicleRespawnDelay, a porzucony pojazd po czasie zsetVehicleIdleRespawnDelay. Wyłączenie anuluje odrodzenie wraku, które już czekało w kolejce; wrak bez odradzania znika po czasie zsetVehicleWreckDelay(domyślnie 20 s).
Funkcje klienta 1
Funkcje wspólne 80
addMontuje w pojeździe część tuningu (spoiler, felgi, wydech, nitro, hydraulika, zderzaki…), widoczną i działającą u wszystkich graczy. Część musi pasować do modelu (listę dajeVehicle Upgrade getVehicleCompatibleUpgrades). Jeśli w tym samym slocie była już część, zostaje zastąpiona; ta sama część zamontowana drugi raz nic nie zmienia. Działają też nowe części dodane przezengineRequestModel.areSprawdza, czy reflektory pojazdu świecą, czyli czy ustawionoVehicle Lights On setVehicleOverrideLights(pojazd, 2). Działa po obu stronach.calculateLiczy, jakie pola handlingu dałby dany silnik w danym modelu, bez montowania go. Zwraca to samo, coEngine Handling setVehicleEnginewpisałby do pojazdu, więc nadaje się do podglądu w sklepie z silnikami.createTworzy pojazd w świecie: model, pozycja, obrót i tekst tablicy rejestracyjnej.Vehicle fixNaprawia pojazd do stanu fabrycznego: zdrowie 1000, wszystkie drzwi, panele karoserii, lampy i koła wracają do stanu nieuszkodzonego, a wrak przestaje być wrakiem. Anuluje też zaplanowane odrodzenie wraku. Przez sekundę po naprawie serwer ignoruje zgłoszenia uszkodzeń od gry, żeby stare uszkodzenia nie wróciły. Kolor, tuning i tablica zostają bez zmian.Vehicle getZwraca nazwę wpisu w handling.cfg, z którego korzysta model, np. 411 →Handling Line Name INFERNUS, 596 →POLICE_LA. Nowe modele zengineRequestModelkorzystają z wpisu modelu bazowego.getJakModel Compatible Upgrades getVehicleCompatibleUpgrades, ale dla numeru modelu, bez potrzeby tworzenia pojazdu. Przydaje się w sklepie, który pokazuje części przed zakupem auta.getZwraca fabryczne miejsce fotela z gry dla modelu (dla nowych modeli - modelu bazowego), bez zmian skryptów.Model Default Seat Position getZwraca aktualne miejsce fotela dla modelu oraz źródło tych danych:Model Seat Position script(ustawione skryptem),dummy(z punktu pomocniczego modelu) albodefault(fabryczne z gry).getZnajduje w palecie pojazdów gry (0-127) kolor najbardziej podobny do podanej barwy RGB. Przydaje się, gdy gracz wybiera kolor z dowolnego próbnika, a skrypt chce zapisać go jako numer palety.Nearest Vehicle Palette Color getZwraca fabryczny handling modelu prosto z plików gry (handling.cfg Definitive Edition), bez żadnych zmian skryptów. Działa po obu stronach.Original Handling getZwraca kolory pojazdu. Bez drugiego argumentu daje cztery numery z palety gry (gdy auto ma kolory RGB, numery są najbliższymi kolorami palety). ZVehicle Color rgb = truezwraca dwanaście liczb: r, g, b kolejno dla kolorów 1-4, dokładnie takie, jakie widać w grze.getZwraca części tuningu, które pasują do tego pojazdu, według danych gry (lista carmods oraz felgi dla zwykłych samochodów). Można zawęzić wynik do jednego slotu. Idealne do budowy menu warsztatu.Vehicle Compatible Upgrades getZwraca części modelu pojazdu jako tabelę nazwa → czy widoczna. Na kliencie dla modelu z pliku (Vehicle Components engineReplaceModel) to pełna lista ramek .dff (karoseria, drzwi, maska, zderzaki, koławheel_*_dummy, warianty autora), dla aut z gry tylko części zmienione skryptem. Na serwerze tylko części zmienione skryptem.getSprawdza, czy nazwana część modelu pojazdu jest widoczna. Na kliencie uwzględnia też lokalne ustawienia tego gracza.Vehicle Component Visible getZwraca kierowcę pojazdu (osobę na fotelu 0) alboVehicle Controller false, gdy nikt nie prowadzi.getNa serwerze: numer biegu zapisany przezVehicle Current Gear setVehicleCurrentGear(domyślnie 0). W kliencie: aktualny bieg auta liczony jak skrzynia SA z prędkości i handlingu (0 = wsteczny/luz, 1-5).getZwraca zabrudzenie karoserii pojazdu (0 czysta - 1 brudna).Vehicle Dirt Level getZwraca stopień otwarcia drzwi ustawiony przezVehicle Door Open Ratio setVehicleDoorOpenRatio(0 = zamknięte, 1 = otwarte).getZwraca stan jednych drzwi pojazdu (0 zamknięte, 1 uchylone, 2 zamknięte i uszkodzone, 3 uchylone i uszkodzone, 4 urwane). Numeracja drzwi jak wVehicle Door State setVehicleDoorState.getZwraca silnik pojazdu: zamontowany przezVehicle Engine setVehicleEnginealbo, gdy żadnego nie montowano, silnik fabryczny wyliczony z danych gry (z polemfactory = true). Druga wartość to zużycie 0..1. Działa po obu stronach.getSprawdza, czy silnik pojazdu pracuje (ustawione przezVehicle Engine State setVehicleEngineState; zniszczenie pojazdu też gasi silnik).getZwraca silnik fabryczny modelu. Moc jest wyliczana z handlingu gry, a pozostałe dane (moment, pojemność, cylindry, masa) są realistycznym oszacowaniem, oznaczonym polemVehicle Factory Engine estimated = true. Daje punkt odniesienia dla systemów tuningu.getZwraca pełny handling pojazdu taki, jakiego używa gra: wartości fabryczne z handling.cfg, nadpisane ustawieniami modelu (Vehicle Handling setModelHandling), a na końcu zmianami tego pojazdu (setVehicleHandling,setVehicleEngine). Działa po obu stronach.getZwraca tylko te pola handlingu, które zmieniono dla tego konkretnego pojazdu (Vehicle Handling Overrides setVehicleHandlingisetVehicleEngine), bez wartości fabrycznych. Przydaje się do zapisania tuningu auta w bazie danych.getZwraca kolor światła reflektorów (domyślnie biały 255, 255, 255).Vehicle Head Light Color getNoweZwraca próg zdrowia pojazdu ustawiony przez setVehicleHealthFloor (0 = brak progu).Vehicle Health Floor getZwraca stan kierunkowskazów: 0 wyłączone, 1 lewy, 2 prawy, 3 awaryjne. Działa po obu stronach.Vehicle Indicators getZwraca listę nazw wszystkich dwunastu lamp, które przyjmujeVehicle Lamp Names setVehicleLampState, w kolejności numerów 0-11 (odfront_leftdoindicator_rear_right). Grup (front,all…) lista nie zawiera.getZwraca stan lampy albo grupy lamp ustawiony przezVehicle Lamp State setVehicleLampState:'auto','on'albo'off'. Gdy lampy w grupie mają różne stany, zwraca'mixed'.getZwraca stan wszystkich dwunastu lamp pojazdu jako tabelę nazwa →Vehicle Lamp States 'auto'/'on'/'off'.getZwraca, czy lampa pojazdu jest cała (0) czy zbita (1). Numeracja jak wVehicle Light State setVehicleLightState.getZwraca liczbę miejsc pasażerskich pojazdu albo modelu (bez kierowcy): np. 1 dla dwuosobowego auta, 3 dla sedana. Dane pochodzą z gry, więc serwer zna je dopiero, gdy któryś klient je zgłosi (zwykle po pierwszym pojawieniu się modelu u gracza); wcześniej zwracaVehicle Max Passengers false.getZamienia nazwę pojazdu na numer modelu, bez względu na wielkość liter i spacje na brzegach, np.Vehicle Model From Name "infernus"→ 411. Rozpoznaje też nazwy nowych modeli zengineRequestModel. Idealne do komend typu/v infernus.getZwraca numery wszystkich modeli danego rodzaju, np. wszystkie łodzie albo helikoptery. Przydaje się do losowania pojazdu konkretnego typu.Vehicle Models Of Type getZwraca średnicę kół modelu ustawioną przezVehicle Model Wheel Size setVehicleModelWheelSize. Na kliencie bez nazwy grupy zwraca tabelę{ front_axle, rear_axle }.getZwraca nazwę pojazdu na podstawie jego modelu, np.Vehicle Name "Infernus","Landstalker". Dla nowego modelu zengineRequestModelzwraca nazwę nadaną przy rejestracji albo nazwę modelu bazowego. Działa po obu stronach.getZwraca nazwę pojazdu dla numeru modelu, np. 411 →Vehicle Name From Model "Infernus", bez tworzenia pojazdu. Dla numeru spoza 400-611, który nie jest nowym pojazdem, zwracafalse.getZwraca liczbę ładunków nitro zapisaną przezVehicle Nitro Count setVehicleNitroCount(domyślnie 0, -1 = bez końca).getZwraca poziom nitro zapisany przezVehicle Nitro Level setVehicleNitroLevel(domyślnie 1).getZwraca gracza albo postać siedzącą na wskazanym fotelu pojazdu. Fotel 0 to kierowca, 1 przedni pasażer, 2 i 3 tylne fotele.Vehicle Occupant getZwraca wszystkie osoby (graczy i postacie) siedzące w pojeździe jako tabelę numer fotela → osoba. Puste fotele nie występują w tabeli, więc do przejścia po niej używajVehicle Occupants pairs, nieipairs(fotel 0 nie jest indeksem tablicy).getZwraca wymuszony stan świateł: 0 bez wymuszenia, 1 zgaszone, 2 zapalone.Vehicle Override Lights getZwraca numer naklejki pojazdu: 0-2 albo 3, gdy pojazd nie ma naklejki. Działa po obu stronach.Vehicle Paintjob getZwraca barwę koloru o podanym numerze z palety pojazdów gry (0-127) oraz jego nazwę. Wartości RGB są dokładnie tymi, które rysuje Definitive Edition, więc nadają się np. do podglądu koloru w sklepie z lakierami.Vehicle Palette Color getZwraca stopień uszkodzenia elementu karoserii (0 cały - 3 mocno zniszczony). Numeracja jak wVehicle Panel State setVehiclePanelState.getZwraca osiągi pojazdu w formie przyjaznej graczowi: moc w kW i KM, moment obrotowy, masę, czas 0-100 km/h i prędkość maksymalną. Można podać pojazd (bierze jego silnik i zużycie) albo numer modelu, opcjonalnie z silnikiem do porównania.Vehicle Performance getZwraca tekst tablicy rejestracyjnej pojazdu.Vehicle Plate Text getNoweZwraca tabelę odporności pojazdu ustawionych przez setVehicleProofs.Vehicle Proofs getSprawdza, czy syrena pojazdu jest włączona przezVehicle Sirens On setVehicleSirensOn. Działa po obu stronach.getZwraca kolor tylnych lamp (domyślnie 255, 0, 0).Vehicle Tail Light Color getZwraca rodzaj pojazdu (angielską nazwę):Vehicle Type Automobile,Bike,BMX,Quad,Monster Truck,Boat,Helicopter,Plane,Train,Trailer. Przyjmuje pojazd albo numer modelu.getZwraca rodzaj pojazdu dla numeru modelu (jakVehicle Type From Model getVehicleType). Nowy model zengineRequestModelma typ swojego modelu bazowego.getZwraca nazwy wszystkich rodzajów pojazdów, posortowane alfabetycznie.Vehicle Type Names getZwraca ID części zamontowanej w danym slocie tuningu albo 0, gdy slot jest pusty. Numery slotów 0-16 opisujeVehicle Upgrade On Slot getVehicleUpgradeSlotName.getZwraca listę ID wszystkich części tuningu zamontowanych w pojeździe. Działa po obu stronach.Vehicle Upgrades getZwraca numer slotu tuningu (0-16), do którego należy część.Vehicle Upgrade Slot getZwraca angielską nazwę slotu tuningu, podając numer slotu albo ID części. Sloty: 0 Hood, 1 Vent, 2 Spoiler, 3 Sideskirt, 4 Front Bullbars, 5 Rear Bullbars, 6 Headlights, 7 Roof, 8 Nitro, 9 Hydraulics, 10 Stereo, 11 Unknown, 12 Wheels, 13 Exhaust, 14 Front Bumper, 15 Rear Bumper, 16 Misc.Vehicle Upgrade Slot Name getZwraca nazwy wszystkich 17 slotów tuningu w kolejności numerów (pierwszy element = slot 0).Vehicle Upgrade Slot Names getZwraca dwa warianty wyglądu pojazdu (255 = brak). Działa po obu stronach.Vehicle Variant getNoweZwraca mnożnik przyczepności kół pojazdu (iloczyn mnożników wszystkich zasobów, 1 = zwykła).Vehicle Wheel Grip getZwraca stan czterech kół pojazdu w kolejności: przednie lewe, tylne lewe, przednie prawe, tylne prawe (0 całe, 1 przebite, 2 odpadnięte).Vehicle Wheel States getNoweZwraca przyciemnienie szyb pojazdu w procentach (0 = zwykłe szyby), a jeśli ustawiono kolor - także jego składniki r, g, b.Vehicle Window Tint isSprawdza, czy numer jest modelem pojazdu: 400-611 z gry albo nowy pojazd zarejestrowany przezValid Vehicle Model engineRequestModel.isSprawdza, czy pojazd jest wrakiem, czyli został zniszczony (Vehicle Blown blowVehiclealbo wybuch w grze) i jeszcze nie naprawiony ani odrodzony. Wraku nie da się prowadzić.isSprawdza, czy drzwi pojazdu są zamknięte przezVehicle Locked setVehicleLocked.isZwraca, czy nitro zostało włączone przezVehicle Nitro Activated setVehicleNitroActivated.isZwraca, czy nitro się ładuje.Vehicle Nitro Recharging isZwraca, czy pojazd stoi kołami na ziemi.Vehicle On Ground isSprawdza, czy lampka „TAXI” pojazdu jest zapalona. Działa po obu stronach.Vehicle Taxi Light On isZwraca, czy koło dotyka ziemi.Vehicle Wheel On Ground removeZdejmuje z pojazdu zamontowaną część tuningu. Zdjęcie nitro kasuje też zapisane ładunki nitro.Vehicle Upgrade setUstawia kolory lakieru pojazdu dowolnymi barwami RGB, widoczne u wszystkich graczy. Pojazd ma do czterech kolorów: 1 = główny lakier, 2 = drugi kolor (pasy, dach, felgi zależnie od modelu), 3 i 4 = dodatkowe elementy niektórych modeli. Podaj tylko pierwsze trzy liczby, a drugi kolor będzie taki sam jak pierwszy. Kolory, których nie ma w palecie gry, są rysowane dokładnie, bez zaokrąglania do palety.Vehicle Color setPokazuje albo chowa nazwaną część modelu pojazdu. Na serwerze zmiana dotyczy wszystkich graczy na kliencie tylko lokalnego gracza i ma pierwszeństwo przed ustawieniem serwera. Działa na ramkach modelu z pliku (Vehicle Component Visible engineReplaceModel): warianty autora (spoiler_1,extra1…), drzwi, maska, zderzaki. Listę nazw dla danego pojazdu dajegetVehicleComponentspo stronie klienta.setWłącza albo wyłącza silnik pojazdu u wszystkich graczy. Z wyłączonym silnikiem pojazd nie jedzie, nawet gdy kierowca wciska gaz (może się jedynie toczyć). Domyślnie silnik zapala się sam, gdy kierowca wsiada; poVehicle Engine State setWorldSpecialPropertyEnabled("vehicle_engine_autostart", false)tak się nie dzieje i serwer RP może zrobić własny zapłon pod klawiszem albo komendą.setZmienia parametry jazdy (handling) jednego pojazdu u wszystkich graczy: masę, prędkość maksymalną, przyspieszenie, przyczepność, hamulce, skręt, zawieszenie i inne pola z handling.cfg. Gra dostaje własną kopię wpisu handlingu dla tego auta, więc inne pojazdy tego modelu się nie zmieniają. Można podać jedno pole z wartością, całą tabelę pól alboVehicle Handling nil, żeby wrócić do handlingu fabrycznego (z uwzględnieniemsetModelHandling). Nazwy pól, lista:getHandlingFieldNames.setZamyka albo otwiera drzwi pojazdu u wszystkich graczy. Do zamkniętego pojazdu gracze nie mogą wsiąść (gra nie rozpocznie wsiadania). Osoby już siedzące w środku mogą normalnie wysiąść.Vehicle Locked setZmienia średnicę kół modelu pojazdu. Na kliencie zmienia koła pojazdów z własnym modelem (Vehicle Model Wheel Size engineReplaceModel) u tego gracza; koła aut z gry zostają bez zmian. Na serwerze tylko zapamiętuje wartość dla skryptów.setWymusza stan świateł pojazdu u wszystkich graczy. W Trilogy Hub gra sama nie zapala świateł o zmroku, więc reflektory świecą tylko po ustawieniu 2. Pojedyncze lampy (stop, cofania, kierunkowskazy) ustawiaVehicle Override Lights setVehicleLampState.setZmienia tekst tablicy rejestracyjnej pojazdu, widoczny u wszystkich graczy. Tablica mieści najwyżej 8 znaków; dłuższy tekst zostanie obcięty. Używaj liter, cyfr i spacji, bo tylko takie znaki ma czcionka tablic w grze.Vehicle Plate Text
Zdarzenia serwera 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.
Zdarzenia klienta 2
onPojazd stracił zdrowie w Twojej grze: od zderzenia, strzałów, wybuchu, ognia albo zmiany zdrowia ze skryptu. Dotyczy każdego pojazdu, który Twoja gra zna, także aut innych graczy. Gra sprawdza zdrowie pojazdów 10 razy na sekundę i tylko wtedy, gdy któryś skrypt nasłuchuje tego zdarzenia; kilka szybkich uszkodzeń w tym czasie przychodzi jako jedna strata.Client Vehicle Damage onPojazd wybuchł (Client Vehicle Explode blowVehiclealbo wybuch zgłoszony przez jego właściciela). Przychodzi w tej samej chwili u wszystkich, tuż przedonClientExplosion.