- 版权类型
- 原创
- 插件中文名称
- RPT隐藏护甲
- 插件英文名称
- RptHideArmor
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- Folia
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 26.x
- 1.21
关于这个插件
RptHideArmor 只干一件事:把玩家身上不想被看到的护甲藏起来。四个部位各给一个开关 —— 头盔 / 胸甲 / 护腿 / 靴子,想藏哪个藏哪个,也可以四个全藏。玩家点一下,别人屏幕上那件护甲立刻消失,露出皮肤。
关键点:它只改画面。
| 别人屏幕上的护甲外观、玩家自己按 F5 时看到的外观 | |
| 护甲值、盔甲韧性、附魔、耐久、任何原版结算 |
也就是说:隐藏 ≠ 脱掉。藏起来之后防御一样算、附魔一样生效、装备一点没动,只是"看不见"。玩家背包里那件护甲也还在原位,你可以随时点回来。
功能说明
1. 逐部位隐藏
- 界面里四个按钮,分别对应头盔 / 胸甲 / 护腿 / 靴子。
- 每个按钮自己一个状态:绿玻璃 = 显示中(点一下隐藏)、灰玻璃 = 已隐藏(点一下恢复)。
- 四个部位互不影响,可以任意组合。
2. 点一下立刻生效,不用重进
- 点击后当场刷新:周围玩家(含你自己)立刻看不到那件护甲,不用退出重进、不用换世界。
- 之后无论穿脱装备 / 换世界 / 死亡重生 / 进出服务器,隐藏状态都会自动重新应用。
- 另外还有一层兜底刷新(默认每 10 tick 一次,可在
config.yml调):专门补上「刚走进视野的玩家」这种没有事件可监听的漏网情况。
3. 自己按 F5 也是隐藏后的样子
装备包本来只影响"世界里的实体渲染"。本插件连自己那一份也一起发,所以玩家按 F5 看自己,同样是隐藏后的外观 —— 不会出现"别人看不到、自己还能看到"的错位。4. 界面
/rptha 打开界面(3 行):
代码:
■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■
■ 头盔 ■ 胸部 ■ 护腿 ■ 靴子 ■
■ ■ ■ ■ 返回 ■ ■ ■ ■ ■ ■ ■
- 四个部位按钮,悬停能看到当前状态和下一步操作。
- 底部中间是**「返回 / 关闭」**(箭矢),点一下关掉。
- 界面里所有点击与拖拽都被拦下,图标拿不走 —— 这个界面只负责开关,不会真的动你的装备。
- ★ 界面的全部配置都在独立文件
gui.yml里(不与运行规则混在一起):用字符矩阵(layout)画格子 —— 空格留空、#填充、A B C D分别对应四个部位按钮,decorations放固定装饰格。想换排版改字符串就行,不用碰代码。
5. 怎么实现的(为什么能做到零依赖)
插件给「正在追踪该玩家的客户端」发送一份改过的装备清单 —— 把要隐藏的槽位替换成空,仅此而已。- 用的是服务端标准的
Player#sendEquipmentChange,不引任何发包库(没有 PacketEvents、没有 ProtocolLib)。 - 客户端不用装任何东西,服务端也不需要任何前置插件。
- 不需要资源包,不会和服主的资源包打架。
- 玩家背包里的真装备从头到尾没被碰过,所以数据安全 —— 就算把插件删了,装备也还好好地穿在身上。
6. 数据持久化
- 用内嵌 SQLite(
plugins/RptHideArmor/hidearmor.db),不需要 MySQL,驱动已打进 jar。 - 每个玩家只存四个布尔开关,体积极小。
- 改设置只动内存、定时批量落库;关服在独立线程做阻塞收尾,不会卡在主线程。
- 备份 = 复制那个
.db文件。
支持版本与环境
| 项目 | 说明 |
| Minecraft 版本 | 1.21 ~ 26.2(同一个 jar 跨版本,字节码目标 Java 21;api-version 为 1.21) |
| 服务端核心 | Paper、Folia(已声明 folia-supported: true);Purpur 等 Paper 系核心同样可用 |
| Java 运行环境 | Java 21 及以上 |
| 前置插件 | 无。一个都不需要 |
| 资源包 | 不需要 |
| 数据库 | 无外部依赖,使用内嵌 SQLite,不需要 MySQL |
| 编译基线 | dev.folia:folia-api:26.2.build.1-beta |
目标用户
- 想给玩家"脱掉外观"自由的服主 —— 不想因为穿了统一配发的护甲,就把皮肤挡得严严实实。
- 做外观展示 / 时装服的服主 —— 隐藏护甲后露出皮肤,配时装插件正好。
- 拍摄 / 录制用途的服主 —— 需要干净的人物外观时,一键把护甲藏干净,属性还照常。
- 正在用 Folia 核心的服主 —— 所有实体操作都排在玩家自己的区域线程,不会踩线程归属问题。
是否付费
完全免费。 不需要授权、不需要联网校验,下载即用。- 插件不含任何联网校验、授权服务器或机器绑定,安装即用,离线环境照常运行。
- 不区分免费版 / 高级版,所有功能全开(四个部位自由开关 + 界面配置自定义)。
- 插件未做任何混淆,欢迎安全审查。
获取作者帮助
| 途径 | 内容 |
| 交流群 | QQ 群 1124248111 |
| 作者 QQ | 2221899680 |
| 游戏内 | 输入 /rptha help 查看全部指令与说明 |
使用教程
安装
- 把
RptHideArmor-1.0.0.jar放进服务端plugins/目录。 - 重启服务端(换 jar / 新装插件不支持热加载)。
- 首次启动会生成
plugins/RptHideArmor/下的config.yml(运行规则)+gui.yml(界面)+hidearmor.db(数据)。 - 改完
config.yml或gui.yml执行/rptha reload生效,不需要重启服务端。 - 开箱即用:所有玩家默认就能用(
rptha.use默认开启),不需要额外授权。
指令列表
| 指令 | 权限 | 说明 |
/rptha | rptha.use | 打开盔甲外观界面 |
/rptha menu | rptha.use | 同上 |
/rptha help | 免权限 | 显示指令帮助 |
/rptha reload | rptha.admin | 重载 config.yml 与 gui.yml |
权限节点
| 权限 | 默认值 | 说明 |
rptha.use | 所有玩家 | 能打开界面并使用四个部位的隐藏开关 |
rptha.admin | 仅 OP | 重载配置 |
主要配置项
config.yml(运行规则)| 配置项 | 默认值 | 说明 |
storage.database-file | hidearmor.db | SQLite 数据文件名 |
armor.refresh-interval-ticks | 10 | 兜底刷新间隔(tick,20 tick = 1 秒):每隔这么久把"该隐藏的部位"重新对追踪者发一次假装备。0 = 关闭兜底(只靠事件驱动,穿脱装备 / 进服 / 换世界仍会刷新) |
messages.* | 见默认文件 | 全部提示文案(前缀、各部位开关提示、无权限提示等),支持 MiniMessage 颜色 |
gui.yml(界面)| 配置项 | 配置项 | 说明 |
title | 见默认文件 | 界面标题 |
rows | 3 | 界面行数 1~6(每行 9 格) |
layout | 见默认文件 | 界面排布(字符矩阵):空格 / . 留空、# 填充、其它字符对应 decorations.<键>.symbol |
filler | 白玻璃板 | 填充物(enabled / material / name) |
decorations.<键> | 见默认文件 | 按钮:symbol(对应 layout 字符)、action、以及 material / name / lore。部位开关还各有一套 -on / -off(显示中 / 已隐藏)文案与图标 |
部位开关的动作名(
decorations.<键>.action):| action | 说明 |
toggle-head | 切换头盔外观 |
toggle-chest | 切换胸甲外观 |
toggle-legs | 切换护腿外观 |
toggle-feet | 切换靴子外观 |
close | 关闭界面 |
常见问题
- 隐藏之后属性会掉吗? 不会。 护甲值、盔甲韧性、附魔、耐久全部原版照常结算。隐藏只是"不给客户端看",服务器侧的真装备一点没动。
- 会不会把装备弄丢? 不会。界面里所有点击和拖拽都被拦下,插件从头到尾不搬动背包里的任何物品。
- 别人看不到,我自己还能看到吗? 不能 —— 自己那一份也一起发了,按 F5 看自己同样是隐藏后的样子。
- 隐藏期间换装备 / 换世界 / 死一次会失效吗? 不会,都会自动重新应用。另有每 10 tick 的兜底刷新补漏。
- 背包界面里为什么还能看到我的护甲? 因为背包走的是容器数据包,显示的是真实物品 —— 那正是"真装备没被碰过"的证明。隐藏只影响世界中的人物渲染。
- 为什么别人刚走进视野时可能有一瞬间看到护甲? 那是兜底刷新还没轮到他(默认最多 10 tick,约半秒)。嫌慢就把
armor.refresh-interval-ticks调小,代价是发包稍多。 - 需要资源包吗?会和我的材质包冲突吗? 不需要,也不会冲突 —— 插件一个贴图文件都不带。
- 需要装前置吗? 不需要,一个都不用。
- 支持 Folia 吗? 支持,
folia-supported: true。 - 能隐藏其他插件(ItemsAdder / CraftEngine 等)做的自定义护甲吗? 能。隐藏是"把这一格发成空",跟这件护甲长什么样、来自哪个插件无关。
- 数据在哪、怎么备份?
plugins/RptHideArmor/hidearmor.db,复制该文件即可备份全部开关状态。 - 为什么我打开界面点不动? 正常情况下所有玩家都能用。如果你服里用权限插件手动收窄过
rptha.use,检查一下这个玩家是不是被关掉了。
声明
- 本插件为原创作品,保留所有权利,默认不允许转载与整合。如需转载或整合进服务端整合包,请先通过上方交流群或作者 QQ 联系获取授权。
- 本插件未使用任何混淆手段,欢迎安全审查。
- 本插件不含任何后门、病毒或远程控制代码,不含任何联网校验,不收集任何玩家数据,所有数据仅保存在服务器本地
plugins/RptHideArmor/目录中。