Статус текущего ядра
TBM Core 0.4.0-beta — локальная версия для backend Survival. В этой сборке Website Bridge отсутствует: сайт ещё не получает игровые изменения автоматически.
THEBESTMC / KNOWLEDGE BASE
Wiki TheBestMC.
Справочник по игровым режимам, механикам, командам, аккаунтам, экономике и архитектуре серверной сети.
Статус документации: команды игрового ядра сверены с TBM Core 0.4.0-beta из архива. Функции, помеченные как целевые, ещё не доступны в этой beta. Особенно важно: Website Bridge и
/tbm sync в исходной версии плагина не реализованы.THEBESTMC / MANUAL
Начало игры
Что нужно знать перед входом на TheBestMC.
Первый вход
Открой список серверов, подключись к нужному режиму и зарегистрируй один сайт-аккаунт, если он доступен для текущей конфигурации авторизации.
Уникальный профиль
Игроки идентифицируются UUID Minecraft, а сайт сопоставляет их с аккаунтами. Ник может измениться; UUID остаётся основным идентификатором.
THEBESTMC / MANUAL
Приваты и территории
Защита построек, доступы и границы участков.
/claim
Защитить текущий чанк 16×16 по горизонтали на всю высоту мира.
/unclaim
Снять защиту с текущего чанка, если он принадлежит тебе.
/claims
Показать список принадлежащих тебе участков.
/claim info
Показать владельца и сведения о текущем чанке.
/claim trust <ник>
Разрешить игроку строительство и взаимодействие на твоём участке.
/claim untrust <ник>
Удалить ранее выданный доступ.
/claim border [show|hide|toggle]
Включить, отключить или переключить временную рамку частицами по границе текущего чанка.
Правила приватизации
Участки разделяются по UUID мира. Чанк с одинаковыми координатами в обычном мире и Nether считается разным участком. Лимит чанков суммируется по мирам и зависит от ранга.
Ограничения защиты
Beta защищает основные блоки, взаимодействия, часть сущностей, рамки, жидкости, огонь, взрывы, поршни и хопперы. Сложные редстоун-механизмы, вагонетки, нестандартные блоки и projectile damage требуют отдельного тестирования.
THEBESTMC / MANUAL
Дома и перемещения
Сохранение точек и перемещение между игроками.
/sethome [имя]
Сохранить точку дома в текущем мире. Если имя не указано, используется home.
/home [имя]
Телепортироваться к сохранённой точке.
/delhome <имя>
Удалить точку дома.
/spawn
Переместиться на настроенную точку появления.
/setspawn
Установить точку появления — только при наличии соответствующего разрешения.
/back
Вернуться к сохранённой предыдущей позиции, если она доступна.
/tpa <игрок>
Отправить запрос на телепортацию к игроку.
/tpahere <игрок>
Предложить игроку телепортироваться к тебе.
/tpaccept
Принять актуальный запрос на телепортацию.
/tpdeny
Отклонить запрос на телепортацию.
Лимиты домов
В beta: default — 2; HERO — 3; KRAKEN — 3; PREMIUM — 4; KING — 5; SUPPORT — 6; SPONSOR — 8; CUSTOM — 10. Проверяй итоговые лимиты в конфиге сервера.
THEBESTMC / MANUAL
Экономика и Coins
Разница между локальными игровыми монетами и глобальными Coins.
/balance, /bal, /money
Показать локальный игровой баланс текущего backend Survival.
/pay <игрок> <сумма>
Перевести локальные игровые монеты другому игроку.
/eco give|take|set
Административное изменение локальной экономики плагина. Команда доступна только с соответствующим permission.
Награды за мобов
Награды задаются по типам мобов в mob-rewards.yml. Начисление показывается в Action Bar. Есть ограничение оплачиваемых убийств для защиты от фарма.
Глобальные Coins — пока не подключены
В TBM Core 0.4.0-beta нет единого сетевого кошелька, EasyDonate webhook или центральной синхронизации. Не считай локальный /balance общесетевым балансом и не запускай реальные продажи Coins через эту beta.
Целевая модель Coins
После установки совместимой версии Bridge Coins будут общими для всей сети. Узлы Survival/других режимов смогут иметь отдельные локальные валюты GAME. Все изменения Coins должны проходить через идемпотентную транзакцию с уникальным ключом операции.
THEBESTMC / MANUAL
Статистика, XP и достижения
Личные показатели и правила начисления опыта аккаунта.
/tstats [игрок]
Показать статистику текущего режима: убийства мобов и игроков, смерти, сломанные и поставленные блоки, рыбалка и крафт.
/tlevel
Показать уровень и опыт игрока в локальной beta-сборке.
Время в игре
В beta начисляется 3 XP за активный час. AFK не должен приносить опыт; порог активности задаётся параметром stats.active-window-seconds. Максимальный уровень — 100.
Достижения Minecraft
Каждое выполненное достижение приносит 1 XP по умолчанию. Значения можно настроить индивидуально в achievements.yml.
KeepInventory
Поведение инвентаря после смерти настраивается через stats.keep-inventory-on-death.
Лидерборды сайта
Публичные топы строятся только по данным, полученным от сервера и сохранённым сайтом. После внедрения Bridge синхронизация будет пакетной; до этого игровые топы могут быть пустыми или содержать старые данные.
THEBESTMC / MANUAL
Чат и общение
Форматирование общего чата, личные сообщения и офлайн-почта.
Формат чата
Шаблон задаётся в chat.yml. Prefix и suffix считываются через публичный LuckPerms API. Доступные placeholders: %player%, %world%, %server%, %level%, %prefix%, %suffix%, %message%.
/msg, /tell, /w, /whisper <игрок> <текст>
Отправить личное сообщение игроку.
/reply или /r <текст>
Ответить последнему собеседнику.
/ignore <игрок>
Игнорировать сообщения игрока.
/mail send <игрок> <текст>
Отправить офлайн-сообщение на текущем backend.
/mail read
Прочитать накопившуюся локальную офлайн-почту.
Редактирование
После изменения внешних YAML-файлов используй /tbm reload. Не меняй конфиги сторонними скриптами во время работы плагина.
THEBESTMC / MANUAL
Модерация
Наказания в текущей beta хранятся на конкретном backend.
/warn <игрок> <причина>
Выдать предупреждение на текущем сервере при наличии permission.
/mute <игрок> <срок|perm> <причина>
Ограничить чат игрока на текущем backend.
/unmute <игрок>
Снять локальное ограничение чата.
/ban <игрок> <срок|perm> <причина>
Запретить вход на текущий backend.
/unban <игрок>
Снять локальный бан.
/kick <игрок> <причина>
Отключить игрока от текущего backend.
Форматы срока
10m — минуты, 2h — часы, 7d — дни, 1w — неделя, perm — бессрочно.
Важно о сетевых наказаниях
В версии 0.4.0-beta наказания хранятся в локальном YAML-файле и не являются глобальными. Новый сайт может отображать синхронизированные записи, но не выдаёт, не отменяет и не рассылает баны/муты. Сетевое исполнение появится после отдельной проверенной версии Bridge.
THEBESTMC / MANUAL
Утилиты и команды удобства
Команды, доступность которых может зависеть от permission и настроек.
/feed
Восстановить сытость.
/heal
Восстановить здоровье.
/repair
Починить предмет в руке, если команда разрешена.
/more
Заполнить подходящий стак до максимума.
/ext
Потушить игрока.
/craft
Открыть верстак без предмета.
/ec
Открыть эндер-сундук.
/anvil, /grindstone
Открыть наковальню или точило.
/loom, /stonecutter
Открыть ткацкий станок или камнерез.
/smithing, /cartography
Открыть кузнечный стол или стол картографа.
/hat
Надеть предмет из руки на голову.
/fly
Переключить полёт при наличии tbm.fly.custom. Полёт блокируется после PvP на заданный период.
/ping
Показать задержку соединения.
/seen <игрок>
Показать доступную информацию о последнем входе.
/suicide
Завершить жизнь персонажа.
/clear
Очистить инвентарь — только с соответствующим разрешением.
/broadcast <текст>
Отправить объявление от имени сервера при наличии разрешения.
/motd
Показать сообщение дня.
THEBESTMC / MANUAL
Администрирование TBM Core
Команды диагностики и управления локальными настройками плагина.
/tbm status
Показать версию, режим, состояние модулей и статус Website Bridge. В 0.4.0-beta Bridge должен отображаться как OFF.
/tbm modules
Показать список модулей и включённые состояния.
/tbm reload
Перечитать config.yml и внешние YAML-файлы, поддерживаемые безопасной перезагрузкой.
/tbm xp give|take|set <игрок> <число>
Локальное администрирование XP в beta. Это не команда сайта.
/eco give|take|set <игрок> <сумма>
Локальное администрирование игровой валюты.
Конфигурация
config.yml — режим, модули, лимиты и экономика; messages.yml — сообщения и префикс; chat.yml — общий чат; mob-rewards.yml — награды мобов; achievements.yml — XP за достижения.
LuckPerms
Набор permission nodes для рангов и команд указан в PERMISSIONS-LUCKPERMS-RU.txt внутри архива TBM Core.
THEBESTMC / MANUAL
Сайт и Control Panel
Какие действия доступны в панели и что сознательно исключено.
Обзор
Состояние БД, количество аккаунтов, игровые узлы, онлайн и последняя синхронизация.
Серверные узлы
Добавление физических узлов, назначение логического режима и выбор единственного источника глобальных Coins.
Ключи и безопасность
Выпуск/ротация уникального HMAC-ключа узла и проверка статуса глобальных ключей. Секрет отображается только один раз.
Игроки
Каталог аккаунтов и карточка игрока — только просмотр.
Журнал событий
Поиск, фильтры по типам, серверу и актору; страничная выдача вместо бесконечной ленты.
Новости
Редактирование публикаций с безопасной загрузкой изображений JPG, PNG, WEBP и GIF.
Только read-only для игровых действий
Сайт не выдаёт привилегии, Coins, XP, баны, муты, кики и не запускает игровые команды.
THEBESTMC / MANUAL
Синхронизация и архитектура сети
Целевая схема обмена данными между игровым узлом и сайтом.
Команда /tbm sync
В запланированной версии Bridge команда запускает полную или инкрементальную выгрузку. Плагин собирает снимки игроков, кошельки, статистику, достижения, события и локальные наказания и отправляет их пакетами. В текущем 0.4.0-beta команды sync ещё нет.
Почему пакетами
Вместо постоянного HTTP-запроса на каждый игровой event используется один запуск синхронизации, пачки ограниченного размера, повторяемые запросы с idempotency key и контрольный receipt. Это снижает сетевую нагрузку и предотвращает дубли.
Три криптографических контура
1) отдельный HMAC-SHA256 секрет на физический узел — аутентификация запросов; 2) отдельный 256-битный ключ libsodium на сайте — шифрование сохранённых node-секретов; 3) ключ Ed25519 — подпись подтверждений сайта, публичная часть передаётся плагину. Это три ключевых контура, но не три одинаковых ключа шифрования.
Что означает read-only
Игровой сервер — источник игровых фактов. Сайт принимает и отображает эти факты, а административная панель управляет только инфраструктурой сайта и узлами. Отдельные API выдачи игровых действий не включены в интерфейс.
Разделение данных
TBMCore хранит сетевой профиль и глобальные Coins. tbmcore_server_players, tbmcore_server_wallets, tbmcore_server_stats, tbmcore_achievements и tbmcore_server_punishments хранят состояние по server_id. Новому узлу не требуется создавать новые физические SQL-таблицы.
Конфликт данных
Каждая запись привязана к server_id, UUID игрока и revision/idempotency key. Полная синхронизация помечает присутствие на конкретном узле; она не должна удалять данные другого узла. Для глобальных Coins выбирается один авторитетный узел.
Статус интеграции
Сайт содержит серверные endpoint-ы и схему для протокола v2. TBM Core 0.4.0-beta из переданного архива не содержит сетевой Website Bridge, HTTP-клиента или команды /tbm sync. Для фактического обмена нужна следующая сборка плагина и интеграционные тесты.