Contribuer un système de jeu

Pour les contributeurs : le format d'un système (fiche, formules, jets, listes), le contenu autorisé et la proposition au catalogue.

Un système de jeu, dans Striped Dice, est un fichier JSON : il décrit la fiche de personnage, ses formules, ses jets et ses listes de référence. Les 21 systèmes du catalogue sont écrits ainsi ; l'éditeur sans code et l'import de règles produisent le même format.

Contenu autorisé

La règle est stricte : noms et valeurs mécaniques seulement. Une compétence et sa base, une arme et ses dégâts, un sort et son niveau : oui. Un paragraphe de description, une illustration, un scénario, un extrait de texte : jamais. Chaque système porte une mention qui le dit (« Système compatible avec X. X est une marque de Y ; les textes des livres de règles ne sont pas reproduits. »).

Les licences libres (CC-BY, ORC, Cypher Open) autorisent davantage ; on garde pourtant la même ligne, par prudence et par simplicité.

La structure

{
  "slug": "mon-jeu", "nom": "Mon jeu", "version": "1.0.0",
  "famille": "d20", "licence": { "type": "compatible", "libelle": "…" }, "mention": "…",
  "token": { "nom": "nom", "pv": "pv", "pv_max": "pv_max" },
  "onglets": [ { "id": "perso", "titre": "Personnage" } ],
  "sections": [
    { "id": "caracs", "titre": "Caractéristiques", "onglet": "perso", "colonnes": 3, "champs": [
      { "id": "for", "type": "nombre", "libelle": "Force", "defaut": 10 },
      { "id": "for_mod", "type": "formule", "libelle": "Mod. Force", "formule": "floor((for - 10) / 2)", "signe": true,
        "jet": { "libelle": "Test de Force", "mecanique": "d20", "bonus": "for_mod" } }
    ] }
  ],
  "jets": [ { "id": "initiative", "libelle": "Initiative", "mecanique": "d20", "bonus": "dex_mod" } ]
}

• Champs : texte, texte_long, nombre, jauge (valeur et maximum), case, liste (avec options, ou source = une liste de référence, multiple pour plusieurs choix), de, tableau (colonnes typées, lignes ajoutées par le joueur), formule, titre.
• Formules : arithmétique, floor, ceil, round, min, max, abs, somme, conditions (si(x > 10, 1, 0)), raccourcis mod5(x) (modificateur D&D) et moitie(x), et les identifiants des autres champs. Elles se recalculent en direct, dans l'ordre qu'il faut.
• Jets : une mécanique (d20, d100_sous, pool_seuil, pool_d10, d6_system, d100_ouvert, expression, cypher, fate, ironsworn) avec ses paramètres (bonus, cible, seuil, dd…). La barre d'options de jet (avantage, DD, difficulté, dés bonus) découle de la famille.
• Listes de référence : resources/systemes/<slug>/donnees/<liste>.json, des entrées { "nom": "Épée longue", "degats": "1d8" }. Un champ liste avec source les propose ; remplit recopie des valeurs dans d'autres champs ; prerempli sur un tableau crée toutes les lignes d'avance (les 55 compétences de RuneQuest).
• Initiative, défenses, import Roll20 : blocs optionnels qui branchent le suivi des tours, les résistances aux dégâts et l'import d'une fiche Roll20.
• Versions : version en semver et, quand la fiche change, des migrations (renommer, valeur par défaut, supprimer, formule, vers tableau) appliquées aux fiches existantes à la lecture.
• Anglais : un fichier <slug>.en.json traduit les libellés par identifiant, <slug>.en.donnees.json les listes par nom français. Jamais une valeur comparée dans une formule.

Le schéma complet est resources/systemes/schema.json ; la page « règles prises en compte » de chaque système du catalogue montre le résultat.

Écrire sans coder

Dans Systèmes, « Dériver cette fiche » copie un système existant dans votre espace ; l'éditeur permet d'ajouter sections, champs, formules et jets avec un aperçu en direct. Un système personnel n'est visible que de vous, dans vos campagnes, jusqu'à ce qu'un administrateur le publie.

Proposer un système au catalogue

Écrivez-nous sur le Discord (salon systèmes de jeu) avec : le nom du jeu, l'éditeur, la licence ou la raison pour laquelle des mécaniques compatibles suffisent, et votre fiche (exportée depuis l'éditeur, ou le JSON). Un administrateur relit, teste (FicheTest valide chaque fichier contre le schéma), ajoute la mention légale et publie. Les jeux d'origine française sont particulièrement bienvenus.

La page Systèmes de jeu : le catalogue, vos fiches et le formulaire « Proposer un JDR ».