🏠 CrazyHomes

Manage your homes in style — modern GUI, configurable VIP layouts, zero lag.

CrazyHomes replaces the old text-based /sethome system with a modern 4-row graphical interface (GUI). VIP players get more home slots, while regular players see their homes automatically centered in the GUI. Everything can be customized through gui.yml without editing the source code.

✨ Features

• 🖥️ Modern 4-row GUI

  • 9×4 inventory with decorative borders, beds, and dye action buttons.

• 👑 VIP System

  • Players with the crazyhomes.vip permission can have up to 9 homes, while regular players have 5 (fully configurable).

• 📐 Centered Layout

  • Non-VIP home slots are automatically centered instead of being aligned to the left.

• ⚙️ Fully Configurable Layouts

  • Change the slot positions for every layout directly from gui.yml, without editing the code.

• 🗑️ Delete Confirmation GUI

  • Prevent accidental home deletion with a dedicated confirmation menu.

• ⏱️ Teleport Countdown

  • Configurable delay before teleporting; moving cancels the teleport.

• 🌿 Folia Support

  • Fully compatible with Paper, Purpur, and Folia, using native region scheduling.

• 🎨 Adventure API + MiniMessage

  • Supports gradients, hex colors, formatting, and modern text components.

• 🔌 PlaceholderAPI Support

  • Soft dependency; automatically hooks into PlaceholderAPI if installed.

• 💾 YAML Storage

  • One file per player. No external database required.

• 📜 Lightweight

  • Standalone JAR (~51 KB) with no additional runtime dependencies.

🎮 Commands

🔑 Permissions

📐 GUI Layout

The GUI is a 9×4 inventory. Layouts are defined inside gui.yml.

Default Layout (5 Homes)

[■][■][■][■][■][■][■][■][■]  ← Border
[ ][ ][🛏][🛏][🛏][🛏][🛏][ ][ ]  ← Beds
[ ][ ][🟢][🟢][🟢][🟢][🟢][ ][ ]  ← Dyes
[■][■][■][■][■][■][■][■][■]  ← Border

VIP Layout (9 Homes)

[■][■][■][■][■][■][■][■][■]  ← Border
[🛏][🛏][🛏][🛏][🛏][🛏][🛏][🛏][🛏]  ← Beds
[🟢][🟢][🟢][🟢][🟢][🟢][🟢][🟢][🟢]  ← Dyes
[■][■][■][■][■][■][■][■][■]  ← Border

You can freely move every slot by editing:

gui.yml
└── layouts
    ├── default
    └── vip

No code changes are required.

⚙️ Quick Configuration (config.yml)

max-homes-default: 5      # Home slots for regular players
max-homes-vip: 9          # Home slots for VIP players

teleport:
  delay: 3                # Seconds before teleporting
  cancel-on-move: true    # Cancel teleport if the player moves

sounds:
  gui-open: BLOCK_CHEST_OPEN
  home-set: ENTITY_EXPERIENCE_ORB_PICKUP
  teleport: ENTITY_ENDERMAN_TELEPORT
  delete: BLOCK_ANVIL_USE
  error: ENTITY_VILLAGER_NO

📦 Installation

1. Download CrazyHomes-x.x.x.jar.
2. Place it inside your server's plugins/ folder.
3. (Optional) Install PlaceholderAPI if you want placeholder support.
4. Start your server. Configuration files will be generated automatically.
5. Customize config.yml and gui.yml.
6. Run /home reload to reload the configuration without restarting the server.

🧩 Compatibility

Supported Server Software

⚠️ CrazyHomes requires Paper or one of its forks.
The plugin uses native Paper APIs such as the Adventure API, Folia region scheduling, and modern text components, which are not available on vanilla Spigot.

System Requirements

Dependencies

💡 PlaceholderAPI is completely optional.
CrazyHomes works perfectly without it. If PlaceholderAPI is not installed, placeholders are simply ignored.

📄 License

© 2025 Dragon_45_ — All Rights Reserved.

Unauthorized reproduction, redistribution, modification, or commercial use of this plugin is strictly prohibited without the author's prior written permission.

❤️ Made with love by Dragon_45_