Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for yykk7157

Simple storage passwords are saved in an easy-to-read userdata.yml with no database needed

Report UNKNOWN-login-system?

R

1.21.11

πŸ” 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

  1. ⬇️ Download the latest .jar
  2. πŸ“‚ Drop it into your server's plugins/ folder
  3. πŸ”„ Restart the server
  4. βš™οΈ Edit plugins/UNKNOWNLoginSystem/config.yml to your liking
  5. πŸŽ‰ 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 FlarioLoginSystem installs

πŸ“£ 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

Information

Published
November 8, 2026
Author
1Downloads

Platforms

Paper
Paper
1.13–26.3