🏠 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

Command	Permission	Description
/home	crazyhomes.use	Opens the Homes GUI
/home set <n>	crazyhomes.sethome	Sets Home n via chat
/home del <n>	crazyhomes.delhome	Deletes Home n
/home tp <n>	crazyhomes.teleport	Teleports to Home n
/home reload	crazyhomes.reload	Reloads the plugin configuration

---

🔑 Permissions

Permission	Default	Description
crazyhomes.use	true	Allows access to /home
crazyhomes.sethome	true	Allows setting homes
crazyhomes.delhome	true	Allows deleting homes
crazyhomes.teleport	true	Allows teleporting to homes
crazyhomes.reload	op	Allows reloading the plugin
crazyhomes.vip	false	Grants additional home slots

---

📐 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

Software	Minecraft Versions	Status
Paper	1.20.4 · 1.20.5 · 1.20.6	✅ Fully supported
Folia	1.20.4 · 1.20.5 · 1.20.6	✅ Native region scheduling
Purpur	1.20.4 · 1.20.5 · 1.20.6	✅ Fully compatible (Paper fork)
Spigot	—	❌ Not supported (requires the Paper API)
Bukkit	—	❌ Not supported
Forge / Fabric	—	❌ Bukkit plugin, not a mod

⚠️ 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

Component	Minimum Version
Java	17 (tested up to Java 21)
Recommended RAM	No noticeable overhead (~51 KB JAR with lightweight YAML storage)

---

Dependencies

Plugin	Type	Version
PlaceholderAPI	Optional	2.11+

💡 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_