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 <name> - Teleport to a specific home
• /sethome <name> - Set a new home at your current location
• /delhome <name> - 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 <player> <home> - Teleport to any player's home
• /homeadmin list <player> - View another player's homes
• /homeadmin delete <player> <home> - Remove player homes
• /homeadmin reload - Reload configuration without restart
• /homeadmin info <player> - 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.<number> - 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

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! 🏡✨