# 家园
一个用于你的 Minecraft 服务器的插件，允许用户创建家园
## 功能
这个插件允许你：
- 每个玩家最多创建 90 个家园
- 删除自定义家园
- 使用酷炫的粒子导航到家园
- 在其他维度和/或世界中创建家园
- 重命名家园
- 所有功能都基于 GUI
- ...
## 权限：
- homes.create | 创建家园
- homes.use | 使用 GUI 功能
- homes.teleport | 使用传送功能
- homes.navigate | 使用导航功能
- homes.admin | 用于其他信息，例如版本控制等
## 指令：
- /addhomes [名称] | 使用自定义名称添加家园
- /homes | 打开主 GUI，包含所有功能
- /rename [名称] | 重命名现有的家园
- /addperm [权限] [数量] | 为具有特定权限的用户设置家园数量
- /reloadmessages | 从消息配置文件重新加载消息
- /reloadperms | 从权限配置文件重新加载权限
## 数据 & 数据库配置
- 通过配置文件或 SQL 数据库保存家园
```
homes:
Example1:
X: '174.78694353928665'
Y: '65.0'
Z: '-150.7085900761925'
world: 'world'
```
- 要使用数据库，只需在 database.yml 文件中添加 SQL 数据库中用户的登录凭据即可
- 只有当 enabled 设置为 "true" 时，数据库才会起作用
```
database:
enabled: 'true'
host: localhost
database: yourDatabase
user: yourUser
password: 'yourPassword'
```
家园也可以通过写入 config（当启用时）来添加，但可能会导致错误
## 消息配置
- 要编辑消息，只需编辑 messages.yml 文件
- 此插件还支持 [Kyori Adventure Mini-Message](https://docs.advntr.dev/minimessage/format.html) ( 标签在消息之前)
- 需要保留占位符
- 使用 /reloadmessages 重新加载配置
```
messages:
//Minimessage 示例
prefix: Homes |
//Normal 消息示例
home_no_space: §c你没有足够的空间添加更多的家园
```
## 选项配置
- 允许你更改最大家园数量、粒子效果等
```
options:
info: '所有可用粒子: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html'
particle:
enabled: 'true'
particle: FLAME
spawnDelay: '10'
navigation:
spacing: '0.5'
length: '5'
particle: SOUL_FIRE_FLAME
homes:
maxhomes: '99'
block: CYAN_BED
```
- 'maxhomes' 选项只会在禁用 permissions.yml 中的自定义权限数量时才会生效！
- 你可以将块更改为 1.21.1 中存在的任何其他块
## 权限配置
```
homes:
create: homes.create
use: homes.use
teleport: homes.teleport
navigate: homes.navigate
admin: homes.admin
permissions:
enabled: 'TRUE'
default: '40'
```
- 允许你更改权限。 在: 之后留空以使权限无效。
- 当 permissions.enabled 为 "FALSE" 时，将使用 options.yml 中自定义的 maxhomes 数量作为最大家园数。
- 你可以使用游戏中的 /addperm 指令添加新的权限。
[对于建议或错误，请在 GitHub 上的问题标签中创建一个问题！](https://github.com/pqtriick/Homes/issues)
如果你喜欢这个插件，请随意在 GitHub 上留下一个星标！