Ivy 🌿 (beta)

Ivy is a simple, lightweight, and fast 2FA management solution for Minecraft servers.

Download Ivy

You can download the latest version of Ivy from the Releases section.

Using Ivy

In order to use Ivy, you'll first need to create an Ivy Admin account. This account will be used to manage your servers, users, etc. Head over to Ivy's website to create an account.

Once you've created your account, you'll be at the Ivy Dashboard, where you can create your first server. When you've created your server, you'll be given an API key that you can put inside of /plugins/ivy/config.toml in order to use the plugin.

Adding users

In order to add users to your server, you'll need to go in game and execute the /ivy add [player] command. This will send the player a link to setup their 2FA. (You can also execute this command for yourself)

The setup process

Once a player has a link generated for them, they will be at a page that allows them to scan a QR code (or use their 2FA secret); just like any other platform supporting two-factor authentication. After they've added Ivy to their 2FA app, they'll be prompted to confirm their 2FA. Upon doing so, everything is complete and they can now exit the page.

Setting up restricted commands

In order to restrict commands to only be usable by users with 2FA enabled, you'll need to find the blockedCommands section within your Ivy config file. This section contains a list of commands that are blocked from being used by players who are not currently authorized.

Authorizing

When executing the restricted commands you've just setup, you will be prompted to execute /ivy authorize <2FA code>. Enter the 2FA code from your authenticator app and you'll be good to go!

License

Ivy is fully open sourced and licensed under the MPL 2.0 license.

Support

Ivy is worked on in free time, and is hosted completely out of pocket. If you like Ivy, consider dontaing on GitHub Sponsors!