RptHideArmor —— 头盔/胸甲/护腿/靴子逐部位隐身的护甲外观插件，零依赖零资源包 [1.21 ~ 2...

R***

关于这个插件​RptHideArmor 只干一件事：把玩家身上不想被看到的护甲藏起来。
四个部位各给一个开关 —— 头盔 / 胸甲 / 护腿 / 靴子，想藏哪个藏哪个，也可以四个全藏。玩家点一下，别人屏幕上那件护甲立刻消失，露出皮肤。
关键点：它只改画面。

改	别人屏幕上的护甲外观、玩家自己按 F5 时看到的外观
不改	护甲值、盔甲韧性、附魔、耐久、任何原版结算

也就是说：隐藏 ≠ 脱掉。藏起来之后防御一样算、附魔一样生效、装备一点没动，只是"看不见"。玩家背包里那件护甲也还在原位，你可以随时点回来。


功能说明​1. 逐部位隐藏​

• 界面里四个按钮，分别对应头盔 / 胸甲 / 护腿 / 靴子。
• 每个按钮自己一个状态：绿玻璃 = 显示中（点一下隐藏）、灰玻璃 = 已隐藏（点一下恢复）。
• 四个部位互不影响，可以任意组合。
  

2. 点一下立刻生效，不用重进​

• 点击后当场刷新：周围玩家（含你自己）立刻看不到那件护甲，不用退出重进、不用换世界。
• 之后无论穿脱装备 / 换世界 / 死亡重生 / 进出服务器，隐藏状态都会自动重新应用。
• 另外还有一层兜底刷新（默认每 10 tick 一次，可在 config.yml 调）：专门补上「刚走进视野的玩家」这种没有事件可监听的漏网情况。
  

3. 自己按 F5 也是隐藏后的样子​装备包本来只影响"世界里的实体渲染"。本插件连自己那一份也一起发，所以玩家按 F5 看自己，同样是隐藏后的外观 —— 不会出现"别人看不到、自己还能看到"的错位。
4. 界面​/rptha 打开界面（3 行）：
[size=1.2]代码：
■ ■ ■ ■ ■ ■ ■ ■ ■ ■  ■  ■  ■ ■ 头盔 ■ 胸部 ■ 护腿 ■ 靴子 ■■ ■ ■ ■ 返回 ■ ■ ■ ■ ■  ■  ■

• 四个部位按钮，悬停能看到当前状态和下一步操作。
• 底部中间是**「返回 / 关闭」**（箭矢），点一下关掉。
• 界面里所有点击与拖拽都被拦下，图标拿不走 —— 这个界面只负责开关，不会真的动你的装备。
• ★ 界面的全部配置都在独立文件 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

本插件使用 Paper 系独有 API（PlayerArmorChangeEvent、Player#sendEquipmentChange、Entity#getTrackedBy），只能在 Paper 系核心上运行，Spigot / 原版 CraftBukkit 不支持。

目标用户​

• 想给玩家"脱掉外观"自由的服主 —— 不想因为穿了统一配发的护甲，就把皮肤挡得严严实实。
• 做外观展示 / 时装服的服主 —— 隐藏护甲后露出皮肤，配时装插件正好。
• 拍摄 / 录制用途的服主 —— 需要干净的人物外观时，一键把护甲藏干净，属性还照常。
• 正在用 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	rptha.use	打开盔甲外观界面
/rptha menu	rptha.use	同上
/rptha help	免权限	显示指令帮助
/rptha reload	rptha.admin	重载 config.yml 与 gui.yml

主指令为 /rptha，别名 /hidearmor。

权限节点​

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

权限	默认值	说明
rptha.use	所有玩家	能打开界面并使用四个部位的隐藏开关
rptha.admin	仅 OP	重载配置

主要配置项​

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

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/ 目录中。