## ***这是什么附加程序?***
这是一个 [SimplePets](https://modrinth.com/plugin/simplepets) 附加程序,允许服务器所有者/管理员使用自定义 Residence 旗帜,以便对宠物在某些区域进行限制。
## ***插件/资源链接:***
* [SimplePets](https://modrinth.com/plugin/simplepets) ***(必需)***
* [Residence](https://www.spigotmc.org/resources/11480/) ***(必需)*** `(至少 v5.0.1.6)`
## ***它有哪些功能?***
* 新旗帜 `"allow-pet-spawn"`
- 当玩家尝试生成宠物时使用
(默认设置为允许)
* 新旗帜 `"allow-pet-enter"`
- 当宠物尝试进入区域时使用
(默认设置为允许)
* 新旗帜 `"allow-pet-mounting"`
- 当玩家尝试骑乘宠物时使用
(默认设置为允许)
* 新旗帜 `"allow-pet-riding"`
- 当玩家尝试在区域内骑乘宠物时使用
(默认设置为允许)
## ***如何安装:***
附加程序可以通过多种方式安装,可以通过安装命令、GUI 安装器或手动安装。
### ***通过命令安装:*** (最简单)
* 简单地输入 *`/pet addon install Residence`* 命令
它还会尝试加载和启用它
### ***通过 GUI 安装器:***
* 运行 *`/pet addon`* 命令
* 点击 GUI 底行中的 *`安装附加程序`* 项目
* 在 GUI 中找到 *`Residence`* 项目
* 找到后只需点击它
***注意:*** 如果卡在“安装中...”状态,请检查控制台是否有任何错误。如果没有,请尝试其他方法。
### ***手动安装:***
* 打开 SimplePets 插件文件夹
* 打开 *`Addons`* 文件夹
(如果该文件夹不存在,只需创建一个)
* 从下载位置之一下载附加程序
* 将附加程序的 jar 文件放入 *`Addons`* 文件夹
* 重启您的服务器(以实际将附加程序加载到插件中)
## ***默认配置:***
```yaml
# 应该将旁路权限设置为什么?
bypass-permission: pet.residence.bypass
checks:
spawning:
flag:
# 宠物在住宅中生成时应该将旗帜命名为?
name: 'allow-pet-spawn'
# 旗帜的默认值应该是什么?
default-value: true
# 附加程序是否应该在宠物生成时检查?
enabled: true
# 此消息仅在您悬停在“宠物未能生成”消息上时可见
# 如果您想要没有消息,则可以将其留空或设置为“null”
reason: '&c您的宠物无法在此区域生成'
mounting:
flag:
# 宠物在住宅中骑乘时应该将旗帜命名为?
name: 'allow-pet-mounting'
# 旗帜的默认值应该是什么?
default-value: true
# 附加程序是否应该在玩家骑乘宠物时检查?
enabled: true
# 是否应该移除宠物或者仅仅取消?
remove-pet: true
moving:
flag:
# 宠物在住宅中行走时应该将旗帜命名为?
name: 'allow-pet-enter'
# 旗帜的默认值应该是什么?
default-value: true
# 附加程序是否应该在宠物移动时检查?
enabled: true
# 是否应该移除宠物或者仅仅取消?
remove-pet: true
riding:
flag:
# 宠物的所有者在住宅中骑乘宠物时应该将旗帜命名为?
name: 'allow-pet-riding'
# 旗帜的默认值应该是什么?
default-value: true
# 附加程序是否应该在宠物的拥有者骑乘它时检查?
enabled: true
# 是否应该移除宠物或者仅仅取消?
remove-pet: true
# 是否应该卸载玩家(如果 remove-pet 设置为 true,则忽略此项)?
dismount: true
```