BeastTokensProxy

BeastTokensProxy — это серверный модуль для прокси BungeeCord, Velocity и Waterfall, который обеспечивает синхронизацию валют между серверами сети, централизованное управление балансами через консоль прокси и доступ к веб-интерфейсам администраторов бэкендов.

Единая сеть, связанные экономики

BeastTokensProxy выступает в роли сетевого компаньона для BeastTokens, позволяя соединять сервера бэкенда (Survival, SkyBlock, Prison или игровые события) через механизм ProxySync. Модуль устанавливается непосредственно на прокси BungeeCord или Velocity, чтобы связать участвующие сервера в единую сеть. Система поддерживает отправку обновлений балансов для конкретных валют между соединенными серверами, а также обрабатывает различные типы валют, включая токены, драгоценные камни, сезонные очки и пользовательские идентификаторы валют. Администраторы могут проверять, добавлять, удалять или устанавливать балансы прямо из консоли прокси. Кроме того, модуль ретранслирует обновления запасов магазинов и кэша вращающихся магазинов из MySQL, а также автоматически принимает объявления о валютах от подключенных серверов BeastTokens.

Веб-дашборд вашей сети

Для упрощения управления администраторы могут включить опциональный WebInterfaceProxy, предоставляющий единую точку входа для команды администраторов сети. В разделе каталога серверов бэкенда отображаются веб-редакторы объявленных серверов в виде карточек. Для каждого входа показывается имя сервера, адрес редактора, время последнего соединения и статус «Online» или «Stale». Пользователи могут открывать бэкенд-редакторы непосредственно внутри дашборда или в новой вкладке браузера. Сохраненные записи о серверах сохраняются после перезагрузки прокси, а ненужные записи можно удалить. Статус Online/Stale отражает недавние объявления от бэкенда, который обеспечивает свой собственный работающий веб-редактор и систему входа, сохраняя доступность инструментов администрирования, таких как Shop Studio, магазины и резервные копии. Менеджер экономик MySQL позволяет выбирать активные зарегистрированные валюты, искать записи игроков по имени или UUID, сортировать по размеру баланса или времени последнего визита, а также отображать головы игроков, UUID и точные десятичные значения балансов. Можно настроить количество отображаемых записей до 500 на запрос, устанавливать индивидуальный баланс игрока или сбрасывать его до нуля, после чего отправить соответствующее обновление баланса подключенным бэкендам.

Персонализация панели управления

Веб-интерфейс можно адаптировать под нужды команды с помощью четырех браузерных тем: Ocean, Dungeon, Nether и Paper. Панель имеет адаптивную верстку для десктопов и экранов меньшего размера. Доступна настраиваемая система входа с именем пользователя и паролем, а также истекающие сессии. Опционально поддерживаются временные ссылки для автоматического входа. Можно настроить адрес прослушивания, порт и публичный URL браузера. Панель по умолчанию отключена. Перед включением необходимо настроить надежный пароль. Адрес прослушивания по умолчанию — 127.0.0.1, порт веб-интерфейса — 8760. При разрешении удаленного доступа рекомендуется использовать защищенную сеть или доверенный обратный прокси HTTPS.

Команды валюты из прокси

/BTP balance Steve Tokens
/BTP add Steve 100 Tokens
/BTP remove Steve 25 Tokens
/BTP set Steve 500 Tokens
/BTP add Steve 50 Gems -s

Управление реестром валют и администрирование

/BTP currencies
/BTP currency info Tokens
/BTP currency refresh
/BTP shopweb status
/BTP shopweb start
/BTP shopweb stop
/BTP debug on
/BTP debug status
/BTP debug off
/BTP reload

Больше, чем обновление балансов

ProxySync также соединяет функции сетевых магазинов, предоставляемые BeastTokens на бэкендах. Система ретранслирует обновления лимитов запасов для товаров, поддерживаемых MySQL, а также обновления вращающихся магазинов для общего состояния вращений в MySQL. С помощью веб-редактора магазина выбранного бэкенда можно доставлять YAML магазинов выбранным подключенным бэкендам. Модуль пересылает информацию об именах игроков/UUID и объявления о валютах бэкенда, а также делится адресами редакторов бэкендов с WebInterfaceProxy. Важно настроить каждую общую валюту на использование одной и той же базы данных MySQL и таблицы балансов на каждом участвующем бэкенде. Общие запасы и хранилище вращений настраиваются в настройках магазина бэкенда. ProxySync переносит уведомления об обновлениях, тогда как MySQL хранит общие данные.

Пример конфигурации сокета прокси

Options:
  ProxySync:
    Enabled: true
    Ip: "0.0.0.0"
    Port: 5026

Пример подключения бэкенда

Options:
  ProxySync:
    Enabled: true
    Server: ""
    Ip: "10.0.0.10"
    Port: 5026

Важные оговорки по установке и обновлению

Текущий модуль BeastTokensProxy для Velocity требует Java 25 или новее. Для работы требуется прокси BungeeCord или Velocity с соответствующим окружением Java. На каждом участвующем бэкенде должны быть установлены BeastTokens и BeastLib 1.7.0. Для валют, которые должны делиться одним сетевым кошельком, необходимо общее хранилище MySQL/MariaDB. Перед обновлением необходимо сделать резервную копию конфигураций плагинов и базы данных. Очень старые версии Bungee использовали plugins/BeastTokensBungee/bconfig.yml, настройки следует перенести в текущий plugins/BeastTokensProxy/config.yml. Если используются отдельные файловые кошельки, бэкенд-роутинг команд может работать с поддерживаемым кошельком выбранного бэкенда, но для разделения одного кошелька по серверам требуется общее хранилище. Отдельные базы данных File или SQLite остаются отдельными экономиками; используйте MySQL для общих балансов валют.

Поддержка сообщества

Если вам нужна помощь с подключением серверов, настройкой общих валют, открытием редакторов бэкенда или обновлением старой сети, обратитесь к официальной поддержке сообщества BeastTokens.