ZLogin

# ✦ ZLogin — Modern GUI Login System ✦





**Say goodbye to confusing commands. ZLogin brings a beautiful GUI-based login experience to your server.**




---


## Features


| Feature | Description |

|---------|-------------|

| **GUI Interface** | Players see a beautiful chest GUI on join — click to login or register |

| **Captcha Protection** | Math quiz captcha prevents bot registrations and brute-force attacks |

| **BCrypt Encryption** | Industry-standard password hashing, fully async for zero lag |

| **Auto-Login** | IP-based session caching — returning players auto-login within configurable timeout |

| **Anti-Brute-Force** | Configurable max attempts with temporary IP ban |

| **Fully Configurable** | Every text, color, and toggle is customizable via `config.yml` |

| **Multi-Platform** | Works on Paper, Spigot & Arclight Fabric out of the box |

| **No Database Required** | All data stored in YAML files — zero setup |


---


## Installation


1. **Download** the latest `ZLogin-1.0.0.jar` from the releases page

2. **Place** it in your server's `plugins/` folder

3. **Restart** your server (or use `/reload`)

4. **Done!** Players will see the login GUI when they join


> For Arclight Fabric servers, you can also put it in the `mods/` folder.


---


## Commands


| Command | Permission | Description |

|---------|-----------|-------------|

| `/login <password>` | Everyone | Login to your account |

| `/register <password> <confirm>` | Everyone | Register a new account |

| `/changepassword <old> <new>` | Players (logged in) | Change your password |

| `/zlogin reload` | `zlogin.admin` | Reload configuration |

| `/zlogin info <player>` | `zlogin.admin` | View player login info |

| `/zlogin logout <player>` | `zlogin.admin` | Force logout a player |


---


## Configuration


All settings are in `plugins/ZLogin/config.yml`:


```yaml

settings:

session-timeout: 30 # Auto-login timeout (minutes)

max-attempts: 5 # Max login attempts before temp ban

ban-time: 10 # Temp ban duration (minutes)

captcha: true # Enable/disable captcha

allow-register: true # Allow new player registration

auto-login: true # Enable auto-login

min-password-length: 4 # Minimum password length

max-password-length: 32 # Maximum password length

```


All GUI texts and colors are fully customizable in the `gui:` section of `config.yml`.


---


## Security


- **BCrypt hashing** with configurable strength — passwords are never stored in plaintext

- **Async processing** — password verification runs off the main thread, zero impact on TPS

- **Rate limiting** — brute-force protection with automatic IP banning

- **Captcha protection** — prevents automated bot registrations


---




The compiled JAR will be in `target/ZLogin-1.0.0.jar`.


---


## Compatibility


| Server | Status |

|--------|--------|

| Paper 1.21.x | Fully compatible |

| Spigot 1.21.x | Fully compatible |

| Arclight Fabric 1.21.1 | Fully compatible |

| Folia | Not tested (PRs welcome) |


---


## License


This project is open source under the MIT License.

该项目遵循 MIT 许可证，属于开源项目。