As Configurações Padrão para fichas são usadas para fazer alterações nas informações, opções e apresentação padrão de fichas novas adicionadas a um jogo. Se uma Ficha de Personagem tiver Configurações Padrão disponíveis, elas podem ser encontradas na Página de Configurações do Jogo. Alterar quaisquer Configurações Padrão não afeta as fichas de personagem existentes.
As Fichas de Personagem podem armazenar configurações para todos os personagens na seçãouseroptionsdo arquivo sheet.json. Essas configurações podem ser atualizadas facilmente nas Configurações do Jogo. Um exemplo simples do que pode ser feito com essas configurações pode ser encontrado no arquivo sheet.json de Star Trek. Exemplos mais complexos podem ser encontrados no arquivo Pathfinder Official sheet.json, ou em Fate Core.
Alterar ou adicionar Configurações Padrão a uma ficha não pode ser testado antecipadamente antes de enviar um PR para o repositório da ficha de personagem. É uma boa ideia testar as configurações padrão das fichas existentes e os exemplos fornecidos aqui, e então imitar sua estrutura.
Seprocurar no repositório Roll20 Sheetas utilizações de"useroptions"pode encontrar mais exemplos de utilização da opção Default.
Algumas das Configurações Padrão de5ª Edição por Roll20
Uso Comum
- Alternar modo padrão de uma planilha entre PC/NPC. Exemplo: 5ª Edição OGL por Roll20
- Ajustar a quantidade padrão de ouro/crédito inicial com que uma nova planilha de personagem começa. Exemplo: Star Wars D6
- Alternar opções do usuário, como ligar/desligar pop-ups de consulta de rolagem a partir de botões de rolagem. Exemplo: Star Wars D6
Opções de campos de dados
-
atributo- o nome da variável da planilha definida com esta opção. Não inclua o prefixo
attr_no nome. - displayname - Elemento de título da seleção
- displaytranslationkey - i18n chave de tradução para tradução em outros idiomas (não obrigatório se a ficha não usar traduções)
-
type - o elemento de entrada HTML a ser usado na página de Configurações do Jogo. As opções incluem:
select,radio,checkbox,text,number-
checked - Se você deseja que uma caixa de seleção esteja marcada por padrão, adicione
"checked": "checked",sob o atributo - options - Se o seu elemento de entrada tiver opções predefinidas, os pares chave/valor são listados aqui
- optiontranslationkeys - chaves de tradução i18n para as opções (não obrigatório se a planilha não usar traduções)
- padrão ou valor - o valor padrão do atributo. Se usado para uma entrada de seleção com várias opções, defina isso como o valor da seleção padrão desejada, sem incluir a chave. Use tanto padrão ou valor.
-
checked - Se você deseja que uma caixa de seleção esteja marcada por padrão, adicione
- descrição - uma string de texto usada para fornecer mais detalhes sobre a opção e as alterações que ela controla
- descriçãochavetradução - chave de tradução i18n usada para a descrição (não obrigatório se a planilha não usar traduções)
Exemplos
Alguns exemplos de Configurações Padrão atualmente em uso.
Fate Core por MagooChris
Contém exemplo de entradas de texto, caixas de seleção (algumas marcadas por padrão), valores padrão e uso de tags de idioma para suporte multilíngue.
"useroptions": [
{
"attribute": "show_hints_flag",
"displayname": "Mostrar Dicas Iniciais",
"displaytranslationkey": "MostrarDicas-Q",
"type": "checkbox",
"value": "1",
"checked": "checked",
"description": "Mostrar dicas que podem ser úteis para jogadores iniciantes ou aqueles que estão atualizando a partir do design anterior da ficha.",
"descriptiontranslationkey": "MostrarDicas-D"
},
{
"attribute": "run_firstTime_setup",
"displayname": "Executar Configuração Inicial",
"displaytranslationkey": "ExecutarConfiguracaoInicial-Q",
"type": "checkbox",
"value": "1",
"checked": "checked",
"description": "Executar scripts para configurar a ficha para um personagem padrão.",
"descriptiontranslationkey": "ExecutarConfiguracaoInicial-D"
},
{
"attribute": "default_stressSkills",
"displayname": "Estresses e Habilidades Padrão",
"displaytranslationkey": "EstresseHabilidadePadrao-Q",
"type": "text",
"default": "Físico:Físico,Mental:Vontade",
"description": "Ao configurar uma ficha padrão, quais faixas de estresse e suas habilidades guias devem ser configuradas? por exemplo, \"Mental:Vontade,Extra:3\"",
"descriptiontranslationkey": "DefaultStressSkill-D"
},
{
"attribute": "attr_default_consequences",
"displayname": "Consequências Padrão",
"displaytranslationkey": "DefaultConsequences-Q",
"type": "text",
"default": "2,4,6",
"description": "Ao configurar uma ficha padrão, quais são as consequências padrão?" Por exemplo, \"2,4,6\"",
"descriptiontranslationkey": "DefaultConsequences-D"
},
{
"attribute": "show_conditions_flag",
"displayname": "Utilize Condições em vez de Consequências",
"displaytranslationkey": "ShowConditions-Q",
"type": "checkbox",
"value": "1",
"description": "Use as Condições do Conjunto de Ferramentas do Destino para substituir as Consequências",
"descriptiontranslationkey": "ShowConditions-Q"
},
{
"attribute": "show_phase0_flag",
"displayname": "Mostrar Separador Fase 0",
"displaytranslationkey": "ShowPhase0-Q",
"type": "checkbox",
"value": "1",
"checked": "checked",
"description": "Se está a começar com uma Fase 0, pode utilizar este separador para desenvolver as suas ideias.",
"descriptiontranslationkey": "ShowPhase0-Q"
},
{
"attribute": "show_notesTab_flag",
"displayname": "Mostrar separador Notas",
"displaytranslationkey": "ShowNotesTab-Q",
"type": "checkbox",
"value": "1",
"description": "Defina esta opção se preferir que as notas sejam apresentadas num separador próprio.",
"descriptiontranslationkey": "ShowNotesTab-Q"
}
]Star Wars D6por Andreas J.
Contém exemplo de opções de menu suspenso, caixas de seleção, entradas de número e valores padrão.
A ficha não contém tags de tradução, portanto elas também são deixadas de fora das Configurações Padrão.
"useroptions": [
{
"attribute": "sheettype",
"displayname": "Tipo de Ficha: ",
"type": "select",
"options": [
"PC|0",
"NPC|1",
"Nave|2",
"Container|3"
],
"default": "0",
"description": "PC é a ficha normal, NPC é uma versão compacta da mesma, Nave mostra blocos de estatísticas apenas para naves e Container mostra apenas as seções de Arma/Armadura/Equipamento (simulando um contêiner ou exibição de loja)."
},
{
"attribute": "gmrollswitch",
"displayname": "Esconder Rolagens do Mestre: ",
"type": "checkbox",
"value": "1",
"description": "Quando marcado, a ficha esconde os dados extras que fazem rolagens ocultas para o Mestre."
},
{
"attribute": "rollmodswitch",
"displayname": "Desativar Consulta de Modificadores de Rolagem: ",
"type": "checkbox",
"value": "1",
"description": "Se marcado, as rolagens não solicitam modificadores de rolagem e rolam imediatamente ao serem selecionadas."
},
{
"attribute": "wilddie",
"displayname": "Usar Dado Selvagem: ",
"type": "select",
"options": [
"Sim|!cf1cs6",
"Não|cf0cs0"
],
"default": "!cf1cs6",
"description": "Se o Dado Selvagem não for usado, o último dado não irá explodir ou destacar sucessos/falhas críticos."
},
{
"attribute": "forceswitch",
"displayname": "Ocultar Seção de Força: ",
"type": "checkbox",
"value": "1",
"description": "Prático para aqueles que não são sensíveis à Força."
},
{
"attribute": "equipmentswitch",
"displayname": "Ocultar Seção de Equipamentos: ",
"type": "checkbox",
"value": "1",
"description": "Prático para aqueles que não são sensíveis à Força."
},
{
"attribute": "backgroundswitch",
"displayname": "Ocultar Seção de Histórico: ",
"type": "checkbox",
"value": "1",
"description": "Oculta História de Fundo & Misc. section"
},
{
"attribute": "cpswitch",
"displayname": "Ocultar Resumo de Pontos do Personagem: ",
"type": "checkbox",
"value": "1",
"description": "Oculta a tabela de Resumo de Pontos do Personagem usada para rastrear o histórico de ganho/utilização"
},
{
"attribute": "creditswitch",
"displayname": "Ocultar Resumo de Créditos: ",
"type": "checkbox",
"value": "1",
"description": "Oculta a seção de Resumo de Créditos usada para rastrear o histórico de saldo"
},
{
"attribute": "credits",
"displayname": "Créditos Iniciais: ",
"type": "number",
"value": "1000",
"description": "Quantos créditos um personagem começa"
},
{
"attribute": "characterPoints",
"displayname": "Pontos do Personagem: ",
"type": "number",
"value": "0",
"description": "Quantos Pontos de Personagem um personagem começa."
},
{
"attribute": "forcePoints",
"displayname": "Pontos de Força: ",
"type": "number",
"value": "1",
"description": "Quantos Pontos de Força um personagem começa."
}
]