Faction

Fraktionen, die du komplett im Spiel anlegst: Jede Fraktion ist ein echter Job mit Bossmenü, Garagen, Lagern, Kleiderschrank, Aufzug, Level, Aktionsmenü und Gangwar-System. Die Tabellen legt das Script selbst an.

Funktionen

• Creator (/fraktionen): Fraktionen mit Rängen, Gehalt, Fahrzeugen, Orten (Marker oder NPC), Blips und Zugriff ab Rang im Spiel anlegen.
• Bossmenü: Mitglieder verwalten, Kasse mit Verlauf, Fahrzeuge kaufen, Rechte pro Rang, Bewerbungen und Logs.
• Bewerbungen: Spieler bewerben sich an Bewerbungspunkten (NPC oder Marker aus dem Creator) bei Fraktionen, die Leitung nimmt im Bossmenü an oder lehnt ab.
• GPS: Mitglieder sehen sich auf der Karte, mit eigenem Symbol zu Fuß, im Auto, auf dem Motorrad oder Fahrrad, im Boot, Helikopter oder Flugzeug, beim Schwimmen und im Tod (pro Fraktion an/aus).
• Fraktionsfahrzeuge mit Stil: eigenes Kennzeichen-Präfix, Lack und Xenon in Fraktionsfarbe, maximales Tuning und getönte Scheiben. Mit Schlüssel zum Auf- und Abschließen.
• Garagen und Lager: je bis zu 10 pro Fraktion, Zugriff ab einem Rang.
• Kleiderschrank, Aufzug (bis 10 Etagen) und Level mit XP (pro Fraktion an/aus).
• Aktionsmenü (F6): Fesseln, Durchsuchen, Identifizieren, Führen und Fahrzeug-Aktionen, pro Fraktion wählbar.
• Gangwar: Zonen im Spiel anlegen, Modi Zeitlimit und First Contact, eigene Dimension, Shop und Rangliste.
• Discord-Logs für alle Bereiche.

Installation

1. Ordner off_faction in resources legen.
2. In die server.cfg nach oxmysql und ESX:

ensure oxmysql
ensure es_extended
ensure off_faction

1. /fraktionen öffnen, Fraktion anlegen und die Leitung per /setjob <ID> <name> <rang> setzen (höchster Rang = Anzahl Ränge − 1).

Konfiguration

config/settings/config.lua

config/settings/config.gangwar.lua

config/settings/config.actions.lua

config/functions.lua

Hier bindest du eigene Scripts an. Fehler darin landen in der Konsole, das Script läuft weiter.

config/settings/config.server.lua und Sprachen

Discord-Webhooks pro Bereich (creator, members, money, garage, storage, wardrobe, level, gangwar, actions), url = '' schaltet einen Log aus. Alle Texte stehen in config/locales/ (eine Datei pro Sprache).

Im Spiel

• Creator (/fraktionen): Fraktion anlegen, Orte mit Position übernehmen setzen, Marker, NPCs und Blips über Anpassen, unter Settings Levelsystem, Garage, Lager, Gangwar und die Aktionen des F6-Menüs einschalten. Erst Speichern übernimmt alles. Oben wechselst du zu Bewerbungen und Gangwar-Zonen.
• NPC anpassen: Modell aus einer Bilderliste aller GTA-Peds wählen (Suche und Kategorien), dazu Szenario und Blickrichtung, alles mit Live-Vorschau im Spiel. Ein Addon-Ped wählst du über den genauen Modellnamen in der Suche.
• Fahrzeug-Stil (Creator → Fahrzeuge): Kennzeichen-Präfix mit bis zu 5 Zeichen, z. B. BALLA ergibt BALLA 48. Ändert sich das Präfix, bekommen beim Speichern alle Fahrzeuge der Fraktion ein neues Kennzeichen und ausgeparkte Fahrzeuge werden entfernt. Dazu Lack in Fraktionsfarbe, maximales Tuning, getönte Scheiben und Xenon in Fraktionsfarbe.
• GPS (Creator → Settings): Mitglieder sehen sich gegenseitig auf der Karte. Das Symbol wechselt je nach Zustand, Farben und Symbole stehen in gps.types. Die Blickrichtung zeigt der Blip nur zu Fuß und beim Schwimmen, Fahrzeug-Symbole stehen immer gerade.
• Schlüssel: Wer ein Fraktionsfahrzeug ausparkt, kann es mit U auf- und abschließen (in den FiveM-Tastenbelegungen änderbar). Mit vehicleKeys.shared = true können das alle Mitglieder.
• Bewerbungen: Bewerbungspunkte legst du im Creator unter Bewerbungen an (bis zu 20), als NPC oder Marker und auf Wunsch mit Blip für alle Spieler. Sie gelten für alle Fraktionen. Am Punkt öffnet E die Liste aller Fraktionen, die Bewerbungen annehmen, dort schickst du einen Text. Die eigene Fraktion steht nicht in der Liste. Mitglieder mit dem Recht Mitglieder einladen bekommen eine Nachricht und sehen die Bewerbung im Bossmenü unter Mitglieder → Bewerbungen. Dort lassen sich Bewerbungen auch schließen. Annehmen klappt auch, wenn der Spieler offline ist.
• Logs (Bossmenü, unterer Button): alles, was in der Fraktion passiert, z. B. Ein- und Auszahlungen, Fahrzeuge aus- und eingeparkt oder gekauft, Lager, Kleiderschrank, Mitglieder, Bewerbungen, Gangwar-Shop und Level. Gangwar-Angriffe stehen dort nicht. Sichtbar für die Leitung und Ränge mit dem Recht Logs ansehen.
• Orte: An Bossmenü, Garage, Lager, Kleiderschrank und Aufzug öffnet E das Menü.
• Aktionsmenü (F6): Wirkt auf den Spieler oder das Fahrzeug direkt vor dir.
• Harte Fesseln: nur umschauen. Weiche Fesseln: laufen, aber nicht rennen, springen oder angreifen. Nochmal auswählen löst sie.
• Durchsuchen: nur gefesselte Spieler, du kannst nur wegnehmen.
• Führen: gefesselten Spieler vor dir herführen. Ins Fahrzeug setzen / Aus Fahrzeug holen für Gefesselte.
• Fahrzeug: waschen, reparieren, abschleppen (private Fahrzeuge landen im Abschlepphof von off_garage) und identifizieren. X bricht ab.
• Gangwar: Am Gangwar-Punkt E öffnet das Menü. Eine Fraktion stellt eine Zone ein, eine andere nimmt an. Beitreten per E am Gangwar-Punkt.
• Zeitlimit: startet sofort, Punkte pro Kill, Respawn, Beitreten bis zum Ende.
• First Contact: Beitrittszeit in der Lobby, dann ein Leben pro Spieler.

Für Entwickler

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, 'Belohnung')
exports.off_faction:RemoveBalance('vagos', 5000, 'Strafe')

• Alle Exports sind serverseitig.
• Server-Event off_faction:levelUp mit (faction, level) beim Aufstieg.
• Statebags: offGangwar (Zonen-ID im Gangwar), offCuffed ('hard', 'soft' oder false), offEscorted (Server-ID des Führenden).

Häufige Fehler

Beim Start meldet das Script Fehler und Hinweise in der Server-Konsole.