💻Setup a server on Linux

1. Download authlib-injector

Download the latest version from the official github repo: 👉 https://github.com/yushijinhun/authlib-injector/releases

2. Place the JAR File

Move the downloaded authlib-injector JAR file to a dedicated directory. For example, store it in /opt/authlib-injector/:

mkdir -p /opt/authlib-injector
mv authlib-injector.jar /opt/authlib-injector/

3. Modify the Server Startup Command

To use authlib-injector, modify the startup command for your Minecraft server.

Example Command for Paper/Spigot/Purpur:

java -Xmx4G -Xms2G -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector -jar paper.jar nogui

Example Command for Forge/Fabric:

java -Xmx4G -Xms2G -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector -jar fabric-server-launch.jar nogui

Explanation:

• -Xmx4G: Sets the maximum memory allocation (adjust as needed).

• -Xms2G: Sets the minimum memory allocation (adjust as needed).

• -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector: Loads the authlib-injector as a Java agent and redirects authentication requests.

• -jar paper.jar: Starts the Minecraft server (replace with your actual server JAR file).

• nogui: Runs the server without the graphical user interface.

---

4. Automate the Startup (Optional)

To automate the startup process, you can create a startup script:

1. Create a new script file:

   nano start-minecraft.sh

2. Add the following content:

   #!/bin/bash
   java -Xmx4G -Xms2G -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector -jar paper.jar nogui

3. Save the file (CTRL + X, then Y, then Enter).

4. Give it execute permissions:

   chmod +x start-minecraft.sh

5. Start your server using:

   ./start-minecraft.sh

---

5. Verify the Server is Using authlib-injector

Check the server logs (authlib-injector.log or console output) for messages related to authlib-injector. If it's working correctly, you should see output confirming that the authentication system is redirected.

---

✅ Done! Your Minecraft server is now using authlib-injector to authenticate via VI Software's Auth Server