Faction

Fazioni che crei interamente in gioco: ogni fazione è un vero job con menu boss, garage, magazzini, guardaroba, ascensore, livelli, menu azioni e sistema gangwar. Le tabelle le crea lo script da solo.

Funzionalità

• Creator (/fraktionen): crei in gioco fazioni con gradi, stipendio, veicoli, luoghi (marker o NPC), blip e accesso da un certo grado.
• Menu boss: gestire i membri, cassa con cronologia, comprare veicoli, permessi per grado, candidature e log.
• Candidature: i giocatori si candidano alle fazioni nei punti candidatura (NPC o marker dal creator), la direzione accetta o rifiuta nel menu boss.
• GPS: i membri si vedono sulla mappa, con un'icona propria a piedi, in auto, in moto o in bici, in barca, in elicottero o in aereo, mentre nuotano e da morti (attivabile per fazione).
• Veicoli di fazione con stile: prefisso targa proprio, vernice e xeno nel colore della fazione, tuning massimo e vetri oscurati. Con chiave per chiudere e aprire.
• Garage e magazzini: fino a 10 ciascuno per fazione, accesso da un certo grado.
• Guardaroba, ascensore (fino a 10 piani) e livelli con XP (attivabili per fazione).
• Menu azioni (F6): ammanettare, perquisire, identificare, scortare e azioni sui veicoli, selezionabili per fazione.
• Gangwar: crei zone in gioco, modalità Limite di tempo e First Contact, dimensione propria, shop e classifica.
• Log su Discord per tutte le aree.

Installazione

1. Metti la cartella off_faction in resources.
2. Aggiungi nel server.cfg, dopo oxmysql ed ESX:

ensure oxmysql
ensure es_extended
ensure off_faction

1. Apri /fraktionen, crea una fazione e imposta la direzione con /setjob <ID> <name> <grado> (grado più alto = numero di gradi − 1).

Configurazione

config/settings/config.lua

config/settings/config.gangwar.lua

config/settings/config.actions.lua

config/functions.lua

Qui colleghi i tuoi script. Gli errori al loro interno finiscono in console, lo script continua a funzionare.

config/settings/config.server.lua e lingue

Webhook Discord per area (creator, members, money, garage, storage, wardrobe, level, gangwar, actions), url = '' disattiva un log. Tutti i testi sono in config/locales/ (un file per lingua).

In gioco

• Creator (/fraktionen): crea una fazione, imposta i luoghi con Usa la mia posizione, marker, NPC e blip con Personalizza, e in Impostazioni attiva sistema livelli, garage, magazzino, gangwar e le azioni del menu F6. Solo Salva applica tutto. In alto passi a Candidature e Zone Gangwar.
• Personalizza NPC: scegli un modello da una lista di immagini di tutti i ped di GTA (ricerca e categorie), più scenario e direzione dello sguardo, tutto con anteprima live in gioco. Un ped addon lo scegli scrivendo il nome esatto del modello nella ricerca.
• Stile veicolo (Creator → Veicoli): prefisso targa fino a 5 caratteri, es. BALLA diventa BALLA 48. Se il prefisso cambia, al salvataggio tutti i veicoli della fazione ricevono una nuova targa e i veicoli tirati fuori vengono rimossi. In più vernice nel colore della fazione, tuning massimo, vetri oscurati e xeno nel colore della fazione.
• GPS (Creator → Impostazioni): i membri si vedono a vicenda sulla mappa. L'icona cambia in base allo stato, colori e icone sono in gps.types. Il blip mostra la direzione solo a piedi e mentre nuoti, le icone dei veicoli restano sempre dritte.
• Chiavi: chi tira fuori un veicolo di fazione può chiuderlo e aprirlo con U (modificabile nelle impostazioni dei tasti di FiveM). Con vehicleKeys.shared = true possono farlo tutti i membri.
• Candidature: i punti candidatura li crei nel creator in Candidature (fino a 20), come NPC o marker e, se vuoi, con blip per tutti i giocatori. Valgono per tutte le fazioni. Al punto, E apre la lista di tutte le fazioni che accettano candidature, lì invii un testo. La tua fazione non è nella lista. I membri con il permesso Invitare membri ricevono un messaggio e vedono la candidatura nel menu boss in Membri → Candidature. Lì si possono anche chiudere le candidature. Accettare funziona anche se il giocatore è offline.
• Registri (menu boss, pulsante in basso): tutto ciò che succede nella fazione, es. depositi e prelievi, veicoli tirati fuori, parcheggiati o comprati, magazzino, guardaroba, membri, candidature, shop gangwar e livello. Gli attacchi gangwar non ci sono. Visibile alla direzione e ai gradi con il permesso Vedere registri.
• Luoghi: al menu boss, garage, magazzino, guardaroba e ascensore, E apre il menu.
• Menu azioni (F6): agisce sul giocatore o sul veicolo proprio davanti a te.
• Manette rigide: solo guardarsi intorno. Manette morbide: camminare, ma non correre, saltare o attaccare. Selezionarle di nuovo le toglie.
• Perquisire: solo giocatori ammanettati, puoi solo prendere.
• Scortare: porti un giocatore ammanettato davanti a te. Mettere nel veicolo / Far scendere dal veicolo per gli ammanettati.
• Veicolo: lavare, riparare, sequestrare (i veicoli privati finiscono nel deposito di off_garage) e identificare. X annulla.
• Gangwar: al punto gangwar, E apre il menu. Una fazione mette in coda una zona, un'altra accetta. Entri con E al punto gangwar.
• Limite di tempo: parte subito, punti per kill, respawn, si può entrare fino alla fine.
• First Contact: tempo per entrare nella lobby, poi una vita per giocatore.

Per sviluppatori

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

• Tutti gli export sono lato server.
• Evento server off_faction:levelUp con (faction, level) alla salita di livello.
• Statebag: offGangwar (ID della zona nel gangwar), offCuffed ('hard', 'soft' o false), offEscorted (ID server di chi scorta).

Problemi comuni

All'avvio lo script segnala errori e avvisi nella console del server.