🏡 fuzeblocks HomePlugin

🧩 A simple plugin to manage homes and spawn with cache and a multitude of synchronization options.

---

📚 Table of Contents

• ✨ Features
• 🧾 Commands
• 🧩 PlaceholderAPI Integration
• 📥 Installation
• 🧑‍💻 Developer Resources
• ✅ Compatibility
• 🤝 Support & Contributions

✨ Features

• 🔧 Flexible Storage – MySQL & YAML support
• ⚡ Optional Redis Caching – Boost performance
• 📦 Public API – Fully documented and easy to use
• 🏠 Simple Home System – Set, teleport, delete, and list homes
• 🧭 Spawn Management – Set/delete world spawn locations
• ✨ Tpa Management – Send/manage tp request
• 🧩 Plugin Loader – Modular integration for developers
• 🎛️ Custom Home Limits – Configure max homes per player
• 💬 PlaceholderAPI Support – Custom placeholders in GUIs/chat
• 🛠️ Admin Tools – Manage other players’ homes easily
• 🚫 Home Validation System – Prevent unfair home placements

🧾 Commands

⚙️ Command	📝 Description
/sethome [name, info]	Set a home at your current location.
/home [name]	Teleport to a specific home.
/home	Open the GUI listing all your homes.
/delhome [name]	Delete a home by name.
/listhome	View a list of your homes.
/spawn	Teleport to the global spawn.
/setspawn	Define the spawn location.
/delspawn	Remove the current spawn.
/cache [player, clearall, view]	Manage internal cache.
/homeadmin [player]	Admin view of another player's homes.
/plugins	Admin view plugin enable.
/lang [update, merge, set]	Manage languages files.
/tpa	Send a tp request.
/tpaccept [player]	Accept a tp request.
/tpdeny [player]	Deny a tp request.

---

🧩 PlaceholderAPI Integration

Use these placeholders with PlaceholderAPI:

🔤 Placeholder	📋 Description
%homeplugin_homes%	Comma-separated list of home names.
%homeplugin_homes_numbers%	Total number of homes.
%homeplugin_has_homes%	true if player has at least one home.
%homeplugin_home_location_<name>%	Location of the home.
%homeplugin_home_exists_<name>%	true if the home exists.
%homeplugin_home_world_<name>%	World name of the home.
%homeplugin_home_coordinates_<name>%	Coordinates: X Y Z.

Replace <name> with the home name (case-insensitive).

---

📥 Installation

1. ⬇️ Download from Modrinth
2. 📁 Place the .jar in the plugins/ folder
3. 🔁 Restart your server
4. ⚙️ Edit the config in config.yml as needed

---

🧑‍💻 Developer Resources

• 📘 API Docs: GitHub Wiki - API
• 🔌 Plugin Loader Guide: GitHub Wiki - Plugin API

---

✅ Compatibility

• 🧩 Minecraft 1.21.7 to 1.14.x
• Requires: PlaceholderAPI
• API versions: GitHub Releases

---

🤝 Support & Contributions

Found a bug? Have a suggestion? Want to contribute?
Join the Discord server:
🔗 Discord server

---

🛠️ FuzeBlocks HomePlugin — Stable, fast, and extensible home/spawn management.