Naar de inhoud
Aan de slag

Een goed verzoek schrijven

Wat je in een verzoek aan Codexe zet, met goede en slechte voorbeelden voor plugins, mods, datapacks, bots en websites.

Bijgewerkt

Op deze pagina
  1. Wat je erin zet
  2. Slecht tegenover beter
  3. Grote projecten: bouw in stappen
  4. Verbeteren
  5. Zeg wat je niet wilt

Het verzoek is de grootste afzonderlijke factor voor de kwaliteit van het resultaat. De AI kan alleen bouwen wat hij kan afleiden, dus specifieke verzoeken winnen het van lange.

#Wat je erin zet

  • Platform en versie. "Paper 1.21.4", "Fabric voor 1.20.1", "datapack voor 1.21.1", "discord.py".
  • Gedrag. Wat er gebeurt, stap voor stap, ook wat er gebeurt als er iets misgaat.
  • Commando's en argumenten. /home <name>, wie ze mag uitvoeren en welke berichten worden getoond.
  • Permissies. Namen van de nodes en hun standaardwaarden.
  • Configuratie. Wat serverbeheerders moeten kunnen aanpassen.
  • Opslag. In het geheugen, een YAML-bestand, SQLite of MySQL, en of het herstarts overleeft.
  • Integraties. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Noem ze expliciet.
  • Interface. Chatberichten, GUI's (inventorymenu's), scoreboards, bossbalken.
  • Randgevallen. Offline spelers, volle inventories, uitgeschakelde werelden, reloads.

#Slecht tegenover beter

Slecht: make a factions plugin

Beter:

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.

Slecht: a mod with new swords

Beter:

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.

Slecht: custom recipes

Beter:

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.

Slecht: moderation bot

Beter:

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.

#Grote projecten: bouw in stappen

Plak geen specificatie met vijftig functies in één verzoek. Begin met de kern (datamodel, belangrijkste commando's), laat Codexe die verifiëren en voeg daarna functies toe in vervolgberichten. Elke stap is kleiner, goedkoper, geverifieerd en makkelijker bij te sturen.

#Verbeteren

Op Maken (Een project maken) herschrijft de knop Prompt verbeteren een ruw verzoek tot een vollediger verzoek. Dat kost vast 5.000 tokens. Lees de verbeterde tekst altijd voordat je genereert: er kunnen details in zijn aangenomen die je niet wilt.

#Zeg wat je niet wilt

"Geen database, bewaar alles in config.yml", "gebruik geen NMS", "geen externe dependencies". Beperkingen voorkomen dat de AI iets kiest wat jij niet kunt gebruiken.

Een goed verzoek schrijven | Codexe Docs