MobCapture - 生物捕捉插件

MobCapture 是一款免费的生物捕捉插件，旨在为玩家提供 MobCatcher（完整版）的替代方案。通过投掷特定抛射物，你可以将生物转化为包含其完整数据的特殊刷怪蛋，并支持物品或经济等多种捕获成本。

💡基本信息

• 支持版本：Spigot 1.12.2、1.13.2、1.14（1.14 版本为 Alpha 阶段，仍在开发中）
• 核心功能：通过抛射物捕捉生物，将其转化为保存了所有数据的刷怪蛋
• 成本模式：支持物品消耗或经济支付（通过 Vault），可在配置中切换

✨主要特性

• 按类别捕捉：可分类捕捉生物（和平/敌对）或指定具体生物类型
• 多种抛射物：可配置捕捉使用的抛射物类型（雪球、箭、鸡蛋）
• 完整数据保存：保存生物状态，包括药水效果、驯服状态、猪的鞍具等
• 特殊抛射物：支持为抛射物设置独特的名称与描述（需启用 Require Unique）
• 经济支持：软依赖 Vault，支持经济扣款与物品消耗两种成本模式
• 生存刷怪蛋：捕捉后生成可在生存模式使用的刷怪蛋，并带有描述性文本
• 世界限制：可禁止在特定世界（如创造世界）内捕捉或释放生物
• 彩色刷怪蛋：可选是否让刷怪蛋颜色与生物种类对应
• 领地保护兼容：支持与 GriefPrevention、Towny（1.12）集成，防止在保护区内捕捉
• 权限控制：基于权限管理捕捉能力，支持通用权限与具体生物权限

🎮权限列表

• MobCapture.Admin：执行插件管理任务
• MobCapture.Catch.*：允许捕捉所有类型的生物
• MobCapture.Catch.Peaceful：允许捕捉和平生物
• MobCapture.Catch.Hostile：允许捕捉敌对生物
• MobCapture.NoCost：无需支付成本即可捕捉生物
• MobCapture.Catch.<MobName>：允许捕捉特定生物（如 MobCapture.Catch.COW）

> 提示：具体生物名称列表请查看 此链接。

🔧命令列表

• /MobCapture version：显示插件当前版本
• /MobCapture update：检查更新，若有新版本会提供资源链接
• /MobCapture reload：重载配置文件
• /MobCapture regenconfig：重新生成并重载配置文件
• /MobCapture spawn：生成一个特殊的捕捉用抛射物（需启用 Require Unique）

⭐配置文件示例

# 用于捕捉生物的抛射物类型
Projectile Catcher: EGG

# 成本模式：[ NONE, ITEM, VAULT ]
Cost Mode: ITEM

# ITEM 模式下，玩家需拥有此物品才能捕捉
Cost Item: REDSTONE
Cost Amount: 1

# VAULT 模式下，玩家需拥有至少此金额
Cost Vault: 100

# 在这些世界中无法捕捉或释放生物
Disabled Worlds:
  - creative_world

# 刷怪蛋是否根据生物类型着色
Colored Eggs: true

# 是否启用 Towny 集成
Towny Hook: false

# 是否启用 GriefPrevention 集成
GriefPrevention Hook: false

# 是否要求抛射物包含特定元数据（名称、描述）
Require Unique: false

# 当 Require Unique 启用时，/mobcapture spawn 生成的抛射物将具有以下属性
Unique Display Name: '&6Mob Catcher'
Unique Lore:
  - '&3Shoot a mob with me!'

❓开发者 API

如果你是插件开发者，可以监听以下事件来扩展功能

• 捕捉事件：CreatureCaptureEvent(Player captor, Location target)
• 释放事件：CreatureReleaseEvent(Player user, Location target)

🔧待实现功能

• 可配置的成功捕捉概率
• 投掷鸡蛋捕捉时不会生成小鸡
• 独特的抛射物系统
• Towny 兼容性（1.13 版本）
• GriefPrevention 兼容性
• 近战捕捉模式
• 同时支持物品与经济扣款的成本模式（BOTH）
• 对刷怪笼使用刷怪蛋
• 可配置的刷怪蛋显示名称与描述

💡重要说明

• 本插件仅适用于构建时对应的 Spigot/CraftBukkit 版本，请根据你的服务器版本选择正确的构建。
• 目前提供 1.12.2、1.13.2 和 1.14 版本的构建。
• 若遇到问题，请在讨论区反馈而非评分区，我们会尽力协助。请务必注明你使用的 Spigot 版本以及问题的详细描述。

开源地址：本项目已在 GitHub 开源，你可以在此查看源码：GitHub 仓库