Testar e desenvolver
Três ferramentas ajudam a fazer e consertar uma ficha: o modo de teste, para testar sem o RPG Desk; o modo de desenvolvimento, para testar dentro da mesa sem reinstalar a cada mudança; e os erros da página, para achar o que quebrou.
O modo de teste
Seção intitulada “O modo de teste”Abra o arquivo da ficha direto no navegador (dois cliques, ou arrastando para uma aba). Sem o RPG Desk em volta, o rpgdesk.js entra no modo de teste:
- tudo funciona: os campos, as listas, as abas, as contas e as rolagens (sorteadas no navegador);
- os dados ficam guardados no navegador, e voltam ao recarregar a página;
- a faixa no canto tem:
- Papel: Mestre, Dono da ficha ou Outro jogador. Troque para ver o que cada um vê e pode mudar;
- Registro: as rolagens, as mensagens de chat, os avisos, as barras do cartão, os webhooks (de mentira) e os erros. O número laranja conta os erros e as gravações recusadas;
- Limpar dados: começa a ficha do zero.
A faixa fala a língua do navegador. As fichas ao vivo deste site também estão no modo de teste.
O modo de desenvolvimento
Seção intitulada “O modo de desenvolvimento”Para ver a ficha dentro da mesa enquanto você a escreve, sem instalar de novo a cada mudança:
- Instale o plugin na mesa uma vez.
- Sirva a pasta da ficha com um servidor local. Por exemplo, com o Node instalado:
npx serve --cors .(ele mostra o endereço, comohttp://localhost:3000). - Em Configurações da mesa → Plugins, clique em Desenvolvimento no plugin e escreva o
endereço do HTML da ficha, como
http://localhost:3000/minha-ficha.html. Clique em Salvar.
- As fichas desse tipo passam a vir do seu computador, só no seu navegador: os outros na mesa continuam com a versão instalada. A ficha mostra “Desenvolvimento:” e o endereço no alto.
- Salvou o arquivo? Recarregue a ficha (feche e abra a aba, ou Recarregar se ela parar).
- Desligar, na mesma tela, volta à versão instalada.
- Se a página usa
<script type="module">, o servidor local precisa liberar o CORS (o--corsdo exemplo).
Terminou? Suba a version e instale a versão nova para todos. Veja Novas versões.
Os erros da página
Seção intitulada “Os erros da página”Dentro da mesa, um erro no JavaScript da ficha não aparece para quem joga, mas a ficha mostra um triângulo com o número de erros no canto. Clique nele:
- Copiar erros copia os erros, com a ficha, o plugin e a versão: cole na conversa com a IA ou mande para quem fez o plugin.
- Limpar esvazia a lista.
Quando a ficha não abre
Seção intitulada “Quando a ficha não abre”| A mensagem | O que fazer |
|---|---|
| A página não respondeu. Ela carrega o rpgdesk.js? | confira as duas linhas do rpgdesk.js no <head> e se o script não quebra ao carregar |
| A página tentou sair para outro endereço e foi fechada. | um link, um <form> ou um location = … tirou a página da ficha. Use abas e RPGDesk.ui.openLink |
| A página parou de responder. | um laço infinito ou uma conta pesada travou a página. Recarregar tenta de novo |
O verificador, na instalação, já pega a maioria desses problemas antes.