安装与配置

跟着下面的步骤操作，3 分钟就能让你的服务器用上 MyPets！

📥 安装步骤

graph LR
    A[下载 jar 文件] --> B[放入 plugins 文件夹]
    B --> C[重启服务器]
    C --> D[自动生成配置文件]
    D --> E[修改配置 /mp reload]

第 1 步：下载插件

把 MyPets-1.0.0.jar 文件下载到你的电脑上。

第 2 步：放入服务器

把 jar 文件拖进服务器的 plugins/ 文件夹里。就像装其他插件一样简单。

第 3 步：重启服务器

重启你的 Minecraft 服务器（或者用 /reload 命令）。

第 4 步：检查文件

首次启动后，插件会自动生成以下文件结构：

plugins/MyPets/               ← 插件主文件夹
├── config.yml                ← ⭐ 主配置文件（最常改的）
├── data/                     ← 🗄️ 玩家数据（不要手动改！）
│   ├── pets/                 ←   每只宠物的数据
│   └── farms/                ←   每个农场的数据
└── lang/                     ← 🌐 语言文件
    ├── zh_CN.json            ←   简体中文
    ├── zh_TW.json            ←   繁体中文
    ├── en_US.json            ←   英文
    ├── ja_JP.json            ←   日文
    └── ko_KR.json            ←   韩文

⚠️ 注意：data/ 文件夹里的文件是插件自动管理的，不要手动修改，否则可能导致数据丢失！

⚙️ 配置详解（`config.yml`）

配置文件里的每一项都是什么意思？下面给你逐个说明。

基础设置

language: "zh_CN"                  # 服务器默认语言
max_farms: 1                       # 每个玩家最多可以创建几个农场（基础版）
selection_tool: "WOODEN_SHOVEL"    # 选农场用的工具（默认木锹）
price_per_block: 0.2              # 高级版：每格方块收多少钱

max_farm_size_x: 20                # 农场最大能有多宽（X轴）
max_farm_size_y: 20                # 农场最高能有多高（Y轴）
max_farm_size_z: 20                # 农场最大能有多长（Z轴）

高级版功能开关

premium:
  enable_capture: false       # 🥚 宠物封印功能
  gui_chest: false            # 📦 保险箱 GUI（54格大箱子）
  farm_pricing: false         # 💰 农场按体积收费
  farm_heal: false            # ❤️ 农场内宠物自动回血
  gui_menu: false             # 📋 可点击的聊天菜单
  flags: false                # 🚩 农场权限 Flag
  leash_teleport: false       # 🧵 栓绳传送（高级版）
  ride_teleport: false        # 🏇 骑乘传送
  max_pets_per_farm: 10       # 每个农场最多养几只宠物
  max_farms: 3                # 高级版最多几个农场
  max_farm_size_x: 100        # 高级版最大宽度
  max_farm_size_y: 50         # 高级版最大高度
  max_farm_size_z: 100        # 高级版最大长度
  world_whitelist: []         # 世界白名单（哪些世界能用）
  world_whitelist_enabled: false  # 是否启用白名单

💡 怎么开启高级功能？ 把你想用的功能后面的 false 改成 true，然后输入 /mp reload 就行了。比如想开宠物封印，就改成 enable_capture: true。

🔄 重载配置

改完 config.yml 后，不用重启服务器，直接在游戏里输入：

/mp reload

配置就会立即生效，在线玩家也不会掉线。

🌐 世界白名单

这个功能可以限制插件只在某些世界生效。比如你只想让主世界能用 MyPets，下界和末地不能用：

/mp world add world           # 把主世界加入白名单
/mp world enable              # 启用白名单（其他世界就不能用了）

常用命令

命令	作用
`/mp world add <世界名>`	把这个世界加入白名单
`/mp world remove <世界名>`	从白名单移除
`/mp world list`	查看白名单里有哪些世界
`/mp world enable`	启用白名单（只允许列出的世界）
`/mp world disable`	禁用白名单（所有世界都能用）

💡 小技巧：启用白名单但列表为空时，插件在所有世界都能用。只有添加了世界且启用了白名单，才会限制生效。