Agency-Repairkit: Proste naprawy pojazdów, z których gracze naprawdę korzystają

Problem napraw w terenie

Twój pojazd zostaje uszkodzony w trakcie misji. Warsztat mechanika jest 10 minut stąd. Taka jazda zabija tempo każdej sceny akcji, w której brałeś udział. Natomiast natychmiastowa autonaprawa wydaje się niesprawiedliwa. Agency-Repairkit znajduje złoty środek dzięki zdatnym do użycia, lecz ograniczonym narzędziom naprawy w terenie.

Trzy poziomy zestawów

Podstawowe zestawy szybko naprawiają małe uszkodzenia. Zaawansowane zestawy naprawiają średnie uszkodzenia wolniej. Profesjonalne zestawy radzą sobie z poważnymi uszkodzeniami, ale ich użycie trwa zauważalnie dłużej. Podział na poziomy daje graczom realny wybór w zależności od ich ekwipunku i sytuacji, w jakiej się znajdują.

Integralność animacji

Każda naprawa wykorzystuje widoczną animację przy uszkodzonym obszarze pojazdu. Gracze nie mogą wykonać szybkiej naprawy z fotela kierowcy, muszą wysiąść, podejść do uszkodzenia i poświęcić czas na animację naprawy. Zapobiega to nadużywaniu napraw w trakcie walki i sprawia, że naprawa daje satysfakcję.

Przerwanie ma znaczenie

Otrzymanie obrażeń lub trafienie podczas naprawy przerywa ją i zużywa zestaw. Naprawy odbywają się poza walką, a nie w jej trakcie. Zapobiega to zamianie pościgów w niekończącą się grę, w której żadne uszkodzenie nie ma trwałego skutku.

Integracja z ekonomią

Zestawy naprawcze mogą być wytwarzane przez NPC mechaników lub graczy mechaników za pośrednictwem łańcucha dostaw metali z Agency-Minerjob. Cała gospodarka motoryzacyjna: górnictwo, crafting, naprawy w terenie i warsztacie, staje się połączoną siecią. Zestawy nie są jednorazowym przedmiotem, to węzeł w większym systemie.

Instalacja & konfiguracja

Pobierz Agency-Repairkit ze swojej biblioteki Tebex i przenieś folder do katalogu resources. Dodaj ensure agency-repairkit do server.cfg. Resource wymaga oxmysql, jeśli chcesz zachować trwałe śledzenie zestawów między restartami: bez tego ilości zestawów dotyczą tylko bieżącej sesji i resetują się po restarcie serwera.

Przedmioty zestawów muszą zostać zarejestrowane na liście przedmiotów twojego frameworka. Plik config zawiera poprawne nazwy przedmiotów dla QBCore i ESX. W przypadku konfiguracji standalone hook rejestracji przedmiotów to pojedyncze wywołanie funkcji w config.lua.

Opcje konfiguracji

Ten config.lua daje pełną kontrolę nad zachowaniem zestawu:

• Poziomy zestawów, zdefiniuj dowolną liczbę typów zestawów, każdy z maksymalną wartością naprawy, szybkością naprawy i czasem trwania animacji.
• Combat lock, czy naprawy mogą być rozpoczynane, gdy gracz ma flagę walki. Domyślnie: wyłączone podczas walki.
• Próg obrażeń do przerwania, jaka ilość otrzymanych obrażeń przerywa aktywną naprawę. Ustaw 0, aby każde trafienie ją anulowało.
• Animacja na strefę uszkodzeń, różne animacje odtwarzają się dla uszkodzeń silnika, karoserii i opon.
• Integracja z ekonomią, włącz hook zdarzenia craftingu, aby urobek metali z Agency-Minerjob mógł zasilać tworzenie zestawów.

Kompatybilność z frameworkami

Agency-Repairkit zawiera wbudowane adaptery dla QBCore i ESX. Wykrywanie frameworka jest automatyczne: wrzucasz zasób, a on sam wykrywa, z czego korzystasz. Dla serwerów standalone:

• Wdróż Config.GetItem i Config.RemoveItem aby połączyć swój system przedmiotów.
• Wdróż Config.GetVehicleHealth i Config.SetVehicleHealth dla twojej warstwy uszkodzeń pojazdu.
• Wszystko inne (animacje, UI, logika przerywania) działa bez zmian.

Dlaczego ma to znaczenie dla roleplay

Uszkodzenia pojazdów są jednym z najczęstszych źródeł zgrzytów w RP. Gdy misja pójdzie nie tak 15 minut drogi od najbliższego mechanika, gracze stają przed wyborem: wlec się uszkodzonym autem i psuć tempo, poddać się i użyć szybkiej podróży, albo skorzystać z sensownej opcji naprawy w terenie. Zestawy naprawcze dają trzecią drogę, która daje satysfakcję, nie będąc przy tym darmowa.

Wielopoziomowy system zestawów tworzy naturalne decyzje ekonomiczne dotyczące ekwipunku. Czy nosisz profesjonalny zestaw "na wszelki wypadek" i ponosisz koszty miejsca? Czy polegasz na podstawowych zestawach i akceptujesz, że poważne uszkodzenia będą wymagać wizyty w warsztacie? To właśnie takie znaczące mikrodecyzje sprawiają, że zarządzanie ekwipunkiem wydaje się realistyczne, a nie arbitralne.

Mechanika przerywania przez walkę jest szczególnie ważna podczas pościgów RP. Bez niej ścigany gracz mógłby naprawić auto w trakcie ucieczki, co całkowicie niszczy napięcie. Dzięki niej naprawy są czynnością wykonywaną po starciu lub między scenami, a nie przyciskiem ratunkowym.

Często zadawane pytania

Czy mechanicy mogą sprzedawać zestawy naprawcze ze swojego menu?

Tak. Agency-Repairkit eksportuje event po stronie serwera agency-repairkit:giveKit który może wywołać dowolny skrypt mechanika. Przekaż server ID gracza, poziom zestawu i ilość. Twój istniejący skrypt warsztatu mechanika potrzebuje tylko dodania jednego wywołania eventu do swojej procedury sprzedaży.

Czy zestaw działa na łodziach i statkach powietrznych?

Tak. System uszkodzeń korzysta z natywnych właściwości stanu pojazdu w FiveM, które mają zastosowanie do wszystkich typów pojazdów. Statki powietrzne używają uproszczonej animacji (gracze nie mogą podejść do określonej strefy uszkodzeń w trakcie lotu), a łodzie naprawia się z poziomu doku. Oba zachowania można skonfigurować.

Czy mogę ograniczyć poziomy zestawów dla określonych prac?

Dostęp do zestawu na podstawie pracy jest obsługiwany w definicji przedmiotu. Ustaw requiredJob = 'mechanic' do typu zestawu i tylko gracze z tą pracą mogą go używać. Jest to przydatne, jeśli chcesz, aby profesjonalne zestawy były narzędziem dostępnym wyłącznie dla mechaników, a nie towarem możliwym do kupienia.

Jak zestaw współpracuje ze skryptami respawnu pojazdów?

Agency-Repairkit wywołuje agency-repairkit:onRepairComplete z netId pojazdu i wartością naprawy po udanym użyciu zestawu. Każdy skrypt nasłuchujący tego zdarzenia może odpowiednio zareagować, twój skrypt zapisu pojazdów może oznaczyć pojazd jako naprawiony w terenie na potrzeby logów.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql (opcjonalnie, do trwałego śledzenia zestawów)
• konto cfx.re z ważną licencją Agency-Repairkit
• Rejestracja przedmiotów z zestawów w frameworku

Balansowanie zestawów naprawczych w ekonomii twojego serwera

Pytanie ekonomiczne, które serwery zadają najczęściej w kontekście Agency-Repairkit, brzmi: jak rzadkie powinny być zestawy naprawcze? Odpowiedź zależy od istniejącego balansu ekonomii na twoim serwerze.

Jeśli twój serwer ma aktywne warsztaty mechaniczne z dobrym roleplayem, zapewnij rozsądną dostępność zestawów podstawowych i zaawansowanych, ale spraw, by zestawy profesjonalne były rzadkie lub dostępne wyłącznie dla mechaników. Przenosi to poważniejsze naprawy z powrotem do warsztatów, pozwalając jednocześnie na drobne naprawy w terenie i utrzymując sens RP mechanika.

Jeśli twój serwer ma problem z zaangażowaniem graczy w pracy mechanika, zmniejsz dostępność zestawów terenowych i zadbaj o to, aby zestawy wytwarzane przez mechaników były lepsze od tych dostępnych w sklepach. Ekonomiczna zachęta do odwiedzenia gracza mechanika musi być realna, a nie tylko narracyjna.

Jeśli twój serwer ma silną gospodarkę przestępczą, ceny zestawów rzemieślniczych w Agency-Blackmarket lub crafting graczy tworzą równoległy rynek. Zestawy naprawcze klasy wojskowej jako przedmioty z czarnego rynku generują ciekawy RP logistyczny, nie niszcząc rynku mechaników cywilnych.

Kluczowa zasada: naprawa w terenie powinna być przydatną opcją, a nie tą optymalną. Jeśli gracze w ogóle nie odwiedzają warsztatów mechaników, twoje zestawy są zbyt mocne lub zbyt tanie. Dostosowuj wydajność i cenę jednocześnie, a nie pojedynczo.