MinePal: 革新性的Minecraft宠物系统 | A Revolutionary Minecraft Pet System
项目总结 | Project Summary
MinePal是一款高度集成的Minecraft宠物插件，基于Spigot 1.21构建，深度整合了MythicMobs的AI系统。该插件通过添加自定义AI扩展，实现了智能化的宠物行为控制，为服务器玩家提供了身临其境的宠物体验。
MinePal is a highly integrated Minecraft pet plugin built for Spigot 1.21, deeply integrating MythicMobs' AI system. This plugin implements intelligent pet behavior control through custom AI extensions, providing an immersive pet experience for server players.


兼容自定义任何MythicMobs怪物配置
兼容自定义任何ModelEngine模型配置












当前开发状态 | Current Development Status
当前版本已完成以下核心功能：

• ✅ 完整的AI系统扩展

• ✅ 宠物基础控制系统

• ✅ 强大的宠物保护机制

• ✅ 精确的宠物生命周期管理

• ✅ 基础命令系统

Current version has completed the following core features:

• ✅ Complete AI system extension

• ✅ Basic pet control system

• ✅ Powerful pet protection mechanism

• ✅ Precise pet lifecycle management

• ✅ Basic command system

正在开发中的功能：

• ⬜ 宠物数据持久化

• ⬜ 命令处理系统优化

• ⬜ 配置系统增强

Features under development:

• ⬜ Pet data persistence

• ⬜ Command processing system optimization

• ⬜ Configuration system enhancement

核心特性 | Core Features
1. 智能AI系统 | Intelligent AI System
MinePal的宠物AI系统充分利用MythicMobs强大的AI框架，同时添加了自定义扩展，实现了以下功能：

• 目标识别与追踪：宠物能够识别主人的攻击目标并协助战斗

• 自动保护主人：当主人受到攻击时，宠物会自动保护主人

• 智能跟随：高效的路径寻找算法，确保宠物不会卡住或迷路

MinePal's pet AI system fully utilizes MythicMobs' powerful AI framework while adding custom extensions to achieve:

• Target recognition and tracking: Pets can identify owner's attack targets and assist in combat

• Automatic owner protection: When the owner is attacked, pets automatically protect them

• Intelligent following: Efficient pathfinding algorithms ensure pets don't get stuck or lost

2. 完善的宠物保护系统 | Comprehensive Pet Protection System
为确保宠物安全，MinePal实现了全面的保护机制：

• 主宠互动保护：防止主人误伤宠物，宠物也不会攻击主人

• 环境伤害保护：可配置保护宠物免受环境伤害（如摔落、火焰等）

• 药水效果保护：主人的负面药水效果不会影响宠物

To ensure pet safety, MinePal implements comprehensive protection mechanisms:

• Owner-pet interaction protection: Prevents owners from accidentally harming pets, and pets won't attack owners

• Environmental damage protection: Configurable protection from environmental damage (falls, fire, etc.)

• Potion effect protection: Owner's negative potion effects won't affect pets

3. 生命周期管理 | Lifecycle Management
MinePal具有完善的宠物生命周期管理：

• 主人离线处理：主人离线时，宠物会自动安全移除

• 服务器重载兼容：服务器重载时宠物数据不会丢失（持久化功能开发中）

• 战斗状态跟踪：智能记录和分析战斗状态，优化宠物行为

MinePal features comprehensive pet lifecycle management:

• Owner offline handling: Pets are automatically and safely removed when owners go offline

• Server reload compatibility: Pet data won't be lost during server reloads (persistence feature in development)

• Combat state tracking: Intelligently records and analyzes combat states to optimize pet behavior

未来规划 | Future Plans
v1.1.0 (即将推出 | Coming Soon)

• 宠物数据持久化

• 宠物等级系统

• 宠物技能系统

v1.2.0 (规划中 | Planned)

• 宠物GUI管理界面

• 宠物商店系统

• 宠物皮肤系统

技术细节 | Technical Details
MinePal基于以下技术构建：

• Spigot API: 1.21版本

• MythicMobs API: 最新版本兼容

• Maven: 项目依赖管理

• YAML: 配置与数据存储

MinePal is built using:

• Spigot API: Version 1.21

• MythicMobs API: Compatible with latest version

• Maven: Project dependency management

• YAML: Configuration and data storage

安装与使用 | Installation & Usage
`命令召唤宠物" data-section-index="46" style="border-radius: 4px; margin: 6px 0px; position: relative; scroll-margin-bottom: 40px; scroll-margin-top: 40px; color: rgb(216, 222, 233); font-family: "Segoe WPC", "Segoe UI", "Microsoft YaHei", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(20, 20, 20); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">

1. 确保服务器安装了MythicMobs最新版本

1. 下载并放置MinePal.jar到plugins文件夹

1. 重启服务器或使用/reload

1. 使用/mp <宠物模板名>命令召唤宠物

` command to summon pets" data-section-index="47" style="border-radius: 4px; margin: 6px 0px; position: relative; scroll-margin-bottom: 40px; scroll-margin-top: 40px; color: rgb(216, 222, 233); font-family: "Segoe WPC", "Segoe UI", "Microsoft YaHei", sans-serif; font-size: 13px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(20, 20, 20); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">

1. Ensure your server has the latest MythicMobs installed

1. Download and place MinePal.jar in your plugins folder

1. Restart the server or use /reload

1. Use the /mp <pet template name> command to summon pets

结语 | Conclusion
MinePal旨在为Minecraft服务器提供一个功能全面、性能优异的宠物系统。该插件正在积极开发中，我们欢迎社区提供反馈和建议，以帮助我们打造最佳的Minecraft宠物体验！
MinePal aims to provide Minecraft servers with a comprehensive and high-performance pet system. This plugin is under active development, and we welcome community feedback and suggestions to help us create the best Minecraft pet experience!