Installer vMenu sur ton serveur FiveM

Introduction

vMenu est gratuit, open source, et utilisé sur la majorité des serveurs freeroam FiveM. Il fournit en jeu un menu (touche M par défaut) avec spawn de véhicules, weapons, joueur, options serveur (temps, météo), et un système de permissions complet.

Prérequis

• Un serveur FiveM chez VeryCloud
• Accès Files dans Wisp
• Système de permissions ACE fonctionnel (voir le tuto ACE sur la doc)

Étape 1 : Télécharger vMenu

vMenu est sur GitHub :

• Releases : https://github.com/TomGrobbe/vMenu/releases

Télécharge la dernière vMenu-X.Y.Z.zip (pas le Source code).

Étape 2 : Uploader le dossier ressource

Dans Wisp → Files :

1. Va dans /resources/
2. Crée un dossier [trainer] (si tu veux organiser, optionnel)
3. Upload + extract vMenu-X.Y.Z.zip dans /resources/[trainer]/
4. Renomme le dossier en vMenu si nécessaire (pas de version dans le nom)

Structure :

/resources/
└── [trainer]/
    └── vMenu/
        ├── fxmanifest.lua
        ├── client/
        ├── server/
        ├── config/
        └── permissions.cfg

Étape 3 : Ajouter à server.cfg

Édite /server.cfg, ajoute :

ensure vMenu
exec resources/[trainer]/vMenu/config/permissions.cfg

permissions.cfg est un fichier ACE qui définit les permissions vMenu. On le configure à l'étape suivante.

Étape 4 : Configurer les permissions

Ouvre /resources/[trainer]/vMenu/config/permissions.cfg. Il y a beaucoup de lignes, organisées en groupes :

# Groupes
add_ace group.admin "vMenu" allow
add_ace group.admin "vMenu.Everything" allow

add_ace group.moderator "vMenu.OnlinePlayers.Menu" allow
add_ace group.moderator "vMenu.OnlinePlayers.Kick" allow

add_ace group.user "vMenu.VehicleSpawner.Menu" allow
add_ace group.user "vMenu.VehicleSpawner.SpawnByName" allow
add_ace group.user "vMenu.PlayerOptions.Menu" allow

Et tes joueurs sont ajoutés via ACE :

add_principal identifier.steam:110000XXXXXXX group.admin
add_principal identifier.fivem:1234567 group.moderator
add_principal identifier.steam:110000YYYYYYY group.user

Étape 5 : Customiser la config vMenu

Édite /resources/[trainer]/vMenu/config/settings.cfg :

setr vmenu_use_permissions true
setr vmenu_menu_staff_only false
setr vmenu_menu_toggle_key 244          # M par defaut
setr vmenu_noclip_toggle_key 289        # F2 par defaut
setr vmenu_disable_player_stats_setup_in_menu false
setr vmenu_enable_voice_chat true
setr vmenu_use_pma_voice false          # true si tu as pma-voice
setr vmenu_dynamic_weather_freezetime false
setr vmenu_pvp false                    # true pour autoriser le PvP

Ajuste selon tes besoins. Pour un serveur freeroam : pvp true, staff_only false. Pour un RP : staff_only true (trainer admin uniquement).

Étape 6 : Restart et tester

Restart le serveur. En jeu, presse M. Le menu vMenu apparaît.

Si rien ne s'affiche :

• Vérifie en console F8 client : vMenu loaded doit apparaître
• Permissions ACE configurées et le joueur ajouté à un groupe
• setr vmenu_use_permissions true correctement set

Étape 7 : Catégories du menu

Survol des principales options :

• Online Players : kick, ban, teleport, spectate
• Player Options : santé, armure, godmode, vitesse, noclip
• Vehicle Spawner : tous les véhicules vanilla GTA V
• Personal Vehicle : sauvegarder ton dernier véhicule
• Weather Options : forcer météo
• Time Options : forcer heure
• Recording Options : Rockstar Editor in-game
• Misc Settings : speedometer, points de spawn, etc.

Étape 8 : Whitelist staff-only

Pour limiter vMenu à ton staff uniquement (cas RP) :

setr vmenu_menu_staff_only true

Et tes admins sont ajoutés via :

add_ace group.admin "vMenu" allow
add_ace group.admin "vMenu.Staff" allow

Les non-staff voient le menu mais avec quasi rien dedans (juste profil/options de base).

Étape 9 : Banlist persistante

vMenu inclut un système de bans persistants stocké dans vMenu/server/. Les bans sont par SteamID/IP et restent après restart.

Pour le activer dans la config :

setr vmenu_use_permissions true
setr vmenu_log_kick_actions true
setr vmenu_log_ban_actions true

Les logs sont écrits côté serveur dans le dossier resource.

Étape 10 : Mettre à jour vMenu

Périodiquement, GitHub publie des updates :

1. Backup d'abord
2. Téléchage la nouvelle release
3. Remplace les fichiers dans /resources/[trainer]/vMenu/
4. Conserve TON permissions.cfg et settings.cfg (ne les écrase pas !)
5. Restart

Dépannage

M ne fait rien

• vMenu pas démarré → restart vMenu console
• Permissions vides → ajoute-toi à un groupe ACE
• Conflit de touche avec un autre script → change vmenu_menu_toggle_key

Les options de spawn de véhicules ne marchent pas

• Permission manquante : vMenu.VehicleSpawner.Menu + vMenu.VehicleSpawner.SpawnByName
• OneSync mode : certaines opérations diffèrent

Permissions appliquées mais menu vide pour les joueurs

• setr vmenu_use_permissions true non set
• Le joueur n'est dans aucun groupe ACE — print_acl en console pour debug

Commandes utiles

restart vMenu              # Reload la ressource
print_acl                  # Voir les ACL actives
list_principals <player>   # Voir les groupes d'un joueur

Conclusion

vMenu = trainer admin/freeroam mature, gratuit, customisable. 20 minutes d'install, permissions ACE bien posées, et tu as un outil de modération in-game complet plus un freeroam menu pour tes joueurs. Idéal pour serveurs sandbox / freeroam, et comme trainer admin caché pour serveurs RP.

Pour aller plus loin : custom permissions par sous-groupe, intégration avec pma-voice pour le voice chat, custom vehicles dans le spawner.

Ressources

• vMenu — GitHub
• vMenu — Wiki / Docs
• FiveM Docs — ACE Permissions
• Cfx.re Forum — vMenu