BeastTokensProxy
网络货币同步、代理命令与 Web 控制面板
当前版本:4.3.13
将你的 Minecraft 网络中的 BeastTokens 经济体系连接起来。
当玩家在不同服务器间移动时,保持共享货币的连接;从代理控制台管理钱包,并通过一个网络仪表盘打开后端的 Web 编辑器。
BUNGEECORD & VELOCITY • WEB 仪表盘 • 多货币支持 • 代理同步
一个网络,互联的经济体系
运行生存服、空岛服、监狱服或活动服?BeastTokensProxy 是 BeastTokens 的网络伴侣插件。将其安装在 BungeeCord 或 Velocity 上,即可通过 ProxySync 连接参与的后台服务器。
- 在连接的服务器之间发送特定于货币的余额刷新。
- 支持 Tokens、Gems、季节点数以及你自定义的货币 ID。
- 从代理控制台查看、添加、移除或设置余额。
- 转发 MySQL 商店库存和轮换商店缓存的更新。
- 发现后端 Web 编辑器,并从统一仪表盘中打开它们。
- 浏览已注册的 MySQL 经济体系,并在浏览器中设置或重置单个玩家的余额。
- 自动接收来自已连接 BeastTokens 服务器的货币公告。
你的网络 Web 仪表盘
启用可选的 WebInterfaceProxy,为你的管理团队提供网络的统一入口点。
后端服务器目录
- 以服务器卡片的形式查看已公告的 BeastTokens Web 编辑器。
- 查看每个条目的服务器名称、编辑器地址、最后在线时间以及在线/过期状态。
- 在仪表盘内或新浏览器标签页中打开后端编辑器。
- 在代理重启之间保留已保存的服务器条目,并移除不再需要的条目。
- 使用后端的“返回代理”控制按钮回到网络中心。
在线/过期状态反映自后端最近的公告。每个后端都提供其自己的运行中 Web 编辑器和登录界面。Shop Studio、商店、掉落物、备份以及其他管理工具仍可通过该编辑器访问。
MySQL 经济管理
- 从经济列表中选择已启用且已注册的货币。
- 按名称或 UUID 搜索玩家记录。
- 按最大余额、最小余额、玩家名称或最后在线时间排序。
- 显示玩家头像、UUID 和精确的小数余额。
- 选择每次请求显示的记录数量,最多 500 条。
- 设置单个玩家的余额或将其重置为零。
- 在编辑后向已连接的后端发送匹配的货币刷新请求。
此页面读取并编辑代理配置数据库中已注册的 MySQL 余额表。对于使用其他存储提供商的货币,请打开其后端编辑器或使用经后端路由的代理命令。
个性化仪表盘
- 四种浏览器主题:Ocean(海洋)、Dungeon(地牢)、Nether(下界)和 Paper(纸张)。
- 适用于桌面和小屏幕设备的响应式布局。
- 可配置的用户名/密码登录和过期会话。
- 可选的临时自动登录链接。
- 可配置的监听地址、端口和公共浏览器 URL。
面板默认处于禁用状态。启用前请配置强密码;默认监听地址为 127.0.0.1,默认 Web 端口为 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
- 包含货币 ID 以选择钱包,或省略它以使用所选后端的默认货币。
- 目标可以是在线玩家、已知离线玩家名称或 UUID。
- 添加 -s 以抑制在线接收者的余额变更通知。
- 请求将通过已连接的 BeastTokens 后端运行;在线目标在其连接到 ProxySync 时使用其当前的后端。
- 所选后端应用其货币管理器和存储规则。
需要可用的后端连接。分发的余额变更请求会报告已发送;余额查询则返回后端的响应。
货币注册与管理
/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
货币公告会将 ID、显示名称、类型、表名和源服务器填充到 Currencies.yml 中。注册表存储在 config.yml 之外。还提供手动货币注册/移除命令;它们用于管理代理注册表。
代理工作人员需要以下权限之一:
BeastTokens.Admin
BeastTokens.admin
BeastTokens.Proxy.Admin
超越余额刷新
ProxySync 还连接了你在后端由 BeastTokens 提供的网络商店功能。
- 转发基于 MySQL 的商店库存的库存限制刷新。
- 转发共享 MySQL 轮换状态的轮换商店刷新。
- 使用后端的 Web 编辑器的商店同步控件,将商店 YAML 交付给选定的已连接后端。
- 转发玩家名称/UUID 信息和后端货币公告。
- 与 WebInterfaceProxy 共享后端编辑器地址。
配置每个共享货币在每个参与的后端上使用相同的 MySQL 数据库和余额表。在后端商店设置中配置共享库存和轮换存储。ProxySync 承载更新通知;MySQL 持有共享数据。
要求与安装
- 一个 BungeeCord 或 Velocity 代理服务器,并配备该代理构建所需的 Java 运行时环境。当前的 BeastTokensProxy Velocity 模块需要 Java 25 或更高版本。
- 在每个参与的后端服务器上安装 BeastTokens 和 BeastLib 1.7.0。
- 对于希望共享单一网络钱包的货币,使用共享的 MySQL/MariaDB 存储。
- 在代理与参与的后端服务器之间建立可达的 ProxySync 连接。
- 将对应版本的 BeastTokensProxy JAR 文件放入代理服务器的
plugins 文件夹中,然后启动代理以生成其配置文件。
- 打开 BungeeCord 的 plugins/BeastTokensProxy/config.yml,或 Velocity 的 plugins/beasttokensvelocity/config.yml。
- 启用 ProxySync 并设置其监听地址和端口。默认端口为 5026。
- 配置后端共享货币以使用 MySQL,并确保数据库/表设置匹配。
- 在每个后端的 plugins/BeastTokens/config.yml 中启用 ProxySync,并将其指向代理可达的地址以及相同的 Socket 端口。
- 重启更新后的服务器,然后检查
/BTP currencies 和 /BTP debug status。
- 配置 WebInterfaceProxy 的登录设置,并在需要浏览器仪表盘时通过
/BTP shopweb start 启动它。
代理 Socket 示例
Options:
ProxySync:
Enabled: true
Ip: "0.0.0.0"
Port: 5026
后端连接示例
Options:
ProxySync:
Enabled: true
Server: ""
Ip: "10.0.0.10"
Port: 5026
将 10.0.0.10 替换为你代理服务器的可达地址。仅当代理和后端处于同一网络环境时才使用 127.0.0.1。将这些字段合并到现有配置中。若基于地址识别后端,请保持 Server 为空;或者将其设置为代理服务器配置中的确切服务器名称。
代理是否需要自己的 MySQL 登录凭据?
ProxySync 中继和后端路由的命令可以在代理上设置 Options.MySQL.Enabled: false 的情况下运行。当使用浏览器经济管理器时,请启用并配置代理的 MySQL 连接。请将示例凭据(如 DataName 和 UserName)替换为真实的连接设置。Host 必须可从代理访问。
升级现有网络
- 在更新之前备份插件配置和数据库,并在整个网络中使用匹配的 BeastTokens/BeastTokensProxy 版本。
- 非常旧的 Bungee 版本使用 plugins/BeastTokensBungee/bconfig.yml。请将你的设置转移到当前的 plugins/BeastTokensProxy/config.yml 中,包括 MySQL 凭据和 ProxySync 端口。
- 当前配置使用 Options.ProxySync。当手动迁移旧的 Options.BungeeSync 部分时,请使用当前的 ProxySync 名称。
- 在进行传统迁移之前,停止共享货币数据库的旧后端服务器。旧插件可以在迁移后重新创建原始的单一货币表。
- 在更改存储的货币数据之前,使用后端的 legacy-migration 预览功能。保留已验证的迁移存档作为备份。
我可以将它与独立的基于文件的钱包一起使用吗?
后端路由的命令可以在所选后端支持的钱包上操作,但要在服务器之间共享一个钱包,则需要共享存储。独立的 File 或 SQLite 数据库仍保持为独立的经济系统。请使用 MySQL 来共享货币余额。
社区与支持
需要帮助连接服务器、配置共享货币、打开后端编辑器或升级旧网络吗?
BeastTokensProxy
Network Currency Sync, Proxy Commands & Web Control
Current Release: 4.3.13
Connect your BeastTokens economies across your Minecraft network.
Keep shared currencies connected as players move between servers, manage wallets from the proxy console, and open your backend web editors from one network dashboard.
BUNGEECORD & VELOCITY • WEB DASHBOARD • MULTI-CURRENCY • PROXY SYNC
One Network, Connected Economies
Running Survival, SkyBlock, Prison, or an event server? BeastTokensProxy is the network companion for BeastTokens. Install it on BungeeCord or Velocity to connect participating backend servers through ProxySync.
- Send currency-specific balance refreshes between connected servers.
- Support Tokens, Gems, seasonal points, and your own currency IDs.
- Check, add, remove, or set balances from the proxy console.
- Relay MySQL shop stock and rotating-shop cache updates.
- Discover backend web editors and open them from one dashboard.
- Browse registered MySQL economies and set or reset individual player balances in your browser.
- Receive currency announcements automatically from connected BeastTokens servers.
Your Network Web Dashboard
Enable the optional WebInterfaceProxy to give your administration team one starting point for the network.
Backend Server Directory
- View announced BeastTokens web editors as server cards.
- See each entry's server name, editor address, last-seen time, and Online/Stale status.
- Open a backend editor inside the dashboard or in a new browser tab.
- Keep saved server entries across proxy restarts and remove entries you no longer need.
- Use the backend editor's Back To Proxy control to return to the network hub.
Online/Stale reflects recent announcements from the backend. Each backend supplies its own running web editor and login. Its Shop Studio, shops, drops, backups, and other administration tools remain available through that editor.
MySQL Economy Manager
- Select an enabled, registered currency from the economy list.
- Search player records by name or UUID.
- Sort by largest balance, smallest balance, player name, or last-seen time.
- Display player heads, UUIDs, and exact decimal balances.
- Choose how many records to display, up to 500 per request.
- Set an individual player's balance or reset it to zero.
- Send the matching currency refresh to connected backends after an edit.
This page reads and edits registered MySQL balance tables in the proxy's configured database. For a currency using another storage provider, open its backend editor or use a backend-routed proxy command.
Make The Dashboard Your Own
- Four browser themes: Ocean, Dungeon, Nether, and Paper.
- Responsive layout for desktop and smaller screens.
- Configurable username/password login and expiring sessions.
- Optional temporary auto-login links.
- Configurable listen address, port, and public browser URL.
The panel starts disabled. Configure a strong password before enabling it; the default listen address is 127.0.0.1 and the default web port is 8760. When allowing remote access, use a protected network or a trusted HTTPS reverse proxy.
Currency Commands From The Proxy
Give staff a consistent command entry point, even when players are on different backend servers.
/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
- Include a currency ID to choose a wallet, or omit it to use the selected backend's default currency.
- Target an online player, a known offline player name, or a UUID.
- Add -s to suppress the online recipient's balance-change notification.
- Requests run through a connected BeastTokens backend; online targets use their current backend when it is connected to ProxySync.
- The selected backend applies its currency manager and storage rules.
An available backend connection is required. A dispatched balance-change request reports that it was sent; balance queries return the backend's response.
Currency Registry & Administration
/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
Currency announcements populate Currencies.yml with IDs, display names, types, table names, and source servers. The registry is stored separately from config.yml. Manual currency register/remove commands are also available; they manage the proxy registry.
Proxy staff need one of these permissions:
BeastTokens.Admin
BeastTokens.admin
BeastTokens.Proxy.Admin
More Than Balance Refreshes
ProxySync also connects network shop features provided by BeastTokens on your backends.
- Relay stock-limit refreshes for MySQL-backed shop stock.
- Relay rotating-shop refreshes for shared MySQL rotation state.
- Deliver shop YAML to selected connected backends using the backend web editor's shop synchronization controls.
- Forward player-name/UUID information and backend currency announcements.
- Share backend editor addresses with WebInterfaceProxy.
Configure each shared currency to use the same MySQL database and balance table on every participating backend. Configure shared stock and rotation storage in the backend shop settings. ProxySync carries update notifications; MySQL holds the shared data.
Requirements & Installation
- A BungeeCord or Velocity proxy, with the Java runtime required by that proxy build. The current BeastTokensProxy Velocity module requires Java 25 or newer.
- BeastTokens and BeastLib 1.7.0 on each participating backend.
- Shared MySQL/MariaDB storage for currencies that should share one network wallet.
- A reachable ProxySync connection between the proxy and participating backends.
- Install the matching BeastTokensProxy JAR in your proxy's plugins folder, then start the proxy to generate its configuration.
- Open plugins/BeastTokensProxy/config.yml on BungeeCord, or plugins/beasttokensvelocity/config.yml on Velocity.
- Enable ProxySync and choose its listen address and port. The default port is 5026.
- Configure your shared backend currencies to use MySQL with matching database/table settings.
- Enable ProxySync in each backend's plugins/BeastTokens/config.yml and point it at the proxy's reachable address and the same socket port.
- Restart the updated servers, then check /BTP currencies and /BTP debug status.
- Configure WebInterfaceProxy login settings and start it with /BTP shopweb start when you want the browser dashboard.
Proxy Socket Example
Options:
ProxySync:
Enabled: true
Ip: "0.0.0.0"
Port: 5026
Backend Connection Example
Options:
ProxySync:
Enabled: true
Server: ""
Ip: "10.0.0.10"
Port: 5026
Replace 10.0.0.10 with your proxy's reachable address. Use 127.0.0.1 only when the proxy and backend share the same network environment. Merge these fields into the existing configuration. Leave Server blank for address-based backend identification, or set its exact name from your proxy's server configuration.
Does The Proxy Need Its Own MySQL Login?
The ProxySync relay and backend-routed commands can run with Options.MySQL.Enabled: false on the proxy. Enable and configure the proxy's MySQL connection when using the browser Economy Manager. Replace example credentials such as DataName and UserName with real connection settings. The Host must be reachable from the proxy.
Upgrading An Existing Network
- Back up the plugin configurations and database before updating, and use matching BeastTokens/BeastTokensProxy releases across the network.
- Very old Bungee versions used plugins/BeastTokensBungee/bconfig.yml. Transfer your settings into the current plugins/BeastTokensProxy/config.yml, including MySQL credentials and the ProxySync port.
- Current configuration uses Options.ProxySync. When transferring an old Options.BungeeSync section manually, use the current ProxySync names.
- Stop older backends sharing the currency database before legacy migration. An old plugin can recreate the original single-currency tables after migration.
- Use the backend legacy-migration preview before changing stored currency data. Keep verified migration archives as backups.
Can I Use It With Separate File-Based Wallets?
Backend-routed commands can operate on the selected backend's supported wallet, but sharing one wallet across servers requires shared storage. Separate File or SQLite databases remain separate economies. Use MySQL for shared currency balances.
Community & Support
Need help connecting servers, configuring shared currencies, opening backend editors, or upgrading an older network?
评论 0
登录后参与评分
还没有评论,来抢沙发吧