Sari la conținut
Primii pași

Cum scrii o cerere bună

Ce să incluzi într-o cerere Codexe, cu exemple bune și rele pentru plugin-uri, moduri, datapack-uri, boți și site-uri web.

Actualizat

Pe această pagină
  1. Ce să incluzi
  2. Rău vs mai bine
  3. Proiecte mari: construiește în pași
  4. Îmbunătățește
  5. Spune ce nu vrei

Cererea este cel mai important factor pentru calitatea rezultatului. AI-ul poate construi doar ce poate deduce, așa că cererile precise bat cererile lungi.

#Ce să incluzi

  • Platforma și versiunea. „Paper 1.21.4”, „Fabric pentru 1.20.1”, „datapack pentru 1.21.1”, „discord.py”.
  • Comportamentul. Ce se întâmplă, pas cu pas, inclusiv ce se întâmplă când ceva merge prost.
  • Comenzile și argumentele. /home <name>, cine le poate rula și ce mesaje se afișează.
  • Permisiunile. Numele nodurilor și valorile implicite.
  • Configurarea. Ce ar trebui să poată schimba proprietarii de servere.
  • Stocarea. În memorie, într-un fișier YAML, SQLite sau MySQL, și dacă supraviețuiește repornirilor.
  • Integrările. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Numește-le explicit.
  • Interfața. Mesaje în chat, GUI-uri (meniuri de inventar), scoreboard-uri, boss bar-uri.
  • Cazurile-limită. Jucători offline, inventare pline, lumi dezactivate, reload-uri.

#Rău vs mai bine

Rău: make a factions plugin

Mai bine:

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.

Rău: a mod with new swords

Mai bine:

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.

Rău: custom recipes

Mai bine:

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.

Rău: moderation bot

Mai bine:

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.

#Proiecte mari: construiește în pași

Nu lipi o specificație cu cincizeci de funcții într-o singură cerere. Începe cu nucleul (modelul de date, comenzile principale), lasă-l pe Codexe să îl verifice, apoi adaugă funcții în mesajele următoare. Fiecare pas este mai mic, mai ieftin, verificat și mai ușor de corectat.

#Îmbunătățește

Pe Creează (Crearea unui proiect), butonul Îmbunătățește rescrie o cerere sumară într-una mai completă. Costă un preț fix de 5.000 de tokeni. Citește întotdeauna textul îmbunătățit înainte să generezi: poate presupune detalii pe care nu le vrei.

#Spune ce nu vrei

„Fără bază de date, păstrează totul în config.yml”, „nu folosi NMS”, „fără dependențe externe”. Constrângerile împiedică AI-ul să aleagă ceva ce nu poți folosi.

Cum scrii o cerere bună | Codexe Docs