---

✨ 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: xPlugins - xSetHome
• 💬 Discord Support: Join our Community

---

Developed with ❤️ by xPlugins (2026).