Preskoči na sadržaj
Prvi koraci

Kako napisati dobar zahtjev

Što uključiti u zahtjev za Codexe, s dobrim i lošim primjerima za pluginove, modove, datapackove, botove i web stranice.

Ažurirano

Na ovoj stranici
  1. Što uključiti
  2. Loše i bolje
  3. Veliki projekti: gradi u koracima
  4. Poboljšaj
  5. Reci što ne želiš

Zahtjev je najvažniji pojedinačni čimbenik kvalitete rezultata. AI može izgraditi samo ono što može zaključiti, pa konkretni zahtjevi pobjeđuju dugačke.

#Što uključiti

  • Platformu i verziju. „Paper 1.21.4“, „Fabric za 1.20.1“, „datapack za 1.21.1“, „discord.py“.
  • Ponašanje. Što se događa, korak po korak, uključujući što se događa kad nešto pođe po zlu.
  • Naredbe i argumente. /home <name>, tko ih smije pokretati i koje se poruke prikazuju.
  • Dozvole. Nazive čvorova i zadane vrijednosti.
  • Konfiguraciju. Što vlasnici poslužitelja trebaju moći mijenjati.
  • Pohranu. U memoriji, YAML datoteka, SQLite ili MySQL te preživljava li ponovno pokretanje.
  • Integracije. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Navedi ih izričito.
  • Sučelje. Poruke u chatu, GUI-jevi (izbornici inventara), scoreboardi, boss barovi.
  • Rubne slučajeve. Igrači koji nisu online, puni inventari, onemogućeni svjetovi, ponovna učitavanja.

#Loše i bolje

Loše: make a factions plugin

Bolje:

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.

Loše: a mod with new swords

Bolje:

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.

Loše: custom recipes

Bolje:

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.

Loše: moderation bot

Bolje:

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.

#Veliki projekti: gradi u koracima

Ne lijepi specifikaciju s pedeset funkcija u jedan zahtjev. Počni od jezgre (model podataka, glavne naredbe), pusti Codexe da je provjeri, a zatim dodaj funkcije u sljedećim porukama. Svaki je korak manji, jeftiniji, provjeren i lakše ga je ispraviti.

#Poboljšaj

Na stranici Izradi (Izrada projekta) gumb Poboljšaj prepisuje grubi zahtjev u potpuniji. Košta fiksnih 5.000 tokena. Uvijek pročitaj poboljšani tekst prije generiranja: možda pretpostavlja detalje koje ne želiš.

#Reci što ne želiš

„Bez baze podataka, sve drži u config.yml“, „ne koristi NMS“, „bez vanjskih ovisnosti“. Ograničenja sprječavaju AI da odabere nešto što ne možeš koristiti.

Kako napisati dobar zahtjev | Codexe Docs