<div align="center"> <h1>🏡 xSetHome</h1> <p><i>A modern, lightweight, and highly customizable home system for your Minecraft server.</i></p> </div> !(https://cdn.modrinth.com/data/cached_images/08dbbf4f9c73ca9427cd75394205d2c3e6fc9c52.jpeg) --- ## ✨ Key Features * **Interactive GUI Menu:** Let players view and manage their homes through a clean, fully customizable `/homes` inventory. Includes built-in support for empty states and custom buttons. * **Dynamic Custom Icons:** Players can personalize how their homes look in the menu! Simply **Right-Click** a home icon while holding a block to update its appearance. * **Safe Teleportation:** Configure a safe teleport delay. If a player moves during the countdown, the teleportation is automatically canceled. * **Immersive Visuals & Audio:** Enhance the player experience with highly customizable ActionBars, on-screen Titles, sound effects, and particles during teleportation. * **100% Customizable:** Tailor every single message, prefix, and menu item. Features native support for HEX colors (e.g., `&#FAEDCB`). * **Custom Head Support:** Use Base64 textures to decorate your menus (perfect for custom "Close Menu" buttons or specific icons). * **PlaceholderAPI Integration:** Extract data from your players' homes to display on scoreboards, holograms, or custom UI menus. --- ## 📝 Commands & Permissions | Command | Description | Permission | | :--- | :--- | :--- | | `/sethome <name>` | Saves your current location as a home. | `xsethome.use.sethome` | | `/home <name>` | Teleports you to a saved home. | `xsethome.use.home` | | `/homes` | Opens the visual homes GUI. | *None (Free for all)* | | `/delhome <name>` | Deletes a saved home. | `xsethome.use.delhome` | | `/xsethome reload` | Reloads the configuration files. | *Admin Only* | | `/xsethome help` | Displays admin commands. | *Admin Only* | > **Note:** The default home limit for standard players is **3** (fully adjustable in the `config.yml`). --- ## 🔗 PlaceholderAPI Variables You can use the following placeholders in your menus, scoreboards, or chat formatting. *(Make sure to replace `<home>` with the exact name of the home)*: * `%xsethome_<home>_name%` ▸ Returns the name of the home. * `%xsethome_<home>_world%` ▸ Returns the world where it is located. * `%xsethome_<home>_x%` ▸ X coordinate of the home. * `%xsethome_<home>_y%` ▸ Y coordinate of the home. * `%xsethome_<home>_z%` ▸ Z coordinate of the home. * `%xsethome_<home>_date%` ▸ Exact date of creation. --- ## 🚀 Installation Guide 1. **Download** the latest version of `xSetHome.jar`. 2. **Move** the downloaded file into your server's `plugins` folder. 3. *(Optional but recommended)* Install **PlaceholderAPI** to utilize the custom variables. 4. **Restart** your server to generate the configuration files. 5. **Configure** `config.yml` and `menu.yml` to your liking, then run `/xsethome reload` in-game or from the console. 6. Enjoy! --- ## 🛠️ Support & Links * 🌐 **Official Website:** (https://xplugins.es/plugins/xsethome) * 💬 **Discord Support:** (https://xplugins.es/discord) --- *Developed with ❤️ by (https://xplugins.es/) (2026).*