MobCatcher Lite - 生物捕捉器轻量版

MobCatcher 允许玩家捕捉生物并获得对应的刷怪蛋，便于交易、运输生物，甚至跨世界传送。它支持自定义捕捉物品、可配置的生物类型和捕捉成本，为各种生物赋予了新的经济价值。通过独立的 .dat 文件保存和读取生物数据，你可以捕捉并重新生成带颜色的绵羊、幼年动物、已驯服的狼等。快来你的服务器上试试吧！

💡核心特性

• 可配置的生物捕捉：允许管理员设置哪些生物可以被捕捉。
• 完整的生物数据保存（完整版）：将生物的颜色、年龄、健康值等数据保存到对应的刷怪蛋中。
• 刷怪笼数据兼容（完整版）：被修改的刷怪笼会使用 MobCatcher 保存的数据生成生物。
• 物品描述信息：刷怪蛋的 Lore 会显示其包含的生物信息。
• 领地保护兼容：尊重 Towny 区域保护。
• 生存模式获取刷怪蛋：无需创造模式即可获得刷怪蛋。
• 可投掷的刷怪蛋：刷怪蛋可以像普通物品一样被投掷出去。
• 可配置的捕捉物品：包括直接手持物品捕捉和发射物捕捉。
• 按生物类型配置成本（完整版）：为每种生物单独设置捕捉所需的物品或经济成本。
• 告示牌生物保护：通过放置告示牌来保护区域内的生物不被捕捉。
• Vault 经济支持（完整版）：与 Vault 经济插件集成，支持货币支付。
• 百分比捕捉成功率：捕捉并非总是成功，可设置概率。
• 发射器增强：发射器可以高速射出刷怪蛋。

🎮使用方法

捕捉生物非常简单：手持配置好的捕捉物品（默认是鸡蛋），左键点击你想要捕捉的生物即可。

命令列表

• /mobc - 显示所有命令的用法。
• /mobc item - 显示当前设置的捕捉物品。
• /mobc clean - 清除一个刷怪蛋物品堆中的数据。
• /mobc projectiles - 显示当前的发射物捕捉设置。
• /mobc settings [生物类型] - 显示指定生物类型的设置。
• /mobc worlds - 显示 MobCatcher 在哪些世界启用。
• /mobc area - 显示玩家所在位置受多少个保护告示牌影响。
• /mobc resetsigndata - 删除所有已保存的告示牌数据。

🔧权限节点

所有 mobcatcher.catch 相关节点的默认值均为 true，你需要通过设置为 false 来取消权限。如有任何关于权限的疑问，请通过私信或页面评论联系作者。

管理员权限 (mobcatcher.op.*)

• 默认: op
• 子权限:

- `mobcatcher.op.catchchance`： 捕捉成功率始终为 100%。

- `mobcatcher.op.free`： 所有捕捉行为免费。

- `mobcatcher.op.sign`： 允许破坏任何所有者的保护告示牌、重置数据库，并绕过告示牌数量和半径限制。

- `mobcatcher.op.ignoreprotection`： 无视区域保护、所有者或刷怪笼设置，捕捉任何生物。

- `mobcatcher.op.ignoreconfig`： 允许捕捉配置文件中禁用的生物（仅基于权限判断）。

捕捉权限 (mobcatcher.catch.*)

• 默认: true
• 子权限:

- `mobcatcher.catch.peaceful.*`： 捕捉所有和平生物（默认 false，需单独开启子节点）。

- `mobcatcher.catch.hostile.*`： 捕捉所有敌对生物（默认 false，需单独开启子节点）。

和平生物子节点 (mobcatcher.catch.peaceful.*)

包括：mooshroom, pig, sheep, cow, chicken, squid, wolf, ocelot, villager, irongolem, snowgolem, bat, horse, rabbit, donkey, llama, mule, skeletonhorse, zombiehorse。

敌对生物子节点 (mobcatcher.catch.hostile.*)

包括：pigzombie, magmacube, cavespider, creeper, skeleton, spider, zombie, slime, ghast, enderman, silverfish, blaze, angrywolf, enderdragon, witch, witherskeleton, wither, endermite, guardian, elderguardian, shulker, husk, zombievillager, vindicator, evoker, vex, stray。

其他权限

• mobcatcher.sign： 允许放置保护告示牌（默认 true）。

❓配置文件详解

如果阅读后仍有疑问，欢迎私信作者。

多世界支持

在 PluginEnabled 部分，true 表示插件在该世界启用，false 表示禁用。注意：当服务器新增世界并重载后，配置文件会自动更新。

捕捉物品

• Capture item 字段用于配置玩家手持的捕捉物品，默认为鸡蛋。
• UsedOnCapture 默认为 true，表示捕捉时会消耗 1 个该物品。
• ReturnedOnSpawn 设置为 true 时，使用刷怪蛋后会返还该物品。
• 禁用 Capture 下的 Enabled 字段将意味着仅能使用发射物捕捉。
• 注意：所有物品名称字段仅用于提示，不影响实际功能。

发射物捕捉

• 默认只有鸡蛋 (chicken eggs) 可以用于发射物捕捉，将其他发射物（如雪球、箭）对应的字段改为 true 即可启用。
• 此设置与直接手持物品捕捉的设置完全独立。
• SpawnEggsDirectToInventory 默认为 false，表示通过发射物捕捉到的刷怪蛋会掉落在地面；设为 true 则会直接进入玩家背包。
• MissedEggsSpawnsChickens 定义鸡蛋击中方块时是否会生成小鸡。
• 注意：MobsMustBeKilled 设置同样适用于发射物捕捉。

铁傀儡保护村民

• IronGolemsProtectVillagersFromCaptures 默认为 true，玩家捕捉村民会激怒铁傀儡。设为 false 可避免此情况。
• 注意：使用非捕捉物品攻击村民仍会激怒铁傀儡。

效果与声音

• 默认启用捕捉效果，表现为全向烟雾和烈焰人发射的音效。

投掷刷怪蛋

• 将此选项设为 false 将禁用投掷刷怪蛋的功能。注意：存在可覆盖此设置的权限（默认 OP 拥有）。

发射器

• 启用后，发射器可以射出刷怪蛋并在落点生成生物，而非仅在发射器前方一格生成。
• power 字段是速度乘数：1 为正常速度，小于 1 会减速，大于 1 会加速。

消息提示

• 可在此部分禁用插件的捕捉成功或生成生物时的提示消息。

简单配置与复杂配置

通用设置项

• ItemName： 物品名称，仅作提示，不影响功能。
• ItemID： 成本物品的实际 ID。
• Amount： 每次捕捉消耗的物品数量。
• VaultCost： 每次捕捉消耗的金钱（需启用 Vault）。
• Chance： 捕捉成功的百分比概率。
• MustBeKilled： 设为 true 时，必须完全杀死生物才能捕捉（默认只需攻击一次）。

简单配置

• 此为默认配置，将生物简单分为和平与敌对两类进行管理，易于设置但灵活性较低。

复杂配置

• 将 ComplexConfig > Enabled 设为 true 以启用，它将完全覆盖简单配置。
• 允许为每一种生物进行独立的详细配置，提供最大灵活性。

Vault 经济

• 使用支持 Vault 的经济插件时，将 Vault 设为 true 以启用经济成本。
• 在每种生物的配置中修改 Vault Cost 字段来设定价格。
• 注意：物品成本仍然有效，如果不想消耗物品，需将其 Amount 设为 0，否则将同时消耗物品和金钱。

保护告示牌

• Default Radius： 默认保护半径（当玩家未指定或 PlayerSet Enabled 为 false 时使用）。
• PlayerSet Enabled： 设为 true 时，允许玩家自行设置半径。
• SignLimit： 单个玩家可放置的保护告示牌最大数量。
• MaxRadius： 玩家可设置的最大半径值。若玩家尝试设置超过此值的半径，将自动使用默认半径。
• 注意：这些设置对所有人生效。要为特定玩家设置允许捕捉的生物类型，请参考权限节点部分。

✨重要提示与兼容性

• 本插件在 BukkitDev 已有超过 18 万次下载，现首次发布于 SpigotMC。
• 喜欢 MobCatcher Lite？请购买完整版以解锁全部功能！
• 版本兼容性：MobCatcher 必须与对应版本的 CraftBukkit (CB) 一同使用。由于 Bukkit 的“安全防护”机制，每次服务端核心包版本更新都可能导致插件失效。请勿使用错误版本的插件。
• 错误排查：在提交问题报告前，请检查服务器控制台是否有巨大的红色错误信息。对于因版本错误导致的 ClassNotFoundException 等问题，将不予处理。
• 历史版本：需要旧版本请访问 BukkitDev 旧页面。
• 支持开发：如需进一步支持本插件的开发与维护，请考虑 购买完整版 或通过 Paypal 捐赠。