MineAuth: Secure Authentication for Offline Minecraft Servers

What Is MineAuth and Why Your Offline Minecraft Server Needs It Running a Minecraft server in offline mode opens the door to creativity without premium account restrictions, but it also invites a serious problem: anyone can join with any username. Without Mojang’s authentication servers, there is...

Download MineAuth for Minecraft 1.21.4, 1.20.6

Original name: MineAuth

Minecraft: 1.20.6, 1.21.4

FileVersionLoaderSize
MineAuth-1.0.1.jar1.20.6—4.2 МБDownload
MineAuth-1.0.2.jar1.20.6—4.2 МБDownload
MineAuth-1.0.3.jar1.20.6—26 КБDownload
MineAuth-1.0.4.jar1.20.6—4.2 МБDownload
MineAuth-1.0.5.jar1.20.6—4.2 МБDownload
MineAuth-1.0.0.jar1.21.4—4.2 МБDownload

What Is MineAuth and Why Your Offline Minecraft Server Needs It

Running a Minecraft server in offline mode opens the door to creativity without premium account restrictions, but it also invites a serious problem: anyone can join with any username. Without Mojang’s authentication servers, there is nothing stopping a player from impersonating an admin, stealing another player’s identity, or griefing without consequences. MineAuth steps in as a lightweight, reliable authentication plugin for Bukkit, Spigot, and Paper servers, giving you full control over who accesses your world. It turns an insecure offline server into a gated community where every player must prove who they are before they can interact with blocks, execute commands, or even chat.

Core Features That Keep Your Server Safe

MineAuth does not try to be everything at once. It focuses on one job—authentication—and does it with speed and clarity. The plugin introduces a familiar login and registration flow that players will recognize from premium servers, but it runs entirely on your own infrastructure. Here is what you get right out of the box:

  • Login and Registration System – Players use /register <password> to create an account and /login <password> to access it. Aliases like /reg and /l keep things snappy.
  • Command Blocking for Unauthenticated Players – Until a player logs in, every command is locked down. This prevents exploits that rely on executing instructions before identity is verified.
  • Session System – Once logged in, players stay authenticated across reconnects until they explicitly log out. No need to re-enter passwords every time the server restarts.
  • Auto-Kick for Time-Wasters – If someone joins and ignores the authentication prompt, MineAuth kicks them after a configurable timeout. No idle impostors lingering in the player list.
  • MySQL Database Support – All account data can be stored in MySQL 5.7+ or MariaDB, making it easy to sync authentication across multiple servers or back up user credentials.
  • Configurable Messages and Settings – Every chat message, timeout value, and database parameter lives in a clean config.yml file.
  • Fast and Lightweight – Designed to run even on modest hardware, MineAuth adds negligible overhead so your server’s TPS stays healthy.

Commands That Give You Full Control

Simplicity in commands means less confusion for players and less support work for admins. MineAuth ships with a handful of essential commands that cover the entire authentication lifecycle. Players can register, log in, and change their password without ever leaving the game. Server operators get a reload command to apply configuration changes on the fly.

  • /register <password> – Creates a new account. The password is hashed before storage, so even with database access, raw passwords are never exposed.
  • /login <password> – Authenticates an existing account and grants full access to the server.
  • /changepassword <old> <new> – Lets players update their credentials securely.
  • /mineauth reload – Reloads the plugin configuration without restarting the server. Restricted to operators.

Aliases like /reg and /l are built in, so players can type less and get into the action faster. The plugin also blocks all other commands until authentication succeeds, which means even creative attempts to bypass the system are shut down early.

How MineAuth Handles Sessions and Timeouts

One of the most annoying parts of authentication plugins is being kicked for inactivity or having to log in again after a quick disconnect. MineAuth solves this with a persistent session system. Once a player authenticates, their session remains valid until they manually log out or an admin clears it. This is especially useful for servers that experience occasional restarts or network hiccups. The auto-kick feature only targets players who join and then refuse to register or log in within the set time limit. You can adjust that timeout in the configuration file to match your community’s patience level.

When setting up a modded server, getting all the pieces to work together can be a challenge. Many server owners find that a modern launcher streamlines the process dramatically. For instance, this mod can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, which means you spend less time fiddling with files and more time building your world.

Database Setup and Configuration Deep Dive

MineAuth stores player credentials in a MySQL or MariaDB database, keeping everything organized and portable. When the plugin starts for the first time, it automatically creates the required tables, so you do not need to run any SQL scripts manually. The config.yml file inside /plugins/MineAuth/ holds all the connection details: host, port, database name, username, and password. Here is what you can configure:

  • MySQL Connection Settings – Point MineAuth to your existing database server or set up a fresh one just for authentication.
  • Authentication Timeout – Define how many seconds a player has to log in before being kicked.
  • Session Settings – Control how long a session remains valid and whether IP changes invalidate it.
  • Custom Messages – Reword every plugin message to match your server’s tone, from the welcome text to the kick reason.

Because the plugin uses standard SQL, you can easily integrate it with web panels, forums, or custom tools that need to check a player’s registration status. Just keep in mind that the localization is still a work in progress. If you spot a mistake in the plugin’s language files, reaching out to the developer helps improve the experience for everyone.

Compatibility and Tested Environments

MineAuth is built for the modern Minecraft server ecosystem. It has been tested on Paper 1.21.x, Spigot 1.21.x, and CraftBukkit 1.21.x, so you can drop it into almost any standard server setup without worrying about version conflicts. The plugin avoids niche APIs and sticks to stable Bukkit methods, which means it plays nicely with other essentials like world protection, economy, and chat managers. Whether you are running a small survival world for friends or a large network with multiple game modes, MineAuth adds a security layer that does not interfere with your other tools.

Why Lightweight Authentication Matters for Small Servers

Many server owners start small, hosting on a shared machine or a low-cost VPS. Heavy plugins with bloated feature lists can drag down performance and complicate troubleshooting. MineAuth’s focus on doing one thing well means it uses minimal RAM and CPU. There are no GUI menus, no unnecessary listeners, and no background tasks that pile up over time. For a server with ten players or a hundred, the authentication check happens once per session and then stays out of the way. This efficiency is especially important for modded servers where every tick of processing power counts.

Getting Started with MineAuth

Installing MineAuth follows the same straightforward pattern as any Bukkit plugin. Download the JAR file, place it in your server’s /plugins folder, and restart or reload the server. The plugin will generate the default config.yml immediately. Edit that file to enter your MySQL credentials if you want database storage, or leave it as is to use the built-in SQLite fallback for quick testing. Set up your messages, adjust the timeout, and you are ready to welcome players. When someone joins, they will be greeted with clear instructions to register or log in. From that moment on, your offline server has a robust identity layer that keeps impersonation and unauthorized access at bay.

Final Thoughts on Securing Your Minecraft World

An offline server does not have to mean an insecure server. MineAuth bridges the gap between open access and player accountability, giving you the freedom to invite anyone while still protecting your community. The plugin’s session handling, command blocking, and database support create a seamless experience that players will barely notice once they are logged in. Its lightweight design respects your server’s resources, and the straightforward configuration means you spend less time reading documentation and more time playing. If you run a Bukkit, Spigot, or Paper server without online mode, adding MineAuth is one of the smartest moves you can make to keep griefers out and trusted players in control.