Assistant pour FFXIV : Outil pour les Maîtres du Jeu et les joueurs en roleplay, permettant de gérer des marqueurs de terrain, jets de dés, initiative, fiches de personnages, météo et bien plus, avec synchronisation en temps réel.
- Setup guidé au premier lancement.
- 7 étapes : Bienvenue, RGPD, Modèle, Résultat, Fiche de personnage, Test de dés, Complétion
- Création de modèle intégrée avec éditeur complet ou import par code de partage
- Création de fiche avec pré-remplissage du nom du personnage actuel
- Test interactif des dés directement dans l'assistant
- Accessible à tout moment depuis les Réglages > Guide
- 8 marqueurs (A, B, C, D, 1, 2, 3, 4) entièrement configurables
- Nom personnalisé (max 26 caractères)
- Points de vie (PV) avec barre visuelle, mode pourcentage ou points
- Points d'éther (PE) optionnels avec barre dédiée
- Bouclier avec overlay visuel sur la barre de vie
- Attitude : Hostile (rouge), Neutre (jaune), Amical (vert)
- Statut Boss pour les ennemis importants
- Compteurs personnalisés illimités avec couleur RGB configurable
- Statistiques configurables par marqueur (MJ uniquement, non visibles par les joueurs)
- Bonus/malus temporaire applicable aux marqueurs et joueurs
- Placement, déplacement et suppression des waymarks en jeu
- Multi-dés : support complet des formules XdY (ex :
2d20,5d6) - Animation multi-dés : N icosaèdres 3D animés côte à côte avec révélation individuelle
- Vitesse d'animation réglable : x1, x1.5 ou x2 depuis les paramètres
- Éditeur de formule : deux champs « Nombre de dés » et « Nombre de faces » (au lieu d'un champ texte)
- Jets avec statistiques : modificateurs de stat appliqués automatiquement
- Bonus/malus temporaires pris en compte dans les jets
- Seuils critiques configurables par modèle : réussite et échec critique selon un seuil personnalisé, avec deux modes (« plus c'est haut, mieux c'est » ou « plus c'est bas, mieux c'est ») pour couvrir les systèmes de jeu roll-under
- Breakdown affiché en chat et historique :
14 + 13 = 27/40 (+5) = 32 - Historique des jets consultable (20 derniers) avec effacement
- Diffusion en temps réel à tous les joueurs connectés
- Rétrocompatible avec les anciens clients (champ
rollDicenullable)
- Création de modèles d'événement personnalisés
- Configuration par modèle : mode PV/PE, bouclier, barre PE, formule de dé, seuils critiques, stat d'initiative, compteurs, statistiques
- Partage de modèles via code court (6 caractères) sur le serveur relais
- Option de stockage permanent ou temporaire (7 jours) sur le serveur
- Versioning et abonnements :
- Chaque modèle partagé porte un numéro de version qui s'incrémente à chaque mise à jour
- Les joueurs qui importent un modèle deviennent abonnés : le modèle est en lecture seule chez eux (édition et partage désactivés)
- Mise à jour automatique : au démarrage ou via notification temps réel, le plugin compare les versions et télécharge la dernière itération publiée par le créateur
- Seul le créateur peut publier une mise à jour, grâce à un jeton d'autorisation stocké localement (vérification par hash côté serveur)
- Listing séparé : « Mes modèles » (créés localement, tous droits) et « Modèles abonnés » (importés, cadenas visuel, boutons limités à Charger / Se désabonner)
- Synchronisation des fiches liées : quand un modèle abonné est mis à jour, les
PlayerSheetqui l'utilisent sont alignées automatiquement (stats et compteurs ajoutés, retirés ou renommés selon les identifiants stables du modèle). Un résumé par fiche est affiché dans le chat. - Partage au groupe : diffusion du modèle actif à tous les joueurs connectés dans la session courante
- Bibliothèque de modèles sauvegardée localement, modèle par défaut configurable
- Création de profils liés à un modèle importé ou créé
- Personnalisation des PV, PE, statistiques et compteurs par profil
- Plusieurs profils possibles (un par événement / modèle)
- Adaptation automatique lors de la mise à jour du modèle parent (cf. plus haut)
- Sélection de profil dans la vue joueur (filtré par le modèle actif du MJ)
- Sauvegarde locale en JSON
- Sidebar avec deux onglets : vue d'ensemble et jets de dés
- Carte joueur : PV, PE, compteurs, statistiques en lecture seule
- Grille de jets : un bouton par stat pour lancer directement avec le bon modificateur
- Historique des jets intégré avec breakdown multi-dés
- Sélection de fiche : liste déroulante filtrée par le modèle actif
- Accessible via
/masterevent joueurou bouton dans les paramètres
- Participer en tant que joueur : le MJ peut cocher cette option pour ouvrir automatiquement la vue joueur en parallèle de la vue MJ
- Permet au MJ de lancer ses propres dés et gérer sa fiche tout en maîtrisant la session
- Lancement de combat avec jet d'initiative automatique pour tous les marqueurs et joueurs
- Ajout de participants en cours de combat via le bouton « + » (marqueurs ou joueurs non encore présents)
- Ordre de passage trié par initiative, avec indicateur du tour actif
- Groupes de passage : plusieurs participants peuvent être fusionnés dans une même phase de tour et jouer simultanément (« Alice, Bob et Charlie jouent »), avec un libellé personnalisable par groupe et un état « a joué » partagé
- Actions par entrée : cocher « a joué », relancer l'initiative, monter/descendre dans l'ordre, fusionner avec un voisin ou détacher, retirer du combat
- Actions par groupe : déplacer tout le bloc (montée/descente), renommer, dissoudre
- Tour suivant : remet les coches à zéro, décrémente les bonus/malus temporaires
- Notifications toast pour annoncer le prochain participant (ou le groupe) et la fin de tour
- Synchronisation en temps réel avec tous les joueurs connectés
- Message libre à l'écran (overlay rouge rubis centré) et dans le chat, diffusé à tous les joueurs connectés
- Limité à 180 caractères, wrap automatique multi-lignes, durée d'affichage proportionnelle à la longueur du message (3 à 10 secondes)
- Déclenché depuis la sidebar via un bouton mégaphone dédié (réservé au MJ)
- Vue MJ (Maître du Jeu) pour le chef de groupe
- Vue Joueur en lecture seule pour les autres membres
- Système de co-MJ : promotion/rétrogradation de joueurs
- Suivi des PV/PE individuels des joueurs
- Bonus/malus temporaire par joueur (MJ uniquement)
- Indicateur de connexion en temps réel par joueur
- Mode Raid Alliance : génération d'un code de salle 6 caractères pour connecter jusqu'à 24 joueurs (3 groupes de 8) sur la même session, indépendamment du groupe FFXIV local
- Indicateurs visuels par groupe : badge coloré
[A],[B],[C]… et compteur par groupe - Persistance du code alliance : survit aux reloads/crashes, auto-rejoin à la reconnexion
- Kick de joueur : retrait de joueurs individuels de l'alliance avec notification
- Communication en temps réel via WebSocket (WSS/TLS)
- Serveur relais dédié en Rust avec gestion de salles par groupe
- Authentification du MJ : un jeton local unique est généré à l'installation et vérifié côté serveur (hash SHA-256) pour empêcher qu'un étranger prenne le contrôle d'une session en connaissant simplement son identifiant
- CORS restrictif : les requêtes HTTP ne sont acceptées que depuis les origines configurées (
ALLOWED_ORIGINS) ; les clients natifs (plugin Dalamud) passent toujours - Limitation par IP : maximum 10 connexions WebSocket par minute et 5 créations de salles par heure et par adresse IP, avec un plafond global de salles simultanées
- Mode Alliance : salles par code (indépendant du groupe FFXIV), tracking automatique des joueurs des autres groupes, identification par groupe d'origine
- Reconnexion automatique avec backoff exponentiel (1s à 30s)
- Récupération de session : cache serveur + cache local en cas de crash
- Shutdown gracieux : à l'arrêt du serveur, les clients connectés reçoivent une frame Close propre avant coupure
- Notifications de connexion/déconnexion en chat
- API REST pour l'export/import/mise à jour de modèles (
POST /api/templates,GET /api/templates/{code},PUT /api/templates/{code},GET /api/templates/{code}/version)
- Contrôle de la météo : changement du temps affiché en jeu (dégagé, pluie, orage, brouillard…)
- Contrôle de l'heure : gel de l'heure éorzéenne à une valeur choisie (0h-23h)
- Entièrement autonome : aucune dépendance externe (ni Weatherman, ni Brio). Hook direct sur les fonctions du jeu + patch mémoire sur le rendu
- Avertissement intégré en début d'onglet : la coexistence avec d'autres plugins qui modifient la météo (Weatherman, Brio en mode GPose, etc.) peut entrer en conflit
- Listes de météo par zone chargées depuis les données Lumina du jeu
- Synchronisation : météo et heure diffusées à tous les joueurs connectés via le relay
- Réinitialisation : retour instantané à la météo naturelle et à l'heure normale du jeu (force le recalcul via
WeatherManager.GetCurrentWeather())
- Sauvegarde de l'état complet des marqueurs en preset nommé
- Chargement et suppression de presets
- Stockage local en JSON
- Français (langue par défaut)
- English
- Changement de langue à chaud depuis les paramètres
- Consentement intégré dans l'assistant de configuration au premier lancement
- Consentement versionné (v2) et révocable depuis les réglages
- Données de session supprimées à la déconnexion ; seuls les modèles partagés en permanence sont conservés sur le serveur
- Journalisation anonymisée (hash SHA-256 uniquement, rotation quotidienne avec rétention 7 jours)
- Information complète sur les droits (accès, effacement, opposition)
- Données transmises : nom de personnage, identifiant de groupe, données des marqueurs (PV, PE, attitude, bouclier), fiches de personnage, jets de dés, modèles, paramètres de météo, identifiant anonymisé, jeton d'autorisation du MJ (envoyé en clair sur TLS, jamais stocké en clair côté serveur — seul son hash SHA-256 l'est)
Le projet est composé de deux parties :
| Composant | Technologie | Description |
|---|---|---|
MasterEvent/ |
C# / .NET 10 / Dalamud API 15 | Plugin FFXIV (tourne dans le jeu) |
MasterEventRelay/ |
Rust / Axum / SQLite | Serveur relais de synchronisation |
- Point d'entrée :
Plugin.cs— enregistre la commande/masterevent(+ alias), les hooks UI et le tick framework - Rôles : Chef de groupe = MJ, autres = Joueurs. Mode solo = MJ local
- Communication : Messages JSON via WebSocket, thread-safe avec
ConcurrentQueue - UI : ImGui avec thème rouge/sombre, fenêtres MJ et Joueur séparées, assistant de configuration dédié, overlay d'annonce et overlay de tour
- Modèles :
EventTemplate(définition d'événement, avec versioning et statut abonnement),PlayerSheet(fiche personnage, synchronisée avec son modèle parent),StatDefinition/StatValue,CounterDefinition/CustomCounter,TurnState/TurnEntry/TurnGroup,SharedTemplate - Persistance : Config Dalamud (jeton d'autorisation du MJ, paramètres généraux), presets/modèles/fiches/partages en JSON local via un helper unifié
JsonFileStore
- Axum + Tokio pour les WebSocket et HTTP asynchrones
- SQLite (rusqlite) pour le stockage persistant des modèles, avec migration idempotente au démarrage
- Salles par
partyId, expiration après inactivité configurable - Cache d'état pour récupération de session, jamais persisté sur disque
- Stockage de modèles avec codes courts, versioning, statut permanent et hash SHA-256 du créateur
- Nettoyage automatique des rooms (5 min) et modèles expirés (1h)
- Rate limiting : 30 messages/s par client connecté, 10 nouvelles connexions/min par IP, 5 créations de salle/h par IP
- Endpoint
/health(statut + nombre de sessions actives) et/metrics(format Prometheus : sessions, clients, uptime, templates, compteurs de messages et d'erreurs) - Rotation quotidienne des logs avec rétention 7 jours
- Shutdown gracieux sur SIGINT / SIGTERM : notification des sessions WS puis drain court avant extinction
- TLS via reverse proxy (Caddy)
dotnet build MasterEvent/MasterEvent.csprojNécessite .NET 10.x SDK et Dalamud API 15 (via XIV on Mac ou équivalent).
cd MasterEventRelay
cargo build --release
./target/release/master-event-relayCopier .env.example en .env pour la configuration (PORT, HOST, ROOM_EXPIRY_MS, TEMPLATE_EXPIRY_MS, LOG_LEVEL, DATABASE_PATH, MIN_VERSION, MAX_ROOMS, ALLOWED_ORIGINS).
| Commande | Description |
|---|---|
/masterevent |
Ouvre la fenêtre principale (MJ ou joueur selon le rôle) |
/masterevent joueur |
Ouvre/ferme la vue joueur |
/masterevent config |
Ouvre les paramètres |
/masterevent help |
Affiche l'aide |
/mevent |
Alias court de /masterevent (accepte les mêmes sous-commandes) |
| Commande | Description |
|---|---|
| `/masterevent connect | /mevent connect` |
| `/masterevent disconnect | /mevent disconnect` |
| `/masterevent mj | /mevent mj` |
Voir le fichier LICENSE.