- 版权类型
- 转载
- 插件中文名
- 生物捕捉器
- 插件英文名
- creaturecatcher
- 支持的核心 [服务端]
- Folia
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# 生物捕捉器
**移动生物不该需要一艘船、两根拴绳，再搭上一小时的人生。**
右键点击生物，即可将它装入口袋；右键点击地面，它就会原样回归。
Minecraft 26.2 · Java 25 · 仅支持 Paper 及其分支，不支持 Spigot
---
在生存模式中，你一定熟悉这种情况：在距离基地 300 格外发现了一个拥有优质交易的村民，于是不得不铺设一条矿车轨道；想把马匹带到新基地，只能让它乘船、一步步横渡海洋；重建农场后，还得牵着九头牛来回奔波，而苦力怕正在一旁虎视眈眈。
CreatureCatcher 只需两次点击，即可解决这一切。
## 玩家可以用它做什么？
- **迁移交易大厅**：无需铺设任何铁轨，村民的职业、等级和全部交易都会完整保留。
- **一次搬走整个农场**：不必分九趟牵运九头牛。
- **带上自己的宠物**：已驯服的狼仍会保持驯服状态，且主人不会改变。
- **收藏稀有生物**：例如哞菇、粉色绵羊，或属性恰到好处的马匹。
- **亲手打造动物园**：展示亲自捕捉的生物，而不是依赖刷怪蛋。
- **救出误入险境的生物**：不必眼睁睁看着它们溺水或消失。
## 放出的是真正的原生物，而不只是同类复制品
这正是捕捉插件最关键的部分。若一只生物被放出后满血、没有名字，村民交易列表也被清空，那么它就不再是玩家原本捕捉的那一只。
CreatureCatcher 会保留以下全部数据：
- 生命值、年龄以及是否为幼体
- 自定义名称
- 盔甲、武器及其附魔
- 村民职业、等级、经验值和完整交易列表
- 羊驼的箱子及其中全部物品
- 鞍、项圈颜色、马匹花纹、熊猫基因和鱼类花纹
- 驯服者信息
- 当前生效的药水效果
- 其他插件附加到该生物上的数据
捕捉器物品还会准确告知玩家其中装着什么。物品 Lore 会根据生物本身自动生成：捕捉到的村民会显示职业和交易数量，而奶牛等生物则不会出现这些无关条目。
## 功能特性
### 捕捉器
- 一个物品，两种状态；无需携带第二件道具，也不会占用额外背包空间。
- 可自定义材质、名称、Lore 和附魔光效。
- 完整支持资源包，包括现代物品模型和自定义模型数据。
- 也可以让装有生物的捕捉器显示对应的刷怪蛋外观，让每次捕捉都自动呈现不同样式。
- 可选耐久／次数机制：可无限使用，也可在达到指定使用次数后损坏。
### 控制可捕捉的生物
- 可通过黑名单或白名单限制任意生物类型。
- 可一键保护 Boss、已驯服宠物、村民、命名生物和幼体。
- 默认禁止捕捉其他玩家的宠物，避免利用插件偷宠物。
- 支持按生物类型单独设置权限，例如某个等级可捕捉马匹，另一个等级可捕捉村民。
- 捕捉与释放可分别设置冷却时间。
- 可要求玩家潜行才能捕捉，避免误将自己的马装进捕捉器。
### 自定义体验
- 捕捉和释放时的音效与粒子效果均可配置。
- Lore 模板支持使用所有生物详细信息占位符。
- 可选合成配方，支持有序与无序合成，并会自动在配方书中解锁。
- 也可通过命令发放捕捉器，适用于宝箱奖励、投票奖励、任务奖励和等级特权。
### 全部文本均可翻译
- 内置英语和巴西葡萄牙语。
- 可自行添加任意语言文件，甚至可翻译生物名称和单独词汇。
- 未完成的翻译会自动回退至英语，不会向玩家显示原始语言键名。
- 插件更新不会覆盖你的语言文件。
### 开发者支持
- 提供可取消的捕捉与释放事件，方便其他插件添加任务条件、消耗或限制。
## 命令
| 命令 | 说明 |
|---|---|
| `/cc give <player> [amount] [charges]` | 向玩家发放捕捉器。 |
| `/cc reload` | 重新读取配置文件和语言文件。 |
| `/cc inspect` | 查看捕捉器内保存的生物，以及该捕捉器是否真实有效。 |
| `/cc ledger` | 查看当前仍以捕捉器形式存在于世界中的生物数量。 |
别名：`/creaturecatcher`、`/catcher`
## 权限
| 权限节点 | 默认权限 | 说明 |
|---|---:|---|
| `creaturecatcher.use` | 所有人 | 使用捕捉器。 |
| `creaturecatcher.capture` | 所有人 | 将生物捕捉进捕捉器。 |
| `creaturecatcher.release` | 所有人 | 从捕捉器中释放生物。 |
| `creaturecatcher.mob.<type>` | 所有人 | 在启用按生物类型控制权限时，允许捕捉指定生物类型。 |
| `creaturecatcher.command.give` | OP | 发放捕捉器。 |
| `creaturecatcher.command.reload` | OP | 重载配置文件和语言文件。 |
| `creaturecatcher.command.inspect` | OP | 检查手持的捕捉器。 |
| `creaturecatcher.command.ledger` | OP | 查看并清理未释放的捕捉记录。 |
| `creaturecatcher.bypass.cooldown` | OP | 忽略冷却时间。 |
| `creaturecatcher.bypass.owner` | OP | 捕捉其他玩家驯服的宠物。 |
| `creaturecatcher.bypass.protection` | OP | 无视领地保护规则进行捕捉和释放。 |
| `creaturecatcher.bypass.rules` | OP | 忽略生物捕捉规则，但不会绕过针对其他玩家宠物的保护。 |
| `creaturecatcher.admin` | OP | 获得全部命令和全部绕过权限。 |
每项功能均使用独立权限节点。你可以将特定生物的捕捉权限绑定至不同等级，也可以让普通玩家只能捕捉，而将释放权限保留给管理人员。
## 运行要求
需要 **Java 25**，以及 **Paper 26.2 或其任意分支服务端**。
- **支持：** Paper、Purpur、Pufferfish、Leaf，以及其他 Paper 分支。
- **不支持：** Spigot、CraftBukkit。
- **不支持 Folia。**
将生物数据完整保存至物品中依赖 Paper 及其分支提供的专用 API。只要使用的是 Paper 分支服务端即可正常运行；插件会在启动时进行检测，并在环境不兼容时明确提示。
[/MD]
# 生物捕捉器
**移动生物不该需要一艘船、两根拴绳，再搭上一小时的人生。**
右键点击生物，即可将它装入口袋；右键点击地面，它就会原样回归。
Minecraft 26.2 · Java 25 · 仅支持 Paper 及其分支，不支持 Spigot
---
在生存模式中，你一定熟悉这种情况：在距离基地 300 格外发现了一个拥有优质交易的村民，于是不得不铺设一条矿车轨道；想把马匹带到新基地，只能让它乘船、一步步横渡海洋；重建农场后，还得牵着九头牛来回奔波，而苦力怕正在一旁虎视眈眈。
CreatureCatcher 只需两次点击，即可解决这一切。
## 玩家可以用它做什么？
- **迁移交易大厅**：无需铺设任何铁轨，村民的职业、等级和全部交易都会完整保留。
- **一次搬走整个农场**：不必分九趟牵运九头牛。
- **带上自己的宠物**：已驯服的狼仍会保持驯服状态，且主人不会改变。
- **收藏稀有生物**：例如哞菇、粉色绵羊，或属性恰到好处的马匹。
- **亲手打造动物园**：展示亲自捕捉的生物，而不是依赖刷怪蛋。
- **救出误入险境的生物**：不必眼睁睁看着它们溺水或消失。
## 放出的是真正的原生物，而不只是同类复制品
这正是捕捉插件最关键的部分。若一只生物被放出后满血、没有名字，村民交易列表也被清空，那么它就不再是玩家原本捕捉的那一只。
CreatureCatcher 会保留以下全部数据：
- 生命值、年龄以及是否为幼体
- 自定义名称
- 盔甲、武器及其附魔
- 村民职业、等级、经验值和完整交易列表
- 羊驼的箱子及其中全部物品
- 鞍、项圈颜色、马匹花纹、熊猫基因和鱼类花纹
- 驯服者信息
- 当前生效的药水效果
- 其他插件附加到该生物上的数据
捕捉器物品还会准确告知玩家其中装着什么。物品 Lore 会根据生物本身自动生成：捕捉到的村民会显示职业和交易数量，而奶牛等生物则不会出现这些无关条目。
## 功能特性
### 捕捉器
- 一个物品，两种状态；无需携带第二件道具，也不会占用额外背包空间。
- 可自定义材质、名称、Lore 和附魔光效。
- 完整支持资源包，包括现代物品模型和自定义模型数据。
- 也可以让装有生物的捕捉器显示对应的刷怪蛋外观，让每次捕捉都自动呈现不同样式。
- 可选耐久／次数机制：可无限使用，也可在达到指定使用次数后损坏。
### 控制可捕捉的生物
- 可通过黑名单或白名单限制任意生物类型。
- 可一键保护 Boss、已驯服宠物、村民、命名生物和幼体。
- 默认禁止捕捉其他玩家的宠物，避免利用插件偷宠物。
- 支持按生物类型单独设置权限，例如某个等级可捕捉马匹，另一个等级可捕捉村民。
- 捕捉与释放可分别设置冷却时间。
- 可要求玩家潜行才能捕捉，避免误将自己的马装进捕捉器。
### 自定义体验
- 捕捉和释放时的音效与粒子效果均可配置。
- Lore 模板支持使用所有生物详细信息占位符。
- 可选合成配方，支持有序与无序合成，并会自动在配方书中解锁。
- 也可通过命令发放捕捉器，适用于宝箱奖励、投票奖励、任务奖励和等级特权。
### 全部文本均可翻译
- 内置英语和巴西葡萄牙语。
- 可自行添加任意语言文件，甚至可翻译生物名称和单独词汇。
- 未完成的翻译会自动回退至英语，不会向玩家显示原始语言键名。
- 插件更新不会覆盖你的语言文件。
### 开发者支持
- 提供可取消的捕捉与释放事件，方便其他插件添加任务条件、消耗或限制。
## 命令
| 命令 | 说明 |
|---|---|
| `/cc give <player> [amount] [charges]` | 向玩家发放捕捉器。 |
| `/cc reload` | 重新读取配置文件和语言文件。 |
| `/cc inspect` | 查看捕捉器内保存的生物，以及该捕捉器是否真实有效。 |
| `/cc ledger` | 查看当前仍以捕捉器形式存在于世界中的生物数量。 |
别名：`/creaturecatcher`、`/catcher`
## 权限
| 权限节点 | 默认权限 | 说明 |
|---|---:|---|
| `creaturecatcher.use` | 所有人 | 使用捕捉器。 |
| `creaturecatcher.capture` | 所有人 | 将生物捕捉进捕捉器。 |
| `creaturecatcher.release` | 所有人 | 从捕捉器中释放生物。 |
| `creaturecatcher.mob.<type>` | 所有人 | 在启用按生物类型控制权限时，允许捕捉指定生物类型。 |
| `creaturecatcher.command.give` | OP | 发放捕捉器。 |
| `creaturecatcher.command.reload` | OP | 重载配置文件和语言文件。 |
| `creaturecatcher.command.inspect` | OP | 检查手持的捕捉器。 |
| `creaturecatcher.command.ledger` | OP | 查看并清理未释放的捕捉记录。 |
| `creaturecatcher.bypass.cooldown` | OP | 忽略冷却时间。 |
| `creaturecatcher.bypass.owner` | OP | 捕捉其他玩家驯服的宠物。 |
| `creaturecatcher.bypass.protection` | OP | 无视领地保护规则进行捕捉和释放。 |
| `creaturecatcher.bypass.rules` | OP | 忽略生物捕捉规则，但不会绕过针对其他玩家宠物的保护。 |
| `creaturecatcher.admin` | OP | 获得全部命令和全部绕过权限。 |
每项功能均使用独立权限节点。你可以将特定生物的捕捉权限绑定至不同等级，也可以让普通玩家只能捕捉，而将释放权限保留给管理人员。
## 运行要求
需要 **Java 25**，以及 **Paper 26.2 或其任意分支服务端**。
- **支持：** Paper、Purpur、Pufferfish、Leaf，以及其他 Paper 分支。
- **不支持：** Spigot、CraftBukkit。
- **不支持 Folia。**
将生物数据完整保存至物品中依赖 Paper 及其分支提供的专用 API。只要使用的是 Paper 分支服务端即可正常运行；插件会在启动时进行检测，并在环境不兼容时明确提示。
[/MD]