{"id":96640,"date":"2026-06-05T15:55:30","date_gmt":"2026-06-05T12:55:30","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/"},"modified":"2026-06-05T15:55:30","modified_gmt":"2026-06-05T12:55:30","slug":"lunnara-login","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/","title":{"rendered":"Lunnara login"},"content":{"rendered":"
\n

# \u2726 LunnaraLogin \u2726<\/p>\n

**Authentication plugin for Lunnara Network**<\/p>\n

Spigot \u00b7 Paper \u00b7 Purpur \u00b7 All Forks \u00b7 1.21.x \u00b7 Secure BCrypt \u00b7 MiniMessage Styled<\/p>\n

—<\/p>\n<\/div>\n

## Supported Platforms<\/p>\n

| Platform | Status |
\n|—|—|
\n| **Paper** 1.21.x | \u2714 Fully supported (native Adventure) |
\n| **Spigot** 1.21.x | \u2714 Fully supported (shaded Adventure) |
\n| **Purpur** 1.21.x | \u2714 Fully supported |
\n| **Pufferfish** 1.21.x | \u2714 Fully supported |
\n| **Any Spigot\/Paper fork** | \u2714 Should work out of the box |<\/p>\n

> Requires **Java 21** or higher.<\/p>\n

## Features<\/p>\n

– **BCrypt Password Hashing** \u2014 Passwords are securely salted & hashed, never stored in plain text
\n– **MiniMessage Support** \u2014 All messages fully customizable with gradients, colors & formatting
\n– **Full Lockdown** \u2014 Players can’t move, chat, interact, build, or take damage until authenticated
\n– **Blindness Effect** \u2014 Optional blindness + slowness applied before login
\n– **Auto Kick** \u2014 Players who don’t authenticate within the timeout get kicked
\n– **Login Reminders** \u2014 Periodic messages reminding players to `\/login` or `\/register`
\n– **JSON Storage** \u2014 Per-player data files, no database needed
\n– **Async Operations** \u2014 Password hashing runs off the main thread, zero lag<\/p>\n

—<\/p>\n

## Commands<\/p>\n

### Player Commands<\/p>\n

| Command | Aliases | Description |
\n|—|—|—|
\n| `\/register ` | `\/reg` | Register a new account (first join) |
\n| `\/login ` | `\/l` | Log in to your account |
\n| `\/changepass ` | `\/changepassword` | Change your own password |<\/p>\n

### Admin Commands<\/p>\n

All admin commands use `\/lunaralogin` (aliases: `\/ll`, `\/llogin`)<\/p>\n

| Command | Permission | Description |
\n|—|—|—|
\n| `\/ll changepass ` | `lunaralogin.admin.changepass` | Force-change a player’s password |
\n| `\/ll delacc ` | `lunaralogin.admin.delacc` | Delete a player’s account (kicks if online) |
\n| `\/ll forcelogin ` | `lunaralogin.admin.forcelogin` | Force-login an online player without a password |
\n| `\/ll status ` | `lunaralogin.admin.status` | Check if a player is registered \/ logged in |
\n| `\/ll reload` | `lunaralogin.admin.reload` | Reload config & messages |<\/p>\n

—<\/p>\n

## Permissions<\/p>\n

| Permission | Default | Description |
\n|—|—|—|
\n| `lunaralogin.admin` | OP | Access to admin help |
\n| `lunaralogin.admin.changepass` | OP | Change another player’s password |
\n| `lunaralogin.admin.delacc` | OP | Delete a player’s account |
\n| `lunaralogin.admin.forcelogin` | OP | Force-login a player |
\n| `lunaralogin.admin.status` | OP | View player auth status |
\n| `lunaralogin.admin.reload` | OP | Reload configuration |<\/p>\n

—<\/p>\n

## Configuration<\/p>\n

### config.yml<\/p>\n

| Option | Default | Description |
\n|—|—|—|
\n| `session-timeout` | `60` | Session duration in minutes |
\n| `login-timeout` | `120` | Seconds before unauthenticated players are kicked |
\n| `max-login-attempts` | `5` | Failed login attempts before kick |
\n| `min-password-length` | `6` | Minimum password length |
\n| `max-password-length` | `32` | Maximum password length |
\n| `allow-movement-before-auth` | `false` | Allow movement before logging in |
\n| `blind-before-auth` | `true` | Apply blindness + slowness before auth |
\n| `reminder-interval` | `5` | Seconds between login\/register reminders |
\n| `allowed-commands` | `\/login, \/register, \/l, \/reg` | Commands usable before authenticating |<\/p>\n

### messages.yml<\/p>\n

All messages use **MiniMessage** formatting. Supports gradients, hex colors, bold, etc.<\/p>\n

Example from the default config:
\n“`
\nlogin-success: “\u2714 Logged in successfully! Welcome back.”
\n“`<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Build the plugin:
\n “`bash
\n cd LunnaraLogin && .\/gradlew build
\n “`
\n2. Copy `build\/libs\/LunnaraLogin-1.0.0.jar` to your server’s `plugins\/` folder
\n3. Start the server \u2014 config files will be generated
\n4. Edit `config.yml` and `messages.yml` to your liking
\n5. Run `\/ll reload` to apply changes<\/p>\n

—<\/p>\n

## How It Works<\/p>\n

1. **First join** \u2014 Player is frozen & blinded, prompted to `\/register `
\n2. **Return visit** \u2014 Player is frozen & blinded, prompted to `\/login `
\n3. **On success** \u2014 Effects removed, full server access granted
\n4. **Too slow?** \u2014 Kicked after `login-timeout` seconds
\n5. **Wrong password?** \u2014 Kicked after `max-login-attempts` failed tries<\/p>\n

Player data is stored in `plugins\/LunnaraLogin\/playerdata\/.json`.<\/p>\n

—<\/p>\n

\n

**Lunnara Network** \u00b7 Spigot \/ Paper \/ Purpur \u00b7 1.21.x \u00b7 Java 21<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

A secure authentication plugin for Minecraft 1.21.x. Players must register and login with BCrypt-hashed passwords. Full lockdown until authenticated. Admin tools included. Works on Spigot, Paper, Purpur, and all forks.<\/p>\n","protected":false},"featured_media":96641,"template":"","meta":{"_minecraft_slug":"lunnara-login","_minecraft_project_id":"eTGlIhqq","_minecraft_author":"Mistix","_minecraft_license":"MIT","_minecraft_downloads":14,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lunnara-login.zip","_minecraft_size_bytes":1196976,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:52:58.780750Z","_minecraft_date_created":"2026-04-13T23:39:16.193089Z","_minecraft_date_modified":"2026-04-04T05:51:54.136315Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lunnara-login","_minecraft_icon_attachment_id":96641,"_minecraft_imported_at":"2026-06-05T12:55:31+00:00","_minecraft_import_hash":"a40c2b5c7445101de5c0b05295ad70ca","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,127,128,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-96640","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nLunnara login - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Lunnara login - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A secure authentication plugin for Minecraft 1.21.x. Players must register and login with BCrypt-hashed passwords. Full lockdown until authenticated. Admin tools included. Works on Spigot, Paper, Purpur, and all forks.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/\",\"name\":\"Lunnara login - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp\",\"datePublished\":\"2026-06-05T12:55:30+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/lunnara-login\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Lunnara login\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Lunnara login - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/","og_locale":"en_US","og_type":"article","og_title":"Lunnara login - Minecraft","og_description":"A secure authentication plugin for Minecraft 1.21.x. Players must register and login with BCrypt-hashed passwords. Full lockdown until authenticated. Admin tools included. Works on Spigot, Paper, Purpur, and all forks.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/","name":"Lunnara login - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp","datePublished":"2026-06-05T12:55:30+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/lunnara-login-icon-6bf6aba4c5665624a8e0aa1620df41898cb7f29d_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/lunnara-login\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Lunnara login"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/96640","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/96641"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=96640"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=96640"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=96640"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=96640"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}