ForHosting KIT · Outils pour développeurs

Calculateur de difficulté des rencontres D&D et budget XP

Préparez un combat de cinquième édition adapté au groupe sans vous fier à une estimation approximative.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez un niveau pour chaque personnage joueur et un facteur de puissance pour chaque monstre. Le calculateur additionne les XP des monstres, applique le multiplicateur standard lié au nombre d'ennemis et à la taille du groupe, établit les seuils facile, moyen, difficile et mortel, puis affiche la difficulté obtenue. Il offre aux maîtres de jeu une référence rapide avant une séance ou pendant la partie.

Décrivez l'ensemble du groupe et des monstres

Ajoutez une valeur dans niveaux des joueurs pour chaque personnage participant. Les répétitions sont voulues : quatre personnages de niveau 3 doivent être saisis sous la forme 3, 3, 3 et 3. Le nombre de valeurs détermine la taille du groupe ; aucun compteur distinct ne risque donc de contredire les niveaux. Ajoutez ensuite un facteur de puissance pour chaque créature hostile. Employez les valeurs décimales pour les fractions : 0.125 pour FP 1/8, 0.25 pour FP 1/4 et 0.5 pour FP 1/2. Le FP 0 et les nombres entiers jusqu'à 30 sont également acceptés. Comptez les monstres qui devraient agir de manière significative dans le même combat, mais écartez les dangers, les créatures neutres et les renforts peu probables. Si le combat comporte plusieurs vagues séparées par un temps de récupération ou de repositionnement, calculez-les séparément : le résultat sera souvent plus utile que si toutes les créatures étaient présentes simultanément. Au moins un personnage est indispensable, car aucun seuil ne peut être établi sans groupe.

Comprenez le calcul du budget de XP

Chaque niveau de personnage possède quatre seuils de XP publiés : facile, moyen, difficile et mortel. Le calculateur les additionne pour tout le groupe et prend ainsi naturellement en charge les groupes de niveaux différents. Il convertit aussi chaque facteur de puissance en valeur de XP, puis additionne ces valeurs pour obtenir les XP de base des monstres. Plusieurs ennemis sont plus dangereux qu'une seule créature offrant autant de XP, car ils disposent de davantage de tours et menacent plusieurs cibles. La méthode standard applique donc un multiplicateur selon leur nombre. Celui-ci monte d'un cran pour moins de trois personnages et descend d'un cran à partir de six. Les XP ajustés servent uniquement à classer la difficulté ; les XP de base restent la référence pour la récompense habituelle. Le résultat présente les deux montants, le multiplicateur retenu et les quatre seuils du groupe afin que vous puissiez vérifier l'origine du classement. Toute valeur inférieure au seuil moyen est annoncée comme facile afin de respecter les quatre catégories demandées.

Considérez la difficulté comme un repère, non une promesse

Un budget de XP constitue un point de départ cohérent, mais ne modélise pas tous les éléments tactiques. Le terrain, la surprise, la portée, les abris, les synergies, les ressources épuisées, les objets magiques, l'optimisation et l'expérience des joueurs peuvent modifier fortement le danger réel. La mention mortelle signifie que les XP ajustés atteignent ce seuil ; elle ne garantit pas la mort d'un personnage. De même, facile ne protège pas contre une série de mauvais jets. Surveillez particulièrement les capacités qui contournent les points de vie, les monstres capables d'abattre un personnage débutant en un coup et les champs de bataille étroits. La méthode perd aussi en précision lorsque de nombreux ennemis faibles gonflent le multiplicateur sans menacer véritablement le groupe. Utilisez les seuils pour ajuster la composition : retirez un monstre, baissez un facteur de puissance ou séparez les ennemis en vagues, puis recommencez le calcul. Pour une journée d'aventure, tenez également compte des autres rencontres et des possibilités de repos.

Cas d’usage

Préparer une séance

Comparez les monstres prévus aux niveaux précis et à la taille réelle du groupe avant de jouer.

Ajuster un groupe de niveaux variés

Additionnez les seuils individuels de personnages de niveaux différents sans recourir à une moyenne.

Comparer plusieurs variantes

Ajoutez ou retirez des monstres, puis comparez XP ajustés, multiplicateurs et classements avant votre choix final.

Questions fréquentes

Quelles règles de D&D ce calculateur applique-t-il ?

Il utilise les seuils de XP, les valeurs des monstres et les multiplicateurs standard de création des rencontres de cinquième édition, généralement associés aux règles de base de 2014.

Comment saisir un facteur de puissance fractionnaire ?

Saisissez FP 1/8 sous la forme 0.125, FP 1/4 sous la forme 0.25 et FP 1/2 sous la forme 0.5.

Pourquoi les XP de base diffèrent-ils des XP ajustés ?

Les XP de base additionnent les valeurs des monstres. Les XP ajustés appliquent le multiplicateur pour classer la difficulté, et non pour fixer la récompense habituelle.

Comment la taille du groupe intervient-elle ?

Le nombre de niveaux saisis fixe la taille. Avec moins de trois personnages, le multiplicateur monte d'un cran ; à partir de six, il descend d'un cran.

Une rencontre peut-elle se situer sous le seuil facile ?

La sortie reste limitée aux quatre catégories demandées ; toute valeur ajustée inférieure au seuil moyen est donc classée comme facile.

Combien coûte un calcul par API ?

Chaque requête API coûte $0.002. Le même calcul déterministe peut aussi être exécuté dans le navigateur.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_levels":[3,3,3,3],"monster_challenge_ratings":[1,1]}'

const res = await fetch("https://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "player_levels": [
      3,
      3,
      3,
      3
    ],
    "monster_challenge_ratings": [
      1,
      1
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "player_levels": [
        3,
        3,
        3,
        3
    ],
    "monster_challenge_ratings": [
        1,
        1
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"player_levels":[3,3,3,3],"monster_challenge_ratings":[1,1]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"player_levels":[3,3,3,3],"monster_challenge_ratings":[1,1]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/dnd-encounter-difficulty-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "player_levels": [
    3,
    3,
    3,
    3
  ],
  "monster_challenge_ratings": [
    1,
    1
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.dnd_encounter_difficulty_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_players`	20
`max_monsters`	50

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →