MultiJoinPlugin

# MultiJoin This repository is the Velocity-side companion plugin for (https://github.com/Dainsleif233/MultiJoin). It is not the MultiJoin service itself. (https://github.com/Dainsleif233/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: ```properties 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 1. Build or download the jar for this project. 2. Put it into Velocity's `plugins` directory. 3. Start Velocity once to generate the config file. 4. Edit `config.properties` in the plugin data directory. 5. Restart Velocity. Default configuration: ```properties 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 ```text /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 ```text 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 (LICENSE).