CrazyHomes

# 🏠 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) ```text ← Border ← Beds ← Dyes ← Border ``` ## VIP Layout (9 Homes) ```text ← Border ← Beds ← Dyes ← Border ``` You can freely move every slot by editing: ```text gui.yml └── layouts ├── default └── vip ``` **No code changes are required.** --- # ⚙️ Quick Configuration (`config.yml`) ```yaml 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) | --- ## Dependencie