bingus-auth

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.