ServerManagement+

ServerManagement+

Универсальное решение для управления сервером Minecraft

Поддерживается: Minecraft 1.20.1 (Forge 47.4.0+ / Fabric API 0.92.8+) | Minecraft 1.21.1 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric API 0.116.1+)

ServerManagement+ даёт вам полный набор инструментов для управления сервером — полноценная экономика с банковскими счетами, игровой рынок, казино, ежедневные задания, управление миром и стильная админ-панель — всё в одном моде.

Статус релиза и планы

Последний релиз — Minecraft 1.20.1 v2.1.2-b1 и 1.21.1 v2.1.2-b3

Последние бета-обновления уже доступны для Minecraft 1.20.1 и 1.21.1!

• 1.20.1 (v2.1.2-b1): Выпущено для Forge и Fabric. Этот масштабный бэкпорт обеспечивает полное соответствие функций современной ветке 1.21.1! Он включает ребалансировку экономического движка Goldrush из Фазы 1 (динамические кривые инфляции, 140+ ценовых ориентиров, разрыв цикла RecipeBasedPricing), обновления GUI из Фазы 3 (выпадающие списки, плавающие логотипы, редакторы на основе узлов), движок производительности и сетевое взаимодействие Zstd из Фаз 6-8, а также полную переработку интерфейса в стиле дизайна 1.21.1.
• 1.21.1 (v2.1.2-b3): Выпущено для Forge, NeoForge и Fabric. Это обновление приносит дополнительные исправления стабильности, улучшения интерфейса и настройку экономического движка для более плавной кроссплатформенной работы.

Обе версии, 1.20.1 и 1.21.1, теперь имеют полное соответствие функций, включая финальную полировку GUI на каждом экране, единое масштабирование pose-matrix, переработку Player Manager и длинный список критических исправлений для Chat Isolation, Tab Isolation и консоли OP-2.

Далее — предстоящие порты и обновления

Отдельные порты для Minecraft 1.21.4 и 1.21.11 находятся в активной разработке.

Возможности

Админ-панель

Современный командный центр в тёмной теме, доступный по команде /sm. Шесть карточек функций позволяют сразу перейти к World Manager, Player Manager, консоли, глобальным настройкам, управлению экономикой или настройкам мода. На каждом экране единообразная навигация с кнопками назад/закрыть и стильная панель заголовка.

• Живая консоль сервера — Запускайте серверные команды прямо из GUI. Вывод окрашен по уровню логов (красный для ошибок, жёлтый для предупреждений) и прокручивается. Требуется OP уровень 2.
• Глобальные настройки — Переключайте Chat Isolation (отдельный чат для каждого измерения) и Tab Isolation (отдельный список игроков для каждого измерения) с помощью переключателей в стиле iOS.
• Настройки мода — Включайте или отключайте отдельные функции (World Manager, Player Manager, SlimeHead, экономика, производительность сервера, MOTD) без перезапуска сервера. Каждый переключатель идёт с кратким описанием и чередующимся фоном строк для наглядности.

Экономическая система

Каждый игрок получает банковский счёт при первом входе с настраиваемым стартовым балансом (по умолчанию: $1,000).

• Управление балансом — Проверяйте баланс, просматривайте историю транзакций и отслеживайте каждый доллар
• Переводы между игроками — Отправляйте деньги напрямую или создавайте запросы на деньги, которые другой игрок может принять или отклонить
• История транзакций — Полный журнал всех покупок, продаж, переводов, наград за задания, азартных игр и бесплатных получений с иконками по типу операции
• Уведомления в action bar — Ненавязчивые сообщения об успехе/ошибке, отображаемые над хотбаром
• Админ-инструменты — Устанавливайте, выдавайте или забирайте деньги у любого игрока через команды или админ-панель
• Статистика экономики — Обзор экономики в реальном времени: всего счетов, денег в обороте, уровень инфляции, активность рынка, статистика азартных игр и объёмы транзакций
• Зашифрованное хранилище — Все экономические данные защищены шифрованием AES-256-GCM

Рынок MineBay

Полнофункциональный игровой рынок, где вы можете покупать и продавать предметы другим игрокам.

• Создание лотов — Продавайте любой предмет или стак из своего инвентаря
• Гибкое ценообразование — Принимайте деньги, до 3 разных типов предметов или и то, и другое
• Динамическое рыночное ценообразование — Отслеживание спроса/предложения с настраиваемой инфляцией
• Встречные предложения — Покупатели могут предложить альтернативную цену; продавцы рассматривают и принимают/отклоняют
• Инвентарь переполнения — Если ваш инвентарь полон при покупке, предметы безопасно сохраняются для последующего получения (работает как в режиме выживания, так и в креативе)
• Безопасность предметов — Серверная обработка предметов с откатом эскроу. Предметы никогда не теряются и не дублируются
• Система черновиков — Пошаговое создание лота с выбором предметов и управлением количеством
• Управление наценкой — Продавцы могут регулировать цены от -50% до +200% от рыночной стоимости

MineStacks Casino

Полноценное казино с четырьмя играми, все результаты честные и используют SecureRandom.

• Coin Flip — преимущество казино 2%, выплата 2x. Простой орёл или решка
• Dice Roll — преимущество казино 3%. Ставки на High/Low (2x), Seven (5x) или Doubles (6x)
• Slot Machine — преимущество казино 5%. Выплаты от Cherry (2x) до Jackpot (100x), с половинными выплатами за две одинаковые
• Roulette — преимущество казино 2.7%. Ставки на Red/Black, Even/Odd, Low/High с возвратом 2x

Поддерживает ставки деньгами ($10–$10,000) и предметами (автооценка). Включает анимации вращения, эффекты частиц при выигрыше, тряску экрана и звуковые эффекты. Ваша статистика азартных игр отслеживается.

Ежедневные задания и бесплатные награды

Три случайно назначенных задания в день, выбранных из настраиваемого пула шаблонов.

Типы заданий:

• Отслеживание прогресса в реальном времени с полосами прогресса в GUI
• Мгновенные уведомления при выполнении задания — нажмите на сообщение в чате, чтобы забрать награду
• Настраиваемые награды — деньги и/или предметы за каждый шаблон задания
• Бесплатная ежедневная награда — забирайте бесплатные деньги и опциональный предмет каждые 24 часа (кулдаун настраивается)
• Редактор шаблонов для админов — создавайте, редактируйте, включайте/отключайте и удаляйте шаблоны заданий прямо из GUI

Управление мирами

Управляйте всеми мирами сервера через визуальный интерфейс.

• Список миров — просмотр всех измерений с количеством игроков
• Телепортация — кликните, чтобы телепортироваться между мирами (с кулдауном)
• Управление порталами — включайте и отключайте порталы в Nether и End
• Спавн лобби — задайте точку спавна лобби и телепортируйте туда игроков (точная позиция + поворот, а не просто выравнивание по блоку)
• Изоляция чата — сообщения чата остаются в пределах измерения (полностью работает на 1.20.1 и 1.21.1)
• Изоляция таба — разделение списка игроков по измерениям (полностью работает на 1.20.1 и 1.21.1)
• Система таймеров — автоматическое включение/отключение порталов по расписанию с живым отсчётом в GUI

Менеджер игроков

Админ-инструменты для управления онлайн- и офлайн-игроками. Переработан с вкладками, поиском и постраничной навигацией.

• Вкладка Online — просмотр всех игроков онлайн с локацией, измерением и режимом игры
• Вкладка Banned — бан / разбан игроков (работает для офлайн-игроков через кэш профилей); опциональный IP-бан
• Вкладка Whitelist — добавление / удаление игроков и включение/отключение вайтлиста
• Spectate — наблюдение за любым игроком в реальном времени с полным отслеживанием между измерениями, режимом невидимости (в том же измерении) и маскировкой в табе, чтобы имя наблюдателя не отображалось у других серым курсивом
• View inventory — просмотр инвентаря игрока в режиме только для чтения
• Kick — кик онлайн-игроков с опциональной причиной
• Автосинхронизация — сервер отправляет клиенту состояние бана/вайтлиста/переключателей после каждого изменения
• Нажатие E в поле имени больше не закрывает экран

SlimeHead

Забавный косметический предмет — неразрушаемый блок-голова слизня с кастомной текстурой.

• Получается через команду /slimehead или с шансом 5% при дропе со слизней
• Защищён от разрушения не-опами при установке
• Доступен во вкладке Creative Tools & Utilities

Редактор MOTD

Настройте Message of the Day вашего сервера с помощью визуального редактора.

• Форматирование текста — применяйте цветовые коды и форматирование (жирный, курсив, подчёркивание, зачёркивание) с живым предпросмотром
• Многострочность — редактируйте обе строки MOTD сервера
• Только для админов — доступен с Dashboard, требует OP уровня 2
• Мгновенное применение — изменения вступают в силу сразу без перезапуска сервера
• Переключаемость — включайте/отключайте кастомный MOTD через конфиг

Инструменты производительности сервера

Панель настроек производительности с восемью переключателями на лету и прокручиваемой вкладкой статистики — TPS, MSPT, использование памяти и количество сущностей одним взглядом.

• Обработчик объединения предметов — Ограничивает объединение предметов-сущностей до 500 предметов на измерение за тик (больше никаких зависаний O(n²) от сброса моб-ферм)
• Ограничитель спавна мобов — Ограничение на тик, сглаживающее всплески спавна
• Дроссель Redstone — Ограничивает частые обновления Redstone за тик
• Все переключатели настраиваются на лету; перезапуск не требуется

Система уведомлений

Кликабельные уведомления в чате держат игроков в курсе, не спамя.

• Уведомления о входе — Админы видят ссылку на панель управления; игроки видят напоминания о бесплатной награде и заданиях
• Оповещения о платежах — Уведомления при отправке или получении денег
• Завершение задания — Мгновенное уведомление с кликабельной кнопкой получения, когда задание выполнено
• Награда получена — Подтверждение при сборе наград

Интеграция со справкой

Все команды ServerManagement+ интегрированы в ванильную команду /help.

• /help — Показывает все доступные команды, включая команды ServerManagement+, с описаниями
• /help <команда> — Подробное использование любой команды мода (например, /help bank)
• Фильтрация для админов — Админ-команды помечены тегом [Admin] и скрыты от не-операторов
• Работает вместе с ванильными командами и командами других модов

Автоматические обновления модов и умный перезапуск

Автоматические OTA-обновления модов для подключённых клиентов и простое обновление сервера.

• Обновления с двух платформ — Автоматически проверяет и Modrinth, и CurseForge, чтобы найти последние обновления.
• Корректное завершение работы сервера — При обновлении сервера безопасно сохраняет ваш мир и корректно завершает работу перед горячей заменой jar-файла мода.
• Скрипт умного перезапуска — Сканирует ваш сервер на наличие run.bat / run.sh и разумно встраивается в них, чтобы ваш сервер автоматически перезагружался после применения обновления. Админы могут автоматически пропатчить свои run-скрипты прямо из игры!
• Учёт нескольких версий — OTA-обновления блокируются между разными версиями Minecraft (например, клиент 1.20.1 не получит обновление для 1.21.1)
• Учёт нескольких загрузчиков — Клиентам Forge не будут выдаваться JAR-файлы NeoForge или Fabric, и наоборот
• Ограничение частоты — Одна передача на игрока за сессию; прерывается досрочно, если клиент отключается в середине передачи

Как работает обновление (для ручной проверки)

Чтобы обеспечить полную прозрачность того, как мод обрабатывает обновления, не вызывая ложных срабатываний систем безопасности:

1. Запросы к API: Мод делает только стандартные GET-запросы к официальным эндпоинтам api.modrinth.com и api.curseforge.com для проверки номеров версий.
2. Отдельный обновлятор: Чтобы избежать проблем с блокировкой файлов в Windows, мод извлекает встроенный updater.jar в корень сервера. Этот jar запускается в отдельном временном процессе JVM, единственная задача которого — дождаться выхода основного сервера, скопировать новый скачанный jar-файл мода поверх старого и затем удалить себя.
3. Изменение серверного скрипта: Если админ соглашается на функцию умного перезапуска через внутриигровое окно GUI, мод читает существующий скрипт run.bat или run.sh, создаёт его резервную копию в run.bat.bak и внедряет стандартный JVM-аргумент -Dservermanagement.smartstart=true. Он не выполняет произвольный shell-код и не скачивает внешние скрипты. Вся генерация скриптов происходит локально и требует явного согласия админа в игре.
4. Согласие на стороне клиента: На стороне клиента, если обнаружено обновление, мод перехватывает главное меню отдельным UI-оверлеем. Клиент никогда не скачивает и не устанавливает что-либо автоматически без нажатия пользователем кнопки "Update Now". Пользователям также явно предоставляются опции "Update Later" и "Skip This Version".
5. Проверьте сами: Если вы рецензент кода или админ сервера и хотите безопасно протестировать эту систему в действии, клонируйте наш репозиторий с открытым исходным кодом и понизьте версию, чтобы сымитировать устаревший мод. Поскольку текущая версия мода статически проверяется, вам нужно понизить версию в gradle.properties, а также изменить жёстко заданные строки версий в ForgeUpdateHooks.java и FabricUpdateHooks.java на более старую версию. Скомпилируйте мод (gradlew build), запустите локальный тестовый сервер и явно включите функцию умного перезапуска через внутриигровое админ-меню. Вы увидите, что мод безопасно скачивает обновление, извлекает updater.jar, создаёт резервные копии ваших run-скриптов в файлы .bak и чисто внедряет флаг -Dservermanagement.smartstart=true, не выполняя произвольный shell-код. Ничего не скрыто.

Безопасность

Все чувствительные данные шифруются при хранении и аутентифицируются при передаче.

• Шифрование AES-256-GCM для данных экономики, ежедневных заданий, денежных запросов и отслеживания достижений
• Уникальный ключ сервера автоматически генерируется при первом запуске и хранится с ограниченными правами доступа
• HMAC-SHA256 аутентификация пакетов предотвращает повторную отправку и подмену
• Управление сессиями с индивидуальными токенами для каждого игрока и таймаутом в 30 минут
• Атомарные транзакции с автоматическим откатом эскроу — никаких частичных операций, никакой потери данных
• Защита от дублирования предметов — серверная валидация предметов в лотах и предложениях на рынке; безопасная от гонок очистка слотов; синхронизированные операции с балансом
• Укрепление сетевого буфера — все строковые и целочисленные поля пакетов имеют строгие ограничения длины и значений на уровне декодирования, что предотвращает исчерпание памяти из-за слишком больших полезных нагрузок
• Ограничения размера NBT — вся загрузка данных NBT использует лимиты NbtAccounter в 10MB для предотвращения исчерпания памяти из-за повреждённых файлов
• Проверка прав на каждом админском пакете — включая телепортацию между измерениями и выполнение консольных команд
• Валидация ввода — имена игроков проверяются по регулярному выражению [a-zA-Z0-9_]{1,16} на сетевом уровне до любой серверной обработки
• Защита от инъекций в логи — управляемые пользователем строки очищаются перед записью в лог для предотвращения подделки логов
• Потокобезопасная экономика — синхронизированные операции с балансом, атомарный эскроу с откатом через try-catch, итерация по коллекциям на основе снимков, планировщик сохранения на виртуальных / демон-потоках и конкурентные коллекции в общих менеджерах

Команды

Команды игроков

Команды администраторов

Конфигурация

Файл конфигурации находится по адресу config/servermanagement-common.toml. Ключевые настройки:

Все данные экономики, шаблоны заданий и прогресс игроков сохраняются после перезапусков сервера с автоматическим резервным копированием и поддержкой миграции.

Установка

Требования

• Minecraft: 1.20.1 или 1.21.1 (порт на 1.21.4 выйдет этим летом)
• Forge: 47.4.0+ (MC 1.20.1) или 52.1.0+ (MC 1.21.1),
• NeoForge: 21.1.80+ (MC 1.21.1),
• Fabric API: 0.92.8+ (MC 1.20.1) или 0.116.1+ (MC 1.21.1) с Fabric Loader 0.19.2+ (MC 1.20.1) или 0.18.1+ (MC 1.21.1)
• Java: 17+ (MC 1.20.1) или 21+ (MC 1.21.1)

Настройка

1. Скачайте JAR для вашей версии Minecraft и загрузчика модов:

   • MC 1.20.1 Forge: ServerManagement-forge-1.20.1-2.1.2-b01-mc1.20.1.jar
   • MC 1.20.1 Fabric: ServerManagement+-fabric-1.20.1-2.1.2-b01-mc1.20.1.jar
   • MC 1.21.1 Forge: ServerManagement-forge-1.21.1-2.1.2-b03-mc1.21.1.jar
   • MC 1.21.1 NeoForge: ServerManagement-neoforge-1.21.1-2.1.2-b03-mc1.21.1.jar
   • MC 1.21.1 Fabric: ServerManagement+-fabric-1.21.1-2.1.2-b03-mc1.21.1.jar
2. Поместите его в папку mods/ вашего сервера
3. Запустите сервер — папки config и data создадутся автоматически
4. По желанию установите на клиентах для полной поддержки GUI (работает и только на сервере)
5. Измените настройки в config/servermanagement-common.toml и перезапустите

Первоначальная настройка (для владельцев серверов)

1. Проверьте значения конфига (стартовый баланс, награды, перезарядки)
2. Откройте админ-панель командой /sm, чтобы изучить возможности
3. Перейдите в Economy Management, чтобы создать шаблоны ежедневных заданий
4. Задайте суммы и предметы бесплатных наград
5. Протестируйте экономику командами /bank, /minebay и /minestacks

Хранение данных

Все данные мода хранятся в world/data/servermanagement/:

Перед обновлениями делайте резервную копию world/data/servermanagement/ и config/servermanagement/.

Решение проблем

Лицензия

MIT License — можно свободно использовать, изменять и распространять.

ServerManagement+ — Minecraft 1.20.1 v2.1.2-b1 (Forge 47.4.0+ / Fabric API 0.92.8+) — Minecraft 1.21.1 v2.1.2-b3 (Forge 52.1.0+ / NeoForge 21.1.80+ / Fabric 0.116.1+) — порт для Minecraft 1.21.4 выйдет этим летом

Команда ServerManagement+