# HomeSweetHome 🏠 **The ultimate home management plugin for your Minecraft server!** HomeSweetHome provides players with a comprehensive and intuitive home system, featuring modern GUI interfaces, safety measures, and extensive administrative controls. Whether you're running a small survival server or a large multiplayer network, this plugin scales to meet your needs. ## ✨ Key Features ### 🏡 **Player Commands** - **`/home`** - Teleport to your default home or open the GUI - **`/home `** - Teleport to a specific home - **`/sethome `** - Set a new home at your current location - **`/delhome `** - Delete an existing home - **`/homes`** - List all your homes - **`/bed`** - Quick teleport to your spawn point - **`/homegui`** - Open the beautiful graphical interface ### 🎮 **Intuitive GUI Interface** - **Bed icon at the top** for quick spawn teleportation - **Visual home icons** with easy navigation - **Right-click to delete** homes with confirmation - **Pagination support** for players with many homes - **Custom item representations** based on your preferences ### ⏱️ **Safe Teleportation System** - **3-second countdown** before teleportation - **Movement cancellation** - moving during countdown cancels teleport - **Damage cancellation** - taking damage cancels teleport - **Safe location checks** to prevent suffocation - **Configurable cooldowns** between teleports - **Sound effects** and visual feedback ### 🔧 **Administrative Controls** - **`/homeadmin tp `** - Teleport to any player's home - **`/homeadmin list `** - View another player's homes - **`/homeadmin delete `** - Remove player homes - **`/homeadmin reload`** - Reload configuration without restart - **`/homeadmin info `** - Display player home statistics ### 📊 **Flexible Configuration** - **Configurable home limits** (default: 6 homes per player) - **Permission-based limits** - grant different amounts to different groups - **Unlimited homes** for operators and specific permissions - **World restrictions** - disable homes in certain worlds - **Customizable messages** and GUI elements - **Economy integration** support (optional) ### 🗃️ **Organized Storage** - **Clean folder structure** for easy server management - **Individual player files** for organized data storage - **SQLite database option** for high-performance servers - **Automatic backups** to prevent data loss - **Easy data migration** between storage types ## 🛡️ **Permissions System** ### Player Permissions - `homesweethome.home` - Use home commands - `homesweethome.sethome` - Set home locations - `homesweethome.bed` - Use bed teleportation - `homesweethome.gui` - Access home GUI - `homesweethome.unlimited` - Unlimited homes - `homesweethome.homes.` - Specific home limits (5, 10, 25, etc.) ### Admin Permissions - `homesweethome.admin.*` - All administrative permissions - `homesweethome.admin.tp` - Teleport to other player homes - `homesweethome.admin.delete` - Delete other player homes - `homesweethome.admin.bypass.cooldown` - Skip teleport cooldowns ## ⚙️ **Configuration Highlights** ```yaml settings: teleport-delay: 3 # Countdown in seconds teleport-cooldown: 5 # Cooldown between teleports default-max-homes: 6 # Default home limit cancel-on-move: true # Cancel on movement cancel-on-damage: true # Cancel on damage safe-teleport: true # Safety checks ``` ## 🔌 **Integration Support** - **Vault** - Economy integration for paid teleports/homes - **WorldGuard** - Region compatibility and restrictions - **PlaceholderAPI** - Custom placeholders for other plugins - **Multiple storage backends** - YAML files or SQLite database ## 📋 **Requirements** - **Minecraft Version:** 1.16+ - **Server Software:** Bukkit, Spigot, Paper (recommended) - **Java Version:** 11+ - **Optional Dependencies:** Vault, WorldGuard, PlaceholderAPI ## 🚀 **Why Choose HomeSweetHome?** - **User-friendly** - Intuitive commands and beautiful GUI interface - **Highly configurable** - Customize everything to fit your server - **Performance optimized** - Async operations and efficient data handling - **Admin-friendly** - Comprehensive management tools and permissions - **Safe & reliable** - Built-in safety checks and data backup systems - **Modern codebase** - Clean, maintainable code following best practices --- **Transform your server's home system today with HomeSweetHome!** 🏡✨

ArchieDxncan

ArchieDxncan

HomeSweetHome