# HomeSweetHome 🏠
**您的 Minecraft 服务器终极家庭管理插件！**
HomeSweetHome 为玩家提供一套全面且直观的家庭系统，具有现代化的 GUI 界面、安全措施和广泛的管理员控制。无论您运行小型生存服务器还是大型多人网络，此插件都能根据您的需求进行扩展。
## ✨ 主要功能
### 🏡 **玩家指令**
- **`/home`** - 传送到您的默认家园或打开 GUI
- **`/home <名称>`** - 传送到特定的家园
- **`/sethome <名称>`** - 在您当前的位置设置新的家园
- **`/delhome <名称>`** - 删除现有的家园
- **`/homes`** - 列出您的所有家园
- **`/bed`** - 快速传送到您的出生点
- **`/homegui`** - 打开漂亮的图形化界面
### 🎮 **直观的 GUI 界面**
- **顶部有床图标**，可快速传送至出生点
- **视觉家园图标**，易于导航
- **右键单击删除**家园并确认
- **分页支持**，方便拥有众多家园的玩家
- **基于您偏好的自定义物品表示**
### ⏱️ **安全传送系统**
- **3 秒倒计时**传送前
- **移动取消** - 倒计时期间移动将取消传送
- **伤害取消** - 受到伤害将取消传送
- **安全位置检查**，以防止窒息
- **可配置的传送冷却时间**
- **音效**和视觉反馈
### 🔧 **管理员控制**
- **`/homeadmin tp <玩家> <家园>`** - 传送到任何玩家的家园
- **`/homeadmin list <玩家>`** - 查看其他玩家的家园
- **`/homeadmin delete <玩家> <家园>`** - 删除玩家家园
- **`/homeadmin reload`** - 在不重启服务器的情况下重新加载配置
- **`/homeadmin info <玩家>`** - 显示玩家家园统计信息
### 📊 **灵活配置**
- **可配置的家园上限** (默认：每位玩家 6 个家园)
- **基于权限的限制** - 授予不同组不同的数量
- **无限家园**供操作者和特定权限使用
- **世界限制** - 禁用特定世界中的家园
- **可定制的消息**和 GUI 元素
- **经济系统集成**支持 (可选)
### 🗃️ **有组织的存储**
- **清晰的文件夹结构**，便于服务器管理
- **单个玩家文件**，用于有组织的存储
- **SQLite 数据库选项**，适用于高性能服务器
- **自动备份**，防止数据丢失
- **易于在不同存储类型之间进行数据迁移**
## 🛡️ **权限系统**
### 玩家权限
- `homesweethome.home` - 使用家园指令
- `homesweethome.sethome` - 设置家园位置
- `homesweethome.bed` - 使用出生点传送
- `homesweethome.gui` - 访问家园 GUI
- `homesweethome.unlimited` - 无限家园
- `homesweethome.homes.<数字>` - 具体的家园限制 (5, 10, 25, 等等)
### 管理员权限
- `homesweethome.admin.*` - 所有管理员权限
- `homesweethome.admin.tp` - 传送到其他玩家的家园
- `homesweethome.admin.delete` - 删除其他玩家的家园
- `homesweethome.admin.bypass.cooldown` - 跳过传送冷却时间
## ⚙️ **配置亮点**
```yaml
settings:
teleport-delay: 3 # 倒计时秒数
teleport-cooldown: 5 # 传送之间的冷却时间
default-max-homes: 6 # 默认家园限制
cancel-on-move: true # 移动时取消
cancel-on-damage: true # 受到伤害时取消
safe-teleport: true # 安全检查
```
## 🔌 **集成支持**
- **Vault** - 经济系统集成，用于付费传送/家园
- **WorldGuard** - 区域兼容性和限制
- **PlaceholderAPI** - 用于其他插件的自定义占位符
- **多个存储后端** - YAML 文件或 SQLite 数据库
## 📋 **要求**
- **Minecraft 版本：** 1.16+
- **服务器软件：** Bukkit, Spigot, Paper (推荐)
- **Java 版本：** 11+
- **可选依赖项：** Vault, WorldGuard, PlaceholderAPI
## 🚀 **为什么选择 HomeSweetHome?**
- **用户友好** - 直观的命令和漂亮的 GUI 界面
- **高度可配置** - 定制一切以适应您的服务器
- **性能优化** - 异步操作和高效的数据处理
- **管理员友好** - 全面的管理工具和权限
- **安全可靠** - 内置的安全检查和数据备份系统
- **现代代码库** - 干净、可维护的代码，遵循最佳实践
---
**立即使用 HomeSweetHome 转换您的服务器家园系统！** 🏡✨