Як написати хороший запит
Що включити в запит до Codexe, з хорошими й поганими прикладами для плагінів, модів, датапаків, ботів і вебсайтів.
Оновлено
На цій сторінці
Запит є найважливішим окремим чинником якості результату. AI може створити лише те, що здатен вивести із запиту, тому конкретні запити кращі за довгі.
#Що включити
- Платформу й версію. «Paper 1.21.4», «Fabric для 1.20.1», «датапак для 1.21.1», «discord.py».
- Поведінку. Що відбувається крок за кроком, зокрема що відбувається, коли щось іде не так.
- Команди та аргументи.
/home <name>, хто може їх виконувати і які повідомлення показуються. - Дозволи. Назви вузлів і значення за замовчуванням.
- Конфігурацію. Що власники серверів повинні мати змогу змінювати.
- Зберігання. У пам'яті, у файлі YAML, SQLite чи MySQL, і чи переживають дані перезапуск.
- Інтеграції. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Називайте їх явно.
- Інтерфейс. Повідомлення в чаті, GUI (меню інвентарю), табло, панелі боса.
- Крайні випадки. Гравці офлайн, заповнені інвентарі, вимкнені світи, перезавантаження.
#Погано й краще
Погано: make a factions plugin
Краще:
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
Краще:
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
Краще:
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
Краще:
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 токенів. Завжди читайте покращений текст перед генерацією: у ньому можуть бути припущення, яких ви не хочете.
#Скажіть, чого ви не хочете
«Без бази даних, тримай усе в config.yml», «не використовуй NMS», «без зовнішніх залежностей». Обмеження не дають AI вибрати те, чим ви не зможете скористатися.