Les paramètres par défaut des feuilles sont utilisés pour modifier les informations, les options et la présentation par défaut denouvelles feuilles ajoutées à un jeu. Si une feuille de personnage dispose de paramètres par défaut disponibles, ils peuvent être trouvés sur la page des paramètres du jeu. Changer les paramètres par défaut n'affecte pas les feuilles de personnage existantes.
Les feuilles de personnage peuvent stocker des paramètres pour tous les personnages dans la sectionuseroptionsdu fichier sheet.json. Ces paramètres peuvent être facilement mis à jour dans les paramètres du jeu. Un exemple simple de ce qui peut être fait avec ces paramètres peut être trouvé dans le fichier sheet.json de Star Trek. Des exemples plus complexes peuvent être trouvés dans les fichiers sheet.json officiels de Pathfinder, ou Fate Core.
Il n'est pas possible de tester à l'avance les changements ou l'ajout de paramètres par défaut sur une feuille avant de soumettre une demande de pull au dépôt de feuilles de personnage. Il est conseillé de tester les paramètres par défaut des feuilles existantes ainsi que les exemples donnés ici, puis de les imiter dans leur structure.
Si vous recherchez le référentiel Roll20 Sheet pour les utilisations de "useroptions", vous pouvez trouver d'autres exemples de l'option par défaut dans l'utilisation.
Certaines des paramètres par défaut de 5ème édition par Roll20
Usage courant
- Basculer le mode par défaut d'une feuille entre PC/NPC. Exemple : 5ème édition OGL par Roll20
- Ajuster le montant par défaut de l'or/crédit de départ avec une nouvelle feuille de personnage. Exemple : Star Wars D6
- Basculer les options utilisateur, telles que l'activation/désactivation des fenêtres contextuelles de requête de lancer depuis les boutons de lancer. Exemple : Star Wars D6
Options des champs de données
-
attribut - le nom de la variable de feuille définie avec cette option. Ne pas inclure le préfixe
attr_dans le nom. - affiché- Élément de titre de la sélection
- displaytranslationkey - i18n clé de traduction pour la traduction dans d'autres langues (pas obligatoire si la fiche n'utilise pas de traductions)
-
type- l'élément d'entrée HTML à utiliser dans la page des paramètres du jeu. Les options incluent:
sélectionner,radio,case à cocher,texte,nombre-
coché- Si vous voulez qu'une case à cocher soit pré-cochée par défaut, ajoutez
"checked": "checked",sous l'attribut - options- Si votre élément d'entrée a des options prédéfinies, les paires clé/valeur sont répertoriées ici
- optiontranslationkeys- clés de traduction i18n pour les options (non obligatoire si la feuille n'utilise pas de traductions)
- valeur par défautouvaleur- la valeur par défaut de l'attribut. Si utilisé pour une entrée de sélection avec plusieurs options, définissez ceci sur la valeur de la sélection par défaut souhaitée, sans inclure la clé. Utilisez soitvaleurpar défaut ouvaleur.
-
coché- Si vous voulez qu'une case à cocher soit pré-cochée par défaut, ajoutez
- description- une chaîne de texte utilisée pour donner plus de détails sur l'option et les changements qu'elle contrôle
- clé de traduction de la description- clé de traduction i18n utilisée pour la description (non obligatoire si la feuille n'utilise pas de traductions)
Exemples
Quelques exemples de paramètres par défaut actuellement utilisés.
Fate Corepar MagooChris
Contient des exemples de saisie de texte, de cases à cocher (certaines pré-cochées par défaut), de valeurs par défaut et de l'utilisation de balises de langue pour le support multilingue.
"useroptions" : [
{
"attribute" : "show_hints_flag",
"displayname" : "Show First Time Hints",
"displaytranslationkey" : "ShowHints-Q",
"type" : "checkbox",
"value" : "1",
"checked" : "checked",
"description" : "Show hints that might be useful for first time players or those upgrading from the previous sheet design.",
"descriptiontranslationkey" : "ShowHints-D"
},
{
"attribute" : "run_firstTime_setup",
"displayname" : "Run First Time Setup",
"displaytranslationkey" : "RunFirstTimeSetup-Q",
"type" : "checkbox",
"value" : "1",
"checked" : "checked",
"description" : "Exécuter des scripts pour configurer la feuille pour un caractère par défaut",
"descriptiontranslationkey" : "RunFirstTimeSetup-D"
},
{
"attribute" : "default_stressSkills",
"displayname" : "Stress et compétences par défaut",
"displaytranslationkey" : "DefaultStressSkill-Q",
"type" : "text",
"default" : "Physical:Physique,Mental:Will",
"description" : "Lors de la mise en place d'une feuille par défaut, quelles pistes de stress et leur compétence directrice doivent être mises en place ? par exemple \"Mental:Will,Extra:3\"",
"descriptiontranslationkey": "DefaultStressSkill-D"
},
{
"attribute": "attr_default_consequences",
"displayname": "Consequences par défaut",
"displaytranslationkey": "DefaultConsequences-Q",
"type": "text",
"default": "2,4,6",
"description": "Lors de la configuration d'une feuille par défaut, quelles sont les conséquences par défaut? e.g. \"2,4,6\"",
"descriptiontranslationkey": "DefaultConsequences-D"
},
{
"attribute": "show_conditions_flag",
"displayname": "Utiliser les conditions au lieu des conséquences",
"displaytranslationkey": "ShowConditions-Q",
"type": "checkbox",
"value": "1",
"description": "Utilisez les conditions du Fate Toolkit pour remplacer les conséquences",
"descriptiontranslationkey": "ShowConditions-Q"
},
{
"attribute": "show_phase0_flag",
"displayname": "Afficher l'onglet Phase 0",
"displaytranslationkey": "ShowPhase0-Q",
"type": "checkbox",
"value": "1",
"checked": "checked",
"description": "Si vous commencez par une Phase 0, vous pouvez utiliser cet onglet pour développer vos idées.",
"descriptiontranslationkey": "ShowPhase0-Q"
},
{
"attribute": "show_notesTab_flag",
"displayname": "Afficher l'onglet Notes",
"displaytranslationkey": "ShowNotesTab-Q",
"type": "checkbox",
"value": "1",
"description": "Activez ceci si vous préférez que les notes s'affichent sur un onglet dédié.",
"descriptiontranslationkey": "ShowNotesTab-Q"
}
]Star Wars D6parAndreas J.
Contient des exemples d'options de menu déroulant, de cases à cocher, d'entrées numériques et de valeurs par défaut.
La feuille ne contient pas de balises de traduction, elles sont donc également exclues des paramètres par défaut.
"useroptions" : [
{
"attribute" : "sheettype",
"displayname" : "Sheet Type : ",
"type" : "select",
"options" : [
"PC|0",
"NPC|1",
"Ship|2",
"Container|3"
],
"default" : "0",
"description" : "PC est la feuille normale, NPC est une version compacte de la même, Ship montre les blocs de stat pour le navire seulement, et Container montre seulement les sections Armes/Armorations/Equipement (simulant l'affichage d'un conteneur ou d'un magasin)."
},
{
"attribute": "gmrollswitch",
"displayname": "Masquer les jets de MJ : ",
"type": "case à cocher",
"value": "1",
"description": "Lorsque cette case est cochée, la fiche masque les dés supplémentaires qui effectuent des jets cachés au MJ."
},
{
"attribute": "rollmodswitch",
"displayname": "Désactiver la demande de modificateurs : ",
"type": "case à cocher",
"value": "1",
"description": "Si cochée, les jets ne demandent pas de modificateurs et roulent immédiatement lors de leur sélection."
},
{
"attribute": "wilddie",
"displayname": "Utiliser le dé effroyable : ",
"type": "sélectionner",
"options": [
"Oui|!cf1cs6",
"Non|cf0cs0"
],
"défaut": "!cf1cs6",
"description": "Si le dé effroyable n'est pas utilisé, le dernier dé n'explosera pas et ne mettra pas en évidence les succès/échecs critiques."
},
{
"attribute": "forceswitch",
"displayname": "Masquer la section Force : ",
"type": "checkbox",
"value": "1",
"description": "Pratique pour ceux qui ne sont pas sensibles à la Force."
},
{
"attribute": "equipmentswitch",
"displayname": "Masquer la section Équipement : ",
"type": "checkbox",
"value": "1",
"description": "Pratique pour ceux qui ne sont pas sensibles à la Force."
},
{
"attribute": "backgroundswitch",
"displayname": "Masquer la section Arrière-plan : ",
"type": "checkbox",
"value": "1",
"description": "Masque l'histoire personnelle & Divers. section"
},
{
"attribute": "cpswitch",
"displayname": "Masquer le résumé des points de personnage : ",
"type": "case à cocher",
"value": "1",
"description": "Masque la table de résumé des points de personnage utilisée pour suivre l'historique des gains/dépenses"
},
{
"attribute": "creditswitch",
"displayname": "Masquer le résumé des crédits : ",
"type": "case à cocher",
"value": "1",
"description": "Masque la section de résumé des crédits utilisée pour suivre l'historique des soldes"
},
{
"attribute": "credits",
"displayname": "Crédits de départ : ",
"type": "nombre",
"value": "1000",
"description": "Combien de crédits un personnage commence avec."
},
{
"attribute": "characterPoints",
"displayname": "Points de personnage : ",
"type": "number",
"value": "0",
"description": "Nombre de points de personnage avec lesquels un personnage commence."
},
{
"attribute": "forcePoints",
"displayname": "Points de Force : ",
"type": "number",
"value": "1",
"description": "Nombre de Points de Force avec lesquels un personnage commence."
}
]