🔐 SimpleAuth 🔐

Minimal Authentication System for Paper 1.21+

Basic login/register system designed for small servers

✨ Features

🚪 Simple Authentication

Registration: Players register on first join with /register <password> <repeat>
Login: Required on every join - no IP sessions
Password Management: Change password with /changepassword
Plain Text Storage: YAML-based data storage for simplicity

🎯 Player Restrictions (Pre-Auth)

Frozen Movement: Players cannot move until authenticated
Blindness Effect: Cannot see while unauthenticated
Blocked Interactions: No blocks, entities, items, or commands
Chat Disabled: Cannot write in chat
Applies to All: Even OPs must authenticate

⏱️ Auto-Kick System

Configurable Delay: Set timeout in seconds
Enable/Disable: Toggle auto-kick on/off
Custom Message: Personalize the kick message
Default: 60 seconds before removal

💬 Smart Reminders

Periodic Messages: Regular chat reminders
Context-Aware: Different messages for registered vs unregistered
Customizable Interval: Set reminder frequency in config
Auto-Cancel: Stops after successful authentication

👑 Admin Features

One-Time Bypass: /sa onetimeforce <player> for special cases
Permission System: simpleauth.admin permission
OP Enforcement: OPs are NOT exempt from authentication
Help Command: /sa help for documentation

⚙️ Fully Configurable

All Messages: Every message customizable with color codes
Password Rules:
- Minimum/maximum length
- Forbidden password list
- Custom validation
Command Control: Enable/disable specific commands
Whitelist: Players who bypass authentication
Color Codes: Full support for & color formatting

📦 Installation

Download the latest SimpleAuth.jar
Place in your server's plugins/ folder
Start your server (generates default config)
(Optional) Customize plugins/SimpleAuth/config.yml
Restart or use /reload confirm

🎮 Usage

Player Commands

/register <password> <repeat_password>
  └─ Create your account (first join)

/login <password>
  └─ Authenticate (every subsequent join)

/changepassword <old_password> <new_password> <repeat>
  └─ Change your password when logged in

Admin Commands

/sa onetimeforce <player_name>
  └─ Allow a player to join once without authentication
  └─ Requires: simpleauth.admin permission

/sa help
  └─ Show admin help menu

Tab Completion

✅ Full tab completion on all commands

⚠️ Important Notice

This plugin stores passwords in PLAIN TEXT by design. It intentionally does NOT encrypt or hash passwords. This is for simplicity only and is suitable for:

✅ Private servers with trusted friends

✅ Development and testing

✅ Small community servers with trusted admins

❌ The plugin creator is not responsible for any data leaks

🔒 How It Works

Data Storage

Passwords stored in plugins/SimpleAuth/passwords.yml:

550e8400-e29b-41d4-a716-446655440000:
  uuid: "550e8400-e29b-41d4-a716-446655440000"
  nickname: "Steve"
  password: "MyPassword123"

📋 Configuration

Password Requirements

password:
  min-length: 4              # Minimum 4 characters
  max-length: 32             # Maximum 32 characters
  forbidden-passwords:
    - "123"
    - "password"
    - "qwerty"
    - "admin"

Auto-Kick Settings

auto-kick:
  enabled: true              # Enable auto-kick
  delay: 60                  # Seconds before kick
  message: "&cToo slow!"

Reminders

reminders:
  interval: 10               # Seconds between reminders
  not-registered: "&eRegister with /register!"
  not-logged-in: "&eLogin with /login!"

🎨 Color Code Support

Standard Colors:

&0 - Black
&c - Red
&a - Green
&6 - Gold
&e - Yellow

Effects:

&l - Bold
&m - Strikethrough
&n - Underline
&o - Italic
&r - Reset

Example:

prefix: "&8[&6SimpleAuth&8]&r"
message: "&aWelcome &l&e%player%&r&a!"

📊 Version Compatibility

Version	Status
1.21.5	✅ Target
1.21+	✅ Compatible
1.20+	✅ Likely Compatible
1.19 and below	⚠️ You need to test

⚙️ Permissions

Permission	Description	Default
`simpleauth.admin`	Admin commands	op

Support

contact me on discord nickname: we_rt, only with important bug related things

🌟 License

The source code is not publicly available, but if you want to edit something in the plugin for your own needs, update the plugin to a new version or anything else, contact me on discord nickname: we_rt and we will definitely come to an agreement

Made with ❤️ for the Minecraft community

SimpleAuth