# RPG Desk

> O RPG Desk é uma mesa virtual de RPG: mesas com chat, dados, fichas de personagem, mapa com névoa e visão, música e voz. Esta é a documentação de uso e a referência para criar fichas e tabelas da mesa em HTML, CSS e JavaScript com o rpgdesk.js.

- As fichas e as tabelas da mesa são páginas web: um arquivo `.html` só (ou um pacote `.zip`), com o manifesto num `<script type="application/rpgdesk+json">` e o rpgdesk.js, a biblioteca que liga a página à mesa.
- Para escrever uma ficha, comece pelo guia para IA: ele traz as regras e um exemplo completo. Os detalhes estão nas seções Criar fichas e Referência.
- A ficha roda num quadro isolado, sem internet e sem bibliotecas de fora. A única saída são os webhooks declarados no manifesto, para o Zapier, o Make ou o IFTTT.
- Os nomes de botões, menus e campos aparecem em negrito, com o texto exato da interface em português.

## Arquivos completos

- [Documentação completa do RPG Desk](https://docs.rpgdesk.com/llms-full.txt): todas as páginas, num arquivo só
- [Criar fichas e referência do RPG Desk](https://docs.rpgdesk.com/llms-fichas.txt): as seções Criar fichas e Referência, com tudo o que se usa para escrever fichas e tabelas
- [Guia para IA](https://docs.rpgdesk.com/_sdk/1/guia-ia.md): as regras para uma IA escrever uma ficha do RPG Desk, com um exemplo completo

## Começando

- [Começando](https://docs.rpgdesk.com/comecando.md): O que é o RPG Desk e os primeiros passos, para quem vai jogar e para quem vai mestrar.
- [Criar a conta e entrar](https://docs.rpgdesk.com/comecando/conta.md): Como criar a conta no RPG Desk, entrar, ficar conectado e trocar o idioma.
- [A tela inicial](https://docs.rpgdesk.com/comecando/tela-inicial.md): A barra de navegação à esquerda e o Início, com a última mesa e as suas mesas.
- [Achar uma mesa e entrar](https://docs.rpgdesk.com/comecando/explorar.md): O Explorar: as listas de mesas, os filtros, os detalhes de cada mesa e como entrar.
- [Criar a sua mesa](https://docs.rpgdesk.com/comecando/primeira-mesa.md): Para quem vai mestrar: criar a mesa, chamar os jogadores e deixar tudo pronto para a primeira sessão.
- [Perfil, amigos e conversas](https://docs.rpgdesk.com/comecando/perfil-e-amigos.md): Seu perfil público, o painel Amigos e chat, os pedidos de amizade, as conversas e os convites para mesas.
- [Desk Cloud](https://docs.rpgdesk.com/comecando/arquivos.md): O Desk Cloud: os seus mapas, tokens, trilhas e documentos, em pastas, com as mesas que podem abrir cada um, a lixeira e os menus do botão direito.
- [Planos e espaço](https://docs.rpgdesk.com/comecando/planos.md): Os planos do RPG Desk: o Grátis e os planos 1, 2 e 3, o espaço e o maior arquivo de cada um, e o que acontece quando o plano muda ou vence.
- [Suas preferências](https://docs.rpgdesk.com/comecando/configuracoes.md): As Configurações: perfil, conta e plano; idioma, chat, dados, notificações, áudio e vídeo; e a solução de problemas, com a busca.
- [No celular](https://docs.rpgdesk.com/comecando/celular.md): O RPG Desk no celular: instalar como aplicativo, a barra de baixo, as abas da mesa e os gestos (tocar, segurar, pinça).
- [Administração do servidor](https://docs.rpgdesk.com/comecando/administracao.md): A área de quem cuida do servidor do RPG Desk: a visão geral, as contas, os planos, as mesas, a configuração do servidor e o registro do que foi feito.

## Usando a mesa

- [A tela da mesa](https://docs.rpgdesk.com/mesa.md): Como a mesa se organiza: as abas, que se encaixam em espaços, o menu da mesa com as Abas, arrastar abas e espaços e organizar a tela com Ctrl+E.
- [Chat](https://docs.rpgdesk.com/mesa/chat.md): Conversar na mesa: mensagens, formatação, narrador e NPCs, arquivos, menções e conversas particulares.
- [Dados e rolagens](https://docs.rpgdesk.com/mesa/dados.md): Como rolar dados no RPG Desk, como ler o resultado, os dados 3D e a personalização dos seus dados.
- [Biblioteca](https://docs.rpgdesk.com/mesa/biblioteca.md): A biblioteca da mesa: fichas, pastas e cenas, como abrir, organizar, e o que cada um vê.
- [Fichas de personagem](https://docs.rpgdesk.com/mesa/fichas.md): Criar uma ficha, preencher, rolar pela ficha e escolher o personagem principal.
- [Participantes](https://docs.rpgdesk.com/mesa/participantes.md): A lista de quem está na mesa: os cartões, as barras de vida, as linhas, a sua foto na mesa e o menu de cada pessoa.
- [Cena e mapa](https://docs.rpgdesk.com/mesa/cena.md): Usar a cena como jogador: mover o seu token, medir distâncias, pingar, desenhar, abrir portas e ver através da névoa.
- [Voz e vídeo](https://docs.rpgdesk.com/mesa/voz.md): A conferência da mesa: entrar, ligar o microfone e a câmera, e escolher os aparelhos.
- [Música e efeitos sonoros](https://docs.rpgdesk.com/mesa/musica.md): A trilha sonora da mesa: o que o jogador ouve e controla, e como o mestre monta a playlist e o quadro de efeitos.
- [Janelas e várias mesas](https://docs.rpgdesk.com/mesa/janelas.md): Abrir janelas que funcionam como a mesa, levar espaços e abas para elas (outro monitor) e ficar em mais de uma mesa ao mesmo tempo.
- [Macros](https://docs.rpgdesk.com/mesa/macros.md): Comandos seus, com uma palavra: uma macro guarda linhas de chat e rolagens e roda tudo com /nome.

## Para mestres

- [Para mestres](https://docs.rpgdesk.com/mestres.md): O que o mestre controla no RPG Desk: a mesa, os papéis, as fichas dos jogadores, a cena, o combate, os plugins e as integrações.
- [Configurar a mesa](https://docs.rpgdesk.com/mestres/configurar-mesa.md): As configurações da mesa: perfil, capa e status, regras de jogo, plugins, senha, histórico do chat, mestres auxiliares, banidos e apagar a mesa.
- [Papéis e moderação](https://docs.rpgdesk.com/mestres/papeis.md): Mestres, jogadores e espectadores; silenciar, esconder o chat, moderar, expulsar e banir.
- [Fichas dos jogadores](https://docs.rpgdesk.com/mestres/fichas-dos-jogadores.md): Criar e entregar fichas para os jogadores, escolher o personagem principal, trocar o dono e decidir o que cada um vê.
- [Regras de jogo](https://docs.rpgdesk.com/mestres/regras-de-jogo.md): As barras (vida, energia…) e as linhas de texto dos cartões dos jogadores: quantas aparecem, os nomes, as cores e quem vê os números. E de onde vêm os números dos dados.
- [Montar a cena](https://docs.rpgdesk.com/mestres/mapa.md): Criar a cena, pôr a imagem do mapa, acertar a grade, configurar a escala, colocar os tokens e dar auras a eles.
- [Névoa, paredes e visão](https://docs.rpgdesk.com/mestres/nevoa-e-visao.md): Revelar o mapa aos poucos com a névoa de guerra, desenhar paredes e portas, e fazer cada token enxergar só o que a luz e as paredes deixam.
- [Tracker de combate](https://docs.rpgdesk.com/mestres/combate.md): A tabela de iniciativa da mesa: atores, iniciativa, turnos, rodadas, lados, efeitos com duração e o que os jogadores veem.
- [Plugins e tabelas da mesa](https://docs.rpgdesk.com/mestres/plugins.md): Instalar, atualizar e remover os plugins de ficha e de tabela da mesa, e ativar as tabelas da sala.
- [Integrações](https://docs.rpgdesk.com/mestres/integracoes.md): Mandar o que acontece na mesa para fora (Discord, planilhas, luzes) pelo Zapier, pelo Make ou pelo IFTTT, com os webhooks dos plugins.
- [Relógio da sessão](https://docs.rpgdesk.com/mestres/relogio-da-sessao.md): Marcar o começo, as pausas e o fim da sessão de jogo: o relógio que todos veem, as marcas no chat, a pausa automática e a aba Sessões, com o registro e as notas de cada sessão.

## Criar fichas

- [Criar fichas](https://docs.rpgdesk.com/fichas.md): Fichas e tabelas da mesa feitas em HTML, CSS e JavaScript, à mão ou com ajuda de uma IA.
- [A primeira ficha](https://docs.rpgdesk.com/fichas/primeira-ficha.md): O tutorial: do arquivo vazio a uma ficha com campos, rolagens, uma lista e um campo calculado, testada no navegador e instalada na mesa.
- [Criar com uma IA](https://docs.rpgdesk.com/fichas/com-ia.md): Fazer a ficha do seu sistema com ajuda de uma IA: o guia do RPG Desk, o pedido, o teste e como consertar o que vier errado.
- [Campos, listas e abas](https://docs.rpgdesk.com/fichas/campos.md): Tudo o que se faz só com atributos no HTML: campos de todos os tipos, textos calculados, imagens, listas, abas e o que cada papel vê.
- [JavaScript na ficha](https://docs.rpgdesk.com/fichas/javascript.md): O rpgdesk.js pelo código: conectar, ler e gravar o documento, acompanhar as mudanças, campos calculados e listas.
- [Rolagens, chat e cartão](https://docs.rpgdesk.com/fichas/rolagens-e-chat.md): Rolar dados e falar no chat pela ficha, preencher as barras do cartão do jogador, e as ajudas de interface: avisos, perguntas, menus, imagens e preferências.
- [Partes privadas](https://docs.rpgdesk.com/fichas/partes-privadas.md): Partes da ficha que só o mestre (ou só o dono e o mestre) recebem: o segredo de verdade, não só escondido na tela.
- [Tabelas da sala](https://docs.rpgdesk.com/fichas/tabelas.md): Páginas para a mesa toda, abertas como aba para todos: uma lista de NPCs, a iniciativa, um calendário. Como declarar, quem escreve e um exemplo comentado.
- [Visual](https://docs.rpgdesk.com/fichas/visual.md): O rpgdesk.css, as classes prontas, as cores do tema da mesa, fontes, imagens e como fazer a ficha caber num espaço estreito.
- [Pacotes com vários arquivos](https://docs.rpgdesk.com/fichas/pacotes.md): O plugin em .zip: o manifest.json, várias fichas e tabelas, CSS e JavaScript separados, imagens, fontes e sons.
- [Testar e desenvolver](https://docs.rpgdesk.com/fichas/desenvolvimento.md): O modo de teste fora do RPG Desk, o modo de desenvolvimento dentro da mesa e os erros da página.
- [Webhooks na ficha](https://docs.rpgdesk.com/fichas/webhooks.md): A única saída da ficha para a internet: declarar webhooks no manifesto e mandar dados para o Zapier, o Make ou o IFTTT.
- [Novas versões](https://docs.rpgdesk.com/fichas/versoes.md): Atualizar a ficha na mesa sem perder os dados dos jogadores: a versão, o que não pode mudar e como migrar um campo renomeado.
- [Exemplos](https://docs.rpgdesk.com/fichas/exemplos.md): Fichas e uma tabela prontas, funcionando: use na sua mesa, estude o código ou entregue a uma IA como ponto de partida.

## Referência

- [Referência](https://docs.rpgdesk.com/referencia.md): Para consulta: o manifesto dos plugins, os atributos no HTML, a API do rpgdesk.js, o CSS, o verificador, os limites, os comandos do chat, as rolagens, os atalhos e a formatação.
- [O manifesto](https://docs.rpgdesk.com/referencia/manifesto.md): Cada campo do manifesto de um plugin do RPG Desk, o que aceita e o que o verificador confere.
- [Atributos no HTML](https://docs.rpgdesk.com/referencia/atributos.md): Todos os atributos data-* que o rpgdesk.js liga sozinho: campos, textos, imagens, listas, rolagens, abas e papéis.
- [A API do rpgdesk.js](https://docs.rpgdesk.com/referencia/api.md): Todas as funções do objeto RPG Desk e do documento, com os parâmetros e o que devolvem.
- [Visual (CSS)](https://docs.rpgdesk.com/referencia/css.md): As classes e as variáveis do rpgdesk.css, e as cores do tema da mesa que o rpgdesk.js entrega à página.
- [O verificador](https://docs.rpgdesk.com/referencia/verificador.md): O que o RPG Desk confere antes de instalar um plugin: cada problema, pelo código, com o que quer dizer e como consertar.
- [Limites](https://docs.rpgdesk.com/referencia/limites.md): Os tamanhos e as quantidades que o RPG Desk aceita: pacotes, documentos, rolagens, mensagens, webhooks, arquivos e mesas.
- [Comandos do chat](https://docs.rpgdesk.com/referencia/comandos.md): Os comandos que o chat entende: rolar, narrar, rir, limpar o chat, trocar de nome, sair da mesa e as macros.
- [Rolagens](https://docs.rpgdesk.com/referencia/rolagens.md): A gramática das rolagens do RPG Desk: dados, números, Fudge, ordem, sucessos com dificuldade, o nome da rolagem, os limites e as mensagens de erro.
- [Formatação do chat](https://docs.rpgdesk.com/referencia/formatacao.md): Todas as marcações do chat: itálico, negrito, ação, fala, fora do personagem, letra capitular, títulos, separadores, links, menções, os códigos de estilo, a paleta de cores e os emoji.
- [Atalhos do teclado](https://docs.rpgdesk.com/referencia/atalhos.md): Os atalhos do teclado e do mouse na cena, nas paredes, no chat, nas barras e linhas dos participantes, nas abas e nos espaços da mesa e para organizar a tela.

## Ajuda

- [Perguntas frequentes](https://docs.rpgdesk.com/ajuda.md): As dúvidas mais comuns sobre o RPG Desk: o que é preciso para usar, papéis, dados, mapas, fichas, plugins e onde ficam os seus dados.
- [Problemas comuns](https://docs.rpgdesk.com/ajuda/problemas.md): O que fazer quando algo não funciona: entrar na conta, o chat, os tokens, as abas, o som, a voz e o vídeo, as fichas e os plugins, os arquivos.

## Optional

- [English documentation](https://docs.rpgdesk.com/en/llms.txt): the same documentation, in English