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.