Différences

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

--- doc-competence [2026/02/14 19:16] – [2\. Orienté technique] 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.
-    *   Utilisation : Combats avec armes de mêlée, parries.
-    *   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.
-    *   Utilisation : Tirs à distance, attaques sur cibles mobiles.
-    *   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.
-    *   Utilisation : Lancer des sorts offensifs, défensifs ou de soin.
-    *   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.
-    *   Utilisation : Éviter les coups en combat, se protéger des projectiles.
-    *   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.
-    *   Utilisation : Jeter des objets (pierres, potions), lancer des sorts à distance.
-    *   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.
-    *   Utilisation : Résoudre des puzzles, gagner des mini-jeux, ouvrir des serrures.
-    *   Avantages : Accès à des récompenses cachées, exploration enrichie.
-### Évolution et utilisation
+  * **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.
+    * Avantages : Dégâts élevés, contrôle du combat rapproché.
-*   Les compétences s'améliorent en distribuant des points d'expérience gagnés lors des actions réussies.
+  * **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.
-*   Chaque compétence a un seuil de réussite (ex: 1d100 ≤ compétence + bonus).
+    * Utilisation : Tirs à distance, attaques sur cibles mobiles.
-*   Les compétences influencent les jets de dés pour déterminer le succès des actions.
+    * Avantages : Sécurité à distance, contrôle des zones.
-## 2\. Orienté technique
-Cette section détaille l'implémentation technique des compétences dans le code et la base de données.
+  * **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.
+    * Avantages : Versatilité, effets spéciaux (dégâts magiques, buffs).
-### Structure de données
+  * **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.
+    * Avantages : Réduction des dégâts reçus, mobilité tactique.
-#### Table `competences` (si existante)
+  * **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.
+    * Avantages : Polyvalence, pas limité aux armes dédiées.
-*   `id` : Identifiant unique
+  * **Jeu** : Aptitude aux mini-jeux et énigmes. Combine intelligence, dextérité et chance pour résoudre des défis.
-*   `nom` : Nom de la compétence (ex: "Bagarre")
+    * Utilisation : Résoudre des puzzles, gagner des mini-jeux, ouvrir des serrures.
-*   `description` : Description technique
+    * Avantages : Accès à des récompenses cachées, exploration enrichie.
-*   `carac_principale` : Caractéristique associée (FOR, DEF, etc.)
-*   `formule_base` : Formule de calcul (ex: "cdb + ca + FOR")
-#### Évolution des compétences
+====== Évolution et utilisation ======
+  * 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).
+  * Les compétences influencent les jets de dés pour déterminer le succès des actions.
-*   Points distribués par niveau : 500 points total sur 100 niveaux, dégressif (15 pts niv 1, 4 pts niv 100).
+====== 2. Orienté technique ======
-*   Limite par montée : max points = niveau / 3 (arrondi inférieur).
-*   Progression par race : Voir tableau dans regles-techniques.md.
-### Calculs techniques
+Cette section détaille l'implémentation technique des compétences dans le code et la base de données.
-#### Jets de compétence
+====== Structure de données ======
-*   Formule générale : `1d100 ≤ (cdb + ca + carac + bonus - malus)`\\
+====== Table `competences` (si existante) ======
-*   `cdb` : Compétence de base (ex: 90 pour Bagarre)\\
+  * `id` : Identifiant unique
-*   `ca` : Compétence de l'arme/équipement\\
+  * `nom` : Nom de la compétence (ex: "Bagarre")
-*   `carac` : Caractéristique associée\\
+  * `description` : Description technique
-*   `bonus` : Faction, buffs temporaires\\
+  * `carac_principale` : Caractéristique associée (FOR, DEF, etc.)
-*   `malus` : Distance, malus présence personnages\\
+  * `formule_base` : Formule de calcul (ex: "clamp(cdb + ca + (FOR - 10), 0, 95)")
-#### Compétences spécifiques
+====== É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.
-*   **Bagarre** : `1d100 ≤ cdb` (cdb=90), attaque parfaite si \<5.\\
+====== Calculs techniques ======
-*   **Arme mêlée** : `1d100 ≤ (cdb + ca + FOR)`, cdb=35, max=95.\\
-*   **Arme distance** : `1d100 ≤ (cdb + ca + DEX) - distance`, cdb=25, max=95.\\
-*   **Magie** : `1d100 ≤ (cdb + INT + DEX + bonus_faction)`, cdb basé sur INT.\\
-*   **Esquive** : `1d100 ≤ (cdb + DEF + bonus_luck)`, cdb basé sur DEF.\\
-*   **Lancer** : `1d100 ≤ cdb`, cdb=25, max=95.\\
-*   **Jeu** : `1d100 ≤ (cdb + INT + DEX + LUK)`, cdb basé sur INT+DEX+LUK.\\
-### Implémentation dans le code
+====== Jets de compétence ======
+  * Formule générale : `1d100 ≤ clamp(cdb + ca + bonus_carac + bonus - malus, 0, max_competence)`
+    * `cdb` : Compétence de base (ex: 90 pour Bagarre)
+    * `ca` : Compétence de l'arme/équipement
+    * `bonus_carac` : Conversion de caractéristique, `stat - 10`
+    * `bonus` : Faction, buffs temporaires
+    * `malus` : Distance, malus présence personnages
-#### Classes principales
+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 `%`.
-*   `Game_personnage` : Méthodes `caracs()` pour récupérer les valeurs.
+====== Compétences spécifiques ======
-*   `Game_attaque` : Gestion des jets d'attaque et esquive.
+  * **Bagarre** : `1d100 ≤ cdb` (cdb=90), attaque parfaite si <5.
-*   `Game_sort` : Jets de magie et contre-magie.
+  * **Arme mêlée** : `1d100 ≤ clamp(cdb + ca + (FOR - 10) + autres_bonus, 0, 95)`, cdb=35.
+  * **Arme distance** : `1d100 ≤ clamp(cdb + ca + (DEX - 10) - malus_distance + autres_bonus, 0, 95)`, cdb=25.
+  * **Magie** : `1d100 ≤ clamp(cdb_magie + (INT - 10) + (DEX - 10) + bonus_faction + autres_bonus, 0, 95)`, cdb conseillé=25.
+  * **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.
-#### Méthodes clés
+''bonus_luck'' recommandé : ''floor(LUK / 5)'', avec plafond ''4''.
-*   `checkPAenough()` : Vérification PA avant action.
+====== Exemples rapides (stats à 15) ======
-*   `updatePA()` : Déduction PA.
+  * **Arme mêlée** : `35 + ca 10 + (15-10) = 50%`.
-*   `updateXP()` : Gain d'XP après succès.
+  * **Arme distance** : `25 + ca 10 + (15-10) - distance 8 = 32%`.
-*   `BonusFaction()` : Calcul bonus factionnel.
+  * **Magie** (bonus faction 2) : `25 + 5 + 5 + 2 = 37%`.
+  * **Esquive** (LUK=15, bonus_luck=3, bonus faction 2) : `30 + 5 + 3 + 2 = 40%`.
-#### Gestion des malus
+====== Implémentation dans le code ======
-*   **Distance** : Pour armes distance, -1 par case >1.
+====== Classes principales ======
-*   **Présence personnages** : Malus basé sur proximité autres persos du compte.
+  * `Game_personnage` : Méthodes `caracs()` pour récupérer les valeurs.
-*   **Faction** : Bonus log2(nb\_alliés +1).
+  * `Game_attaque` : Gestion des jets d'attaque et esquive.
+  * `Game_sort` : Jets de magie et contre-magie.
-### Équilibrage et options
+====== Méthodes clés ======
+  * `checkPAenough()` : Vérification PA avant action.
+  * `updatePA()` : Déduction PA.
+  * `updateXP()` : Gain d'XP après succès.
+  * `BonusFaction()` : Calcul bonus factionnel.
-*   Options configurables : `cout_action_attaque`, `xp_action_magie`, etc.
+====== Gestion des malus ======
-*   Logs : Suivi des jets dans `application/logs/`.
+  * **Distance** : Pour armes distance, -1 par case >1.
-*   Tests : Vérifications serveur pour redistribution de points.
+  * **Présence personnages** : Malus basé sur proximité autres persos du compte.
+  * **Faction** : Bonus log2(nb_alliés +1).
-### Points à améliorer
+====== Équilibrage et options ======
+  * Options configurables : `cout_action_attaque`, `xp_action_magie`, etc.
+  * Logs : Suivi des jets dans `application/logs/`.
+  * Tests : Vérifications serveur pour redistribution de points.
-*   Intégration buffs/debuffs sur compétences.
+====== Points à améliorer ======
-*   Système de spécialisations avancées.
+  * Intégration buffs/debuffs sur compétences.
-*   Interface UI pour visualisation des jets.
+  * Système de spécialisations avancées.
+  * Interface UI pour visualisation des jets.