Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Simple storage passwords are saved in an easy-to-read userdata.yml with no database needed
π UNKNOWN Login System
A lightweight, cross-version player authentication plugin for Minecraft servers. Players register once, then log in each time they join, and anyone who hasn't logged in can't do anything on your server. π‘οΈ
β¨ Features
- π Register & Login: simple password-based accounts
- π Change Password: players can update their own password at any time
- π§ Secure storage: passwords are never saved as plain text; they're salted and hashed (SHA-256)
- π§ Player freeze: unauthenticated players can't move
- π¬ Chat blocked: no chatting until logged in
- β¨οΈ Commands blocked: only the login commands work before authentication
- β Failed attempt limit: players are kicked after too many wrong passwords (default: 5)
- β±οΈ Optional login timeout: kick players who don't log in within X seconds
- π Optional IP lock: kick players whose IP changes between sessions
- π¨ Fully customizable messages: every message supports
&color codes - π€ Bypass permission: let trusted accounts or bots skip authentication
- π¦ Lightweight: no dependencies, no database; data is stored in a simple
userdata.yml
π» Commands
| Command | Description |
|---|---|
/unknownregister <password> <confirm-password> |
π Create your account |
/unknownlogin <password> |
π Log in to your account |
/unknownchangepassword <old-password> <new-password> |
π Change your password |
/unknownadmin unregister <player> |
ποΈ Remove a player's account (admin) |
/unknownadmin reload |
β»οΈ Reload the config (admin) |
π Permissions
| Permission | Description | Default |
|---|---|---|
unknown.login.admin |
Access to admin commands | OP |
unknown.login.bypass |
Skip authentication on join | Nobody |
βοΈ Configuration
settings:
auth-timeout-seconds: 0 # 0 = no timeout
min-password-length: 6
max-failed-attempts: 5
ip-lock: false # kick if IP changes between sessions
All messages live in config.yml under messages: and use {player}, {remaining} and {min} placeholders. π¨
π₯ Installation
- β¬οΈ Download the latest
.jar - π Drop it into your server's
plugins/folder - π Restart the server
- βοΈ Edit
plugins/UNKNOWNLoginSystem/config.ymlto your liking - π Done! Players can now
/unknownregister
β Compatibility
- π’ Spigot, Paper, Purpur and other Bukkit-based servers
- β Built for Java 8+ and the Bukkit API, so it works across a wide range of Minecraft versions
- β»οΈ Automatically migrates data from older
FlarioLoginSysteminstalls
π£ Support & Feedback
Found a bug or have a suggestion? ππ‘ Open an issue or leave a comment, and thanks for using UNKNOWN Login System! π
Made with β€οΈ by UNKNOWN
Platforms
Paper
1.13β26.3