RptCapture —— 全GUI操作的生物抓捕器 · 每名玩家一个抓捕位 · 完整保留生物数据 [1.21 ~ 26.2]

原创 工具 娱乐 RptCapture —— 全GUI操作的生物抓捕器 · 每名玩家一个抓捕位 · 完整保留生物数据 [1.21 ~ 26.2] 1.0.0

完成注册/登录后下载
版权类型
原创
插件中文名称
RPT抓捕器
插件英文名称
RptCapture
原帖地址
#
支持的核心(服务端)
  1. Paper
  2. Folia
语言支持
中文(简体)
适配版本(Java)
  1. 26.x
  2. 1.21

关于这个插件​

RptCapture 只干一件事:把一只生物收走,之后再原样放出来。
整个流程全部在界面里完成,玩家背包里不会多出任何物品 —— 没有抓捕球、没有捕捉蛋、没有任何道具。界面点两下,瞄准,点击,收工。
6ca81416-b45f-46b1-b8a9-fe117d7e322c.webp


步骤操作
抓捕/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

⚠️ 本插件使用 Paper 系独有 API(Entity#getAsString()、Server#getEntityFactory()、Folia 区域调度器),只能在 Paper 系核心上运行,Spigot / 原版 CraftBukkit 不支持。

目标用户​

  • 想让玩家搬运生物但不能刷的服主 —— 抓一只放一只,一个萝卜一个坑,天然限量。
  • 不想让玩家背包多出杂物的服主 —— 全程界面操作,抓捕道具一件都不发。
  • 需要"原样搬运"特定个体的服主 —— 村民交易等级、驯服宠物、命名生物,搬过去还是原来那只。
  • 正在用 Folia 核心的服主 —— 抓捕、放出、落盘全部走正确的线程,不会踩区域归属问题。

是否付费​

完全免费。 不需要授权、不需要联网校验,下载即用。
  • 插件不含任何联网校验、授权服务器或机器绑定,安装即用,离线环境照常运行。
  • 不区分免费版 / 高级版,所有功能全开。
  • 插件未做任何混淆,欢迎安全审查。

获取作者帮助​

途径内容
交流群QQ 群 1124248111
作者 QQ2221899680
游戏内输入 /rptcp help 查看全部指令与说明

使用教程​

安装​

  1. 把 RptCapture-1.0.0.jar 放进服务端 plugins/ 目录。
  2. 重启服务端(换 jar / 新装插件不支持热加载)。
  3. 首次启动会生成 plugins/RptCapture/ 下的 config.yml(运行规则)+ gui.yml(界面)+ players.yml(数据)。
  4. 改完 config.yml 或 gui.yml 执行 /rptcp reload 生效,不需要重启服务端。
  5. 开箱即用:所有玩家默认就能用(rptcp.use 默认开启),不需要额外授权。
玩家最快的上手方式:/rptcp,点一下按钮,对着生物右键。

指令列表​


指令权限说明
/rptcprptcp.use打开抓捕器界面
/rptcp help免权限显示指令帮助
/rptcp reloadrptcp.admin重载 config.yml 与 gui.yml

主指令为 /rptcp,别名 /capture、/rptcapture。

权限节点​

本插件免费开放:功能权限 rptcp.use 默认所有玩家都有,装上即用,不需要额外配置。
如果只想给一部分人用,把 rptcp.use 的默认值在权限插件里收窄即可,例如 LuckPerms:
/lp group default permission set rptcp.use false

权限默认值说明
rptcp.use所有玩家能打开界面并使用抓捕 / 放出
rptcp.admin仅 OP重载配置

主要配置项​

运行规则看 config.yml,界面看 gui.yml —— 两个文件分开,互不混淆。
config.yml(运行规则)

配置项默认值说明
aim-seconds5点按钮后进入瞄准状态的持续秒数,超时自动解除
capture-cooldown-seconds5两次抓捕之间的冷却秒数,0 = 不冷却
blocked-types末影龙 / 监守者 / 凋灵禁止抓捕的生物类型(Bukkit EntityType 名,全大写)
release-fall-search6放出时向下寻找可站立地面的最大格数,0 = 不寻找
sounds-enabledtrue抓捕 / 放出成功时是否播放音效
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/ 目录中。
作者
RPT
下载
2
查看
74
首次发布
最后更新

评分

0.00 星 0 次评分

RPT 的其他资源

最新更新

  1. 1.0.1版本

    修复关服报错(插件已卸载时仍去注册调度任务)。关服落盘改为独立线程,绕开调度器。
后退
顶部 底部