Module FoundryVTT pour Mongoose Traveller 2e (MgT2e), regroupant des compendiums de référence et une suite d'outils d'aide au MJ (commerce, PNJ, rencontres, missions, cartes stellaires, calendrier impérial).

Compatibilité : FoundryVTT v13 et v14

✨ Fonctionnalités

Commandes de chat

Commande	Rôle
`/commerce`	Génération d'offres de commerce (3 onglets)
`/pnj`	Génération de PNJ rapide (4 onglets)
`/rencontre`	Rencontres aléatoires
`/mission`	Contrats / missions aléatoires
`/sector`	Carte stellaire interactive (Traveller Map)
`/subsector`	Carte d'un sous-secteur
`/cal`	Fenêtre du calendrier impérial

Génération de PNJ

PNJ rapide : nom, carrière, caractéristiques, compétences (localisées en français), relations
PNJ détaillé (Traveller) : génération selon les règles du générateur officiel, création de fiche npc MgT2e avec spécialités de compétences natives
Alliés & Ennemis : relations générées via tables D66, modificateurs d'affinité/inimité, caractéristiques spéciales
Création d'acteur : possibilité de créer directement une fiche PNJ et de l'ouvrir

Import par lot de PNJ

scripts/batchNpcCreator.js : importe un répertoire d'images (fichiers) comme PNJs, grille de raccourcis dans la barre latérale Acteurs (Commerce, PNJ, Rencontre, Mission), bouton Traveller Map dans la barre latérale Scènes

Carte stellaire (Traveller Map)

Carte interactive en IFRAME avec recherche de mondes
Carte de chat complète : UWP (avec détail), importance, économie, culture, population, noblesse, bases, remarques, allégeance, étoiles
Synchronisation : le MJ peut partager la vue actuelle (hex, zoom) avec tous les joueurs via socket
Vue joueur en lecture seule, mise à jour en temps réel
Synchronisation du canvas : le MJ peut aligner la vue des joueurs sur la sienne

Calendrier impérial

Fenêtre compacte affichant la date impériale (Wonday, 234-1116 IC ─ 14:30)
Configurable par le MJ : année, jour (1-365), heure:minute locale, planète
Boutons rapides +1 jour et +1 heure (report 24 h → jour, 365 → 1)
Conversions calendaires : Solomani, Vilani, Zhodani (Olympiades), Aslan, K'Kree, Hiver (formules approximatives de Date_Conversion)
Synchronisé pour les joueurs en temps réel via socket
Auto-ouverture au démarrage (désactivable) et sauvegarde de la position de la fenêtre
Notes de bord : bouton crayon → saisie d'une note datée (date impériale + date réelle), ajoutée à un journal de session

Compendiums

14 compendiums organisés en dossiers thématiques :

Dossier	Contenu
Équipements	armures, objets, équipement, ordinateur, contenants, armes
Références	compétences, maladie/poison/blessure, espèces, talents psioniques, carrières
PNJ & Items	tables PNJ, PNJ, compétences, maladies, espèces, talents, carrières
Journaux	journal psioniques

📦 Installation

Copie manuelle : placer le dossier dans FoundryVTT/Data/modules/mgt2-compendium-amiral-denisov/
Manifest : dans FoundryVTT, Add-on Modules → Install Module avec l'URL du manifest

Activer ensuite le module dans la configuration du monde.

🎮 Utilisation

Commencer une partie

Tapez une commande dans le chat (ex. /pnj) ou utilisez les raccourcis de la barre latérale. Le message d'accueil au lancement rappelle les commandes disponibles.

Calendrier impérial

/cal (ou auto-ouverture au démarrage)
Clic sur la roue dentée ⚙ (MJ) pour configurer la date
Clic sur le crayon ✎ (MJ) pour ajouter une note au journal de bord

Paramètres du monde

Dans Configuration → Réglages → Module Settings :

Réglage	Description
Calendrier impérial : auto-ouverture	Ouvrir automatiquement la fenêtre au démarrage
Journal de bord	Nom du journal utilisé pour les notes de session (créé automatiquement)

🛠 Développement

Structure

module.json            Manifeste du module (source de vérité pour la version)
scripts/
  data/                Tables de données (NPC, commerce, alliés/ennemis, générateur Traveller)
  tests/               Tests unitaires (Jest)
  *.js                 Logique des outils
  *.css → styles/      Styles
templates/             Templates Handlebars
packs/                 Compendiums (niveau de base de données)

Prérequis

Aucun gestionnaire de paquets, aucun build — JavaScript ESM chargé directement par FoundryVTT
package.json créé uniquement pour les tests ("type": "module")

Tests

Deux styles de tests coexistent (pas de configuration Jest, package.json n'existe que pour "type": "module" + mock FoundryVTT fait main) :

allyEnemyGenerator.test.js — mini-runner maison (test()/assertEqual), à lancer avec Node directement :

node scripts/tests/allyEnemyGenerator.test.js   # "All N tests passed"

travellerNpcGenerator.test.js — Jest (describe/it), à lancer avec le flag ESM :

NODE_OPTIONS="--experimental-vm-modules" npx jest scripts/tests/travellerNpcGenerator.test.js

Conventions

Tout le contenu (libellés, commentaires, messages de commit) est en français
Dialogs : ApplicationV2 + HandlebarsApplicationMixin
Compatibilité v13/v14 : certains hooks doivent gérer les API jQuery (v13) et DOM (v14)
Dés à lancer : toujours await new Roll(formula).evaluate()

📄 Licence & Crédits

Cartes stellaire via Traveller Map
Règles de conversion calendaires d'après Traveller Wiki
Module initié par JdR.Ninja