Como escrever um bom pedido

O pedido é o fator que mais pesa na qualidade do resultado. A IA só consegue criar o que consegue deduzir, então pedidos específicos são melhores do que pedidos longos.

#O que incluir

• Plataforma e versão. "Paper 1.21.4", "Fabric para 1.20.1", "datapack para 1.21.1", "discord.py".
• Comportamento. O que acontece, passo a passo, incluindo o que acontece quando algo dá errado.
• Comandos e argumentos. /home <name>, quem pode executá-los e as mensagens exibidas.
• Permissões. Nomes dos nós e valores padrão.
• Configuração. O que os donos de servidor devem poder mudar.
• Armazenamento. Em memória, em um arquivo YAML, SQLite ou MySQL, e se os dados sobrevivem a reinicializações.
• Integrações. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Cite-as explicitamente.
• Interface. Mensagens no chat, GUIs (menus de inventário), scoreboards, boss bars.
• Casos-limite. Jogadores offline, inventários cheios, mundos desativados, recarregamentos.

#Ruim e melhor

A Paper 1.21.x factions plugin.
- /f create <name>, /f invite <player>, /f join <name>, /f leave, /f disband (owner only).
- Max 10 members per faction (configurable).
- Chunk claiming with /f claim and /f unclaim; claimed chunks block building by non-members.
- Faction power: +1 per online member, claims limited to power x 2.
- Data saved to SQLite, loaded on startup.
- Vault economy: creating a faction costs 1000 (configurable).
- Permissions: factions.use (default true), factions.admin (op) for /f admin bypass.

A Fabric mod for Minecraft 1.20.1.
- Adds three swords: Ember Blade (sets targets on fire for 3s), Frost Edge (Slowness II for 2s), Void Cutter (5% chance to teleport the target 8 blocks).
- Crafting recipes using blaze rods, packed ice and ender pearls with a netherite sword.
- English lang file and item models (textures can be placeholders).
- No client-only code on the server side.

A datapack for Minecraft 1.21.1.
- Shaped recipe: 8 rotten flesh around a leather = 1 leather.
- Shapeless recipe: 9 nether wart = 1 nether wart block, and the reverse.
- A function that runs every tick and gives Speed I to players standing on gold blocks.

A discord.py bot with slash commands.
- /warn <user> <reason>: stores warnings in SQLite, DMs the user.
- /warnings <user>: lists warnings with dates.
- /timeout <user> <minutes> <reason>: applies a Discord timeout; only for members with Moderate Members.
- Logs every action to a channel set with /setlog.
- Token read from an environment variable.

#Projetos grandes: crie em etapas

Não cole uma especificação com cinquenta recursos em um único pedido. Comece pelo núcleo (modelo de dados, comandos principais), deixe o Codexe verificar e depois adicione recursos nas mensagens seguintes. Cada etapa fica menor, mais barata, verificada e mais fácil de corrigir.

#Aprimorar prompt

Em Criar (Como criar um projeto), o botão Aprimorar prompt reescreve um pedido ainda cru em um mais completo. Ele custa um valor fixo de 5.000 tokens. Sempre leia o texto aprimorado antes de gerar: ele pode supor detalhes que você não quer.

#Diga o que você não quer

"Sem banco de dados, deixe tudo no config.yml", "não use NMS", "sem dependências externas". Restrições impedem a IA de escolher algo que você não pode usar.