# Criar fichas

> Fichas e tabelas da mesa feitas em HTML, CSS e JavaScript, à mão ou com ajuda de uma IA.

Página: https://docs.rpgdesk.com/fichas/

No RPG Desk, uma ficha é uma página web: **HTML** para os campos, **CSS** para o visual e, se precisar, **JavaScript** para as contas. O **rpgdesk.js**, a biblioteca do RPG Desk, liga a página à mesa:

- o que o jogador escreve fica guardado na mesa e aparece na hora para o mestre;
- os botões de rolagem rolam no chat, com os dados 3D, para todos;
- só o dono da ficha e os mestres escrevem; os outros só leem, e o rpgdesk.js trava os campos sozinho;
- partes da ficha podem ser só do mestre, e elas nem chegam aos jogadores.

A ficha abaixo está funcionando. Escreva nos campos e clique em **Rolar Força**:

*Exemplo funcionando:* [Ficha mínima](https://docs.rpgdesk.com/exemplos/ficha-minima.html)

Ela não tem nenhuma linha de JavaScript: cada campo tem um atributo `data-field`, e cada botão de rolagem, um `data-roll`.

## Três jeitos de fazer

**Com uma IA**

Copie o guia do RPG Desk para a IA (o ChatGPT, o Claude, o Gemini…), descreva a ficha e instale o arquivo que ela devolver. Veja [Criar com uma IA](https://docs.rpgdesk.com/fichas/com-ia/).

**À mão, num arquivo só**

Um arquivo `.html`, com o manifesto dentro e as duas linhas do rpgdesk.js. Comece pelo [tutorial](https://docs.rpgdesk.com/fichas/primeira-ficha/).

**Num pacote**

Vários arquivos (HTML, CSS, JavaScript, imagens, fontes) num `.zip`, com mais de uma ficha ou tabela. Veja [Pacotes com vários arquivos](https://docs.rpgdesk.com/fichas/pacotes/).

## Do arquivo à mesa

1. **Teste no navegador:** abra o arquivo da ficha (dois cliques). Fora do RPG Desk, o rpgdesk.js entra no **modo de teste**, com os dados no navegador e uma faixa no canto para trocar de papel.
2. **Instale na mesa:** como mestre, em **Configurações da mesa → Plugins → Instalar plugin…**, escolha o `.html` (ou o `.zip`). O RPG Desk confere o arquivo e diz o que consertar, se for o caso.
3. **Use:** a ficha aparece em **Nova ficha…**, na biblioteca.

> **Dica**
>
> Fichas e tabelas são a mesma coisa por dentro. Uma **tabela da sala** (uma lista de NPCs, um calendário) é uma página igual, que fica embaixo da biblioteca para a mesa toda. Veja [Tabelas da sala](https://docs.rpgdesk.com/fichas/tabelas/).

## Nesta seção

[A primeira ficha](https://docs.rpgdesk.com/fichas/primeira-ficha/): O tutorial: do arquivo vazio à ficha instalada na mesa.

[Criar com uma IA](https://docs.rpgdesk.com/fichas/com-ia/): O guia para a IA, o pedido e como consertar o que vier errado.

[Campos, listas e abas](https://docs.rpgdesk.com/fichas/campos/): Tudo o que se faz só com atributos no HTML.

[JavaScript na ficha](https://docs.rpgdesk.com/fichas/javascript/): O documento, os campos calculados e as listas pelo código.

[Rolagens, chat e cartão](https://docs.rpgdesk.com/fichas/rolagens-e-chat/): Rolar, falar no chat e preencher as barras do jogador.

[Partes privadas](https://docs.rpgdesk.com/fichas/partes-privadas/): O que só o mestre ou só o dono vê.

[Tabelas da sala](https://docs.rpgdesk.com/fichas/tabelas/): Páginas para a mesa toda: NPCs, iniciativa, mapas de viagem.

[Visual](https://docs.rpgdesk.com/fichas/visual/): O rpgdesk.css, as cores do tema e as telas estreitas.

[Pacotes com vários arquivos](https://docs.rpgdesk.com/fichas/pacotes/): O .zip com manifest.json, imagens e fontes.

[Testar e desenvolver](https://docs.rpgdesk.com/fichas/desenvolvimento/): O modo de teste, o modo de desenvolvimento e os erros da página.

[Webhooks na ficha](https://docs.rpgdesk.com/fichas/webhooks/): Mandar dados para o Zapier, o Make ou o IFTTT.

[Novas versões](https://docs.rpgdesk.com/fichas/versoes/): Atualizar a ficha sem perder os dados dos jogadores.

[Exemplos](https://docs.rpgdesk.com/fichas/exemplos/): Fichas e uma tabela prontas, para usar e estudar.

Para consultar os detalhes, a [Referência](https://docs.rpgdesk.com/referencia/) tem o manifesto, os atributos, a API do rpgdesk.js, o verificador e os limites.
