Vue d'ensemble fonctionnelle¶
Le HUD joueur centralise les informations persistantes non interactives : buffs et debuffs en haut à droite, puis date et heure du monde dans un inlay AR en bas à droite.
Le monde inclut les packs publics de mappings Medusa. Par défaut, avant chaque démarrage de FXServer, leurs intérieurs et environnements sont automatiquement synchronisés avec la dernière révision disponible sur la branche main. Un développeur peut définir FIVEM_LOAD_MLOS=false pour démarrer un environnement allégé sans télécharger ni charger les MLO/IPL.
La plateforme FiveM utilise automatiquement le dernier artefact serveur Linux officiel. Le build
GTA imposé aux joueurs suit toutefois une politique Production versionnée : 3751 est le plus haut
build actuellement approuvé pour les clients stables. Un build plus récent seulement documenté ou
disponible sur Canary n'est pas activé automatiquement. À chaque démarrage, Medusa vérifie que le
build Production approuvé figure encore dans la table officielle Cfx.re ; une source inaccessible
ou incohérente bloque le lancement plutôt que d'imposer une version non vérifiée.
Acteurs¶
- Joueur : rejoint FiveM avec un compte Discord autorisé, crée et incarne son personnage.
- Staff : utilise les outils dont ses rôles Discord lui donnent explicitement les permissions.
- Founder : rôle Discord
1527775014013894796, détenteur permanent de toutes les permissions.
Capacités livrées¶
Medusa vérifie la whitelist Discord avant l'entrée, affiche un loading screen éditorialisé, crée et restaure les personnages, leur apparence, leur tenue et leur position, propose des magasins de vêtements, et fournit des outils de modération. Le staff peut agir depuis le navigateur ou le panneau en jeu selon ses droits.
Les interactions contextuelles partagent une même lecture AR : l'entité ciblée reçoit une mise en évidence turquoise à l'approche, puis un popup configurable présente l'action lorsqu'elle devient accessible. Ce langage est utilisable pour les joueurs, peds, véhicules, objets et lieux.
L'administration couvre actuellement :
- whitelist avec notes internes ;
- contenu du loading screen et fil d'actualités ;
- rôles Discord classés et permissions héritées ;
- recherche, modification, transfert, suppression et recustomisation de personnages ;
- rapports, avertissements et bannissements ;
- journaux techniques et audit administratif.
Le bot Discord Medusa expose aussi des commandes slash de consultation et de gestion des rôles.
Chaque capacité livrée dispose d'un scénario de validation dans la section Tests. Ce plan sert de recette fonctionnelle avant mise en production et de base à la non-régression.
Au démarrage, FiveM attend désormais que l'API, PostgreSQL, Redis et la version du schéma soient réellement prêts. Une indisponibilité temporaire ne vide pas les données déjà synchronisées : les modules concernés reprennent leur initialisation de manière bornée et signalent clairement la panne puis son rétablissement dans les journaux.
Avant toute migration automatique, l'image API vérifie aussi que tous les identifiants Alembic peuvent être enregistrés dans la table de version PostgreSQL. Une image invalide est ainsi refusée avant de tenter de modifier le schéma ou de rendre les services dépendants disponibles.