MKT Essentials

MKT Essentials

Комплексный всё-в-одном серверный мод-утилита для NeoForge 1.21.1. Всё, что нужно для работы Minecraft-сервера — телепортация, богатый чат, косметика, модерация, аутентификация, мост в Discord, бэкапы инвентаря и многое другое — в одном лёгком пакете. Игроки заходят с ванильным клиентом, и им ничего не нужно устанавливать.

✨ Почему MKT Essentials?

• Всё-в-одном — заменяет кучу отдельных модов одним.
• Только на сервере — работает с ванильными клиентами.
• Самодостаточный — таб-лист, никнеймы над головой, MOTD и плейсхолдеры встроены; никакой сопутствующий мод не нужен.
• Полностью настраиваемый — чистый YAML, переключатели для каждой команды, английский и польский языковые файлы.
• На правах доступа — узел для каждой команды; отлично работает с LuckPerms.

💬 Богатый чат

• Markdown-форматирование — *курсив*, **жирный**, __подчёркнутый__, ~~зачёркнутый~~, ??матрица?? — в чате и на тексте наковальни/книг/табличек
• Интерактивный чат — кликабельные ссылки, шорткоды :emoji: и ||спойлеры||, которые раскрываются при наведении
• Встроенные объекты — [item] показывает предмет в руке (с подсказкой), `
• Упоминания — @player подсвечивает и пингует игрока; отключается через /mentions
• Личный цвет чата — /chatcolor
• GUI настроек чата — /chatsetting, плюс меню игнор-листа
• Локальный / по мирам чат — сообщения только рядом или по мирам с глобальным префиксом
• Ролеплей, анонимность и стрим — /me, /do, /anon, /stream, плюс глифы /symbol

🎨 Косметика и отображение

• Никнеймы — /nick отображается в чате, таб-листе и над головой игрока (скин сохраняется)
• Встроенный таб-лист — свой заголовок/подвал, анимации, опциональная колонка пинга
• Никнеймы над головой — префикс/суффикс ранга через команды скорборда
• Значения под ником, боковой скорборд и боссбар — плейсхолдеры + анимации
• Бренд сервера — настройка названия сервера на экране отладки F3
• Приветствие — персональное сообщение при входе, которое может отрисовать лицо скина игрока пиксель-артом
• MOTD и иконка — настройка описания и иконки в списке серверов, с отдельным MOTD для техработ

🔗 Интеграция с Discord

Встроенный бот на JDA — никаких внешних плагинов не нужно:

• Привязка аккаунтов — сгенерируйте 6-значный код в игре, подтвердите слэш-командой в Discord; опциональная роль для привязанных
• Двусторонний релей чата — чат в игре и вход/выход дублируются в канал Discord (с вебхук-аватарами, показывающими имя и скин каждого игрока); сообщения из канала появляются в игре
• Живой статус — бот показывает текущее число игроков онлайн
• Безопасно по умолчанию — блокирует пинги @everyone из игры, очищает цветовые коды в обе стороны

Для функций Discord требуется мод KotlinForForge.

🔨 Модерация

• Ban / Tempban / Unban — парсинг длительности (1d12h, 30m) и экран бана с причиной + временем
• IP-баны — /banip, /unbanip (работает на офлайн-игроках по последнему известному IP)
• Mute / Tempmute / Unmute — на время или навсегда, поддерживает офлайн
• Предупреждения — /warn с автоматической эскалацией до темпбана при достижении настраиваемого лимита
• История — /history полная запись наказаний
• Шэдоу-бан — 4 метода, включая фантомную полную изоляцию: игрок заходит в пустой мир, никого не видит, его никто не видит, не получает чат и беззвучно замучен в голосовом чате

🔐 Аутентификация

• 5 режимов — полный, только авторизация, только привязка, опциональный, отключён
• Регистрация и вход — пароли хешируются через bcrypt
• Система заморозки — неавторизованные игроки не могут двигаться, взаимодействовать или писать в чат
• Защита новичков — окно неуязвимости для игроков, зашедших впервые
• Управление сессиями — автовход с того же IP в течение таймаута
• Опциональная веб-синхронизация — двусторонняя синхронизация с внешним сайтом/бэкендом

🏠 Телепортация

• Дома с лимитами по рангам через LuckPerms (`mktessentials.homes.`)
• Варпы (кликабельный GUI), TPA, RTP (асинхронно, чёрный список биомов, безопасная посадка)
• /back (работает после смерти), Spawn, Top, TpAll
• Отдельные кулдауны для каждого типа — TPA, RTP и варпы работают на независимых таймерах

📦 Киты и предметы

• Киты — создание через сундук-GUI или из инвентаря, кулдауны для каждого кита, кликабельный браузер /kits
• Виртуальные рабочие станции — /workbench, /anvil, /grindstone, /stonecutter, /smithing, а также /trash

💾 Бэкапы инвентаря

• Автоматически при смерти/входе/выходе, опциональные бэкапы по расписанию, GUI-браузер, поддержка Curios

🧹 Очистка предметов

• Автоудаление с голограммой-отсчётом, стакинг сущностей, белый список (модовые предметы и вайлдкарды), ручная очистка

🛡️ Админ-утилиты

• Fly / God / Vanish (сохраняются), быстрые команды смены режима игры, /invsee и /enderchest (офлайн + Curios), /speed, /repair, /enchant, /exp, /whois, /geolocate, /sudo, /tps и /lag
• Автообъявления, текстовые команды из конфига, почта, опросы, личное время/погода для каждого игрока

🔗 Опциональные интеграции

Определяются автоматически — установлен = используется, отсутствует = игнорируется.

Мод отлично работает и без них.

⚠️ Заметки о совместимости

• LuckPerms на NeoForge 1.21.1 — в официальной сборке известный баг; используйте пропатченную версию: https://github.com/onmydestiny/LuckPerms-PATCHED
• Text Placeholder API — нет официального релиза для NeoForge 1.21.1; используйте порт: https://github.com/MakotoPD/TextPlaceholderAPI-NeoForge
• Discord — требует мод KotlinForForge и включённые Message Content Intent (релей) / Server Members Intent (привязка) в Discord Developer Portal.

📋 Требования

• Minecraft 1.21.1 · NeoForge 21.1.228+ · Java 21

🔒 Права

У каждой команды свой узел (mktessentials.command.home, mktessentials.admin.fly, mktessentials.moderation.ban, …). Полный список в игре через /mkt permissions. Некоторые лимиты масштабируются по рангам через LuckPerms (лимиты домов, кулдауны телепортации по типам).

📄 Ссылки

• Исходники: https://github.com/MakotoPD/MKT-Essentials
• Баг-трекер: https://github.com/MakotoPD/MKT-Essentials/issues
• Лицензия: GPL-3.0-only