MiniGameCore - ядро для мини-игр

MiniGameCore - это плагин-каркас для серверов Minecraft, который берет на себя всю рутину по созданию мини-игр. Если вы админ и хотите запустить BedWars, Spleef или что-то свое, вам обычно приходится писать кучу кода для лобби, команд и статистики. Этот плагин решает проблему: он умеет хостить игры, пускать игроков, вести счет и поддерживать несколько миров.

Свежие релизы (вплоть до 1.3.7.2 от апреля 2026 года) отлично работают на Paper, Spigot и Purpur для Minecraft Java 1.21.x. Хотите поиграть с друзьями онлайн? Плагин легко запустится на BungeeHost (https://bungee.host) буквально в 1 клик, так что проблем с хостингом не будет.

Установка

1. Скачать плагин для Майнкрафт можно по внутренней ссылке в виде .jar файла.
2. Кидаем файл в папку plugins/ вашего сервера.
3. Для управления правами можно поставить LuckPerms (в новых версиях это опционально).
4. Перезагружаем сервер. Готово.

Команды и права

Плагин использует алиасы для удобства: /p для /party и /tc для /teamchat.

Команда	Описание	Право
/mg host <game>	Создает новое лобби	mgcore.host
/mg join <lobby-id>	Войти в лобби	mgcore.join
/mg ready	Отметиться как готовый	mgcore.ready
/mg unready	Снять готовность	mgcore.ready
/mg confirm	Подтвердить действие	mgcore.confirm
/mg leave	Выйти из лобби или игры	mgcore.leave
/mg start	Запустить игру вручную (если разрешено)	mgcore.start
/mg spectate <lobby-id|player>	Зайти в игру как наблюдатель	mgcore.spectate
/mg reload	Перезагрузить конфиг плагина	mgcore.admin
/mg stop <lobby-id>	Остановить конкретную игру	mgcore.admin
/mg stopall	Остановить все активные игры	mgcore.admin
/mg ban <player>	Забанить игрока на использование команд MiniGameCore	mgcore.admin
/mg version	Показать версию плагина	mgcore.use (по умолчанию)
/party create <name>	Создать пати	mgcore.party.create
/party join <player>	Войти в пати к игроку	mgcore.party.join
/party leave	Покинуть пати	mgcore.party.join
/party invite <player>	Пригласить игрока в пати	mgcore.party.invite
/party deny	Отклонить приглашение	mgcore.party.invite
/party list	Список участников пати	mgcore.party.list
/teamchat <message>	Отправить сообщение только команде	mgcore.teamchat

Настройка плагина и миров

Конфиги лежат в ./plugins/MiniGameCore. Основной файл - config.yml. Там можно указать список доступных игр и забаненных игроков по UUID.

Совет от опытного админа: Обратите внимание на параметр keep-worlds. Если выставить true, отыгранные миры не будут удаляться, а переедут в папку ArchivedWorlds. Это спасет карту, если в процессе игры что-то пошло не так и мир сломается.

Папка для миров и их настроек - ./MiniGameCore. Мир должен называться по схеме <Имя_игры>_world. Нужны разные карты для одного режима? Назовите их <Имя_игры>_world1, <Имя_игры>_world2 и так далее. Настройки карты лежат в файле config.yml внутри папки мира.

Доступные опции мира

Поле	Описание	Обязательно / По умолчанию
name	Отображаемое имя игры (в скорборде, при /mg host)	Да
maxPlayers	Лимит игроков на игру	Да
teams	Число команд (0 - без команд, от 2 до 8)	Нет (0)
minPlayers	Минимум игроков для старта	Нет (2)
spawnPoints	Стандартные точки спавна для игроков без команды	Зависит
teamSpawnPoints	Точки спавна для команд (напр. 0: [...], 1: [...])	Зависит
inventory	Стартовые предметы (напр. ["WOODEN_SHOVEL"])	Нет
allowed_break_blocks	Разрешенные к ломке блоки (напр. ["SNOW_BLOCK"])	Нет
allowed_place_blocks	Разрешенные к установке блоки (напр. ["OAK_PLANKS"])	Нет
respawnMode	Респавн: "true" или "false"	Нет (false)
respawnDelay	Задержка респавна в секундах	Нет (0)
doDurability	Уменьшение прочности предметов: true (ванилла) или false	Нет (true)
allowPVP	Разрешить PVP: true или false	Нет (true)
blocked_damage_causes	Блокировать указанные типы урона	Нет
timeLimit	Остановить игру через X секунд	Нет (600)
allowFriendlyFire	Разрешить урон по своим	Нет (false)
allowCrafting	Разрешить крафт во время игры (появилось в 1.3.5)	Нет (false)
silenceDeathMessages	Скрыть сообщения о смерти	Нет (false)
hostPerm	Право для создания лобби	Нет (mgcore.host)
joinPerm	Право для входа в лобби	Нет (mgcore.join)
doHunger	Убывать ли шкале голода	Нет (false)
allowOpeningContainers	Открывать сундуки до старта игры	Нет (false)

Пример конфига для Spleef на 8 игроков:

yaml game: name: Spleef maxPlayers: 8 teams: 0 spawnPoints: spawn1: x: -11 y: 64 z: 0 spawn2: x: -7 y: 64 z: -7 spawn3: x: 0 y: 64 z: -11 spawn4: x: 7 y: 64 z: -7 spawn5: x: 11 y: 64 z: 0 spawn6: x: 7 y: 64 z: 7 spawn7: x: 0 y: 64 z: 11 spawn8: x: -7 y: 64 z: 7 inventory: - "iron_shovel" allowed_break_blocks: - "snow_block" respawnMode: false doDurability: false allowPVP: false

API для разработчиков

Если вы кодер и пишете свой режим для сервера Майнкрафт, MiniGameCore дает готовый API. Импортируйте проект через Gradle:

gradle repositories { maven { url "https://jitpack.io" } }

dependencies { implementation 'com.github.Wueffi:MiniGameCore:master-SNAPSHOT' }

Импортируйте нужные классы через import wueffi.MiniGameCore.x.

События (Events):

• GameStartEvent (доступны event.getGameName() и event.getLobby())
• GameOverEvent (доступен event.getLobby())

Полезные классы:

• Lobby
• Team

Методы API:

• getLobbyManager() - получить инстанс менеджера лобби
• winPlayer(Lobby lobby, Player player) - выдать победу игроку
• winTeam(Lobby lobby, Team team) - выдать победе команде
• playerDeath(UUID playerid) - уведомить ядро о смерти
• playerAlive(UUID playerid) - уведомить ядро о респавне
• getRespawnLocation(UUID playerid) - получить точку возрождения

Короче, если вы заморачиваетесь над кастомным режимом - этот каркас сэкономит вам десятки часов работы. Скачайте MiniGameCore и соберите свой идеальный сервер для мини-игр.