Cómo escribir una buena petición
Qué incluir en una petición a Codexe, con ejemplos buenos y malos para plugins, mods, datapacks, bots y sitios web.
Actualizado
En esta página
La petición es el factor que más influye en la calidad del resultado. La IA solo puede crear lo que es capaz de deducir, así que las peticiones concretas funcionan mejor que las largas.
#Qué incluir
- Plataforma y versión. "Paper 1.21.4", "Fabric para 1.20.1", "datapack para 1.21.1", "discord.py".
- Comportamiento. Qué pasa, paso a paso, incluido lo que ocurre cuando algo sale mal.
- Comandos y argumentos.
/home <name>, quién puede ejecutarlos y los mensajes que se muestran. - Permisos. Nombres de los nodos y valores predeterminados.
- Configuración. Qué deberían poder cambiar los dueños del servidor.
- Almacenamiento. En memoria, en un archivo YAML, en SQLite o en MySQL, y si sobrevive a los reinicios.
- Integraciones. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Nómbralas explícitamente.
- Interfaz. Mensajes de chat, GUIs (menús de inventario), scoreboards, barras de jefe.
- Casos límite. Jugadores desconectados, inventarios llenos, mundos desactivados, recargas.
#Mal frente a mejor
Mal: make a factions plugin
Mejor:
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.Mal: a mod with new swords
Mejor:
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.Mal: custom recipes
Mejor:
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.Mal: moderation bot
Mejor:
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.#Proyectos grandes: créalos por pasos
No pegues una especificación de cincuenta funciones en una sola petición. Empieza por el núcleo (modelo de datos, comandos principales), deja que Codexe lo verifique y luego añade funciones en mensajes posteriores. Cada paso es más pequeño, más barato, queda verificado y es más fácil de corregir.
#Mejorar prompt
En Crear (Crear un proyecto), el botón Mejorar prompt reescribe una petición en borrador para hacerla más completa. Cuesta una tarifa fija de 5,000 tokens. Lee siempre el texto mejorado antes de generar: puede dar por hechos detalles que no quieres.
#Di lo que no quieres
"Sin base de datos, guárdalo todo en config.yml", "no uses NMS", "sin dependencias externas". Las restricciones evitan que la IA elija algo que no puedes usar.