AuthFlux - Minecraft Authentication Plugin
Secure. Reliable. Customizable.
Protect your server and enhance the player login experience.

What is AuthFlux?
AuthFlux is a powerful and secure authentication plugin for Minecraft servers (Bukkit, Spigot, or Paper). It provides a smooth registration and login system to protect your server from unauthorized access. With full support for MySQL and PostgreSQL, customizable messages, and player movement restrictions, AuthFlux is your all-in-one authentication solution.

️ Features

• Secure Authentication
  Players must register and log in with a password to join the server.
  
  
• Database Support
  Fully supports MySQL and PostgreSQL for scalable data storage.
  
  
• Password Management
  Customizable password length limits (default: 4–24 characters).
  
  
• Player Location Persistence
  Saves player location on logout and restores it upon successful login.
  
  
• Movement Restriction
  Prevents movement until players register or log in.
  
  
• Customizable Messages
  Modify all messages via messages.yml with full color code support (& syntax).
  
  
• Spawn Point Management
  Unauthenticated players are teleported to a configurable spawn point.
  
  
• ❄️ Freeze Mechanism
  Applies Jump and Slowness potion effects to unlogged players.
  
  
• Logging
  Keeps detailed logs of player login, registration, and teleportation actions.
  
  
• ⚙️ Easy Configuration
  Simple and readable config.yml with everything you need in one place.
  

Installation Guide

1. Place the Plugin
   
   • Put AuthFlux.jar into the /plugins folder.
     
2. Start the Server
   
   • Let the plugin generate default config.yml and messages.yml in /plugins/AuthFlux.
     
3. Configure the Database
   
   • Open config.yml and update the following:
     
     database:
     type: "postgresql" (or "mysql")
     host: "localhost"
     port: 5432
     name: "authflux"
     username: "postgres"
     password: "password"
     
4. Set Spawn Point
   
   • Define where unauthenticated players spawn:
     
     spawn-point:
     world: "world"
     x: 0.0
     y: 64.0
     z: 0.0
     yaw: 0.0
     pitch: 0.0
     
5. Customize Messages (Optional)
   
   • Edit messages.yml to set your own registration/login messages. Supports color codes like &c, &a, etc.
     
6. Restart Server
   
   • Restart your server to load the plugin and auto-create the necessary database tables.
     
7. Test
   
   • Join as a player and try:
     
     • /reg your_password — to register.
       
       
     • /log your_password — to log in.
       

Commands
Command Description
/reg [password] Register a new account
/log [password] Log into an existing account
Permissions
AuthFlux doesn’t require permission nodes. All players can use /reg and /log. Admins can configure the plugin via server access.

⚙️ Dependencies

• Java: 8 or higher
  
  
• Minecraft Server: Bukkit, Spigot, or Paper (1.13+)
  
  
• Database: MySQL or PostgreSQL

Configuration Files

• config.yml — Configure spawn, password rules, database settings.
  
  
• messages.yml — Fully customize in-game messages.
  

‍ Author
Created with ❤️ by Alexander Yermolenko.