Vai al contenuto
Per iniziare

Come scrivere una buona richiesta

Cosa includere in una richiesta a Codexe, con esempi buoni e cattivi per plugin, mod, datapack, bot e siti web.

Aggiornato

In questa pagina
  1. Cosa includere
  2. Male e meglio
  3. Progetti grandi: procedi per passi
  4. Migliora il prompt
  5. Di' cosa non vuoi

La richiesta è il fattore che pesa di più sulla qualità del risultato. L'AI può creare solo quello che riesce a dedurre, quindi le richieste precise funzionano meglio di quelle lunghe.

#Cosa includere

  • Piattaforma e versione. "Paper 1.21.4", "Fabric per la 1.20.1", "datapack per la 1.21.1", "discord.py".
  • Comportamento. Cosa succede, passo per passo, compreso cosa succede quando qualcosa va storto.
  • Comandi e argomenti. /home <name>, chi può eseguirli e i messaggi mostrati.
  • Permessi. Nomi dei nodi e valori predefiniti.
  • Configurazione. Cosa devono poter cambiare i proprietari del server.
  • Salvataggio dei dati. In memoria, in un file YAML, in SQLite o MySQL, e se i dati sopravvivono ai riavvii.
  • Integrazioni. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Nominale esplicitamente.
  • Interfaccia. Messaggi in chat, GUI (menu a inventario), scoreboard, boss bar.
  • Casi limite. Giocatori offline, inventari pieni, mondi disattivati, reload.

#Male e meglio

Male: make a factions plugin

Meglio:

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

Male: a mod with new swords

Meglio:

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

Male: custom recipes

Meglio:

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

Male: moderation bot

Meglio:

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

#Progetti grandi: procedi per passi

Non incollare una specifica con cinquanta funzioni in una sola richiesta. Parti dal nucleo (modello dei dati, comandi principali), lascia che Codexe lo verifichi, poi aggiungi le funzioni con i messaggi successivi. Ogni passo è più piccolo, costa meno, viene verificato ed è più facile da correggere.

#Migliora il prompt

In Crea (Creare un progetto), il pulsante Migliora il prompt riscrive una richiesta abbozzata in una più completa. Costa una cifra fissa di 5.000 token. Leggi sempre il testo migliorato prima di generare: potrebbe dare per scontati dettagli che non vuoi.

#Di' cosa non vuoi

"Niente database, tieni tutto in config.yml", "non usare NMS", "nessuna dipendenza esterna". I vincoli impediscono all'AI di scegliere qualcosa che poi non puoi usare.

Come scrivere una buona richiesta | Codexe Docs