Skip to content

Setup a Server on Linux

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

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

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

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

Terminal window
java -Xmx4G -Xms2G -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector -jar paper.jar nogui
Terminal window
java -Xmx4G -Xms2G -javaagent:/opt/authlib-injector/authlib-injector.jar=https://authserver.visoftware.dev/authlib-injector -jar fabric-server-launch.jar nogui
  • -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.

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

  1. Create a new script file:

    Terminal window
    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:

    Terminal window
    chmod +x start-minecraft.sh
  5. Start your server using:

    Terminal window
    ./start-minecraft.sh

5. Verify the Server is Using authlib-injector

Section titled “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

Section titled “Done! Your Minecraft server is now using authlib-injector to authenticate via VI Software’s Auth Server”