Yol_Admin — Tutoriel

Installation

5 minutes pour démarrer

Dépendances

Obligatoires required

es_extended · ox_lib · oxmysql · Yol_Bridge

Recommandées optional

ox_inventory · ox_target · ox_doorlock · mVehicle · mGarage · pefcl

Étapes d'installation

1

Placer la ressource

Copier le dossier Yol_Admin dans resources/ de votre serveur FiveM.

2

Ajouter au server.cfg

Ajouter ensure Yol_Admin après vos dépendances (oxmysql, ox_lib, es_extended).

3

Tables SQL

Les tables SQL sont créées automatiquement par oxmysql au premier démarrage.

4

Ajouter les items requis

Ajouter les items du tableau ci-dessous dans ox_inventory/data/items.lua.

5

Permissions ACE

Dans server.cfg, déclarer un admin :

add_ace group.admin command allow
add_principal identifier.discord:VOTRE_DISCORD_ID group.admin

Configuration

Les fichiers à connaître

Yol_Admin tente d'auto-détecter les frameworks installés (inventory, target, garage, vehicle, banking). Vous pouvez forcer un choix précis ou désactiver l'auto-détection dans shared/config.lua.

Clés principales de `shared/config.lua`

Clé	Description
`Config.Locale`	Langue : `'fr'` ou `'en'`
`Config.ServerName`	Nom affiché du serveur
`Config.AdminGroups`	Groupes ACE autorisés à ouvrir le menu
`Config.AutoDetectDependencies`	Auto-détection des frameworks au démarrage
`Config.Dependencies`	Mapping manuel : inventory, target, garage, vehicle, banking, vehicleKeys
`Config.Modules`	Activation/désactivation par module (table de bools)
`Config.ModulePermissions`	Permission ACE requise pour chaque module
`Config.Weapons`	Liste des armes du panel d'attribution
`Config.TargetOptions`	Options à exposer via ox_target (Player/Vehicle/Ped/Object)
`Config.NotifDefaults`	Image/durée/icône par défaut + compatibilité ESX/ox_lib
`Config.UseYolAnticheat`	Si `true`, expose un hook pour Yol_Anticheat

Persistance du Robbery Manager

Les paramètres modifiés via le panel Robbery Manager sont stockés dans data/robbery_config.json et survivent aux reboots du serveur.

Persistance des raccourcis clavier

Les raccourcis personnalisés via le panel Configurations sont stockés en KVP côté client (SetResourceKvp) — ils survivent aux reloads et déconnexions.

Panels du menu

27 onglets disponibles

Pour désactiver un panel : Config.Modules['nom'] = false. Pour restreindre l'accès : Config.ModulePermissions['nom'] = 'permission'.

dashboard

Dashboard

Vue d'ensemble : joueurs en ligne, mini-carte temps réel, modules tiers, raccourcis.

players

Players

Liste des joueurs. Kick, Ban, Warn, Jail, Slap, SetJob, SetGroup, Bring, Goto, Revive, Heal, Spectate, ESP, inventaire.

multipip

Multi-PIP

Picture-in-picture multi-canaux pour superviser plusieurs joueurs simultanément.

notifications

Notifications

Rich Notifications : annonces avec image, vidéo MP4 ou YouTube. Historique en BDD.

vehicles

Vehicles

Game pool. Réparation, suppression, déverrouillage, téléportation, infos owner.

eco

Eco

Statistiques économiques : cash, banque, society accounts. Refresh auto / 30 min.

fleet

Fleet

Gestion de la flotte serveur (véhicules persistés).

logs

Logs

Historique complet des actions admin (LogAction) avec filtres.

permissions

Permissions

Éditeur visuel de groupes et permissions (basé sur PermissionsCatalog).

zones

Zones

Zones map (circulaire/polygone). Flags : godmode, no_weapon, no_vehicles, no_peds, speed_limit.

jobcreator

Job Creator

Création / édition de jobs ESX avec grades et salaires.

gangcreator

Gang Creator

Création / édition de gangs.

drugcreator

Drug Creator

Markers drug : minigame récolte, payout cash/black_money, dispatch police optionnel.

robberycreator

Robbery Manager

6 modules : Bank, Carheist, Train, Storerobbery, Fraud, ATM. Cooldowns, police, loot, items. Persistance disque.

inventorycreator

Inventory Creator

Création visuelle d'items ox_inventory avec image et raycast.

doorlock

Doorlock

Création / édition de portes ox_doorlock depuis l'UI.

props

Props

Spawn et placement de props mondiaux persistés.

server

Server

États : maintenance, whitelist, message d'accueil, restart programmé.

scripts

Resources

Liste des ressources : start / stop / restart en un clic.

console

Console

Console serveur live (subscribers, exécution de commandes, buffer ring).

discordbot

Discord Bot

Token, guild, role admin, channel logs. Start/Stop depuis l'UI.

anticheat

Anticheat

Pont vers Yol_Anticheat (affichage des détections).

anticheat

AntiCipher

Sous-panel anticheat — analyse de signatures de ressources.

loadingscreen

Loading Screen

Éditeur : logo, position, phrases positives/négatives détectées.

richpresence

Rich Presence

Configuration Discord Rich Presence (titre, image, état joueur).

configurations

Configurations

Raccourcis clavier, options UI, préférences. Persistés en KVP côté client.

Quick Menu

Touche par défaut : INSERT

Staff

Infos du joueur le plus proche (ID, nom RP, distance, ping, vie/armure). Actions : Revive, Heal, Bring, Goto, Open Inventory.

Tools

Toggles : Noclip, Godmode, Invisibility, ESP, Name Tags, Player Blips. Copy Coords. Vehicle Spawner.

World

Toggles serveur (météo, heure, restart) selon permissions.

Modules

Raccourcis vers les modules tiers détectés (Yol_Epave, Yol_Core...).

Raccourcis clavier

Configurables in-game · Persistance KVP

Reconfigurables dans Configurations > Raccourcis Clavier, ou dans le menu FiveM natif (ESC > Paramètres > Affectations clavier > FiveM).

Ouvrir l'admin

F6

Quick Menu

INSERT

Console Serveur

F7

Recherche Joueur

CTRL + K

Noclip

F9

Godmode

F10

Onglet Suivant

CTRL + TAB

Onglet Précédent

CTRL + SHIFT + TAB

Exports publics

3 fonctions exposées

CLIENT `ShowRichNotification`

Affiche une Rich Notification (image, vidéo MP4 ou YouTube).

Lua · Client

exports.Yol_Admin:ShowRichNotification({
    title    = "TITRE",
    message  = "Description",
    image    = "https://example.com/img.png",  -- optionnel
    video    = "https://example.com/vid.mp4",  -- optionnel
    icon     = "fa-solid fa-bell",             -- optionnel
    duration = 5000                             -- ms, optionnel
})

SERVER `HasPermission`

Vérifie si un joueur possède une permission précise (groupe ACE ou perm custom).

Lua · Server

local ok = exports.Yol_Admin:HasPermission(source, 'admin.access')
if ok then
    -- Joueur autorisé
end

SERVER `GetUserGroups`

Récupère la liste des groupes ACE/custom d'un joueur par sa license.

Lua · Server

local groups = exports.Yol_Admin:GetUserGroups('license:abc123')
-- Retourne : { ['group.admin'] = true, ... }

Events réseau publics

Pour l'intégration avec d'autres ressources

`Yol_Admin:client:ShowRichNotification`

Server → Client. Envoyer une notification premium à un joueur depuis n'importe quelle ressource.

Trigger · Server

TriggerClientEvent('Yol_Admin:client:ShowRichNotification', source, {
    title   = "BIENVENUE",
    message = "Profitez bien du serveur !",
    image   = "https://example.com/welcome.png"
})

Interception automatique

Si Config.NotifDefaults.compatibility = true (par défaut), les appels ESX.ShowNotification, ESX.ShowAdvancedNotification et lib.notify sont automatiquement convertis en Rich Notifications.

Fonctions globales

Utilisables depuis les sous-modules de la ressource

SERVER

Signature	Description
`IsStaffMenuOpen(src)`	Retourne `true` si le menu admin est ouvert.
`IsStaffOnTab(src, tab)`	Retourne `true` si le staff est sur l'onglet donné.
`GetStaffActiveTab(src)`	Retourne le nom de l'onglet actif.
`GetCharacterRPName(playerId)`	Prénom + nom RP via ESX.
`LogAction(adminId, action, details, targetId)`	Enregistre une ligne dans le journal d'actions admin.
`CreateSocietyAccount(source, name, label)`	Crée un compte société (PEFCL ou ESX).
`RM_ServerGetConfig(name)`	Lit un convar du Robbery Manager (avec fallback).
`RM_ServerGetConfigInt(name)`	Variante int.
`RM_ServerModuleEnabled(moduleName)`	Vérifie si un module robbery est actif.
`BroadcastAnnouncements()`	Force un re-broadcast des annonces actives.

CLIENT

Signature	Description
`ShowRichNotification(data)`	Identique à l'export.
`HandleSelfAction(action, data)`	Action sur soi : `noclip`, `godmode`, `invisible`.
`HandleVehicleAction(action, data)`	Action sur le véhicule courant : `fix`, `delete`, `unlock`...
`RM_ClientGetConfig(name, default)`	Lit la config robbery côté client.
`RM_ClientModuleEnabled(moduleName)`	Vérifie si un module est actif.
`OpenNUIContextMenu(title, items)`	Ouvre un menu contextuel NUI personnalisable.

Items requis (ox_inventory)

À ajouter à ox_inventory/data/items.lua

Sans ces items les modules de braquage ne fonctionneront pas

Hack, ATM clonecard, train heist (grinder, gold), storerobbery (montre), payouts black money — tout passe par ces items.

Lua · items.lua

['laptop'] = { label = 'Laptop de Hack', weight = 2000, stack = false, close = true },
['printer'] = { label = 'Imprimante à Cartes', weight = 5000, stack = false, close = true },
['generator'] = { label = 'Générateur Électrique', weight = 15000, stack = false, close = true },
['fuelcan'] = { label = "Bidon d'essence", weight = 3000, stack = true, close = true },
['clone_card'] = { label = 'Carte Bancaire Clonée', weight = 50, stack = true, close = true },
['grinder2'] = { label = "Meuleuse d'angle", weight = 4000, stack = false, close = true },
['gold'] = { label = "Lingot d'Or", weight = 5000, stack = true, close = true },
['montre'] = { label = 'Montre de Luxe', weight = 100, stack = true, close = true },
['black_money'] = { label = 'Argent Sale', weight = 0, stack = true, close = false },

Bot Discord

Configuration en jeu · Slash commands incluses

Étapes de configuration

1

Ouvrir le menu Yol_Admin

Appuyer sur F6.

2

Aller dans Discord Bot

Onglet Discord Bot dans la sidebar.

3

Renseigner les informations

Token · Guild ID · Role Admin ID · Channel Logs

4

Sauvegarder et démarrer

Cliquer sur Sauver puis Démarrer.

5

Inviter le bot

Inviter le bot avec les intents GUILDS, GUILD_MEMBERS, MESSAGE_CONTENT.

Slash commands

Statut serveur + joueurs

/joueurs

Identique à /joueurs

/serveur

Message global en jeu

/say

Kick un joueur

/kick

Ban un joueur

/ban

Revive un joueur

/revive

Soigne un joueur

/heal

Change le job

/setjob

Restriction par rôle

Toutes les slash commands sont restreintes au rôle Admin Discord configuré dans le panel.

Bienvenue dans Yol_Admin