MultiJoin
此仓库是 MultiJoin 的 Velocity 端配套插件。它本身并非 MultiJoin 服务。
MultiJoin 聚合了多个 Yggdrasil hasJoined 端点,维护 multijoin 配置文件的元数据,并暴露绑定 API。本仓库仅通过提供游戏内绑定和解绑命令,将 Velocity 连接到该服务。
功能说明
- 为玩家请求绑定令牌(bind token)。
- 允许玩家在游戏中进行绑定和解绑操作。
- 从玩家的
GameProfile 中读取 multijoin 数据,以便主服务能解析解绑目标。
- 使用 Velocity 权限来控制对这些命令的访问。
如果您想部署 MultiJoin 本身,请前往上方的 MultiJoin 仓库。仅安装此 jar 文件是不够的。
依赖 MultiJoin
在使用此插件之前,必须确保 MultiJoin 已经在运行且可从 Velocity 访问。
默认情况下,此插件连接至:
http://127.0.0.1:2268/bind
这意味着:
- 必须先启动 MultiJoin;
- 两端必须使用相同的绑定密钥;
- 如果 MultiJoin 运行在另一台机器上,请将
127.0.0.1 替换为实际的 host 地址。
安装
- 构建或下载此项目的 jar 文件。
- 将其放入 Velocity 的
plugins 目录。
- 启动一次 Velocity 以生成配置文件。
- 编辑插件数据目录中的
config.properties。
- 重启 Velocity。
默认配置:
api=http://127.0.0.1:2268/bind
key=
字段说明:
api:MultiJoin 暴露的绑定端点。
key:必须与 MultiJoin 的 config.toml 中配置的绑定密钥一致。
命令
/mj bind
/mj bind <token>
/mj unbind
/mj bind:向 MultiJoin 请求绑定令牌,并在聊天栏返回一个可点击复制到剪贴板的结果。
/mj bind <token>:将当前玩家绑定到该令牌所代表的配置文件。
/mj unbind:移除当前玩家现有的 MultiJoin 绑定。
权限
multijoin.bind
multijoin.unbind
要求与注意事项
- 这是一个 Velocity 插件,而非 Bukkit、Spigot 或 Paper 后端插件。
- 必须已配置并运行 MultiJoin,否则所有命令都会失败。
api 和 key 不能为空。
- 解绑依赖于玩家
GameProfile 中已存在的 multijoin 属性。
- 请求参数直接附加在 URL 之后,因此
api、key 和 token 应使用 URL 安全字符。
许可证
本项目采用 MIT License 许可。
MultiJoin
This repository is the Velocity-side companion plugin for MultiJoin. It is not the MultiJoin service itself.
MultiJoin aggregates multiple Yggdrasil hasJoined endpoints, maintains multijoin profile metadata, and exposes the binding API. This repository only connects Velocity to that service by providing in-game bind and unbind commands.
What This Repository Does
- Requests bind tokens for players.
- Lets players bind and unbind in game.
- Reads
multijoin data from the player's GameProfile so the main service can resolve unbind targets.
- Uses Velocity permissions to control access to those commands.
If you want to deploy MultiJoin itself, go to the MultiJoin repository above. Installing only this jar is not enough.
Dependency on MultiJoin
Before using this plugin, MultiJoin must already be running and reachable from Velocity.
By default, this plugin talks to:
http://127.0.0.1:2268/bind
That means:
- MultiJoin must be started first;
- both sides must use the same binding key;
- if MultiJoin runs on another machine, replace
127.0.0.1 with the real host address.
Installation
- Build or download the jar for this project.
- Put it into Velocity's
plugins directory.
- Start Velocity once to generate the config file.
- Edit
config.properties in the plugin data directory.
- Restart Velocity.
Default configuration:
api=http://127.0.0.1:2268/bind
key=
Fields:
api: the binding endpoint exposed by MultiJoin.
key: must match the binding key configured in MultiJoin's config.toml.
Commands
/mj bind
/mj bind <token>
/mj unbind
/mj bind: requests a bind token from MultiJoin and returns a clickable copy-to-clipboard result in chat.
/mj bind <token>: binds the current player to the profile represented by that token.
/mj unbind: removes the current player's existing MultiJoin binding.
Permissions
multijoin.bind
multijoin.unbind
Requirements and Caveats
- This is a Velocity plugin, not a Bukkit, Spigot, or Paper backend plugin.
- MultiJoin must already be configured and running, otherwise all commands will fail.
api and key must not be empty.
- Unbind depends on an existing
multijoin property in the player's GameProfile.
- Request parameters are appended directly to the URL, so
api, key, and token should use URL-safe characters.
License
This project is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧