Guide d'Installation — Yol Edition

Yol_Edition

Name: Yol Admin (ESCROW)
Brand: YolScript
Price: 5 EUR
Availability: InStock

La Suite d'Administration & Gameplay Ultime pour FiveM — Premium Edition

⚡ ESX LEGACY · OX_LIB · DISCORD BOT NATIF · 11 SCRIPTS

🎮 Qu'est-ce que l'écosystème Yol_Edition ?

La suite Yol_Edition est un écosystème modulaire clé-en-main conçu pour optimiser, administrer et animer votre serveur FiveM. Géré par un dashboard NUI en jeu et synchronisé avec un bot Discord natif, il intègre des fonctionnalités d'administration, de sécurité de haut niveau, de communication moderne, et de gameplay enrichi.

📖 Rôles & Utilité des 11 Scripts

🖥️ Yol_lib OBLIGATOIRE

Design System Commun : Bibliothèque graphique et styles CSS partagés par les UIs de la suite Yol.

Dépendance Vitale : Yol_Admin, Yol_Tchat et les autres interfaces ne peuvent pas fonctionner sans elle.

Emplacement : Placé dans le dossier de dépendances [Depend]/Yol_lib.

🔗 Yol_Bridge OBLIGATOIRE

Shim Framework : Assure la compatibilité universelle entre les scripts Yol et le framework du serveur (ESX Legacy).

Abstraction : Récupère et met à jour de façon standardisée les comptes bancaires, jobs et inventaires.

Emplacement : Placé dans le dossier [Depend]/Yol_Bridge.

👑 Yol_Admin OBLIGATOIRE

Administration & Modération : Menu complet (Heal, Kick, Ban, Revive, Jail, Warn, ESP, Noclip).

Créateur In-Game : Création et configuration dynamique de jobs, gangs et braquages sans redémarrer le serveur.

Bot Discord NodeJS : Synchronisation automatique des grades Staff, logs et commandes Slash.

Factures : Intègre le système de facturation général (Billing).

🛡️ Yol_Anticheat OPTIONNEL

Sécurisation Totale : Détection et bannissement instantané des mod-menus (Lua executors, injections Cipher).

Anti-Trigger Abuse : Empêche le spam d'events pour se give de l'argent ou des armes.

Logs Webhook : Les alertes de détection sont envoyées directement via webhook Discord dédié.

👁️ Yol_Anticheat_Watchdog OPTIONNEL

Sécurité Redondante : Surveille en permanence l'état d'exécution de Yol_Anticheat.

Auto-Restart : Si l'anticheat est stoppé par un hacker ou une erreur, il le relance automatiquement en moins d'une seconde.

Alerte Discord : Envoie une notification Discord critique avec mention rôle Staff lors du redémarrage forcé.

💬 Yol_Tchat OPTIONNEL

Système de Discussion : Organisation en canaux Local, Staff, Global et Annonces.

/me 3D : Affichage du message au-dessus du personnage physique pour une immersion RP maximale.

Screenshot Reports : Capture l'écran du joueur lors d'un report et l'envoie sur votre Discord de modération.

🎬 Yol_Loadingscreen OPTIONNEL

Multimédia Premium : Lecture de vidéos (.mp4 locales) et musiques (.mp3 locales / YouTube) aléatoires.

Détecteur DMCA : Scan automatique des copyrights YouTube pour protéger les streamers de votre serveur.

Staff List & Astuces : Affichage en temps réel des staffs en ligne avec avatars Discord et messages d'aide défilants.

🔋 Yol_Core OPTIONNEL

Système de Besoins : Gère la faim et la soif avec des animations de consommation de nourriture.

Utilitaires Immersifs : Anti-AFK optimisé et système de douches pour se laver du sang.

Optimisation : Ticks optimisés pour réduire la charge CPU des scripts de décors.

🚘 mGarage OPTIONNEL

Garages & Fourrières : Système de rangement de véhicules personnels, d'entreprises et fourrière de modération.

Liaison Yol_Admin : Permet au staff de mettre directement un véhicule en fourrière ou de le ranger dans le garage via le Dashboard.

🔑 mVehicle OPTIONNEL

Carlock & Clés : Système complet de clés physiques, crochetage, allumage moteur et verrouillage.

Intégration Yol_Admin : Permet aux modérateurs de distribuer ou retirer des clés à distance depuis l'interface Staff.

💳 pefcl OPTIONNEL

Système Financier : Banque complète, ATM interactifs, virements, et gestion de comptes partagés.

Intégration Billing : Indispensable pour gérer les virements automatiques de factures et prélèvements d'amendes administratives dans Yol_Admin.

📋 Ordre de Démarrage (server.cfg)

L'ordre suivant doit être respecté dans votre fichier server.cfg pour éviter tout conflit de dépendance au lancement du serveur.

OrdreRessourceNécessitéDossier physique1ensure Yol_LoadingscreenOptionnel[BaseFivem]/Yol_Loadingscreen2ensure oxmysqlObligatoireresources/ (root)3ensure ox_libObligatoireresources/[OX]/ox_lib4ensure Yol_libObligatoireresources/[Depend]/Yol_lib5ensure Yol_AnticheatOptionnelresources/ (root)6ensure Yol_Anticheat_WatchdogOptionnelresources/ (root)7ensure es_extendedObligatoireresources/[Core]/es_extended8ensure ox_targetObligatoireresources/[OX]/ox_target9ensure ox_inventoryObligatoireresources/[OX]/ox_inventory10ensure pefclOptionnelresources/[Others]/pefcl11ensure mVehicleOptionnelresources/[Depend]/mVehicle12ensure mGarageOptionnelresources/[Others]/mGarage13ensure Yol_BridgeObligatoireresources/[Depend]/Yol_Bridge14ensure Yol_CoreOptionnelresources/[Others]/Yol_Core15ensure Yol_TchatOptionnelresources/[Others]/Yol_Tchat16ensure Yol_AdminObligatoireresources/Yol_Admin

🤖 Configuration du Bot Discord Yol_Admin

Le Bot Discord NodeJS se configure dans le fichier suivant :

📁 Yol_Admin/bot/config.json

Structure du fichier :

{
  "token": "DISCORD_BOT_TOKEN",   // Token de l'application Discord Developer Portal
  "guild": "DISCORD_GUILD_ID",    // ID du serveur Discord de votre communauté
  "logChannel": "CHANNEL_ID",     // ID du salon Discord où envoyer les logs
  "adminRole": "ROLE_ID",         // ID du rôle Discord Staff autorisé
  "enableSync": true,
  "autoRename": true
}

💡 Info Bot : Pensez à exécuter npm install dans Yol_Admin/bot/ puis lancez-le avec node index.js (ou configurez-le sur PM2 pour une activation 24/7).

🔔 Webhooks Discord (server.cfg)

Ajoutez ces variables (convars) dans votre fichier server.cfg pour regrouper les webhooks Discord utilisés par la suite Yol :

# Webhook alertes de sécurité Anticheat (Yol_Anticheat & Watchdog)
set yol_ac_webhook "https://discord.com/api/webhooks/votre_webhook_secu"

# Webhook captures d'écran reports tchat (obligatoirement setr)
setr yol_tchat_screenshot_webhook "https://discord.com/api/webhooks/votre_webhook_reports"

# Webhook galerie photo in-game
set yol_tchat_gallery_webhook "https://discord.com/api/webhooks/votre_webhook_galerie"

# Webhook photos et signatures des licences d'identité
setr yol_licenses_screenshot_webhook "https://discord.com/api/webhooks/votre_webhook_licences"

🎥 Arrière-plans & Vidéos (Yol_Loadingscreen)

Le script Yol_Loadingscreen charge automatiquement les ressources média stockées localement :

Vidéos d'arrière-plan (.mp4, .webm) : Placer dans 📁 Yol_Loadingscreen/ui/assets/video/

Musiques de fond (.mp3) : Placer dans 📁 Yol_Loadingscreen/ui/assets/music/

Après avoir ajouté de nouveaux fichiers de façon à ce que le loadingscreen les indexe sans devoir redémarrer votre serveur de jeu, tapez dans la console RCON ou txAdmin :