Faction

Des factions que tu crées entièrement en jeu : chaque faction est un vrai job avec menu boss, garages, coffres, vestiaire, ascenseur, niveaux, menu d'actions et système de gangwar. Le script crée lui-même les tables.

Fonctionnalités

• Créateur (/fraktionen) : crée en jeu des factions avec rangs, salaire, véhicules, lieux (marker ou PNJ), blips et accès à partir d'un rang.
• Menu boss : gérer les membres, caisse avec historique, acheter des véhicules, permissions par rang, candidatures et logs.
• Candidatures : les joueurs postulent auprès des factions aux points de candidature (PNJ ou marker du créateur), la direction accepte ou refuse dans le menu boss.
• GPS : les membres se voient sur la carte, avec une icône propre à pied, en voiture, à moto ou à vélo, en bateau, en hélicoptère ou en avion, en nageant et une fois mort (activable par faction).
• Véhicules de faction avec style : préfixe de plaque propre, peinture et xénon à la couleur de la faction, tuning maximal et vitres teintées. Avec une clé pour verrouiller et déverrouiller.
• Garages et coffres : jusqu'à 10 de chaque par faction, accès à partir d'un rang.
• Vestiaire, ascenseur (jusqu'à 10 étages) et niveaux avec XP (activables par faction).
• Menu d'actions (F6) : menotter, fouiller, identifier, escorter et actions sur les véhicules, au choix pour chaque faction.
• Gangwar : créer des zones en jeu, modes Temps limité et First Contact, dimension propre, boutique et classement.
• Logs Discord pour tous les domaines.

Installation

1. Place le dossier off_faction dans resources.
2. Ajoute dans le server.cfg, après oxmysql et ESX :

ensure oxmysql
ensure es_extended
ensure off_faction

1. Ouvre /fraktionen, crée une faction et définis la direction avec /setjob <ID> <name> <grade> (rang le plus haut = nombre de rangs − 1).

Configuration

config/settings/config.lua

config/settings/config.gangwar.lua

config/settings/config.actions.lua

config/functions.lua

C'est ici que tu branches tes propres scripts. Les erreurs qu'elles contiennent arrivent dans la console, le script continue de tourner.

config/settings/config.server.lua et langues

Webhooks Discord par domaine (creator, members, money, garage, storage, wardrobe, level, gangwar, actions), url = '' désactive un log. Tous les textes se trouvent dans config/locales/ (un fichier par langue).

En jeu

• Créateur (/fraktionen) : crée une faction, place les lieux avec Prendre ma position, règle markers, PNJ et blips via Personnaliser, et sous Paramètres active le système de niveaux, le garage, le coffre, le gangwar et les actions du menu F6. Seul Enregistrer applique tout. En haut, tu passes à Candidatures et Zones Gangwar.
• Personnaliser le PNJ : choisis un modèle dans une liste d'images de tous les peds de GTA (recherche et catégories), plus scénario et orientation, le tout avec aperçu en direct en jeu. Pour un ped addon, tape le nom exact du modèle dans la recherche.
• Style des véhicules (Créateur → Véhicules) : préfixe de plaque jusqu'à 5 caractères, p. ex. BALLA donne BALLA 48. Si le préfixe change, tous les véhicules de la faction reçoivent une nouvelle plaque à l'enregistrement et les véhicules sortis sont supprimés. En plus : peinture à la couleur de la faction, tuning maximal, vitres teintées et xénon à la couleur de la faction.
• GPS (Créateur → Paramètres) : les membres se voient mutuellement sur la carte. L'icône change selon l'état, les couleurs et icônes sont dans gps.types. Le blip n'indique l'orientation qu'à pied et en nageant, les icônes de véhicules restent toujours droites.
• Clés : celui qui sort un véhicule de faction peut le verrouiller et le déverrouiller avec U (modifiable dans les raccourcis clavier de FiveM). Avec vehicleKeys.shared = true, tous les membres le peuvent.
• Candidatures : tu crées les points de candidature dans le créateur sous Candidatures (jusqu'à 20), en PNJ ou marker et, si tu veux, avec un blip pour tous les joueurs. Ils valent pour toutes les factions. Au point, E ouvre la liste de toutes les factions qui acceptent des candidatures, là tu envoies un texte. Ta propre faction n'apparaît pas dans la liste. Les membres avec la permission Inviter des membres reçoivent un message et voient la candidature dans le menu boss sous Membres → Candidatures. On peut aussi y fermer les candidatures. Accepter fonctionne même si le joueur est hors ligne.
• Logs (menu boss, bouton du bas) : tout ce qui se passe dans la faction, p. ex. dépôts et retraits, véhicules sortis, rangés ou achetés, coffre, vestiaire, membres, candidatures, boutique de gangwar et niveau. Les attaques de gangwar n'y figurent pas. Visible pour la direction et les rangs avec la permission Voir les logs.
• Lieux : au menu boss, au garage, au coffre, au vestiaire et à l'ascenseur, E ouvre le menu.
• Menu d'actions (F6) : agit sur le joueur ou le véhicule juste devant toi.
• Menottes rigides : seulement regarder autour. Menottes souples : marcher, mais pas courir, sauter ou attaquer. Les sélectionner à nouveau les retire.
• Fouiller : seulement les joueurs menottés, tu peux seulement prendre.
• Escorter : mener un joueur menotté devant toi. Mettre dans le véhicule / Sortir du véhicule pour les joueurs menottés.
• Véhicule : laver, réparer, mettre en fourrière (les véhicules privés atterrissent à la fourrière de off_garage) et identifier. X annule.
• Gangwar : au point de gangwar, E ouvre le menu. Une faction met une zone en jeu, une autre accepte. Rejoindre avec E au point de gangwar.
• Temps limité : démarre tout de suite, points par kill, respawn, on peut rejoindre jusqu'à la fin.
• First Contact : temps pour rejoindre dans le lobby, puis une seule vie par joueur.

Pour les développeurs

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

• Tous les exports sont côté serveur.
• Event serveur off_faction:levelUp avec (faction, level) lors d'une montée de niveau.
• Statebags : offGangwar (ID de la zone en gangwar), offCuffed ('hard', 'soft' ou false), offEscorted (ID serveur de celui qui escorte).

Problèmes fréquents

Au démarrage, le script signale les erreurs et les remarques dans la console du serveur.