# Guide Utilisateur - Vermine2047 pour FoundryVTT

## Table des matières
1. [Introduction](#introduction)
2. [Installation](#installation)
3. [Création d'un personnage](#création-dun-personnage)
4. [Les jets de dés](#les-jets-de-dés)
5. [Le système de totems](#le-système-de-totems)
6. [La gestion des groupes](#la-gestion-des-groupes)
7. [Le combat](#le-combat)
8. [Les items](#les-items)
9. [Gestion des PNJ et Créatures](#gestion-des-pnj-et-créatures)
10. [Astuces et bonnes pratiques](#astuces-et-bonnes-pratiques)

---

## Introduction

Bienvenue dans Vermine2047, un système pour FoundryVTT qui implémente les règles du jeu de rôle post-apocalyptique Vermine 2047.

### À propos de Vermine2047

Vermine 2047 est un jeu de rôle dans un monde post-apocalyptique où les joueurs incarnent des survivants dans un environnement hostile. Le système utilise des dés d10 avec un système de seuils de réussite et des mécaniques uniques comme les totems et les domaines de prédilection.

### Compatibilité

- **FoundryVTT**: v11 à v14
- **Version du système**: 0.1.14

---

## Installation

### Prérequis

- FoundryVTT installé (version 11 ou supérieure)
- Module "Dice So Nice!" recommandé pour les dés 3D

### Installation du système

1. **Via le compendium de Foundry**
   - Ouvrez FoundryVTT
   - Allez dans "Game Systems"
   - Cliquez sur "Install System"
   - Recherchez "Vermine2047"
   - Cliquez sur "Install"

2. **Via l'URL du manifest**
   - Allez dans "Game Systems"
   - Cliquez sur "Install System"
   - Dans l'onglet "From Manifest URL", entrez:
     ```
     https://raw.githubusercontent.com/rwanoux/vermine2047/refs/heads/main/system.json
     ```
   - Cliquez sur "Install"

3. **Créer un nouveau monde**
   - Sélectionnez "Vermine2047" comme système
   - Donnez un nom à votre monde
   - Configurez les paramètres

### Configuration recommandée

- Activez le module "Dice So Nice!" pour les dés 3D
- Configurez le mode de jeu (Survie, Cauchemar, Apocalypse) dans les paramètres du monde

---

## Création d'un personnage

### Étape 1: Créer un acteur

1. Cliquez sur l'icône "Actors" dans la barre latérale gauche
2. Cliquez sur "Create Actor"
3. Sélectionnez "Character" comme type
4. Donnez un nom à votre personnage

### Étape 2: Choisir un totem

Le totem est au cœur de votre personnage et détermine ses affinités.

1. Dans l'onglet "Totem et ajustements"
2. Cliquez sur le bouton "choisissez un totem"
3. Sélectionnez un totem dans la liste
4. Cliquez sur "Sélectionner"

**Les 10 totems disponibles:**
- **Humain**: Favorise les compétences humaines et du monde civilisé
- **Prédateur**: Favorise la chasse et la survie
- **Charognard**: Favorise la récupération et l'utilisation d'outils
- **Symbiote**: Favorise les interactions sociales
- **Parasite**: Favorise la discrétion et la survie
- **Bâtisseur**: Favorise la construction et la manipulation
- **Horde**: Favorise le combat en groupe
- **Ruche**: Favorise l'organisation collective
- **Solitaire**: Favorise l'autonomie
- **Adapté**: Favorise l'adaptation à l'environnement

### Étape 3: Définir les caractéristiques

Dans l'onglet "Caractéristiques et compétences", vous trouverez 8 caractéristiques réparties en 4 catégories:

**Physique:**
- Vigueur: Résistance physique
- Santé: Résistance aux blessures

**Manuel:**
- Précision: Dextérité et coordination
- Réflexes: Réactivité et vitesse

**Mental:**
- Connaissance: Savoir et mémoire
- Perception: Observation et intuition

**Social:**
- Volonté: Détermination et courage
- Empathie: Compréhension des autres

**Conseil:** Commencez avec des valeurs de 1-2 pour un personnage équilibré, ou 3-4 pour un spécialiste.

### Étape 4: Définir les compétences

Chaque compétence a une valeur de 0 à 5:
- 0: Incompétent
- 1: Débutant
- 2: Compétent
- 3: Expert
- 4: Maître
- 5: Légende

**Catégories de compétences:**
- **Humain**: Arts, civilisation, psychologie, rumeurs, soins
- **Animal**: Animalisme, dissection, vie sauvage, répulsion, pistes
- **Outil**: Artisanat, bricolage, mécanique, pilotage, technologie
- **Arme**: Armes à feu, tir à l'arc, armurerie, lancer, mêlée
- **Survie**: Vigilance, athlétisme, nourriture, discrétion, corps à corps
- **Monde**: Environnement, flore, route, toxiques, ruines

**Astuce:** Le domaine de prédilection (sélectionnable en haut de chaque catégorie) donne des bonus quand il est aligné avec votre totem.

### Étape 5: Ajouter des spécialités

Les spécialités donnent +1D quand elles sont utilisées avec la compétence parente.

1. Dans l'onglet "Caractéristiques et compétences"
2. Cliquez sur l'icône "+" à côté d'une compétence
3. Une spécialité sera créée avec le nom de la compétence
4. Vous pouvez renommer la spécialité

### Étape 6: Définir les réserves

Dans l'onglet "Combat et réserves":
- **Effort**: Réserve pour les actions physiques (basée sur Vigueur + Santé + Réflexes + Précision)
- **Sang-Froid**: Réserve pour les actions mentales (basée sur Connaissance + Perception + Volonté + Empathie)

### Étape 7: Définir l'identité

Dans l'onglet "Histoire":
- Age
- Origine
- Profil
- Concept
- Instincts
- Interdits
- Objectifs
- Relations
- Biographie

### Étape 8: Équipement

Dans l'onglet "Matériel", vous pouvez ajouter:
- Armes
- Protections
- Véhicules
- Objets

---

## Les jets de dés

### Ouvrir le dialogue de jet

Il y a plusieurs façons de lancer un jet:

1. **Depuis la fiche de personnage**
   - Cliquez sur une caractéristique ou une compétence
   - Un dialogue de jet s'ouvre avec la caractéristique/compétence présélectionnée

2. **Depuis la barre d'outils**
   - Cliquez sur l'icône de dés dans la barre d'outils (à droite)
   - Un dialogue de jet vide s'ouvre

3. **Depuis le chat**
   - Tapez `/roll` ou utilisez la commande de jet

### Le dialogue de jet

Le dialogue de jet a été conçu pour être intuitif et compact.

#### Sélection de base

- **Caractéristique**: Sélectionnez une caractéristique (Vigueur, Santé, etc.)
- **Compétence**: Sélectionnez une compétence (optionnel)
- **Score**: Affiche la valeur de la caractéristique sélectionnée

#### Difficulté et Handicap

- **Difficulté**: Sélectionnez le niveau de difficulté
  - Evidente (3+): Tâche très simple
  - Facile (5+): Tâche simple
  - Difficile (7+): Tâche standard
  - Très difficile (9+): Tâche complexe
  - Impossible (10+): Tâche extrêmement difficile

- **Handicap**: Sélectionnez le niveau de handicap
  - Aucun: Pas de handicap
  - (I): Handicap mineur
  - (II): Handicap majeur

#### Bonus

La section "Bonus" peut être dépliée pour accéder aux options supplémentaires:

- **Entraide**: +1D si quelqu'un vous aide
- **Groupe**: +0 à +5D basé sur la taille du groupe
- **Sang-Froid**: +0 à +5D (basé sur votre réserve de Sang-Froid)
- **Équipement**: +1D si vous utilisez un outil approprié
- **Dés de totem**: Cochez pour utiliser les dés de totem
  - Totem humain: +XD (où X est la valeur de votre totem humain)
  - Totem adapté: +XD (où X est la valeur de votre totem adapté)

**Astuce:** Si vous avez les deux totems (humain et adapté) avec des valeurs > 0, vous pouvez choisir quel totem garder après le jet.

#### Total du pool de dés

Le dialogue affiche le total du pool de dés en temps réel:
- **0D**: Aucune caractéristique sélectionnée
- **3D**: Caractéristique de valeur 3
- **4D**: Caractéristique 3 + Compétence 1
- **5D+**: Avec bonus

### Les bonus de domaine de totem

Votre totem influence vos jets en fonction du domaine de prédilection:

- Si votre domaine de prédilection est dans les domaines de votre totem, vous obtenez +1 dé
- Si votre domaine de prédilection est dans les domaines du totem opposé, vous subissez -1 dé

**Exemple:**
- Totem: Prédateur (domaines: animal, survie)
- Domaine de prédilection: Survie
- Bonus: +1 dé sur tous les jets de survie

### Les réussites automatiques

En fonction de votre niveau de maîtrise d'une compétence, vous obtenez des réussites automatiques:

| Niveau | Réussites automatiques | Avec spécialité |
|--------|------------------------|-----------------|
| Incompétent (0) | 0 | 0 |
| Débutant (1) | 0 | 0 |
| Compétent (2) | 0 | +1 |
| Expert (3) | +1 | +1 |
| Maître (4) | +1 | +2 |
| Légende (5) | +2 | +2 |

### Les seuils automatiques

Si vous n'êtes pas maîtrisé dans une compétence, un seuil plus élevé est automatiquement appliqué:

| Niveau | Seuil automatique |
|--------|-------------------|
| Incompétent (0) | 9 (Très difficile) |
| Débutant (1) | 7 (Difficile) |
| Compétent (2+) | Difficulté normale |

### Les dés de totem

Les dés de totem sont spéciaux:
- Ils comptent double en cas de réussite (2 réussites au lieu de 1)
- Ils sont de couleur différente pour les distinguer
- Vous pouvez utiliser les dés de totem humain et adapté simultanément
- Si vous utilisez les deux, vous pouvez choisir quel totem garder après le jet

**Exemple:**
- Pool: 3d10 + 1d10 totem humain
- Résultat: 4, 7, 2, 9 (totem humain)
- Si le seuil est 7: 2 réussites (7 et 9) + 2 réussites supplémentaires pour le 9 du totem = 4 réussites totales

### Relances

Les relances sont disponibles pour les compétences maîtrisées:
- **Niveau 2 (Compétent)**: 1 relance
- **Niveau 3 (Expert)**: 1 relance
- **Niveau 4 (Maître)**: 2 relances
- **Niveau 5 (Légende)**: 2 relances

Pour utiliser une relance:
1. Le MJ ou vous-même pouvez accorder des relances
2. Cliquez sur le dé que vous voulez relancer
3. Le dé sera marqué comme "rerolled"
4. Un nouveau jet sera effectué pour ce dé

**Astuce:** Vous pouvez aussi utiliser votre réserve de Sang-Froid pour obtenir des relances supplémentaires.

---

## Le système de totems

### Sélection du totem

Le totem est choisi lors de la création du personnage et détermine:
- Vos affinités naturelles
- Vos bonus de domaine
- Votre perception du monde

### Gestion des dés de totem

Dans la fiche de personnage, onglet "Totem et ajustements":
- Vous voyez les valeurs de vos totems humain et adapté (0-3 chacun)
- La somme maximale est de 5 (ex: 3 humain + 2 adapté)
- Cliquez sur les flèches pour ajuster les valeurs

**Attention:** La somme des deux totems ne peut pas dépasser 5.

### Domaines de prédilection

Chaque catégorie de compétence peut être votre domaine de prédilection:
- Humain
- Animal
- Outil
- Arme
- Survie
- Monde

Pour définir votre domaine de prédilection:
1. Dans l'onglet "Caractéristiques et compétences"
2. Cliquez sur le bouton radio à côté du nom de la catégorie
3. La catégorie sélectionnée devient votre domaine de prédilection

**Bonus:** Si votre domaine de prédilection est dans les domaines de votre totem, vous obtenez des bonus supplémentaires.

### Totems et PNJ/Créatures

Les PNJ et créatures peuvent aussi avoir des totems, qui influencent leurs caractéristiques et comportements.

---

## La gestion des groupes

### Qu'est-ce qu'un groupe?

Un groupe représente:
- Une communauté de survivants
- Un clan
- Une bande
- Une famille élargie

### Créer un groupe

1. Cliquez sur "Create Actor"
2. Sélectionnez "Group" comme type
3. Donnez un nom au groupe
4. Définissez le totem du groupe
5. Ajoutez des membres

### Ajouter des membres à un groupe

1. Ouvrez la fiche du groupe
2. Dans l'onglet "Membres", cliquez sur "+ Ajouter un membre"
3. Sélectionnez le personnage dans la liste
4. Cliquez sur "Ajouter"

**Synchronisation automatique:** Quand vous ajoutez un personnage à un groupe, le groupe apparaît automatiquement dans la fiche du personnage.

### Gérer les rencontres

Les "rencontres" représentent les PNJ et créatures associés à un groupe:
1. Ouvrez la fiche du groupe
2. Dans l'onglet "Rencontres", cliquez sur "+ Ajouter une rencontre"
3. Sélectionnez le PNJ ou la créature
4. Cliquez sur "Ajouter"

### Retirer un personnage d'un groupe

1. Ouvrez la fiche du groupe
2. Trouvez le membre dans la liste
3. Cliquez sur l'icône de suppression (poubelle)
4. Confirmez

**Synchronisation automatique:** Le personnage sera aussi retiré de la liste des groupes dans sa fiche.

### Mode de jeu

La fiche de personnage a deux modes:
- **Mode Edit**: Tous les champs sont modifiables
- **Mode Jeu**: Les champs sont désactivés pour éviter les modifications accidentelles

Pour basculer entre les modes:
- Cliquez sur l'icône de cadenas en haut de la fiche

---

## Le combat

### Initiative

L'initiative dans Vermine2047 est basée sur:
- Caractéristique: Réflexes
- Compétence: Vigilance
- Statut de combat: Offensif (+), Actif (neutre), Passif (-)

**Formule:** `(Réflexes + Vigilance)d10cs>=difficulté`

**Difficultés par statut:**
- Offensif: 5 (facile)
- Actif: 7 (standard)
- Passif: 9 (difficile)

### Statuts de combat

Chaque participant au combat a un statut:
- **Offensif**: Agressif, prend des risques
- **Actif**: Équilibré, réactif
- **Passif**: Défensif, prudent

Pour changer le statut:
1. Dans le combat tracker
2. Cliquez sur le nom du participant
3. Sélectionnez le nouveau statut

### Tracker de combat

Le tracker de combat affiche:
- L'ordre d'initiative
- Le statut de chaque participant
- Les points de vie
- Les réserves

### Actions de combat

Les actions de combat fonctionnent comme les jets de dés normaux, mais avec:
- Des bonus spécifiques au combat
- Des modifications de difficulté basées sur le statut

---

## Les items

### Types d'items

1. **Objet (item)**: Objet général (nourriture, outils, etc.)
2. **Arme (weapon)**: Arme de mêlée ou à distance
3. **Protection (defense)**: Armure, bouclier, etc.
4. **Véhicule (vehicle)**: Transport
5. **Capacité (ability)**: Compétence spéciale
6. **Spécialité (specialty)**: Spécialisation dans une compétence
7. **Historique (background)**: Historique du personnage
8. **Traumatisme (trauma)**: Traumatisme psychologique
9. **Évolution (evolution)**: Évolution du personnage
10. **Rumeur (rumor)**: Information
11. **Cible (target)**: Objectif
12. **Rite (rite)**: Rituel

### Créer un item

1. Dans la fiche du personnage
2. Allez dans l'onglet approprié (Matériel, Totem et ajustements, etc.)
3. Cliquez sur l'icône "+" à côté du titre de la section
4. Sélectionnez le type d'item
5. Remplissez les informations

### Utiliser un item dans le chat

1. Glissez-déposez l'item depuis votre fiche vers le chat
2. Ou cliquez sur l'icône de l'item et sélectionnez "Post to Chat"
3. Une carte avec les informations de l'item sera affichée

### Caractéristiques des items

**Tous les items:**
- Description
- Rareté (0-5)
- Fiabilité
- Handicap de rareté
- Quantité
- Poids
- Traits
- Dégâts

**Armes:**
- Portée min/max
- Dégâts (valeur, type, bonus de vigueur)
- Munitions

**Protections:**
- Niveau
- Niveau spécifique
- Mobilité
- Bouclier (oui/non)

**Capacités:**
- Type (personnage, groupe, créature, totem)
- Totem
- Niveau
- Seuil d'apprentissage
- Handicap d'apprentissage
- Effets

---

## Gestion des PNJ et Créatures

### Créer un PNJ

1. Cliquez sur "Create Actor"
2. Sélectionnez "NPC" comme type
3. Donnez un nom au PNJ
4. Configurez les attributs:
   - Menace (1-4): Niveau de dangerosité
   - Expérience (1-4): Niveau d'expérience
   - Rôle (1-4): Importance dans le scénario
5. Ajoutez des compétences si nécessaire
6. Ajoutez de l'équipement

### Créer une créature

1. Cliquez sur "Create Actor"
2. Sélectionnez "Creature" comme type
3. Donnez un nom à la créature
4. Configurez les attributs:
   - Gabarit (1-4): Type de créature
   - Taille (1-3): Taille physique
   - Rôle (1-4): Importance dans le scénario
   - Meute (0-3): Taille du groupe
   - Modes: Types de scénarios où la créature apparaît
5. Ajoutez des compétences si nécessaire

### Menace, Expérience et Rôle (PNJ)

Ces trois attributs déterminent les capacités du PNJ:

**Menace:**
- Mineure (1): Peu dangereuse
- Sérieuse (2): Dangereuse
- Majeure (3): Très dangereuse
- Mortelle (4): Extrêmement dangereuse

**Expérience:**
- Débutant (1): Peu expérimenté
- Compétent (2): Expérimenté
- Expert (3): Très expérimenté
- Maître (4): Maître dans son domaine

**Rôle:**
- Mineur (1): Personnage secondaire
- Secondaire (2): Personnage important
- Important (3): Personnage principal
- Majeur (4): Antagoniste principal

### Gabarit, Taille, Rôle et Meute (Créature)

**Gabarit:**
- Insecte (1): Très petit
- Rat (2): Petit
- Chien (3): Moyen
- Ours (4): Grand

**Taille:**
- Petit (1)
- Moyen (2)
- Grand (3)

**Rôle:**
- Mineur (1): Créature secondaire
- Secondaire (2): Créature importante
- Important (3): Créature principale
- Majeur (4): Boss

**Meute:**
- Solitaire (0): Agit seul
- Petit groupe (1)
- Groupe (2)
- Grande meute (3)

**Modes:**
- Survie: Agit dans des scénarios de survie
- Cauchemar: Agit dans des scénarios de cauchemar
- Apocalypse: Agit dans des scénarios d'apocalypse

---

## Astuces et bonnes pratiques

### Pour les Joueurs

1. **Choisissez un totem qui correspond à votre style de jeu**
   - Humain: Pour les sociaux et les civils
   - Prédateur: Pour les chasseurs et les guerriers
   - Adapté: Pour les polyvalents

2. **Définissez un domaine de prédilection**
   - Cela vous donnera des bonus avec votre totem

3. **Utilisez les spécialités**
   - Les spécialités donnent +1D et des réussites automatiques

4. **Gérez vos réserves**
   - Effort: Pour les actions physiques
   - Sang-Froid: Pour les actions mentales et les relances

5. **Utilisez les dés de totem**
   - Ils comptent double en cas de réussite
   - Vous pouvez utiliser les deux totems simultanément

### Pour les MJ

1. **Créez des groupes pour organiser vos PNJ**
   - Les groupes permettent de gérer plusieurs PNJ ensemble
   - Les rencontres dans un groupe sont synchronisées

2. **Utilisez les statuts de combat**
   - Offensif pour les personnages agressifs
   - Actif pour les personnages équilibrés
   - Passif pour les personnages défensifs

3. **Configurez correctement les PNJ et créatures**
   - Menace/Expérience/Rôle pour les PNJ
   - Gabarit/Taille/Rôle/Meute pour les créatures

4. **Utilisez les modes pour les créatures**
   - Cela permet de filtrer les créatures par type de scénario

5. **Encouragez l'utilisation des domaines de prédilection**
   - Cela rend le système de totems plus impactant

### Pour les développeurs

1. **Utilisez les helpers Handlebars**
   - De nombreux helpers sont disponibles pour afficher les données
   - `skillLevel`, `threatLevel`, etc.

2. **Respectez les conventions de nommage**
   - `vermine-` préfixe pour les classes CSS
   - `VERMINE` namespace pour les configurations

3. **Utilisez GroupLink pour la synchronisation**
   - Ne modifiez pas directement les tableaux de membres/rencontres
   - Utilisez les méthodes de GroupLink

---

## Résolution des problèmes

### Problèmes courants

1. **Les dés de totem ne fonctionnent pas**
   - Vérifiez que les valeurs des totems sont > 0
   - Vérifiez que la somme des totems ne dépasse pas 5

2. **Les bonus de domaine ne s'appliquent pas**
   - Vérifiez que vous avez défini un domaine de prédilection
   - Vérifiez que votre totem a des domaines configurés

3. **Les groupes ne se synchronisent pas**
   - Vérifiez que GroupLink est bien initialisé
   - Vérifiez que les hooks sont actifs

4. **Les templates ne s'affichent pas correctement**
   - Vérifiez que les templates sont en `.hbs`
   - Vérifiez que les références sont correctes

### Contact

Pour de l'aide ou pour signaler un problème:
- Rejoignez le Discord Vermine: https://discord.gg/qejqmSxr
- Rejoignez le Discord Foundry Vermine: https://discord.gg/FqGHYvXg

---

## Licence

Vermine2047 System est sous licence MIT. Voir le fichier LICENSE.txt pour plus de détails.

---

## Auteurs

- François-Xavier Guillois
- Rwanoux (Discord: rwanoux)
- Pretre (Discord: pretre)

---

*Guide mis à jour: 2026-06-04*
*Version: 0.1.14*
