Différences

Ci-dessous, les différences entre deux révisions de la page.

--- doc-competence [2026/02/14 19:15] – [Calculs techniques] fabrice
+++ doc-competence [2026/02/15 03:36] (Version actuelle) – fabrice
@@ Ligne 1: / Ligne 1: @@
-# Documentation des compétences
+-02-15 03:20:00
-## 1. Orienté joueur
+====== Documentation des compétences ======
+====== 1. Orienté joueur ======
 Les compétences représentent les talents et aptitudes de votre personnage. Elles déterminent le succès de vos actions en combat, exploration et interactions. Chaque compétence évolue avec l'expérience et influence directement le gameplay.
-### Compétences disponibles
+====== Compétences disponibles ======
-- **Bagarre** : Maîtrise des combats au corps à corps sans arme. Permet de frapper directement l'adversaire avec vos poings ou pieds. Essentielle pour les personnages physiques qui préfèrent la proximité.
+  * **Bagarre** : Maîtrise des combats au corps à corps sans arme. Permet de frapper directement l'adversaire avec vos poings ou pieds. Essentielle pour les personnages physiques qui préfèrent la proximité.
-  - Utilisation : Attaques de mêlée de base, esquives rapprochées.
+    * Utilisation : Attaques de mêlée de base, esquives rapprochées.
-  - Avantages : Pas besoin d'équipement, toujours disponible.
+    * Avantages : Pas besoin d'équipement, toujours disponible.
-- **Arme de mêlée** : Expertise dans l'utilisation d'armes de contact comme épées, haches ou masses. Combine force physique et technique pour des attaques puissantes.
+  * **Arme de mêlée** : Expertise dans l'utilisation d'armes de contact comme épées, haches ou masses. Combine force physique et technique pour des attaques puissantes.
-  - Utilisation : Combats avec armes de mêlée, parries.
+    * Utilisation : Combats avec armes de mêlée, parries.
-  - Avantages : Dégâts élevés, contrôle du combat rapproché.
+    * Avantages : Dégâts élevés, contrôle du combat rapproché.
-- **Arme à distance** : Maîtrise des armes de jet comme arcs, arbalètes ou lances. Nécessite précision et dextérité pour toucher à longue portée.
+  * **Arme à distance** : Maîtrise des armes de jet comme arcs, arbalètes ou lances. Nécessite précision et dextérité pour toucher à longue portée.
-  - Utilisation : Tirs à distance, attaques sur cibles mobiles.
+    * Utilisation : Tirs à distance, attaques sur cibles mobiles.
-  - Avantages : Sécurité à distance, contrôle des zones.
+    * Avantages : Sécurité à distance, contrôle des zones.
-- **Magie** : Capacité à lancer des sorts et manipuler les énergies mystiques. Combine intelligence et dextérité pour des effets variés.
+  * **Magie** : Capacité à lancer des sorts et manipuler les énergies mystiques. Combine intelligence et dextérité pour des effets variés.
-  - Utilisation : Lancer des sorts offensifs, défensifs ou de soin.
+    * Utilisation : Lancer des sorts offensifs, défensifs ou de soin.
-  - Avantages : Versatilité, effets spéciaux (dégâts magiques, buffs).
+    * Avantages : Versatilité, effets spéciaux (dégâts magiques, buffs).
-- **Esquive** : Art d'éviter les attaques ennemies. Basée sur la défense physique pour se déplacer et réagir rapidement.
+  * **Esquive** : Art d'éviter les attaques ennemies. Basée sur la défense physique pour se déplacer et réagir rapidement.
-  - Utilisation : Éviter les coups en combat, se protéger des projectiles.
+    * Utilisation : Éviter les coups en combat, se protéger des projectiles.
-  - Avantages : Réduction des dégâts reçus, mobilité tactique.
+    * Avantages : Réduction des dégâts reçus, mobilité tactique.
-- **Lancer** : Précision dans le jet d'objets ou de sorts. Utile pour les attaques improvisées ou les lancers magiques.
+  * **Lancer** : Précision dans le jet d'objets ou de sorts. Utile pour les attaques improvisées ou les lancers magiques.
-  - Utilisation : Jeter des objets (pierres, potions), lancer des sorts à distance.
+    * Utilisation : Jeter des objets (pierres, potions), lancer des sorts à distance.
-  - Avantages : Polyvalence, pas limité aux armes dédiées.
+    * Avantages : Polyvalence, pas limité aux armes dédiées.
-- **Jeu** : Aptitude aux mini-jeux et énigmes. Combine intelligence, dextérité et chance pour résoudre des défis.
+  * **Jeu** : Aptitude aux mini-jeux et énigmes. Combine intelligence, dextérité et chance pour résoudre des défis.
-  - Utilisation : Résoudre des puzzles, gagner des mini-jeux, ouvrir des serrures.
+    * Utilisation : Résoudre des puzzles, gagner des mini-jeux, ouvrir des serrures.
-  - Avantages : Accès à des récompenses cachées, exploration enrichie.
+    * Avantages : Accès à des récompenses cachées, exploration enrichie.
-### Évolution et utilisation
+====== Évolution et utilisation ======
-- Les compétences s'améliorent en distribuant des points d'expérience gagnés lors des actions réussies.
+  * Les compétences s'améliorent en distribuant des points d'expérience gagnés lors des actions réussies.
-- Chaque compétence a un seuil de réussite (ex: 1d100 ≤ compétence + bonus).
+  * Chaque compétence a un seuil de réussite (ex: 1d100 ≤ compétence + bonus).
-- Les compétences influencent les jets de dés pour déterminer le succès des actions.
+  * Les compétences influencent les jets de dés pour déterminer le succès des actions.
-## 2. Orienté technique
+====== 2. Orienté technique ======
 Cette section détaille l'implémentation technique des compétences dans le code et la base de données.
-### Structure de données
+====== Structure de données ======
+====== Table `competences` (si existante) ======
+  * `id` : Identifiant unique
+  * `nom` : Nom de la compétence (ex: "Bagarre")
+  * `description` : Description technique
+  * `carac_principale` : Caractéristique associée (FOR, DEF, etc.)
+  * `formule_base` : Formule de calcul (ex: "clamp(cdb + ca + (FOR - 10), 0, 95)")
+====== Évolution des compétences ======
+  * Points distribués par niveau : 500 points total sur 100 niveaux, dégressif (15 pts niv 1, 4 pts niv 100).
+  * Limite par montée : max points = niveau / 3 (arrondi inférieur).
+  * Progression par race : Voir tableau dans regles-techniques.md.
-#### Table `competences` (si existante)
+====== Calculs techniques ======
-- `id` : Identifiant unique
-- `nom` : Nom de la compétence (ex: "Bagarre")
-- `description` : Description technique
-- `carac_principale` : Caractéristique associée (FOR, DEF, etc.)
-- `formule_base` : Formule de calcul (ex: "cdb + ca + FOR")
-#### Évolution des compétences
+====== Jets de compétence ======
-- Points distribués par niveau : 500 points total sur 100 niveaux, dégressif (15 pts niv 1, 4 pts niv 100).
+  * Formule générale : `1d100 ≤ clamp(cdb + ca + bonus_carac + bonus - malus, 0, max_competence)`
-- Limite par montée : max points = niveau / 3 (arrondi inférieur).
+    * `cdb` : Compétence de base (ex: 90 pour Bagarre)
-- Progression par race : Voir tableau dans regles-techniques.md.
+    * `ca` : Compétence de l'arme/équipement
-### Calculs techniques
+    * `bonus_carac` : Conversion de caractéristique, `stat - 10`
+    * `bonus` : Faction, buffs temporaires
+    * `malus` : Distance, malus présence personnages
-#### Jets de compétence
+Règles globales :
+  * `bonus_stat = stat - 10`
+  * `chance = clamp(chance, 0, max_competence)`
+  * Les stats brutes (FOR/DEX/INT/DEF/LUK) ne s'ajoutent jamais directement en `%`.
-*   Formule générale : `1d100 ≤ (cdb + ca + carac + bonus - malus)`
+====== Compétences spécifiques ======
-    *   `cdb` : Compétence de base (ex: 90 pour Bagarre)
+  * **Bagarre** : `1d100 ≤ cdb` (cdb=90), attaque parfaite si <5.
-    *   `ca` : Compétence de l'arme/équipement
+  * **Arme mêlée** : `1d100 ≤ clamp(cdb + ca + (FOR - 10) + autres_bonus, 0, 95)`, cdb=35.
-    *   `carac` : Caractéristique associée
+  * **Arme distance** : `1d100 ≤ clamp(cdb + ca + (DEX - 10) - malus_distance + autres_bonus, 0, 95)`, cdb=25.
-    *   `bonus` : Faction, buffs temporaires
+  * **Magie** : `1d100 ≤ clamp(cdb_magie + (INT - 10) + (DEX - 10) + bonus_faction + autres_bonus, 0, 95)`, cdb conseillé=25.
-    *   `malus` : Distance, malus présence personnages
+  * **Esquive** : `1d100 ≤ clamp(cdb_esquive + (DEF - 10) + bonus_luck + bonus_faction, 0, 90)`, cdb conseillé=30.
+  * **Lancer** : `1d100 ≤ clamp(cdb_lance + (DEX - 10) + autres_bonus, 0, 95)`, cdb=25.
+  * **Jeu** : `1d100 ≤ clamp(cdb_jeu + (INT - 10) + (DEX - 10) + (LUK - 10) + autres_bonus, 0, 95)`, cdb conseillé=25.
-#### Compétences spécifiques
+''bonus_luck'' recommandé : ''floor(LUK / 5)'', avec plafond ''4''.
-*   **Bagarre** : `1d100 ≤ cdb` (cdb=90), attaque parfaite si \<5.\\
+====== Exemples rapides (stats à 15) ======
-*   **Arme mêlée** : `1d100 ≤ (cdb + ca + FOR)`, cdb=35, max=95.\\
+  * **Arme mêlée** : `35 + ca 10 + (15-10) = 50%`.
-*   **Arme distance** : `1d100 ≤ (cdb + ca + DEX) - distance`, cdb=25, max=95.\\
+  * **Arme distance** : `25 + ca 10 + (15-10) - distance 8 = 32%`.
-*   **Magie** : `1d100 ≤ (cdb + INT + DEX + bonus_faction)`, cdb basé sur INT.\\
+  * **Magie** (bonus faction 2) : `25 + 5 + 5 + 2 = 37%`.
-*   **Esquive** : `1d100 ≤ (cdb + DEF + bonus_luck)`, cdb basé sur DEF.\\
+  * **Esquive** (LUK=15, bonus_luck=3, bonus faction 2) : `30 + 5 + 3 + 2 = 40%`.
-*   **Lancer** : `1d100 ≤ cdb`, cdb=25, max=95.\\
-*   **Jeu** : `1d100 ≤ (cdb + INT + DEX + LUK)`, cdb basé sur INT+DEX+LUK.\\
-### Implémentation dans le code
+====== Implémentation dans le code ======
-#### Classes principales
+====== Classes principales ======
-- `Game_personnage` : Méthodes `caracs()` pour récupérer les valeurs.
+  * `Game_personnage` : Méthodes `caracs()` pour récupérer les valeurs.
-- `Game_attaque` : Gestion des jets d'attaque et esquive.
+  * `Game_attaque` : Gestion des jets d'attaque et esquive.
-- `Game_sort` : Jets de magie et contre-magie.
+  * `Game_sort` : Jets de magie et contre-magie.
-#### Méthodes clés
+====== Méthodes clés ======
-- `checkPAenough()` : Vérification PA avant action.
+  * `checkPAenough()` : Vérification PA avant action.
-- `updatePA()` : Déduction PA.
+  * `updatePA()` : Déduction PA.
-- `updateXP()` : Gain d'XP après succès.
+  * `updateXP()` : Gain d'XP après succès.
-- `BonusFaction()` : Calcul bonus factionnel.
+  * `BonusFaction()` : Calcul bonus factionnel.
-#### Gestion des malus
+====== Gestion des malus ======
-- **Distance** : Pour armes distance, -1 par case >1.
+  * **Distance** : Pour armes distance, -1 par case >1.
-- **Présence personnages** : Malus basé sur proximité autres persos du compte.
+  * **Présence personnages** : Malus basé sur proximité autres persos du compte.
-- **Faction** : Bonus log2(nb_alliés +1).
+  * **Faction** : Bonus log2(nb_alliés +1).
-### Équilibrage et options
+====== Équilibrage et options ======
-- Options configurables : `cout_action_attaque`, `xp_action_magie`, etc.
+  * Options configurables : `cout_action_attaque`, `xp_action_magie`, etc.
-- Logs : Suivi des jets dans `application/logs/`.
+  * Logs : Suivi des jets dans `application/logs/`.
-- Tests : Vérifications serveur pour redistribution de points.
+  * Tests : Vérifications serveur pour redistribution de points.
-### Points à améliorer
+====== Points à améliorer ======
-- Intégration buffs/debuffs sur compétences.
+  * Intégration buffs/debuffs sur compétences.
-- Système de spécialisations avancées.
+  * Système de spécialisations avancées.
-- Interface UI pour visualisation des jets.
+  * Interface UI pour visualisation des jets.