bingus-auth

A simple, lightweight authentication mod for Minecraft 26.1 Fabric servers.

Features

• Password authentication for Java players (Argon2 hashing)
• Teleports unauthenticated players to a configurable spawn point to hide their real coordinates (as of 1.0.0 you need to edit the source)
• Blocks all packets (movement, chat, interactions) until authenticated
• Per-session state, logging out deauthenticates the player

Commands

Command	Description
/register <password>	Register a new account
/login <password>	Login to your account
/l <password>	Alias for /login
/deletepassword <username>	(Admin) Delete a player's password and kick them

Requirements

• Minecraft 26.1
• Fabric Loader 0.18.5+
• Fabric API
• Fabric Language Kotlin
• Java 25

Installation

Drop the jar into your server's mods/ folder. No configuration file needed. Spawn coordinates default to 0, 400, 0 in the overworld and can be changed in AuthConfig.kt before building.

Data

Player passwords are stored in config/bingus-auth/data.json as Argon2 hashes. Do not edit this file manually!

Floodgate / Geyser

Bedrock players are detected by their UUID (Floodgate assigns UUIDs with mostSignificantBits == 0). They are automatically authenticated without needing a password.

Notes

• This mod is purpose-built for one server and is still in beta
• No config file UI, change settings by editing the source and rebuilding as of now

Contributing

This is a open sourced project under the MIT license. located here.