🏠 HellHome Wiki

Welcome to the official wiki for HellHome, the professional, DonutSMP-style home management plugin for Paper/Folia servers. This plugin is designed to be lightweight, highly customizable, and extremely user-friendly.

---

✨ Key Features

• 🎨 Multi-Module Messaging: Configure Chat, ActionBar, Title, Subtitle, and Sound for any event.
• 🛠️ Interactive Anvil GUI: Rename your homes using a sleek Anvil interface—no clunky chat commands required.
• 📦 Dynamic GUI Management: View and manage all your homes in a single, beautiful menu.
• 🚀 Teleport Logic: Smarter teleportation with configurable delays and move/jump cancellation.
• 🛡️ WorldGuard Integration: Easily prevent home creation in specific regions.
• 📊 Database Support: Out-of-the-box support for both SQLite and MySQL.
• 💥 Sound Effects: Fully customizable sound triggers for every interaction.

---

💻 Commands & Permissions

Command	Alias	Description	Permission
/homes	/home	Opens the main homes management GUI.	(None)
/sethome [name]		Sets a new home at your current location.	(None)
/delhome [name]		Safely deletes a home via a GUI confirmation.	(None)
/homeadmin help		Displays admin help information.	hellhome.admin
/homeadmin <player>		Manage or visit another player's homes.	hellhome.admin
/homeadmin reload		Reloads all plugin configurations.	hellhome.admin

🔑 Extra Permissions

• hellhome.limit.<rank>: Sets the player's home limit to the value defined in config.yml.
• hellhome.bypass.cooldown: Allows players to teleport instantly, bypassing the countdown.
• hellhome.limit.*: Grants unlimited homes (capped only by GUI slots).

---

🧩 Placeholders

You can use these placeholders in messages.yml and gui.yml:

• %home_name%: The name of the home.
• %new-name%: The new name after a rename action.
• %countdown%: Remaining seconds during teleport.
• %player%: The player's name (used in admin commands).
• %min% / %max%: Configuration limits for home name length.
• %link%: Your server store link (defined in messages.yml).

---

📥 Installation

1. Download the HellHome.jar.
2. Drop it into your server's plugins/ directory.
3. Restart your server.
4. Configure your database in database.yml (defaults to SQLite).
5. Customize your settings and use /homeadmin reload to apply changes!