# Create with an AI

> Making the sheet for your system with help from an AI: RPG Desk's guide, the request, testing and how to fix what comes back wrong.

Page: https://docs.rpgdesk.com/en/fichas/com-ia/

You do not need to know how to code to have a sheet for your system. A chat AI (ChatGPT, Claude, Gemini…) writes the whole sheet, if it knows RPG Desk’s rules. Those rules are in the **AI guide**: you paste the guide at the start of the conversation and describe the sheet.

## The AI guide

Two ways to get the guide:

- **In RPG Desk:** inside your room, as game master, in **Room settings → Plugins**, click **Copy instructions for AI**. The guide goes to the clipboard, in RPG Desk’s language and with your server’s rpgdesk.js address.
- **Here on the site:** [download the guide in English](https://docs.rpgdesk.com/_sdk/1/ai-guide.md) or [in Portuguese](https://docs.rpgdesk.com/_sdk/1/guia-ia.md), and paste the file’s content.

*Screenshot:* The Install plugin and Copy instructions for AI buttons, in Settings, Plugins.

The guide explains to the AI the file format, the environment’s rules (no internet, libraries only inside the package), the attributes and the rpgdesk.js API, and includes a complete example.

## The documentation for the AI

The guide sums up the rules. For the AI to look up the details (every attribute, the rpgdesk.js API, the verifier codes), this documentation also comes in text files made for AI, following the [llms.txt](https://llmstxt.org) standard:

- [`llms-fichas.txt`](https://docs.rpgdesk.com/en/llms-fichas.txt): the Creating sheets and Reference sections in a single file. It is what helps most to write sheets: if the AI accepts files, attach it to the conversation along with the guide.
- [`llms-full.txt`](https://docs.rpgdesk.com/en/llms-full.txt): the whole documentation.
- [`llms.txt`](https://docs.rpgdesk.com/en/llms.txt): the index, with a link to every page. If the AI can open web addresses, send it this one: it finds the rest from there.

Every page of the site also comes in Markdown: replace the slash at the end of the address with `.md` (`/en/fichas/campos/` becomes `/en/fichas/campos.md`).

## Ask for the sheet

1. Open a new conversation with the AI.

2. Paste the guide and, right after it, describe the sheet. The more concrete, the better:

   ```text
   Make the sheet for my system, "Blades of the Backlands".
   - Identity: name, origin, trade, level (1 to 10) and a portrait.
   - Attributes: Strength, Agility, Mind and Courage, from 1 to 5. Each one with a
     button that rolls 2d6 + the attribute.
   - Health: current and maximum (maximum = 10 + Strength x 2, computed). Health
     goes to bar 1 on the player's card.
   - Skills: a list with name and bonus, and a button that rolls 2d6 + bonus.
   - Inventory: a list with item and quantity.
   - A "GM" tab, for game masters only, with notes.
   Colors: sand and leather tones. It has to fit a narrow space.
   ```

3. Ask for **the whole `.html` file**. Save the answer in a file with the `.html` extension (`backlands.html`).

## Test it

Open the file in the browser (double-click it). Outside RPG Desk, the sheet enters **test mode**: fill in the fields, click the roll buttons and look at the **Log**, on the band in the corner. Switch the **Role** to **Another player** and check that the fields lock. See [Test and develop](https://docs.rpgdesk.com/en/fichas/desenvolvimento/).

Something wrong or missing? Tell the AI what happened, in detail (“the Agility button rolls 1d20, not 2d6”; “the portrait does not show up”), and ask for the whole file again.

## Install and fix

Install it in **Room settings → Plugins → Install plugin…**. RPG Desk checks the file first:

*Screenshot:* The install dialog with two errors and a warning, each with how to fix it, and the Copy report button.

- If problems show up, click **Copy report** and paste it in the conversation with the AI: the report says what is wrong, on which line and how to fix it, in a text the AI understands.
- Once installed, if the sheet shows a **Page errors** badge (the triangle in the corner), click it, then **Copy errors**, and paste that in the conversation too.

*Screenshot:* A sheet with the Page errors panel open, showing a TypeError, and the Copy errors and Clear buttons.

> **Tips**
>
> - Ask for one thing at a time: first the basic sheet, then the tabs, then the math.
> - Remind the AI to bump the `version` with each change (`1.0.0`, `1.0.1`…): that way RPG Desk knows it is an update. See [New versions](https://docs.rpgdesk.com/en/fichas/versoes/).
> - If the conversation got long and the AI started forgetting the rules, open another conversation, paste the guide and the current file, and carry on from where you stopped.
> - The AI does not see the screen. A screenshot of the problem, when the AI accepts images, helps a lot.