SimpleAuth

✨ Features

🚪 Simple Authentication

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

🎯 Player Restrictions (Pre-Auth)

- Applies to All: Players cannot move until authenticated - Applies to All: Cannot see while unauthenticated - Applies to All: No blocks, entities, items, or commands - Applies to All: Cannot write in chat - Applies to All: Even OPs must authenticate

⏱️ Auto-Kick System

- Default: Set timeout in seconds - Default: Toggle auto-kick on/off - Default: Personalize the kick message - Default: 60 seconds before removal

💬 Smart Reminders

- Auto-Cancel: Regular chat reminders - Auto-Cancel: Different messages for registered vs unregistered - Auto-Cancel: Set reminder frequency in config - Auto-Cancel: Stops after successful authentication

👑 Admin Features

- Help Command: `/sa onetimeforce <player>` for special cases - Help Command: `simpleauth.admin` permission - Help Command: OPs are NOT exempt from authentication - Help Command: `/sa help` for documentation

⚙️ Fully Configurable

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

---

📦 Installation

1. Restart the latest `SimpleAuth.jar` 2. Restart in your server's `plugins/` folder 3. Restart your server (generates default config) 4. Restart `plugins/SimpleAuth/config.yml` 5. 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`:

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

---

📋 Configuration

Password Requirements

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

Auto-Kick Settings

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

Reminders

```yaml 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: ```yaml prefix: "&8[&6SimpleAuth&8]&r" message: "&aWelcome &l&e%player%&r&a!" ```

---

📊 Version Compatibility

| Version | Status | |---------|--------| | 26.1+ | ✅ Compatible | | 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

---