Skrypt windy FiveM: Poradnik konfiguracji Agency-Elevator 2026

Czym jest skrypt windy w FiveM?

Skrypt windy FiveM to niestandardowy zasób, który dodaje funkcjonalne, interaktywne windy do wielopiętrowych budynków na twoim serwerze roleplay. Bez dedykowanego skryptu windy gracze na serwerach GTA V / FiveM nie mają realistycznego sposobu poruszania się między piętrami w wysokich budynkach, są zmuszeni do korzystania ze schodów, komend teleportacji lub topornych obejść, które natychmiast psują immersję.

Prawidłowy skrypt windy wyświetla graczom panel UI w grze po wejściu do strefy windy. Gracze wybierają piętro docelowe, drzwi zamykają się z animacją, kamera lub postać płynnie przemieszcza się na docelowy poziom, odtwarzają się efekty dźwiękowe, a po dotarciu na miejsce drzwi otwierają się ponownie. Cała interakcja sprawia wrażenie integralnej części świata gry, a nie doklejonej na siłę mechaniki.

Dla serwerów serious roleplay, kompleksów apartamentów, szpitali, komend policji, biur w wieżowcach czy parkingów, dobry skrypt windy to żaden luksus. To różnica między budynkiem, który tętni życiem, a takim, który sprawia wrażenie pustej makiety. W 2026 roku Agency-Elevator od Agency Scripts stał się wiodącym darmowym rozwiązaniem społeczności, a ten poradnik omawia wszystko, co musisz wiedzieć, aby uruchomić go na swoim serwerze.

Dlaczego potrzebujesz Agency-Elevator

Na forach społeczności FiveM i na GitHubie można znaleźć kilka skryptów wind, ale większość z nich cierpi na co najmniej jeden poważny problem: przestarzały kod psujący się na nowoczesnych kompilacjach FiveM, brak aktywnego wsparcia, sztywno wpisane współrzędne pięter, brak panelu NUI lub słaba obsługa animacji powodująca przenikanie graczy przez tekstury.

Agency-Elevator został stworzony, aby czysto rozwiązać wszystkie te problemy. Jest aktywnie rozwijany przez zespół Agency Scripts, w pełni udokumentowany i, co kluczowe, całkowicie darmowy. Możesz pobrać go bezpośrednio ze sklepu Tebex bez żadnych kosztów i zobowiązań. Oto dlaczego się wyróżnia:

• Obsługa wielu pięter: Zdefiniuj tyle pięter, ile ma Twój budynek. Skrypt nie ma na stałe wpisanego sztywnego limitu.
• Płynne animacje: Skrypt wykorzystuje natywne animacje GTA V oraz precyzyjnie zsynchronizowane teleportacje, dzięki czemu gracze nie widzą gwałtownych przeskoków pozycji.
• Panel wyboru piętra NUI: Przejrzysta, lekka nakładka w przeglądarce pokazuje bieżące piętro i pozwala graczom kliknąć lub nacisnąć przycisk, aby wybrać cel podróży.
• Efekty dźwiękowe: Dźwięk dzwonka windy, otwierania/zamykania drzwi oraz odgłosy ruchu są dostępne od razu po instalacji.
• W pełni konfigurowalne: Każdy budynek, każdy szyb windy, współrzędne każdego piętra, etykieta każdego piętra, wszystko zdefiniowane w pojedynczym Config.lua plik.
• Niezależny od frameworka: Działa z QBCore, ESX oraz w pełni samodzielnymi konfiguracjami Standalone. Domyślnie brak zależności od frameworka.
• Zerowy koszt: ZA DARMO, bez opłat, bez escrow, bez subskrypcji Tebex poza darmowym kontem.

Szczegółowe omówienie funkcji

Budynki wielopiętrowe

Każda winda w Agency-Elevator jest zdefiniowana jako wpis tabeli w konfiguracji. Określasz strefę aktywacji (gdzie gracz staje, aby wezwać windę), a następnie wymieniasz każde piętro wraz z jego nazwą, współrzędnymi docelowymi (x, y, z, heading) i opcjonalnie ograniczeniem dostępu. Możesz definiować windy dla dowolnej liczby budynków w jednym zasobie: szpital, komenda policji, blok mieszkalny, wieżowiec kasyna, wszystko zarządzane z jednego miejsca.

Panel NUI

Gdy gracz wchodzi w strefę aktywacji windy, pojawia się pływający panel NUI. Wyświetla listę wszystkich dostępnych pięter wraz z ich etykietami (np. "Parter", "2. piętro, apartamenty", "Dach"). Gracze klikają miejsce docelowe lub nawigują za pomocą klawiatury. Panel jest ostylowany zgodnie z językiem projektowym Agency Scripts, ale można go w pełni dostosować za pomocą plików NUI HTML/CSS, jeśli chcesz dopasować go do brandingu swojego serwera.

Animacje i dźwięk

Agency-Elevator po wybraniu piętra odtwarza animację i dźwięk zamykania drzwi, a następnie płynnie teleportuje gracza na piętro docelowe po skonfigurowanym opóźnieniu. Po dotarciu na miejsce odtwarzany jest dźwięk otwierania drzwi, a panel znika. Wszystkie czasy animacji i dźwięków można skonfigurować w Config.lua aby móc dopasować wrażenia do prędkości windy w Twoim budynku.

Ograniczenia dostępu

Poszczególne piętra można zablokować za pomocą weryfikacji pracy (QBCore/ESX) lub weryfikacji przedmiotu. Na przykład możesz ograniczyć dostęp do penthouse'u w apartamentowcu tylko dla graczy posiadających klucz do penthouse'u albo zablokować piętro z serwerownią dla policji lub rangi staff. Gdy gracz spróbuje wybrać zablokowane piętro bez wymaganej pracy lub przedmiotu, pojawi się powiadomienie, a winda nie ruszy.

Konfigurowalne strefy aktywacji

Każdy trigger windy jest zdefiniowany przez pozycję 3D i promień. Opcjonalnie możesz też dodać znacznik (blip), aby nowi gracze mogli znaleźć windę pieszo. Znaczniki można wyłączyć na serwerach preferujących czystą minimapę.

Instalacja: krok po kroku

Krok 1: Pobierz Agency-Elevator

Przejdź do oferty na Tebex pod adresem agency-script.tebex.io/package/7285036 i dodaj Agency-Elevator do koszyka. Jest DARMOWY, wystarczy dokończyć zamówienie z zerową kwotą. Otrzymasz link do pobrania przez system dostarczania Tebex (połączony z Twoim kontem CFX lub udostępniony jako bezpośrednie pobranie).

Krok 2: Umieść zasób

Rozpakuj pobrane archiwum i umieść agency-elevator folder wewnątrz katalogu twojego serwera resources katalogu (lub podfolderze takim jak resources/[scripts]/).

Krok 3: Dodaj do server.cfg

Otwórz swój server.cfg i dodaj następującą linijkę w dowolnym miejscu po zasobie frameworku:

ensure agency-elevator

Krok 4: Skonfiguruj Config.lua

Otwórz agency-elevator/config/Config.lua i skonfiguruj swoje windy. Zobacz sekcję poniżej, aby zapoznać się z pełnym przykładem. Wymagane minimum to ustawienie frameworku i zdefiniowanie co najmniej jednej windy z co najmniej dwoma piętrami.

Krok 5: Uruchom serwer

Zrestartuj serwer (lub użyj refresh + start agency-elevator w konsoli serwera). Podejdź w grze do dowolnej strefy aktywacji windy, a panel NUI powinien się pojawić. Sprawdź konsolę serwera pod kątem komunikatów o błędach, jeśli panel się nie pojawi: większość problemów wynika z niezgodności współrzędnych w konfiguracji.

Przykład Config.lua

Poniżej znajduje się przykładowy wariant konfiguracji Agency-Elevator. Dopasuj współrzędne do mapy i wnętrz budynków Twojego serwera:

-- Agency-Elevator: Config.lua

Config = {}

-- Framework: "standalone", "qbcore", or "esx"
Config.Framework = "qbcore"

-- Show floor markers on the minimap
Config.ShowBlips = false

-- Default floor label shown when no floor is selected
Config.DefaultFloorLabel = "Select Floor"

-- Elevator transition delay in milliseconds (door close → teleport)
Config.TransitionDelay = 1500

-- Enable NUI debug mode (shows borders on the panel)
Config.Debug = false

-- Define your elevators
Config.Elevators = {
    {
        name = "Mission Row PD - Elevator",
        -- Zone where players stand to call the elevator
        trigger = { x = 441.6, y = -982.3, z = 30.7, radius = 1.5 },
        floors = {
            { label = "Ground Floor",    coords = { x = 441.6, y = -982.3, z = 30.7,  h = 90.0 } },
            { label = "2nd Floor",       coords = { x = 441.6, y = -982.3, z = 34.7,  h = 90.0 } },
            { label = "3rd Floor",       coords = { x = 441.6, y = -982.3, z = 38.7,  h = 90.0 } },
            {
                label = "Roof Access",
                coords = { x = 441.6, y = -982.3, z = 50.7, h = 90.0 },
                -- Restrict to police jobs only
                jobRestrict = { "police", "sheriff" },
            },
        },
    },
    {
        name = "Alta Apartments - Elevator",
        trigger = { x = -268.4, y = -955.8, z = 31.2, radius = 1.5 },
        floors = {
            { label = "Lobby",       coords = { x = -268.4, y = -955.8, z = 31.2, h = 0.0  } },
            { label = "Floor 2",     coords = { x = -268.4, y = -955.8, z = 35.2, h = 0.0  } },
            { label = "Floor 3",     coords = { x = -268.4, y = -955.8, z = 39.2, h = 0.0  } },
            {
                label = "Penthouse",
                coords = { x = -268.4, y = -955.8, z = 48.0, h = 0.0 },
                -- Restrict to players who own this item
                itemRestrict = "penthouse_key",
            },
        },
    },
}

Kompatybilność z frameworkami

Ustawienie Config.Framework = "standalone" sprawia, że Agency-Elevator działa bez żadnych zależności od QBCore lub ESX. Wybór piętra i panel NUI działają idealnie w trybie standalone; jedynymi funkcjami wymagającymi frameworka są opcjonalne kontrole ograniczeń prac i przedmiotów dla poszczególnych pięter. Jeśli ustawisz Config.Framework = "qbcore" lub "esx", skrypt ładuje odpowiedni bridge, aby sprawdzić pracę gracza i przedmioty w eq, gdy wybrane zostanie zastrzeżone piętro.

Dokumentacja i wsparcie

Pełna dokumentacja, w tym wszystkie opcje konfiguracji, wskazówki dotyczące współrzędnych, personalizacja NUI oraz FAQ, jest dostępna na docs.agencyg.de/elevator. Jeśli napotkasz problemy, serwer Discord Agency Scripts to najszybszy sposób na uzyskanie pomocy od programisty i społeczności.

Cena: całkowicie za darmo

Agency-Elevator kosztuje DARMOWY. Nie ma w tym żadnego haczyka, żadnej blokady escrow, subskrypcji ani poziomu premium odblokowującego ukryte funkcje. Pełny skrypt ze wszystkimi funkcjami opisanymi w tym artykule jest dostępny całkowicie za darmo. W ten sposób Agency Scripts odwdzięcza się społeczności FiveM, prezentując jednocześnie jakość oferty Agency Scripts. Otrzymujesz tę samą jakość wykonania i aktywne wsparcie, co w przypadku płatnych skryptów, bez ponoszenia jakichkolwiek kosztów.

Dla porównania: wiele porównywalnych zasobów wind na forum CFX jest albo nieutrzymywanych, closed-source, albo kosztuje kilka euro za funkcjonalność, którą Agency-Elevator oferuje za darmo. Jeśli odkładałeś dodanie wind na swój serwer z obawy o koszty lub jakość, teraz nie masz już powodu, aby czekać.

Kto powinien zainstalować Agency-Elevator?

Agency-Elevator to właściwy wybór dla każdego serwera FiveM, który posiada:

• Budynki z wielopiętrowym wnętrzem, szpitale, komisariaty policji, sądy, biurowce, kompleksy apartamentowe, parkingi wielopoziomowe
• Społeczności Serious RP które dbają o immersję i nie chcą, aby gracze teleportowali się lub używali komend czatu do zmiany pięter
• Konfiguracja dowolnego frameworka, QBCore, ESX lub w pełni niestandardowe buildy standalone działają od razu po instalacji
• Serwery z ograniczonym budżetem, nic nie kosztuje, więc nie ma żadnej bariery finansowej dla dopracowanego systemu wind

Zacznij już teraz

Pobranie dzieli tylko jedno kliknięcie. Odwiedź ofertę na Tebex, zrealizuj darmowe zamówienie, wrzuć zasób na swój serwer, dodaj ensure agency-elevator do Twojego server.cfg, skonfiguruj piętra i gotowe. Pełna konfiguracja dla pojedynczego budynku zajmuje zazwyczaj mniej niż 15 minut. Szczegółowa dokumentacja na docs.agencyg.de/elevator przeprowadzi cię przez każdą opcję, jeśli potrzebujesz pomocy.