Dodawanie światełek ELS

Światełka ELS są konfigurowane bezpośrednio w pliku ustawień zasobu tW_ELS.

Aby dodać nowe światełka dla danego pojazdu, należy edytować plik:

Plik konfiguracyjny
tW_ELS/sh_settings.lua

Światełka przypisywane są do konkretnego modelu pojazdu za pomocą jego ID.

Szybka instrukcja

Aby dodać nowe światełka ELS:

Otwórz zasób tW_ELS.
Przejdź do pliku sh_settings.lua.
Znajdź tablicę settings.vehiclesELSPosition.
Dodaj ID pojazdu w formie [id].
Dodaj pozycje światełek w lightPosition.
Ustaw kolor światełek w lightColor.
Ustaw wielkość światełek w lightSize.
Ustaw sekwencję działania w lightSequence.
Zapisz plik.
Zrestartuj zasób tW_ELS.

info

Konfiguracja światełek ELS korzysta ze zwykłych tablic Lua.
Nie trzeba używać JSON-a ani narzędzia tableToJSON.

warning

Pamiętaj, aby każdy wpis w tablicy kończył się przecinkiem.
Brak przecinka może spowodować błąd w konfiguracji.

Struktura konfiguracji

Światełka ELS znajdują się w tablicy:

sh_settings.lua
settings.vehiclesELSPosition

Każdy pojazd posiada osobną konfigurację przypisaną do jego ID.

Przykładowa struktura dla kilku pojazdów:

Przykładowa konfiguracja światełek ELS
settings = {
    vehiclesELSPosition = {
        [id] = {
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 2 },
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 2 },
        },

        [id] = {
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { x, y, z }, lightColor = { r, g, b }, lightSize = 1, lightSequence = 2 },
        },
    }
}

tip

Jedno ID pojazdu może posiadać dowolną liczbę światełek.
Każde światełko dodaje się jako osobny wpis w tablicy danego pojazdu.

Opis wymaganych pól

Poniżej znajduje się opis pól używanych przy dodawaniu światełek ELS.

`[id]`

Pole [id] określa ID pojazdu, dla którego mają działać dane światełka.

Przykład:

ID pojazdu
[596] = {
    -- światełka pojazdu
}

W tym przykładzie światełka zostaną przypisane do pojazdu o ID 596.

info

ID pojazdu wpisuje się w nawiasach kwadratowych, na przykład [596].

`lightPosition`

Pole lightPosition określa pozycję światełka względem pojazdu.

Pozycja składa się z trzech wartości:

Wartość	Znaczenie
`x`	Przesunięcie na osi X
`y`	Przesunięcie na osi Y
`z`	Przesunięcie na osi Z

Przykład:

Pozycja światełka
lightPosition = { 0.5, 1.2, 0.8 }

warning

Pozycja światełka jest relatywna względem pojazdu.
Na serwerze nie ma edytora do ustawiania tych pozycji, więc wartości trzeba dobrać metodą prób i błędów.

`lightColor`

Pole lightColor określa kolor światełka.

Kolor składa się z trzech wartości w formacie RGB:

Wartość	Znaczenie
`r`	Ilość koloru czerwonego
`g`	Ilość koloru zielonego
`b`	Ilość koloru niebieskiego

Przykład czerwonego światła:

Czerwone światło
lightColor = { 255, 0, 0 }

Przykład niebieskiego światła:

Niebieskie światło
lightColor = { 0, 0, 255 }

tip

Wartości kolorów RGB najczęściej mieszczą się w zakresie od 0 do 255.

`lightSize`

Pole lightSize określa wielkość światełka.

Przykład:

Wielkość światełka
lightSize = 1

Im większa wartość, tym większe będzie światełko.

tip

Najlepiej zacząć od wartości 1, a następnie zwiększać lub zmniejszać ją w zależności od efektu w grze.

`lightSequence`

Pole lightSequence określa sekwencję działania światełka.

Światła przełączają się między sekwencją 1 oraz 2. Dzięki temu można ustawić światełka, które migają naprzemiennie.

Dostępne podstawowe wartości:

Wartość	Znaczenie
`1`	Pierwsza sekwencja świateł
`2`	Druga sekwencja świateł

Przykład:

Sekwencja światełka
lightSequence = 1

Jeżeli chcesz, aby dwa światełka działały naprzemiennie, ustaw jednemu lightSequence = 1, a drugiemu lightSequence = 2.

info

Ilość światełek w jednej sekwencji nie jest limitowana.
Możesz dodać kilka światełek z tą samą sekwencją.

Przykład dodania jednego pojazdu

Poniżej znajduje się przykład konfiguracji światełek dla jednego pojazdu:

sh_settings.lua
settings = {
    vehiclesELSPosition = {
        [596] = {
            { lightPosition = { -0.5, 1.2, 0.8 }, lightColor = { 255, 0, 0 }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { 0.5, 1.2, 0.8 }, lightColor = { 0, 0, 255 }, lightSize = 1, lightSequence = 2 },
        },
    }
}

W tym przykładzie:

światełka są przypisane do pojazdu o ID 596,
pierwsze światełko ma kolor czerwony,
drugie światełko ma kolor niebieski,
światła będą działać naprzemiennie.

Przykład kilku światełek w jednej sekwencji

Poniżej znajduje się przykład, w którym dwa światełka działają w sekwencji 1, a dwa kolejne w sekwencji 2.

sh_settings.lua
settings = {
    vehiclesELSPosition = {
        [596] = {
            { lightPosition = { -0.6, 1.2, 0.8 }, lightColor = { 255, 0, 0 }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { -0.3, 1.2, 0.8 }, lightColor = { 255, 0, 0 }, lightSize = 1, lightSequence = 1 },

            { lightPosition = { 0.3, 1.2, 0.8 }, lightColor = { 0, 0, 255 }, lightSize = 1, lightSequence = 2 },
            { lightPosition = { 0.6, 1.2, 0.8 }, lightColor = { 0, 0, 255 }, lightSize = 1, lightSequence = 2 },
        },
    }
}

W tym przykładzie:

dwa czerwone światełka działają w sekwencji 1,
dwa niebieskie światełka działają w sekwencji 2,
sekwencje będą przełączać się naprzemiennie.

Przykład dodania kilku pojazdów

Aby dodać światełka dla kilku pojazdów, należy dodać kolejne ID pojazdów w tablicy vehiclesELSPosition.

sh_settings.lua
settings = {
    vehiclesELSPosition = {
        [596] = {
            { lightPosition = { -0.5, 1.2, 0.8 }, lightColor = { 255, 0, 0 }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { 0.5, 1.2, 0.8 }, lightColor = { 0, 0, 255 }, lightSize = 1, lightSequence = 2 },
        },

        [597] = {
            { lightPosition = { -0.4, 1.1, 0.75 }, lightColor = { 255, 0, 0 }, lightSize = 1, lightSequence = 1 },
            { lightPosition = { 0.4, 1.1, 0.75 }, lightColor = { 0, 0, 255 }, lightSize = 1, lightSequence = 2 },
        },
    }
}

Każdy wpis [id] oznacza osobną konfigurację światełek dla danego modelu pojazdu.

Podsumowanie

Aby dodać światełka ELS:

Edytuj plik tW_ELS/sh_settings.lua.
Znajdź tablicę settings.vehiclesELSPosition.
Dodaj ID pojazdu w formie [id].
Dodaj wpisy światełek dla danego pojazdu.
Ustaw pozycję relatywną w lightPosition.
Ustaw kolor RGB w lightColor.
Ustaw wielkość w lightSize.
Ustaw sekwencję w lightSequence.
Pamiętaj o przecinku po każdym wpisie.
Zapisz plik i zrestartuj zasób tW_ELS.

Najważniejsze pola:

Pole	Za co odpowiada
`[id]`	ID pojazdu, dla którego działają światełka
`lightPosition`	Pozycja światełka względem pojazdu
`lightColor`	Kolor światełka w formacie RGB
`lightSize`	Wielkość światełka
`lightSequence`	Sekwencja działania światełka

info

Konfiguracja światełek ELS korzysta ze zwykłych tablic Lua.
Nie trzeba konwertować jej do JSON-a.

Szybka instrukcja​

Struktura konfiguracji​

Opis wymaganych pól​

[id]​

lightPosition​

lightColor​

lightSize​

lightSequence​

Przykład dodania jednego pojazdu​

Przykład kilku światełek w jednej sekwencji​

Przykład dodania kilku pojazdów​

Podsumowanie​

Szybka instrukcja

Struktura konfiguracji

Opis wymaganych pól

`[id]`

`lightPosition`

`lightColor`

`lightSize`

`lightSequence`

Przykład dodania jednego pojazdu

Przykład kilku światełek w jednej sekwencji

Przykład dodania kilku pojazdów

Podsumowanie