Посібник
Як створити плагін міні-гри для Minecraft
Оновлено 18 жовтня 2026 р.
Плагін міні-гри проводить раунди: гравці чекають у лобі, запускається відлік, гра йде за своїми правилами, хтось перемагає, і арена скидається для наступного раунду. Кожна міні-гра, від spleef до bed wars, має однаковий кістяк. Зробіть його правильно, і правила гри стануть найпростішою частиною.
Почніть із цього прикладу й змініть правила.
Згенерувати це в CodexeКрок за кроком
1.Опишіть правила одного раунду
Скільки гравців, як раунд починається й закінчується, як визначається переможець, що стається після смерті (вибуває, відроджується, стає глядачем) і що гравці отримують на старті.
2.Сплануйте налаштування арени
Команди адміністратора, щоб створити арену й задати її лобі, точки появи та межі, наприклад
/mg create <name>і/mg setspawn <name>. Арени зберігаються у файлі, тож переживають перезапуски.3.Визначте стани гри
Очікування, старт (відлік), гра й завершення. У кожному стані дозволено різне: у лобі ніхто не ламає блоки, до гри, що вже триває, ніхто не приєднується.
4.Вирішіть, як скидається арена
Відстежуйте й скасовуйте блоки, змінені за раунд, або перезавантажуйте копію світу-шаблону. Без скидання другий раунд почнеться на зруйнованій карті.
5.Додайте те, що бачать гравці
Бічне табло з кількістю гравців, що залишилися, і часом, панель боса або титри для відліку, повідомлення в чаті про вбивства й переможця.
6.Згенеруйте, зберіть і зіграйте раунд
Опишіть гру для Codexe, дочекайтеся компіляції, потім зайдіть на тестовий сервер через «Спробувати зараз». Під час тестування встановіть невеликий мінімум гравців, щоб раунд міг початися.
Стани гри
Більшість помилок у міні-іграх - це гравці, які роблять щось не в тому стані. Якщо описати стани в запиті, ШІ збудує плагін навколо них.
| Стан | Що відбувається | Типові правила |
|---|---|---|
| Очікування | Гравці заходять у лобі | Без шкоди, без ламання блоків, вихід предметом або командою |
| Запуск | Відлік, щойно набрано мінімум | Відлік зупиняється, якщо гравців стає менше за мінімум |
| Гра | Діють правила гри | Приєднатися не можна, смерть означає вибування або відродження, вихід зараховується як поразка |
| Завершення | Оголошується переможець, видаються нагороди | Гравців повертають за кілька секунд, арена скидається |
Скидання арени
- Запис і скасування змін: зберігайте кожен блок перед зміною під час раунду й повертайте його наприкінці. Швидко для малих арен, де гравці ламають або ставлять небагато блоків.
- Світ-шаблон: тримайте чисту копію карти, після раунду вивантажуйте зіграний світ і копіюйте шаблон поверх нього. Просто й надійно для карт, які руйнують.
- Жодних змін: в іграх на кшталт паркуру чи PvP-дуелей повністю скасовуйте зміни блоків, і скидати нічого не доведеться.
Приклад опису
«Плагін міні-гри spleef для Paper 1.21.4. Адміністратори створюють арени командами /spleef create <name>, /spleef setlobby і /spleef setfloor (два кути снігової підлоги). Гравці приєднуються через /spleef join <arena>. Раунд починається через 15 секунд після того, як зайшли 2 гравці, максимум 8. Гравці отримують діамантову лопату, миттєво ламають сніг і вибувають, коли падають нижче підлоги. Останній гравець перемагає й отримує 50 монет через Vault. Гравці, що вибули, стають глядачами. Снігова підлога відновлюється після кожного раунду. Бічне табло з кількістю гравців і часом. Арени зберігаються в arenas.yml, мінімум гравців і нагороди в config.yml.»
Тестування міні-гри
Міні-гру важко оцінити за кодом: треба зіграти раунд. «Спробувати зараз» запускає приватний сервер Paper вашої версії зі встановленим плагіном, зазвичай у пласкому світі, а друзі можуть приєднатися, якщо ви додасте їх у Доступ до сервера. На безкоштовному плані на тестовий сервер можуть зайти 2 особи, на Pro 5, на Business 10, на Enterprise 20.
Попросіть винести мінімум гравців у config.yml, щоб під час тестування встановити його на 1 або 2. Тестові гравці теж можуть зайти, виконати команди приєднання й адміністратора та перевірити повідомлення, тож зламані команди виявляються ще до того, як ви почнете грати.
Запитання
Одна арена чи багато?
Просіть кілька арен від самого початку. Щоб пізніше переробити плагін з однією ареною на плагін з багатьма, доведеться переписати, як зберігаються гравці й стан гри.
Чи можна створити PvP-міні-гру для 1.8?
Так. Вкажіть у запиті Spigot або Paper 1.8.8: Codexe напише код під цей старіший API, а тестові сервери підтримують версії від 1.8 до 26.3.
Як працюють мережі міні-ігор?
Великі мережі запускають кожну гру на окремому сервері за проксі BungeeCord або Velocity, а сервер-лобі відправляє гравців у вільну гру. Це проксі-плагін плюс ігровий плагін, тобто два проєкти.
Створіть свою міні-гру
Цей запит відкривається готовим до надсилання:
“Плагін міні-гри spleef для Paper 1.21.4: арени створюються через /spleef create, setlobby і setfloor, гравці приєднуються через /spleef join, раунд починається через 15 секунд після 2 гравців (максимум 8), діамантові лопати, вибування при падінні нижче підлоги, останній гравець виграє 50 монет через Vault, глядачі для тих, хто вибув, снігова підлога відновлюється після кожного раунду, бічне табло з гравцями й часом, арени зберігаються в arenas.yml.”
Згенерувати це в Codexe