Към съдържанието
Първи стъпки

Как да напишеш добра заявка

Какво да включиш в заявка към Codexe, с добри и лоши примери за плъгини, модове, датапакове, ботове и сайтове.

Обновено

На тази страница
  1. Какво да включиш
  2. Лошо срещу по-добро
  3. Големи проекти: създавай на стъпки
  4. Подобри заявката
  5. Кажи какво не искаш

Заявката е най-важният отделен фактор за качеството на резултата. AI може да създаде само това, което може да разбере, така че конкретните заявки бият дългите.

#Какво да включиш

  • Платформа и версия. „Paper 1.21.4“, „Fabric за 1.20.1“, „датапак за 1.21.1“, „discord.py“.
  • Поведение. Какво се случва стъпка по стъпка, включително какво става, когато нещо се обърка.
  • Команди и аргументи. /home <name>, кой може да ги пуска и какви съобщения се показват.
  • Права. Имената на permission node-овете и стойностите им по подразбиране.
  • Конфигурация. Какво трябва да могат да променят собствениците на сървъри.
  • Съхранение. В паметта, в YAML файл, в SQLite или MySQL, и дали данните оцеляват след рестарт.
  • Интеграции. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Назови ги изрично.
  • Интерфейс. Съобщения в чата, GUI (менюта в инвентара), scoreboard-и, boss bar-ове.
  • Гранични случаи. Офлайн играчи, пълни инвентари, изключени светове, презареждания.

#Лошо срещу по-добро

Лошо: make a factions plugin

По-добро:

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.

Лошо: a mod with new swords

По-добро:

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.

Лошо: custom recipes

По-добро:

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.

Лошо: moderation bot

По-добро:

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.

#Големи проекти: създавай на стъпки

Не поставяй спецификация с петдесет функции в една заявка. Започни с основата (модела на данните, главните команди), остави Codexe да я провери, а после добавяй функции в следващи съобщения. Всяка стъпка е по-малка, по-евтина, проверена и по-лесна за поправяне.

#Подобри заявката

В Създай (Създаване на проект) бутонът Подобри заявката пренаписва груба заявка в по-пълна. Струва фиксирано 5,000 токена. Винаги прочитай подобрения текст, преди да генерираш: възможно е да приема подробности, които не искаш.

#Кажи какво не искаш

„No database, keep everything in config.yml“, „don't use NMS“, „no external dependencies“. Ограниченията пречат на AI да избере нещо, което не можеш да използваш.

Как да напишеш добра заявка | Codexe Docs