# Criar com uma IA

> 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.

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

Você não precisa saber programar para ter a ficha do seu sistema. Uma IA de conversa (o ChatGPT, o Claude, o Gemini…) escreve a ficha inteira, se ela souber as regras do RPG Desk. Essas regras estão no **guia para IA**: você cola o guia no começo da conversa e descreve a ficha.

## O guia para IA

Dois jeitos de pegar o guia:

- **No RPG Desk:** dentro da sua mesa, como mestre, em **Configurações da mesa → Plugins**, clique em **Copiar instruções para IA**. O guia vai para a área de transferência, na língua do RPG Desk e com o endereço do rpgdesk.js do seu servidor.
- **Aqui no site:** [baixe o guia em português](https://docs.rpgdesk.com/_sdk/1/guia-ia.md) ou [em inglês](https://docs.rpgdesk.com/_sdk/1/ai-guide.md), e cole o conteúdo do arquivo.

*Captura de tela:* Os botões Instalar plugin e Copiar instruções para IA, em Configurações, Plugins.

O guia explica à IA o formato do arquivo, as regras do ambiente (sem internet, bibliotecas só dentro do pacote), os atributos, a API do rpgdesk.js e traz um exemplo completo.

## A documentação para a IA

O guia resume as regras. Para a IA consultar os detalhes (todos os atributos, a API do rpgdesk.js, os códigos do verificador), esta documentação também existe em arquivos de texto feitos para IA, no padrão [llms.txt](https://llmstxt.org):

- [`llms-fichas.txt`](https://docs.rpgdesk.com/llms-fichas.txt): as seções Criar fichas e Referência num arquivo só. É o que mais ajuda para escrever fichas: se a IA aceita arquivos, anexe-o à conversa junto com o guia.
- [`llms-full.txt`](https://docs.rpgdesk.com/llms-full.txt): a documentação inteira.
- [`llms.txt`](https://docs.rpgdesk.com/llms.txt): o índice, com um link para cada página. Se a IA consegue abrir endereços da internet, mande o endereço dele: ela acha o resto a partir daí.

Cada página do site também existe em Markdown: troque a barra do fim do endereço por `.md` (`/fichas/campos/` vira `/fichas/campos.md`).

## Pedir a ficha

1. Abra uma conversa nova com a IA.

2. Cole o guia e, logo depois, descreva a ficha. Quanto mais concreto, melhor:

   ```text
   Faça a ficha do meu sistema, "Lâminas do Sertão".
   - Identidade: nome, origem, ofício, nível (1 a 10) e um retrato.
   - Atributos: Força, Agilidade, Mente e Coragem, de 1 a 5. Cada um com um botão
     que rola 2d6 + o atributo.
   - Vida: atual e máxima (máxima = 10 + Força x 2, calculada). A vida vai para a
     barra 1 do cartão do jogador.
   - Perícias: uma lista com nome e bônus, e um botão de rolar 2d6 + bônus.
   - Inventário: uma lista com item e quantidade.
   - Uma aba "Mestre", só para os mestres, com anotações.
   Cores: tons de areia e couro. Tem que caber num espaço estreito.
   ```

3. Peça **o arquivo `.html` inteiro**. Salve a resposta num arquivo com a extensão `.html` (`sertao.html`).

## Testar

Abra o arquivo no navegador (dois cliques). Fora do RPG Desk, a ficha entra no **modo de teste**: preencha os campos, clique nos botões de rolar e veja o **Registro**, na faixa do canto. Troque o **Papel** para **Outro jogador** e confira se os campos travam. Veja [Testar e desenvolver](https://docs.rpgdesk.com/fichas/desenvolvimento/).

Algo errado ou faltando? Diga à IA o que aconteceu, com detalhes (“o botão de Agilidade rola 1d20, não 2d6”; “o retrato não aparece”), e peça o arquivo inteiro de novo.

## Instalar e consertar

Instale em **Configurações da mesa → Plugins → Instalar plugin…**. O RPG Desk confere o arquivo antes:

*Captura de tela:* O diálogo de instalação com dois erros e um aviso, cada um com como consertar, e o botão Copiar relatório.

- Se aparecerem problemas, clique em **Copiar relatório** e cole na conversa com a IA: o relatório diz o que está errado, em que linha e como consertar, num texto que a IA entende.
- Já instalada, se a ficha mostrar um aviso de **Erros da página** (o triângulo no canto), clique nele, em **Copiar erros**, e cole na conversa também.

*Captura de tela:* Uma ficha com o painel Erros da página aberto, mostrando um TypeError, e os botões Copiar erros e Limpar.

> **Dicas**
>
> - Peça uma coisa de cada vez: primeiro a ficha básica, depois as abas, depois as contas.
> - Lembre a IA de subir a `version` a cada mudança (`1.0.0`, `1.0.1`…): assim o RPG Desk sabe que é uma atualização. Veja [Novas versões](https://docs.rpgdesk.com/fichas/versoes/).
> - Se a conversa ficou longa e a IA começou a esquecer as regras, abra outra conversa, cole o guia e o arquivo atual, e continue de onde parou.
> - A IA não vê a tela. Uma captura do problema, quando a IA aceita imagens, ajuda muito.