### **GUI Player Authentication Plugin – Secure Your Server with PIN Authentication** <\/p>\n
\ud83d\udd12 **GUI Player Authentication** is a **Minecraft plugin** that enhances server security by requiring players to **set up and enter a secure PIN** before they can interact with the world. This plugin prevents unauthorized access, ensuring that only verified players can play.<\/p>\n
—<\/p>\n
## **\ud83d\udd39 Features**
\n\u2705 **PIN Registration & Login:** Players must register a **4-digit PIN** (or any other configured value) on their first login and use it for future authentications.
\n\u2705 **Custom Chest GUI:** Players enter their PIN using a visually appealing **Chest GUI** with **Light Blue Dye items** representing digits.
\n\u2705 **Auto-Kick System:** If a player **fails to authenticate within 30 seconds**, they will be **automatically kicked** from the server.
\n\u2705 **PIN Verification:** If the entered PIN is incorrect, the player is **kicked immediately** to prevent brute-force attempts.
\n\u2705 **Player Restrictions:** Until authentication is complete, players **cannot move, chat, execute commands, or interact** with the world.
\n\u2705 **Blindness Effect:** Unauthenticated players receive a **permanent blindness effect** until they log in successfully.
\n\u2705 **PIN Reset Command (`\/resetpin`)**: Players can reset their PIN and register a new one at any time. <\/p>\n
—<\/p>\n
## **\ud83d\udd39 How It Works**
\n1. **New Players:**
\n – Upon joining, if the player **has no PIN registered**, they are shown a **Register GUI** where they must **select a 4-digit PIN** (or however many digits the user inputs in `config.yml`.
\n – Once confirmed, the PIN is **stored securely in a SQLite database**, and the player is granted access to the server. <\/p>\n
2. **Returning Players:**
\n – If the player already has a PIN, they are shown the **Login GUI** and must enter their **correct PIN**.
\n – A correct PIN **removes all restrictions**, while an incorrect PIN results in an **immediate kick**. <\/p>\n
3. **Auto-Kick for Unauthenticated Players:**
\n – If a player **does not authenticate within 30 seconds**, they are **automatically kicked** from the server. <\/p>\n
4. **PIN Reset:**
\n – Players can use **`\/resetpin`** to delete their PIN and start the registration process again. <\/p>\n
—<\/p>\n
## **\ud83d\udd39 Commands & Permissions**
\n| Command | Description | Permission |
\n|—————|————-|————|
\n| `\/resetpin` | Resets the player’s PIN and prompts for re-registration. | **All Players** |<\/p>\n
—<\/p>\n
## **\ud83d\udd39 Configuration (`config.yml`)**
\n“`yaml
\n# The number of digits required for PIN authentication
\npin_length: 4
\n“`
\n– **Customizable PIN length** if needed. <\/p>\n
—<\/p>\n
## **\ud83d\udd39 Why Use This Plugin?**
\n\ud83d\udd39 **Prevents Account Hijacking:** Ensures that only the real player can log into their account. Traditional password crackers are designed for `\/login` authentication, which is nonexsistent here.
\n\ud83d\udd39 **Brute-Force Protection:** Instant kicks for incorrect PIN attempts prevent unauthorized access.
\n\ud83d\udd39 **User-Friendly GUI:** Players interact through an **intuitive Chest GUI** instead of typing commands.
\n\ud83d\udd39 **Lightweight & Efficient:** Uses **SQLite storage** for easy setup and **low server impact**.
\n\ud83d\udd39 **Perfect for Private & Public Servers:** Ideal for **SMPs, Minigame servers, and RP servers** that need an extra layer of security. <\/p>\n
—<\/p>\n
## **\ud83d\udd39 Installation**
\n1. **Download the Plugin `.jar` File.**
\n2. **Place it in the `\/plugins` folder** of your Minecraft server.
\n3. **Restart the server.**
\n4. **Customize settings in `\/plugins\/GUIPlayerAuth\/config.yml` (optional).**
\n5. **Enjoy a more secure Minecraft experience!** <\/p>\n
—<\/p>\n
### **\ud83d\udcbe Compatibility**
\n\u2705 Supports **Minecraft 1.21+**
\n\u2705 Works with **Paper, Spigot, and Bukkit** servers <\/p>\n
—<\/p>\n
### **\ud83d\udd39 Future Updates & Features**
\n\ud83d\udd1c **MySQL Support** for multi-server authentication
\n\ud83d\udd1c **Configurable Auto-Kick Time**
\n\ud83d\udd1c **Admin Override Commands** <\/p>\n
—<\/p>\n
\ud83c\udf89 **Secure your server today with GUI Player Authentication!** \ud83c\udf89 <\/p>\n","protected":false},"excerpt":{"rendered":"
A groundbreaking new approach to player authentication.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"gui-player-auth","_minecraft_project_id":"NG3xYWKV","_minecraft_author":"Earth1283","_minecraft_license":"MIT","_minecraft_downloads":605,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gui-player-auth.zip","_minecraft_size_bytes":59992,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T10:14:20.430271Z","_minecraft_date_created":"2025-02-07T20:42:25.954168Z","_minecraft_date_modified":"2025-03-30T09:24:37.748429Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gui-player-auth","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-04T12:35:37+00:00","_minecraft_import_hash":"5c0a2608805ed0e6e2c279ee8d63c525","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-78451","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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":"\n