Faction

Frakcje, które tworzysz w całości w grze: każda frakcja to prawdziwy job z menu szefa, garażami, magazynami, szafą, windą, poziomami, menu akcji i systemem gangwaru. Tabele skrypt tworzy sam.

Funkcje

• Kreator (/fraktionen): Tworzysz w grze frakcje z rangami, pensją, pojazdami, miejscami (marker lub NPC), blipami i dostępem od danej rangi.
• Menu szefa: Zarządzanie członkami, kasa z historią, kupno pojazdów, uprawnienia dla każdej rangi, podania i logi.
• Podania: Gracze składają podania do frakcji w punktach podań (NPC lub marker z kreatora), zarząd przyjmuje lub odrzuca je w menu szefa.
• GPS: Członkowie widzą się na mapie, z osobną ikoną pieszo, w aucie, na motocyklu lub rowerze, w łodzi, helikopterze lub samolocie, podczas pływania i po śmierci (wł./wył. dla każdej frakcji).
• Pojazdy frakcji ze stylem: własny prefiks tablicy, lakier i xenon w kolorze frakcji, maksymalny tuning i przyciemniane szyby. Z kluczykiem do zamykania i otwierania.
• Garaże i magazyny: do 10 każdego rodzaju na frakcję, dostęp od danej rangi.
• Szafa, winda (do 10 pięter) i poziomy z XP (wł./wył. dla każdej frakcji).
• Menu akcji (F6): Kajdanki, przeszukiwanie, identyfikacja, prowadzenie i akcje na pojazdach, do wyboru dla każdej frakcji.
• Gangwar: Strefy tworzone w grze, tryby Limit czasu i First Contact, własny wymiar, sklep i ranking.
• Logi na Discordzie dla wszystkich obszarów.

Instalacja

1. Wrzuć folder off_faction do resources.
2. Dodaj do server.cfg po oxmysql i ESX:

ensure oxmysql
ensure es_extended
ensure off_faction

1. Otwórz /fraktionen, utwórz frakcję i ustaw zarząd przez /setjob <ID> <name> <ranga> (najwyższa ranga = liczba rang − 1).

Konfiguracja

config/settings/config.lua

config/settings/config.gangwar.lua

config/settings/config.actions.lua

config/functions.lua

Tutaj podłączasz własne skrypty. Błędy w nich trafiają do konsoli, skrypt działa dalej.

config/settings/config.server.lua i języki

Webhooki Discorda dla każdego obszaru (creator, members, money, garage, storage, wardrobe, level, gangwar, actions), url = '' wyłącza log. Wszystkie teksty są w config/locales/ (jeden plik na język).

W grze

• Kreator (/fraktionen): Utwórz frakcję, ustaw miejsca przyciskiem Użyj mojej pozycji, markery, NPC i blipy przez Dostosuj, w zakładce Ustawienia włącz system poziomów, garaż, magazyn, gangwar i akcje menu F6. Dopiero Zapisz zapisuje wszystko. Na górze przełączasz na Podania i Strefy Gangwar.
• Dostosuj NPC: Wybierz model z listy obrazków wszystkich pedów GTA (wyszukiwarka i kategorie), do tego scenariusz i kierunek patrzenia, wszystko z podglądem na żywo w grze. Peda addon wybierasz, wpisując w wyszukiwarkę dokładną nazwę modelu.
• Styl pojazdów (Kreator → Pojazdy): Prefiks tablicy do 5 znaków, np. BALLA daje BALLA 48. Gdy prefiks się zmieni, przy zapisie wszystkie pojazdy frakcji dostają nową tablicę, a pojazdy wyjęte z garażu zostają usunięte. Do tego lakier w kolorze frakcji, maksymalny tuning, przyciemniane szyby i xenon w kolorze frakcji.
• GPS (Kreator → Ustawienia): Członkowie widzą się nawzajem na mapie. Ikona zmienia się zależnie od stanu, kolory i ikony są w gps.types. Kierunek patrzenia blip pokazuje tylko pieszo i podczas pływania, ikony pojazdów zawsze stoją prosto.
• Kluczyki: Kto wyjmie pojazd frakcji z garażu, może go zamykać i otwierać klawiszem U (do zmiany w ustawieniach klawiszy FiveM). Z vehicleKeys.shared = true mogą to robić wszyscy członkowie.
• Podania: Punkty podań tworzysz w kreatorze w zakładce Podania (do 20), jako NPC lub marker i opcjonalnie z blipem dla wszystkich graczy. Działają dla wszystkich frakcji. W punkcie E otwiera listę wszystkich frakcji, które przyjmują podania, tam wysyłasz tekst. Twojej frakcji nie ma na liście. Członkowie z uprawnieniem Zapraszanie członków dostają wiadomość i widzą podanie w menu szefa w Członkowie → Podania. Tam można też zamknąć podania. Przyjęcie działa także wtedy, gdy gracz jest offline.
• Logi (menu szefa, dolny przycisk): wszystko, co dzieje się we frakcji, np. wpłaty i wypłaty, pojazdy wyjęte, schowane lub kupione, magazyn, szafa, członkowie, podania, sklep gangwaru i poziom. Ataków gangwaru tam nie ma. Widoczne dla zarządu i rang z uprawnieniem Przeglądanie logów.
• Miejsca: Przy menu szefa, garażu, magazynie, szafie i windzie E otwiera menu.
• Menu akcji (F6): Działa na gracza lub pojazd tuż przed tobą.
• Twarde kajdanki: tylko rozglądanie się. Miękkie kajdanki: chodzenie, ale bez biegania, skakania i atakowania. Ponowny wybór je zdejmuje.
• Przeszukaj: tylko skutych graczy, możesz tylko zabierać.
• Prowadź: prowadzisz skutego gracza przed sobą. Wsadź do pojazdu / Wyciągnij z pojazdu dla skutych.
• Pojazd: umyj, napraw, odholuj (prywatne pojazdy trafiają na parking odholowanych pojazdów off_garage) i zidentyfikuj. X przerywa.
• Gangwar: W punkcie gangwaru E otwiera menu. Jedna frakcja wystawia strefę, inna przyjmuje wyzwanie. Dołączasz przez E w punkcie gangwaru.
• Limit czasu: startuje od razu, punkty za zabójstwo, respawn, dołączanie do samego końca.
• First Contact: czas na dołączenie w lobby, potem jedno życie na gracza.

Dla deweloperów

exports.off_faction:AddXP('vagos', 250)
exports.off_faction:SetLevel('vagos', 5, 0)
local level, xp, needXp = exports.off_faction:GetLevel('vagos')
local faction = exports.off_faction:GetFaction('vagos')
local list = exports.off_faction:GetFactions()
local isFaction = exports.off_faction:IsFaction('vagos')
local name, grade = exports.off_faction:GetPlayerFaction(source)
local allowed = exports.off_faction:HasPermission(source, 'withdraw')
exports.off_faction:AddBalance('vagos', 5000, 'Nagroda')
exports.off_faction:RemoveBalance('vagos', 5000, 'Strafe')

• Wszystkie eksporty działają po stronie serwera.
• Event serwera off_faction:levelUp z (faction, level) przy awansie na wyższy poziom.
• Statebagi: offGangwar (ID strefy w gangwarze), offCuffed ('hard', 'soft' lub false), offEscorted (ID serwera prowadzącego).

Częste problemy

Przy starcie skrypt zgłasza błędy i wskazówki w konsoli serwera.