# RayLogin – Secure Minecraft Login System (1.21+)

**RayLogin** is a lightweight, secure, and customizable login system built for Minecraft servers running version 1.21+. It supports both **premium** and **cracked** players, offering automatic handling for premium accounts and a clean, user-friendly experience for everyone.

---

## Core Features

- `/register [password]` – For new non-premium players
- `/login [password]` – For returning non-premium players
- `/resetpassword [old] [new]` – Secure password reset after login
- ️ Admin command to reset any player's password
- ✅ **Automatic login & registration** for premium players (UUID-based detection)

---

## Player Restrictions Before Login

Until the player logs in or registers:
- ❌ Cannot move
- ❌ Cannot chat
- ❌ Cannot open inventory
- ❌ Cannot run commands (except `/login` and `/register`)
- All settings are configurable in `config.yml`

---

## Player Experience

- Teleport to a set spawn before login/register
- ⏳ BossBar countdown timer
- Title/subtitle messages like “Please Login” or “Register First”
- Sound played on successful login/register
- Colored messages using `&` codes
- Confirmation message on **auto login**

---

## ⚙️ Full Customization

- YAML-based `config.yml` for:
- Spawn location
- Timeout duration before kick
- Message colors and text
- Enable/disable sound, titles, and auto-login
- Optional `messages.yml` for multi-language and cleaner management

---

## Security

- Passwords are encrypted using **BCrypt** or **SHA-256 + salt**
- Supports **SQLite** or **MySQL** databases
- ❌ No password-related logs in console
- Optional: Anti-session hijack/IP-checking (coming soon)

---

## Admin Commands

| Command | Description |
|---------|-------------|
| `/raylogin setspawn` | Set login/register spawn |
| `/raylogin reload` | Reload plugin configuration |
| `/raylogin reset [player] [newPassword]` | Admin password reset |
| `/resetpassword [old] [new]` | Player resets own password |

**Permissions**:
- `raylogin.admin` – Full access to admin tools
- `raylogin.bypass` – Bypass login for trusted players

---

## ✅ Compatibility

- Minecraft 1.21+
- Paper / Spigot
- ❌ Not designed for BungeeCord (yet)

---

Stay secure, stay simple — with **RayLogin**