? CrazyHomes
以时尚的方式管理你的家——现代 GUI、可配置的 VIP 布局、零延迟。
CrazyHomes 用现代化的 4 行图形界面(GUI) 取代了旧版的基于文本的 /sethome 系统。VIP 玩家拥有更多的家园槽位,而普通玩家的家园在 GUI 中会自动居中显示。所有内容均可通过 gui.yml 进行自定义,无需修改源代码。
✨ 特性
? 命令
| 命令 |
权限 |
描述 |
/home |
crazyhomes.use |
打开家园 GUI |
/home set <n> |
crazyhomes.sethome |
通过聊天设置第 n 个家园 |
/home del <n> |
crazyhomes.delhome |
删除第 n 个家园 |
/home tp <n> |
crazyhomes.teleport |
传送到第 n 个家园 |
/home reload |
crazyhomes.reload |
重载插件配置 |
? 权限
| 权限 |
默认值 |
描述 |
crazyhomes.use |
true |
允许访问 /home |
crazyhomes.sethome |
true |
允许设置家园 |
crazyhomes.delhome |
true |
允许删除家园 |
crazyhomes.teleport |
true |
允许传送到家园 |
crazyhomes.reload |
op |
允许重载插件 |
crazyhomes.vip |
false |
授予额外的家园槽位 |
? GUI 布局
GUI 是一个 9×4 的背包。布局定义在 gui.yml 中。
默认布局(5 个家园)
[■][■][■][■][■][■][■][■][■] ← 边框
[ ][ ][?][?][?][?][?][ ][ ] ← 床
[ ][ ][?][?][?][?][?][ ][ ] ← 染色剂
[■][■][■][■][■][■][■][■][■] ← 边框
VIP 布局(9 个家园)
[■][■][■][■][■][■][■][■][■] ← 边框
[?][?][?][?][?][?][?][?][?] ← 床
[?][?][?][?][?][?][?][?][?] ← 染色剂
[■][■][■][■][■][■][■][■][■] ← 边框
你可以通过编辑以下内容自由移动每个槽位:
gui.yml
└── layouts
├── default
└── vip
无需更改代码。
⚙️ 快速配置 (config.yml)
max-homes-default: 5 # 普通玩家的家园槽位数
max-homes-vip: 9 # VIP 玩家的家园槽位数
teleport:
delay: 3 # 传送前的秒数
cancel-on-move: true # 如果玩家移动则取消传送
sounds:
gui-open: BLOCK_CHEST_OPEN
home-set: ENTITY_EXPERIENCE_ORB_PICKUP
teleport: ENTITY_ENDERMAN_TELEPORT
delete: BLOCK_ANVIL_USE
error: ENTITY_VILLAGER_NO
? 安装
- 下载 CrazyHomes-x.x.x.jar。
- 将其放入服务器的 plugins/ 文件夹中。
- (可选) 如果需要占位符支持,请安装 PlaceholderAPI。
- 启动服务器。配置文件将自动生成。
- 自定义
config.yml 和 gui.yml。
- 运行
/home reload 以在不重启服务器的情况下重载配置。
? 兼容性
支持的服务器软件
| 软件 |
Minecraft 版本 |
状态 |
| Paper |
1.20.4 · 1.20.5 · 1.20.6 |
✅ 完全支持 |
| Folia |
1.20.4 · 1.20.5 · 1.20.6 |
✅ 原生区域调度 |
| Purpur |
1.20.4 · 1.20.5 · 1.20.6 |
✅ 完全兼容 (Paper 分支) |
| Spigot |
— |
❌ 不支持 (需要 Paper API) |
| Bukkit |
— |
❌ 不支持 |
| Forge / Fabric |
— |
❌ Bukkit 插件,不是模组 |
⚠️ CrazyHomes 需要 Paper 或其分支之一。
该插件使用了原生的 Paper API,如 Adventure API、Folia 区域调度和现代文本组件,这些在 vanilla Spigot 上不可用。
系统要求
| 组件 |
最低版本 |
| Java |
17 (已测试至 Java 21) |
| 推荐内存 |
无明显开销 (~51 KB JAR 包,采用轻量级 YAML 存储) |
依赖项
| 插件 |
类型 |
版本 |
| PlaceholderAPI |
可选 |
2.11+ |
? PlaceholderAPI 完全是可选的。
CrazyHomes 在没有它的情况下也能完美运行。如果未安装 PlaceholderAPI,占位符将被忽略。
? 许可证
© 2025 Dragon_45_ — 保留所有权利。
未经作者事先书面许可,严禁未经授权地复制、重新分发、修改或商业使用此插件。
❤️ Made with love by Dragon_45_
? 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
- Download CrazyHomes-x.x.x.jar.
- Place it inside your server's plugins/ folder.
- (Optional) Install PlaceholderAPI if you want placeholder support.
- Start your server. Configuration files will be generated automatically.
- Customize
config.yml and gui.yml.
- 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_
评论 0
登录后参与评分
还没有评论,来抢沙发吧