Skip to main content
Of course, here is the documentation translated into English.

Authentication Plugin Installation Guide (Offline Mode)

When a Minecraft server is set to offline-mode=true, it does not verify player accounts with Mojang’s servers. This allows players who do not own a premium Minecraft account to join. However, this also creates a major security risk: anyone can log in using any username, including an admin’s or operator’s account. To mitigate this, you must use an authentication plugin. This plugin forces every player to register with a password on their first join and log in with that password every time they return. This document will cover two popular plugins: nLogin and LibreLogin.

General Plugin Installation Steps

The installation process is the same for both plugins. Follow the steps below:
  1. Download the Plugin:
  2. Log in to the Control Panel:
  3. Select Your Server:
    • From the server list, click on the server where you want to install the plugin.
  4. Access the File Manager:
    • In the server’s navigation menu, select the Files menu.
  5. Open the Plugins Folder:
    • Find and enter the plugins folder. This is where all server plugins are stored.
  6. Upload the Plugin:
    • Click the Upload button and select the plugin’s .jar file that you just downloaded. Wait for the upload to complete.
  7. Restart the Server:
    • Return to the Console page and click the Restart button. This will load the new plugin and create its configuration folder.
After the server is back online, the authentication plugin is active. Now, let’s discuss the details and setup for each plugin.

1. nLogin

nLogin is a very popular, stable, and feature-rich authentication plugin. It has been used by thousands of servers and is proven to be reliable.

Explanation

nLogin provides a robust /register <password> <confirmPassword> and /login <password> system. The plugin focuses on security with many additional features to protect your server from bots and account theft.

Advantages and Disadvantages

How to Set Up nLogin

After you restart the server, a folder named nLogin will appear inside the plugins folder.
  1. Open the plugins/nLogin folder.
  2. The main file to edit is config.yml. Open this file.
  3. Some important settings you can change:
    • Changing Messages: Open the messages.yml file to translate or change all messages sent by the plugin to players.
    • Password Requirements: YAML
    • Enabling Login Sessions: To prevent players from needing to log in every time. YAML
  4. After you finish editing, save the config.yml file and type nlogin reload in the server console or restart the server to apply the changes.

2. LibreLogin

LibreLogin is a more modern, lightweight, and simpler alternative to nLogin. It’s designed to be easy to use without sacrificing essential security features.

Explanation

Just like nLogin, LibreLogin provides a registration and login system. Its main focus is on performance, ease of use, and a modern design, both in its code and configuration.

Advantages and Disadvantages

How to Set Up LibreLogin

After restarting the server, a LibreLogin folder will appear in the plugins folder.
  1. Open the plugins/LibreLogin folder.
  2. Edit the config.yml file. Most default settings are good enough, but you might want to change a few things.
  3. Some important settings:
    • Changing Messages: Just like nLogin, all messages are in the messages.yml file. You can translate them as needed.
    • Session Duration: YAML
    • Password Security: YAML
    • Registration Limit per IP: To prevent bots. YAML
  4. Save your changes to config.yml. In-game, you can use the command /librelogin reload (requires OP privileges) or simply restart the server.

Conclusion: Which One Should You Choose?

  • Choose nLogin if you need comprehensive security features, deep customization, and don’t mind a slightly more complex configuration.
  • Choose LibreLogin if you want a lightweight, fast, modern, and easy-to-setup plugin for a small to medium-sized server.