Back to Editor

MCPets 创造与魔法宠物系统 - 功能清单

Markdown Document
Reading time about 3 minutes

MCPets 创造与魔法宠物系统 - 功能清单

一、系统概述

基于MCPets插件深度定制，融入《创造与魔法》游戏核心玩法，打造完整的宠物养成体验。

核心特性：

  • 宠物资质系统（影响成长潜力）
  • 宠物融合系统（合成更强宠物）
  • 宠物捕捉系统（击晕→喂食→捕获）
  • 宠物进阶系统（1阶~6阶提升）
  • 独立经验系统（喂食/打怪/挖矿升级）
  • 全GUI可视化管理（无需编辑配置文件）

二、功能模块

1. 宠物经验系统

特点：经验完全独立，只有召唤出来的宠物才能获得经验

经验来源 说明
喂食升级饲料 对召唤的宠物使用升级饲料
击杀怪物 主人击杀MythicMobs怪物
挖矿 通过指令触发（配合MM矿石怪）

配置示例：

Level:
  # 全局经验倍率
  ExpMultiplier: 1.0

  # 怪物击杀经验
  MobKillExp:
    SmallMob: 2500      # 小怪
    LargeMob: 5000      # 精英
    Boss: 10000         # BOSS

2. 饲料系统

两种饲料类型：

类型 用途 使用方式
捕捉饲料 驯服野生宠物 对昏迷的野生宠物喂食
升级饲料 提升宠物等级 对召唤的宠物喂食

配置示例：

# 捕捉饲料
CaptureFoods:
  cooked_meat:
    Material: "COOKED_BEEF"
    Name: "&6熟肉"
    TamingValue: 10           # 驯服值

# 升级饲料
LevelUpFoods:
  pet_food:
    Material: "WHEAT"
    Name: "&e宠物粮"
    Experience: 1000          # 经验值

GUI管理：/mcpets admin food 可视化添加/编辑饲料

3. 资质系统

每只宠物拥有四项资质，决定成长潜力：

资质 影响
生命资质 每级HP成长
攻击资质 每级攻击成长
防御资质 每级防御成长
魔攻资质 每级魔攻成长

品质等级：

品质 颜色 资质范围
普通 灰色 0~20%
优秀 绿色 20~40%
精良 蓝色 40~60%
卓越 紫色 60~80%
传奇 橙色 80~100%

4. 捕捉系统

捕捉流程：

击晕野生宠物 → 喂食饲料 → 好感度满 → 使用捕捉器

配置示例：

Capture:
  StunDuration: 60            # 昏迷持续60秒
  MaxFeedInterval: 3.0        # 喂食间隔不超过3秒

5. 融合系统

两只宠物合成新宠物，有变异概率。

融合公式：

新宠物资质 = 主宠物×60% + 副宠物×40% + 随机浮动

配置示例：

Fusion:
  MainPetWeight: 0.6          # 主宠权重60%
  SubPetWeight: 0.4           # 副宠权重40%
  RandomFluctuation: 0.05     # ±5%浮动

6. 进阶系统

宠物可进阶1~6阶，提升属性和等级上限。

阶数 碎片 进阶石 等级上限+
1阶 30 0 +5
2阶 50 10 +5
3阶 0 15 +5
4阶 0 20 +5
5阶 0 30 +5
6阶 0 35 +5

三、GUI界面

管理员界面

功能 命令 说明
管理主菜单 /mcpets admin 所有管理功能入口
饲料管理 /mcpets admin food 添加/编辑/删除饲料
经验配置 /mcpets admin exp 调整经验参数
融合配方 /mcpets admin fusion 编辑融合配方
进阶材料 /mcpets admin materials 管理进阶材料

玩家界面

功能 命令 说明
宠物菜单 /pet 宠物主菜单
喂食界面 /mcpets feed 选择饲料喂食
融合界面 /mcpets fusion 宠物融合
进阶界面 /mcpets advance 宠物进阶

喂食界面预览：

┌─────────────────────────────────┐
│         喂食 - 皎晶白虎          │
├─────────────────────────────────┤
│  [宠物头像]   等级: 25/55        │
│              经验: 1200/2500     │
│              ████████░░ 48%     │
├─────────────────────────────────┤
│  可用饲料:                       │
│  [宠物粮×50] [高级粮×10] [...]   │
├─────────────────────────────────┤
│       [一键喂食]  [关闭]         │
└─────────────────────────────────┘

四、指令列表

玩家指令

指令 说明
/pet 打开宠物菜单
/mcpets feed 打开喂食界面
/mcpets fusion 打开融合界面
/mcpets advance 打开进阶界面

管理员指令

指令 说明
/mcpets admin 管理员菜单
/mcpets exp add <玩家> <经验> 给宠物加经验
/mcpets exp mining <玩家> <经验> 触发挖矿经验
/mcpets food give <玩家> <ID> <数量> 给予饲料
/mcpets reload 重载配置

五、配置文件结构

plugins/MCPets/
├── config.yml              # 主配置 (GUI可编辑)
├── Food/
│   └── foods.yml           # 饲料库 (GUI可编辑)
├── Fusion/
│   └── recipes.yml         # 融合配方 (GUI可编辑)
├── Pets/
│   └── *.yml               # 宠物定义
└── data/
    └── ...                 # 玩家数据(自动生成)

所有核心配置都可通过GUI编辑，无需手动修改文件！

六、与MythicMobs配合

怪物经验触发

在MM怪物配置中添加标签：

GoblinWarrior:
  Type: ZOMBIE
  Options:
    Tags:
      - "small_mob"    # 小怪标签，击杀给2500经验

挖矿经验触发

在MM矿石怪物死亡时执行：

IronOreMonster:
  Skills:
    - command{c="mcpets exp mining <trigger.uuid> 500"} @trigger ~onDeath

七、亮点总结

特性 说明
全GUI管理 无需编辑配置文件，可视化操作
经验独立 只有召唤的宠物才能升级
双饲料系统 捕捉饲料+升级饲料，功能分离
自定义物品支持 支持ItemsAdder/Nexo物品
本地存储 无需MySQL，YAML文件存储
MM深度集成 完美配合MythicMobs使用

文档版本: v1.0

📋 Document Outline