Kaizen Homes

A modern, feature-rich home management plugin with stunning GUIs and RGB gradient text

Transform your server's home system with KaizenHomes - the ultimate home management solution featuring beautiful interactive menus, advanced sharing capabilities, and eye-catching RGB gradients throughout.

✨ Key Features

🏠 Advanced Home Management

Unlimited Homes (permission-based limits)
Interactive GUI for all home operations
Custom Icons - Choose from 20+ materials
Categories - Organize homes visually
Rename & Update homes anytime
Death Homes - Auto-save location on death
Bed Sync - Sync homes with bed respawn points

🔒 Privacy & Sharing System

Three Privacy Modes:
- Private - Only you can access
- Shared - Share with specific players
- Public - Anyone can visit
Per-Player Sharing - Control who can visit each home
Public Browser - Discover and visit public homes from other players

🚀 Smart Teleportation

Warmup System - Configurable delay before teleportation
Cooldown Management - Prevent spam with configurable cooldowns
Safety Checks - Automatic safe location detection
Visual Feedback - Beautiful titles and action bars
Sound Effects - Modern Adventure API sounds
Particle Effects - Stunning visual effects on teleport

🎨 Beautiful Visuals

RGB Gradients everywhere - Messages, GUIs, titles
7 Preset Themes:
- 🌸 Kaizen (Pink to Purple)
- 🔥 Fire (Red to Orange)
- 🌊 Ocean (Blue to Cyan)
- 🌿 Nature (Green to Lime)
- 🌅 Sunset (Orange to Pink)
- 💜 Purple (Purple to Magenta)
- 🏆 Gold (Yellow to Orange)
✨ Gradients - Multi-color effects
Custom Gradients - Create your own color schemes

⚙️ Admin Features

In-Game Admin Panel - Edit all settings via GUI
Live Config Editor - Changes save instantly
All Homes Browser - View and manage any player's homes
Direct Teleportation - Jump to any home as admin
Bulk Management - Delete homes, manage limits
Reload Command - Apply config changes without restart

📋 Commands

Command	Description	Permission
`/home <name>`	Teleport to your home	`khomes.home`
`/home set <name>`	Create a new home at your location	`khomes.sethome`
`/home delete <name>`	Delete one of your homes	`khomes.delhome`
`/homes`	Open the homes menu GUI	`khomes.homes`
`/publichomes`	Browse public homes from all players	`khomes.publichomes`
`/khomes admin`	Open the admin configuration panel	`khomes.admin`
`/khomes reload`	Reload the configuration	`khomes.reload`

🔑 Permissions

Player Permissions

khomes.home          # Use /home command
khomes.sethome       # Create homes
khomes.delhome       # Delete homes
khomes.homes         # Access homes GUI
khomes.publichomes   # Browse public homes

Home Limit Permissions

khomes.limit.1         # 1 home (default)
khomes.limit.3         # 3 homes
khomes.limit.5         # 5 homes
khomes.limit.10        # 10 homes
khomes.limit.unlimited # Unlimited homes

Admin Permissions

khomes.admin              # Full admin access
khomes.reload             # Reload configuration
khomes.bypass.cooldown    # Bypass cooldowns
khomes.bypass.warmup      # Instant teleportation

📦 Installation

Download the latest version from the releases page
Place KaizenHomes-1.0.jar in your server's plugins/ folder
Restart your server (or use a plugin manager)
Configure settings in plugins/kaizen/kaizenhomes/config.yml
Enjoy! Start setting homes with /home set <name>

⚙️ Configuration

The plugin creates its data folder at plugins/kaizen/kaizenhomes/:

plugins/kaizen/kaizenhomes/
├── config.yml          # Main configuration
└── homes/              # Player home data
    ├── player1.yml
    ├── player2.yml
    └── ...

Key Configuration Options

# Teleportation Settings
teleport:
  warmup: 3              # Seconds before teleport
  cooldown: 60           # Seconds between teleports
  safety-check: true     # Check if location is safe

# Feature Toggles
features:
  death-homes: true      # Save location on death
  bed-sync: true         # Sync with bed respawn
  public-homes: true     # Enable public home browser

# GUI Settings
gui:
  gradient-theme: "kaizen"  # Default gradient preset
  sound-effects: true       # Play sounds on actions

🎯 Use Cases

For Survival Servers

Players can set multiple homes across the world
Death homes help players recover their items
Bed sync keeps spawn points organized

For Creative Servers

Quick teleportation between builds
Share builds with friends via shared homes
Public homes for showcasing creations

For Multiplayer Networks

Town/faction homes with sharing
Public warp-like homes for community areas
Admin tools for managing player homes

🛠️ Technical Details

Platform: Paper 1.21+ (Purpur, Pufferfish compatible)
Java Version: 21
API: Paper API + Adventure API
Storage: Async YAML per-player files
Performance: All storage operations are non-blocking
Modern: Uses Adventure API for text components and sounds

📸 Screenshots

Coming soon! Check the GitHub repository for screenshots and demos.

🐛 Support & Issues

Found a bug or have a feature request?

GitHub Issues: Report Here
Discord: Coming soon!

📄 License

🌟 Why Choose KaizenHomes?

✅ Modern & Beautiful - RGB gradients and polished GUIs ✅ Feature-Rich - Everything you need for home management ✅ Performant - Async operations, optimized code ✅ Configurable - Every feature can be customized ✅ Admin-Friendly - In-game configuration editor ✅ User-Friendly - Intuitive commands and GUIs ✅ Active Development - Regular updates and improvements

Made with ❤️ by KaizenCore