Retour au hub tutoriels

Cartes : tactique et projection

Upload, calibration, tokens, zones AOE, brouillard, projection live.
11 étapes pour devenir un maître de la carte tactique.

Sommaire
1. Vue d'ensemble2. Ajouter une carte3. Calibrer l'échelle4. Tokens : placer les combattants5. Zones AOE6. Brouillard de guerre7. Ancrer / Reset8. Projeter aux joueurs9. Interactions tokens10. Multi-cartes : organisation campagne11. Suppression et bonnes pratiques
Étape 1

Vue d'ensemble

Les Cartes sont le théâtre visuel de tes combats et explorations. Onglet Cartes dans le panneau MJ.

Une campagne peut contenir N cartes (intérieurs, extérieurs, étages d'un donjon, plans d'une cité). Une seule est projetée aux joueurs à la fois (badge LIVE sur sa vignette).

  • Sidebar gauche : liste des cartes avec aperçu miniature.
  • Centre : la carte projetée + ses tokens + ses zones AOE.
  • Toolbar haut : outils édition (calibration, brouillard, mesure, zone).
  • Sidebar droite : token picker (PJ, monstres, PNJ, faune à drag-and-drop).
Étape 2

Ajouter une carte

Bouton + Nouvelle carte en bas de la sidebar gauche :

  1. Donne un nom évocateur (ex. « Crypte des Prêtres », « Cité d'Esmaria - Place centrale »).
  2. Téléverse une image : PNG, JPG, WebP. Pas de limite stricte côté UI mais reste raisonnable (4-10 Mo confortable).
  3. L'app la stocke sur disque (FS) pour les images > 4 Mo, en DB sinon. Servie via /api/maps/[id]/image avec cache ETag.
Sources d'images
DungeonDraft / Dungeon Alchemist pour des cartes pro. Wonderdraft pour des cartes du monde. Inkarnate en ligne. Midjourney / DALL-E pour des illustrations rapides. Format conseillé : ratio 16/9 ou 4/3, résolution 1920×1080 minimum pour rester lisible quand zoomé.
Persistance prod
En production, ton serveur doit avoir un volume Docker monté sur le path STORAGE_DIR sinon les images se perdent à chaque deploy. Cf. guide compte / hosting.
Étape 3

Calibrer l'échelle

Pour que les mesures de portée (5m, 30 ft, 100 ft) soient cohérentes avec l'image, calibre une fois :

  1. Bouton Calibrer dans la toolbar.
  2. Clique 2 points sur la carte qui représentent une distance connue (ex. 2 cases d'une grille, donc 10 ft / 3 m).
  3. Saisis la distance réelle (10 ft ou 3 m).
  4. L'app calcule le cellPx (pixels par case) et ftPerCell (feet par case).
Outil Mesurer
Le bouton Mesurer permet ensuite de tracer une règle pointillée cyan entre 2 clics pour afficher la distance en m ou ft (selon préférence dans UnitProvider).
Unités m vs ft
Toggle global dans les paramètres utilisateur (lien sticky en bas). Toutes les distances affichées (sorts, mouvements, mesures) suivent cette préférence. Conversion 1 ft = 0.3048 m.
Étape 4

Tokens : placer les combattants

Sidebar droite : Token picker. Recherche + filtres (PJ / Monstres / PNJ / Faune).

  • Drag-and-drop : glisse une carte d'entité sur la carte pour poser un token.
  • Quantité × N : pour les monstres, choisis combien d'instances créer (1 click pose N tokens espacés).
  • Taille token : XS / S / M / L / XL au moment de l'ajout. Modifiable plus tard via clic droit.
  • Bouton ⊖ Retirer : enlève une instance.
  • REDIM. TOUS : redimensionne tous les tokens d'un coup (utile pour ajuster la lisibilité).
Embuscade gobeline
Glisse « Gobelin ×4 » sur la carte → 4 tokens GOB apparaissent. Glisse « Hobgobelin ×2 ». Glisse « Bugbear ×1 ». Glisse chaque PJ (Kharak, Lyra, Mireille, Sylas) à leur position de départ. Toute la rencontre est posée en 30 secondes.
Lien token ↔ combattant
Quand tu lances une rencontre liée à cette carte, les tokens reçoivent automatiquement un combatantId qui les attache à un combattant unique. Crucial pour les dégâts multi-instances (Gobelin #1 et #2 ont des HP indépendants).
Étape 5

Zones AOE

Bouton Zone dans la toolbar ouvre le picker de préset zone. 5 formes :

  • Sphère / Cylindre : rayon en ft (boule de feu, nuage mortel).
  • Cube : côté en ft (vague tonnante, immobilisation).
  • Cône : longueur en ft (mains brûlantes, cône de froid).
  • Ligne : longueur (éclair, mur de feu).
  • Polygone : tracé libre (pour zones environnementales custom).

Chaque zone porte :

  • Couleur : auto par damageType (rouge feu, bleu froid, jaune foudre...).
  • FX : effets visuels animés (particules, brume turbulence pour Nappe brouillard, fils croisés pour Toile araignée).
  • Persistante : reste sur la carte après le tour (Nuage mortel, Mur de feu, Toile).
  • Owner : caster (pour ne pas le pénaliser dans sa propre zone si rules le permettent).
Pose via sort PJ
Quand un joueur cast un sort AOE depuis le panneau combat, il peut cliquer « Poser la zone sur la carte ». Le système gère la pose + détection auto des tokens dans la zone + application des dégâts/saves. Détails dans guide combat.
Performance
Plus tu as de zones AOE actives avec FX particles, plus le CPU/GPU travaille. L'app cap auto à 10 particules par zone et désactive les FX si plus de 8 zones simultanées (mode dégradé). Toggle FX dans la toolbar.
Étape 6

Brouillard de guerre

Bouton Brouillard OFF/ON. Quand ON :

  • Joueurs voient uniquement la vision de leur PJ (sphère autour du token, par défaut 12 cases = 60 ft).
  • MJ garde la vue complète mais voit des cercles rouges autour de chaque PJ (rappel de leur champ de vision) et peut cocher / décocher les PJ révélés (utile pour les illusions, l'invisibilité, les sens divers).
  • Tokens hors vision ne sont pas visibles par les joueurs (révèlent uniquement quand un PJ approche).
Vision PHB
Vision normale : 60 ft (ou ce que l'environnement permet). Vision dans le noir : 60 ft (60 ft de gris au-delà). Vision aveugle : portée variable (Détecter mort-vivants, Wave senses, etc.). Configurable par token via clic droit.
Étape 7

Ancrer / Reset

Boutons Ancrer et Reset dans la toolbar.

  • Ancrer : enregistre la position actuelle de tous les tokens comme « point de départ ». Pratique pour préparer une carte avec les tokens à leur place de combat avant de la projeter.
  • Reset : remet tous les tokens à leur ancrage précédent ET nettoie toutes les zones AOE actives. Idéal entre 2 rencontres sur la même carte.
Workflow tactique
1. Pose tes tokens monstres en formation d'embuscade. 2. Click Ancrer. 3. Si les joueurs gâchent l'ambiance (mouvement étrange, retours en arrière), click Reset pour repartir propre.
Étape 8

Projeter aux joueurs

Bouton ▶ Projeter sur la vignette d'une carte la rend visible aux joueurs en temps réel (SSE).

  • Une seule carte projetée à la fois (le badge ● LIVE marque celle active).
  • Bouton Arrêter la projection repasse à l'image d'attente.
  • Switcher à une autre carte au milieu d'une session (ex. PJ passe d'une salle à l'autre) : click Projeter sur la nouvelle carte, la précédente devient inactive.
Bascule auto combat
Quand tu lances une rencontre liée à une carte, l'app projette cette carte automatiquement aux joueurs et les bascule sur l'onglet Cartes. Plus besoin de leur dire « ouvrez l'onglet ».
Image d'attente
Quand aucune carte n'est projetée, les joueurs voient l'image d'attente définie dans les Paramètres (feature premium). Sans image d'attente, écran logo Freyja Forge par défaut.
Étape 9

Interactions tokens

Sur un token posé :

  • Drag : déplace. Coût en points de mouvement si en combat (3 max par tour par défaut).
  • Click : ouvre une lightbox avec l'image en grand + nom + HP.
  • Clic droit : menu contextuel (Statut → conditions, Redimensionner XS/S/M/L/XL, Renommer, Supprimer).
  • HP bar : visible au-dessus du token (toutes entités, MJ + joueurs). Couleur vert/orange/rouge selon %.
  • Halo conditions : anneau coloré autour du token pour signaler conditions actives (Empoisonné, Paralysé, etc.).
Restrictions joueur
Un joueur ne peut déplacer QUE son propre token (verrou par myCharId). Le MJ peut déplacer tous les tokens. En combat, le mouvement consomme les points de mouvement du tour (par défaut 3).
Étape 10

Multi-cartes : organisation campagne

Pour une campagne longue, prévois plusieurs cartes :

  • Carte du monde : pour le voyage entre régions (peut aussi être l'Atlas du Lore Creator).
  • Cartes de cité : intra-ville pour les RP et embuscades urbaines.
  • Cartes de donjon : 1 par étage / salle clé. Lie chacune à son encounter.
  • Cartes d'extérieur : forêt, montagne, désert, marais.
Campagne ECH#01 (démo)
8 cartes : Forêt de Valen (Acte I), Cité d'Esmaria, Crypte des Prêtres (Acte II), Cercle du Rituel, Sanctuaire Souterrain (Acte III), Tour de Voss, Clairière d'Oaken, Catacombes. Chacune liée à son encounter le cas échéant.
Drag-and-drop réorganisation
Tu peux réordonner les cartes dans la sidebar par drag-and-drop. Persiste dans l'ordre d'affichage (cookie/localStorage).
Étape 11

Suppression et bonnes pratiques

Bouton Supprimer sur la vignette d'une carte :

  • Modale de confirmation (jamais directe).
  • L'image FS est effacée si plus référencée nulle part.
  • Si une rencontre est liée à cette carte, l'encounter est conservé mais sans carte (à re-lier ou recréer).
Action irréversible
La suppression d'une carte avec ses tokens et zones est définitive. Aucun backup auto. Si tu veux archiver, renomme plutôt (ex. « [ARCHIVE] Forêt de Valen ») et laisse-la dans la liste.
Tester en mode joueur
Avant une vraie séance, ouvre le lien joueur dans une fenêtre privée, claim un PJ, et vérifie que ta carte est bien projetée, lisible, avec brouillard si applicable.

Cartes prêtes pour l'aventure.

Combiné au guide combat et au bestiaire, tu as l'ensemble pour une rencontre fluide.

Retour au hub