- 版权类型
- 原创
- 插件中文名称
- RPT抓捕器
- 插件英文名称
- RptCapture
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- Folia
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 26.x
- 1.21
关于这个插件
RptCapture 只干一件事:把一只生物收走,之后再原样放出来。整个流程全部在界面里完成,玩家背包里不会多出任何物品 —— 没有抓捕球、没有捕捉蛋、没有任何道具。界面点两下,瞄准,点击,收工。
| 步骤 | 操作 |
| 抓捕 | /rptcp 打开界面 → 点「抓捕生物」→ 界面关闭,进入 5 秒瞄准 → 右键点击一只生物 → 抓走 |
| 放出 | /rptcp 打开界面 → 点「放出生物」→ 界面关闭,进入 5 秒瞄准 → 右键点击地面 → 放回 |
功能说明
1. 每名玩家一个抓捕位
- 每个玩家同一时刻只能抓着一只生物。
- 抓捕位已满时,界面上「抓捕」按钮点了也会被拦下并提示「先放出里面的生物」。
- 这是从源头限制单人囤积 —— 想抓第二只,必须先把第一只放掉或者处理掉。
2. 5 秒瞄准状态
- 点「抓捕」或「放出」后,界面立刻关闭,聊天栏提示进入瞄准状态,限时 5 秒(
config.yml可调)。 - 5 秒内点中目标即执行;超时自动解除,不会留下半吊子状态。
- 瞄准状态只存在内存里,服务器重启不会残留。
3. 抓捕
- 瞄准状态下右键点击一只生物即可抓捕。
- 「右键」会拦截掉原版交互:对着村民右键不会被弹交易界面,对着动物右键不会被喂食 —— 保证点到就是抓。
- 抓捕成功后,世界里的那只生物会被收起(原地消失),它的完整数据被存进插件。
- 抓捕后 5 秒冷却(
config.yml可调),防止手抖连点。
4. 放出
- 瞄准状态下右键点击地面即可放出。
- 生成位置会自动向下寻找可站立的地面(默认最多 6 格,
config.yml可调),点悬空方块面也不会把生物卡在半空。 - 放出来的是原来那一只 —— 见下方「生物数据保留」。
5. 生物数据完整保留(不碰 NMS)
这是本插件最核心的一点:抓到的生物不是"重建一个同类",而是原封不动地存起来再还原。
- 用的是 Paper/Folia 官方标准接口
Entity#getAsString()与EntityFactory#createEntitySnapshot(...),
完全没有使用 NMS,跨版本由服务端负责,版本升级不会因为包名/方法名变动而报废。 - 能保留的数据包括:血量、自定义名字、装备与手持物、颜色与体型变体、幼年/成年状态、驯服状态、村民的职业与交易等级、美西螈/猫/马/羊驼等各类变体、药水效果、骑乘与鞍具等。
- 存进去的是一整串结构化的生物数据,存在插件目录里 —— 服务器重启后依然能放出来。
6. 禁止抓捕的生物
默认禁止:末影龙、监守者、凋灵。玩家天然不可被抓捕(无需配置)。
名单可在
config.yml 的 blocked-types 里自由增删。7. 内置中文生物名
服务端读不到客户端的语言包,默认展示名都是英文(如Zombified Piglin)。本插件内置了一份 100+ 生物类型的简体中文名对照表,界面与提示里显示的一律是中文:猪、牛、羊、苦力怕、末影人、监守者、凋灵、末影龙……表里没有的类型自动回退为英文枚举名的美化形式。8. 数据持久化
- 用
plugins/RptCapture/players.yml每玩家一条记录(UUID + 生物类型 + 完整数据串)。 - 卸载 / 关服时在异步线程落盘,纯数据写入,不碰实体,不会卡在区域线程上。
- 备份 = 复制
players.yml。
9. 界面
/rptcp 打开界面(3 行):
代码:
■ ■ ■ ■ ■ ■ ■ ■ ■
■ 抓捕 ■ 抓捕位状态 ■ 放出 ■
■ ■ ■ ■ ■ ■ ■ ■ ■
- 中间是抓捕位状态格:空时显示灰色染料「抓捕位 · 空」,已抓时显示「抓捕位 · 已抓 XX」。
- 左侧「抓捕生物」(粘液球),右侧「放出生物」(鸡蛋);抓捕位为空时放出按钮显示为禁用态(灰染料)。
- 界面里所有点击与拖拽都被拦下,图标一个也拿不走;这个界面只做开关和状态展示,不会真的给你任何物品。
- ★ 界面的全部文案都在独立文件
gui.yml里(不与运行规则混在一起),标题、图标、lore 全部可改,支持 MiniMessage 颜色。
支持版本与环境
| 项目 | 说明 |
| Minecraft 版本 | 1.21 ~ 26.2(同一个 jar 跨版本,字节码目标 Java 21;api-version 为 1.21) |
| 服务端核心 | Paper、Folia(已声明 folia-supported: true);Purpur 等 Paper 系核心同样可用 |
| Java 运行环境 | Java 21 及以上 |
| 前置插件 | 无。一个都不需要 |
| 资源包 | 不需要 |
| 数据库 | 无外部依赖,使用本地 YAML(players.yml) |
| 编译基线 | dev.folia:folia-api:26.2.build.1-beta |
目标用户
- 想让玩家搬运生物但不能刷的服主 —— 抓一只放一只,一个萝卜一个坑,天然限量。
- 不想让玩家背包多出杂物的服主 —— 全程界面操作,抓捕道具一件都不发。
- 需要"原样搬运"特定个体的服主 —— 村民交易等级、驯服宠物、命名生物,搬过去还是原来那只。
- 正在用 Folia 核心的服主 —— 抓捕、放出、落盘全部走正确的线程,不会踩区域归属问题。
是否付费
完全免费。 不需要授权、不需要联网校验,下载即用。- 插件不含任何联网校验、授权服务器或机器绑定,安装即用,离线环境照常运行。
- 不区分免费版 / 高级版,所有功能全开。
- 插件未做任何混淆,欢迎安全审查。
获取作者帮助
| 途径 | 内容 |
| 交流群 | QQ 群 1124248111 |
| 作者 QQ | 2221899680 |
| 游戏内 | 输入 /rptcp help 查看全部指令与说明 |
使用教程
安装
- 把
RptCapture-1.0.0.jar放进服务端plugins/目录。 - 重启服务端(换 jar / 新装插件不支持热加载)。
- 首次启动会生成
plugins/RptCapture/下的config.yml(运行规则)+gui.yml(界面)+players.yml(数据)。 - 改完
config.yml或gui.yml执行/rptcp reload生效,不需要重启服务端。 - 开箱即用:所有玩家默认就能用(
rptcp.use默认开启),不需要额外授权。
指令列表
| 指令 | 权限 | 说明 |
/rptcp | rptcp.use | 打开抓捕器界面 |
/rptcp help | 免权限 | 显示指令帮助 |
/rptcp reload | rptcp.admin | 重载 config.yml 与 gui.yml |
权限节点
| 权限 | 默认值 | 说明 |
rptcp.use | 所有玩家 | 能打开界面并使用抓捕 / 放出 |
rptcp.admin | 仅 OP | 重载配置 |
主要配置项
config.yml(运行规则)| 配置项 | 默认值 | 说明 |
aim-seconds | 5 | 点按钮后进入瞄准状态的持续秒数,超时自动解除 |
capture-cooldown-seconds | 5 | 两次抓捕之间的冷却秒数,0 = 不冷却 |
blocked-types | 末影龙 / 监守者 / 凋灵 | 禁止抓捕的生物类型(Bukkit EntityType 名,全大写) |
release-fall-search | 6 | 放出时向下寻找可站立地面的最大格数,0 = 不寻找 |
sounds-enabled | true | 抓捕 / 放出成功时是否播放音效 |
gui.yml(界面)| 配置项 | 默认值 | 说明 |
main.title / main.rows | 见默认文件 | 界面标题与行数(1~6) |
main.status-slot / status-empty / status-filled | 见默认文件 | 抓捕位状态格的槽位与两种文案 |
main.capture-button / release-button / release-button-empty | 见默认文件 | 抓捕、放出、放出(禁用态)三个按钮的槽位、图标与文案 |
main.filler | 灰玻璃板 | 填充物 |
messages.* | 见默认文件 | 全部聊天提示文案,支持 MiniMessage 颜色 |
常见问题
- 玩家会拿到抓捕道具吗? 不会。 全程界面操作,插件从头发到尾没给玩家发过任何物品,背包里也不会多出任何东西。
- 抓走的生物去哪了? 存在插件目录的数据文件里(
players.yml),完整保留了它原来的一切数据。世界里的那只已经消失,放出来的是还原出来的同一只。 - 能保证是"原来那一只"吗? 能。血量、名字、装备、变体、驯服状态、村民交易等数据全部随生物一起存取;没有使用 NMS,走的是服务端官方接口,跨版本稳定。
- 为什么只能抓一只? 这是设计:每名玩家一个抓捕位,从源头限制囤积。想抓新的,先把手里那只放掉。
- 末影龙 / 监守者 / 凋灵能抓吗? 默认不能,
config.yml里可以改。 - 能抓玩家吗? 不能,玩家天然被排除在外。
- 抓捕有没有成功率? 没有,点中即抓,不做概率判定。
- 瞄准时点空了怎么办? 5 秒后自动解除,什么也不会发生,界面随时可以重新打开。
- 生物名称是英文? 插件内置了中文对照表,界面与提示显示的是中文名(猪、苦力怕、监守者……)。
- 需要资源包吗?会和我的材质包冲突吗? 不需要,也不会冲突 —— 插件一个贴图文件都不带。
- 需要装前置吗? 不需要,一个都不用。
- 支持 Folia 吗? 支持,
folia-supported: true。 - 数据在哪、怎么备份?
plugins/RptCapture/players.yml,复制该文件即可备份全部抓捕位记录。 - 为什么我打开界面点不动? 正常情况下所有玩家都能用。如果你服里用权限插件手动收窄过
rptcp.use,检查一下这个玩家是不是被关掉了。
声明
- 本插件为原创作品,保留所有权利,默认不允许转载与整合。如需转载或整合进服务端整合包,请先通过上方交流群或作者 QQ 联系获取授权。
- 本插件未使用任何混淆手段,欢迎安全审查。
- 本插件不含任何后门、病毒或远程控制代码,不含任何联网校验,不收集任何玩家数据,所有数据仅保存在服务器本地
plugins/RptCapture/目录中。