# Simple Home Gui – Slot-Based Home System<\/p>\n
**Simple Home Gui** is a modern, GUI-based home system. It uses a visual slot system (akin to 8 “save slots”) that provides players an intuitive and beginner-friendly way to manage their homes.<\/p>\n
The plugin is optimized from the ground up for **Paper 1.20.1**, focusing on stability, performance (via caching), and extensive configuration.<\/p>\n
—<\/p>\n
## Core Features<\/p>\n
### 1. Slot-Based GUI Menu
\nThe heart of the plugin is the main menu, opened with `\/homes`.<\/p>\n
* **Visual Feedback:** Players see 8 slots (beds and dyes) that can represent 3 states:
\n * **Green (Set):** The home is set. Displays the name and coordinates. Clicking opens the submenu.
\n * **Gray (Empty):** The slot is unlocked, but no home has been set. Clicking sets the home at the player’s current location.
\n * **Red (Locked):** The player does not have the necessary permissions for this slot.
\n* **Submenu:** Clicking a set (green) home opens a separate menu where the player can choose to:
\n * Teleport
\n * Delete Home
\n * Go back to the overview
\n* **Fully Customizable:** The layout, items (beds, dyes, ender pearls, etc.), and all text in the GUI can be freely configured in the `config.yml` and language files.<\/p>\n
### 2. Comprehensive Command System
\nFor players who prefer commands, Simple Home Gui offers full functionality via the chat.<\/p>\n
* `\/homes`: Opens the GUI. ### 3. Safe Teleport Timer * **3-Second Delay:** The teleport only executes after 3 seconds. —<\/p>\n ## Configuration & Customization<\/p>\n The plugin was designed to be perfectly integrated into your server. **Everything is configurable.**<\/p>\n * **`config.yml`:** —<\/p>\n ## Permission System<\/p>\n Simple Home Gui is designed for use with **LuckPerms** (or any other permissions plugin). It does *not* check for groups, but for flexible permission nodes.(ignores the name Valoria that was the original name of the system)<\/p>\n * **Home Limits:** The number of available slots is controlled via permissions. —<\/p>\n ## Technical Details<\/p>\n * **Server:** Paper (or compatible forks like Purpur) A home system with extensive GUI<\/p>\n","protected":false},"featured_media":140192,"template":"","meta":{"_minecraft_slug":"simple-home-gui","_minecraft_project_id":"q3H3ChJM","_minecraft_author":"maxmt002","_minecraft_license":"MIT","_minecraft_downloads":114,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-home-gui.zip","_minecraft_size_bytes":31426,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:20:05.619632Z","_minecraft_date_created":"2025-10-23T06:23:23.634757Z","_minecraft_date_modified":"2025-10-20T01:40:06.837080Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-home-gui","_minecraft_icon_attachment_id":140192,"_minecraft_imported_at":"2026-06-08T07:36:33+00:00","_minecraft_import_hash":"276625f94778a70201d79b2d8c0fd1b2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,126,90,127,128],"mod_loader":[132,133],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-140191","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","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"],"yoast_head":"\n
\n* `\/homes set
\n* `\/homes tp
\n* `\/homes delete
\n* `\/homes rename
\n* **Tab Completion:** All commands and arguments (including slot numbers and home names) are fully tab-completable.<\/p>\n
\nTo prevent abuse (e.g., in combat), every teleport includes a timer.<\/p>\n
\n* **Movement Cancellation:** If the player moves from their block during the countdown, the teleport is automatically cancelled.<\/p>\n
\n * **Chat Prefix:** Change the appearance of the plugin’s name in chat.
\n * **Language:** Set the default language (e.g., `en` or `de`).
\n * **GUI Layout:** Change the exact position of every single slot (1-8) in the GUI.
\n * **GUI Items:** Define every item (material, name, lore) for every state (Locked, Empty, Set) and every menu (Main and Submenu).
\n* **`messages_xx.yml`:**
\n * Translate every single message the plugin sends to players\u2014from error messages to GUI descriptions.<\/p>\n
\n * `valoria.homes.limit.1` (Default for every player)
\n * `valoria.homes.limit.2`
\n * …
\n * `valoria.homes.limit.8`
\n * *(If a player has `valoria.homes.limit.5`, slots 1-5 will be unlocked (gray\/green) and 6-8 will be locked (red).)*
\n* **Command Permissions:**
\n * `valoria.homes.command.gui` (For `\/homes`)
\n * `valoria.homes.command.set`
\n * `valoria.homes.command.tp`
\n * `valoria.homes.command.delete`
\n * `valoria.homes.command.rename`
\n* **Wildcard:**
\n * `valoria.homes.*` (Grants all permissions, including all 8 slots)<\/p>\n
\n* **Version:** Minecraft 1.20.1
\n* **Storage:** Homes are managed in a high-performance player cache (RAM) and are saved securely to individual `playerdata\/