SimplePets - 宠物插件

💡SimplePets 简介

SimplePets 是一款功能强大的宠物插件，允许玩家通过指令获取、管理和自定义各种宠物。它提供了丰富的宠物类型、自定义模型、宠物技能和交互功能，旨在为服务器增添趣味性和互动性。

🎮核心功能

宠物系统

• 支持多种宠物类型，包括自定义模型宠物。
• 宠物拥有独立的生命值、等级和技能系统。
• 宠物可以跟随、停留、攻击目标或保护主人。
• 提供宠物重命名、染色和装备自定义功能。

指令与权限

• 使用 /pet 或 /pets 作为主指令打开宠物菜单或管理宠物。
• 常用指令示例：
• /pet give <玩家> <宠物类型> [数量] - 给予玩家指定宠物。
• /pet menu - 打开宠物选择菜单。
• /pet call - 召唤或召回宠物。
• /pet rename <名称> - 为宠物重命名。
• /pet skill - 打开宠物技能菜单。
• 权限节点示例：
• simplepets.command.pet - 允许使用基础 /pet 指令。
• simplepets.command.pet.give - 允许使用给予宠物指令。
• simplepets.pet.<宠物类型> - 允许使用特定类型的宠物。

配置与自定义

• 通过配置文件可调整宠物属性、技能效果和菜单布局。
• 支持 PlaceholderAPI，可在其他插件中显示宠物信息。
• 可自定义宠物模型（需配合 ModelEngine 等资源包或模型插件）。
• 设置宠物经验获取方式、升级所需经验及等级奖励。

🔧安装与依赖

环境要求

• Minecraft 版本: 1.16.x 至 1.20.x（请以官方发布页为准）。
• 服务器核心: Spigot、Paper 或其衍生核心（推荐 Paper 以获得最佳性能）。

必要依赖

• 必须安装:
• ModelEngine (若使用自定义模型宠物)。
• 推荐安装:
• PlaceholderAPI (用于变量扩展)。
• Vault (用于经济系统集成)。
• 可选依赖:
• WorldGuard (用于区域保护兼容)。
• MythicMobs (用于高级宠物技能集成)。

安装步骤

• 将 SimplePets.jar 放入服务器的 plugins 文件夹。
• 重启服务器以生成配置文件和文件夹。
• 根据需求编辑 config.yml、pets.yml 等配置文件。
• 重载配置文件可使用 /pet reload（需对应权限）或重启服务器。

❓常见问题

宠物不显示或模型错误

• 确保已正确安装 ModelEngine 并放置了模型资源包。
• 检查宠物配置中的模型名称是否与 ModelEngine 中的模型标识符一致。
• 确认服务器资源包已正确加载，或玩家已下载所需资源包。

指令无权限或无效

• 检查玩家是否拥有对应指令的权限节点。
• 确认插件已成功加载，无报错信息。
• 尝试使用 /pet reload 重载配置，或查看服务器日志获取错误详情。

如何添加新宠物

• 在 pets.yml 中复制现有宠物配置模板。
• 修改 type、displayname、model（如适用）等字段。
• 设置宠物的基础属性、技能和获取方式。
• 保存文件并使用 /pet reload 重载。

⭐注意事项

• 使用自定义模型时，请确保模型文件兼容服务器和客户端的版本。
• 定期备份宠物数据文件（位于 plugins/SimplePets/data/），防止数据丢失。
• 大量宠物同时活动可能对服务器性能产生影响，建议在配置中调整宠物AI更新间隔。
• 详细配置说明与更新日志请查阅官方 Wiki：https://randomtomato.gitbook.io/simplepets/