动能军械

项目分离： 本模组是基于 KineticCore 构建的独立玩法扩展。KineticCore 是共享的基础 API 与基础设施层；本 README 中描述的实际玩法内容与功能实现均由本项目提供。

本扩展无法安全地合并到 KineticCore 或其他 Kinetic 项目中。它拥有独立的功能范围、依赖项、配置、发布周期和用户群体，因此将它们合并会导致不相关的玩法系统相互耦合，使安装与维护的灵活性降低。

必需依赖： KineticCore。

概述

KineticArmory 是面向整合包作者和服务器管理员的 Kinetic 盔甲套装与动态条件模组。它提供了完整的工作流程，涵盖盔甲套装定义、条件评估、效果执行、可视化编辑以及面向玩家的提示信息，同时使用 KineticCore 的配置、网络和 GUI API。

主要功能

• 可视化盔甲套装编辑器。
• 每个槽位支持多个装备变体，并具备 NBT 感知匹配。
• 件数加成层级。
• 支持 ANY / ALL / MIN / NOT 逻辑的动态谓词。
• 属性、药水效果、攻击修正、免疫与伤害转换。
• 由盔甲套装激活/停用触发的命令。
• 全局与按套装的实体过滤。
• 为非玩家生物实体提供盔甲套装支持。
• 基于真实服务器配置自动生成的提示信息。
• 服务器权威的盔甲评估与配置持久化。
• 可选的 KubeJS 盔甲套装变更事件。

配置

config/kineticcore/armorsets.toml
config/kineticcore/armorsets_client.toml
config/kineticcore/armorsets/

 

需求

• Java 17
• KineticCore：必需
• Curios：必需
• KubeJS：可选

功能参考

配置详情

项目	描述
盔甲套装设置	服务器拥有的全局盔甲套装行为。此页面仅对本地安装或集成服务器可用。
general	控制盔甲套装检测、药水刷新频率和重载同步。
盔甲套装客户端偏好	此客户端的本地提示信息偏好。这些设置不会修改所连接的服务器。
盔甲套装可视化编辑器	通过经过认证的服务器编辑器管理盔甲套装 JSON 文件和实体规则。
打开盔甲套装编辑器	请求当前服务器快照并打开可视化编辑器。需要管理员权限等级 2。
启用盔甲套装	启用或禁用自定义盔甲套装检测与加成逻辑。
检查间隔（秒）	装备状态检查之间的时间间隔，最小为 0.05 秒。
强制同步	管理员重载时是否将数据同步给所有在线玩家。
提示快捷键	按住以显示盔甲套装详情的默认按键：shift、ctrl、alt 或无。

GUI 与编辑器

项目	描述
编辑套装命令	提示：以 / 开头将静默执行命令，不带 / 则作为玩家聊天发送
mode	白名单：仅左侧添加的实体才会进行盔甲套装检查。 黑名单：左侧添加的实体会跳过盔甲套装检查。
set toggle	启用时，此盔甲套装仅对左侧添加的生物生效。 禁用时，实体类型不受限制。
实体规则	全局盔甲套装实体规则 当前模式：%s 点击后先读取当前服务器配置，然后打开实体菜单。 玩家始终被允许，并绕过全局实体过滤器。
黑名单模式	过滤模式 黑名单：左侧的实体无法激活盔甲套装效果；所有其他实体均被允许。 玩家始终被允许，并忽略此列表。 左键单击：切换到白名单模式。 空白黑名单：不限制任何非玩家实体。
白名单模式	过滤模式 白名单：仅左侧的实体可以激活盔甲套装效果。 玩家始终被允许，无需列出。 左键单击：切换到黑名单模式。 空白白名单：阻止所有非玩家实体激活盔甲套装。
enabled	按套装实体限制 启用：此盔甲套装仅对左侧列出的实体生效。 玩家仍须满足此套装的玩家限制与装备要求。 左键单击：禁用此套装的实体限制。 空白列表：此套装不会对任何非玩家实体生效。
disabled	按套装实体限制 禁用：此套装不执行额外的按套装实体列表检查。 它仍受总开关和全局实体规则的限制。 左键单击：启用限制，仅允许左侧列出的实体。
save global	保存全局实体规则 将当前过滤模式和实体列表保存到服务器配置。 过滤缓存将立即重建并同步。
save set	保存套装实体规则 保存此套装的实体限制开关与允许的实体列表。 按套装实体列表始终使用白名单语义。
back	返回 不会保存此界面上未保存的更改。
Remove All	移除当前结果 仅移除左侧面板当前搜索结果中的实体。 未被当前搜索匹配的实体不受影响。
Add All	添加当前结果 将右侧面板当前搜索结果中的所有实体添加到规则列表。 适用于通过名称、ID、@mod 或 #tag 搜索进行批量选择。
Active Entities	盔甲套装生效实体 选择此盔甲套装可以影响的实体。 启用实体限制时，仅左侧的实体可以使用此套装的效果。 禁用时，不施加额外的实体类型限制，但总开关和全局规则仍然适用。
Rotation Speed	输入模型悬停旋转速度百分比，范围 0%-500%。0% 禁用旋转。
direction	点击切换实体模型旋转方向。数值字段仍控制旋转速度，范围 0%-500%。
mode	点击切换逻辑组合： [Match ANY] 若至少满足 1 个条件则激活。 [Match ALL] 仅当满足所有条件时激活。 [Match MIN X] 当满足的条件达到 X 个时激活。 💡 高级：使用反转创建“禁用规则” 结合 [NOT] 按钮实现逻辑反转！ 例如，如果你想要：“下雨且在水中时禁用飞行” 1. 将模式设置为：[Match ANY] 2. 添加条件：[NOT] 下雨 3. 添加条件：[NOT] 在水中 （德摩根定律：只要不在下雨 或 不处于水中，飞行就保持激活）

可编辑选项

• Curio
• Curio 槽位（扩展）
• 拒绝的 Curios（穿戴时阻止套装生效）
• 拒绝的 Curio 槽位
• 头盔槽位
• 胸甲槽位
• 护腿槽位
• 靴子槽位
• 主手
• 副手
• Match MIN %s
• Match MIN
• 白名单模式
• 黑名单模式
• 黑名单
• 白名单
• 过滤模式：黑名单
• 过滤模式：白名单
• Match ALL
• Match ANY
• 属性范围
• 晴朗天气
• 攀爬
• 白天
• 在维度中
• 经验等级范围
• 下落
• 饥饿值范围
• 生命值范围
• 在空中
• 在水中
• 月相
• 鼠标左键单击
• 鼠标左键按住
• 鼠标右键单击
• 鼠标右键按住
• 夜晚
• 站在方块上
• 着火
• 药水等级范围
• 下雨
• 上升
• 潜行
• 速度范围
• 游戏阶段
• 雷暴
• 时间范围
• %s %s
• 未选择

配置默认值

键	默认值
armorsets.defaultTipKey	"shift"
armorsets.enableSets	true
armorsets.entityFilterMode	"BLACKLIST"
armorsets.potionRefreshInterval	20
armorsets.syncOnReload	true

数据路径

主要配置/数据路径：

• config/kineticcore/armorsets.toml
• config/kineticcore/armorsets/
• config/kineticcore/armorsets_client.toml

依赖项

模组 ID	关系
kineticcore	必需
curios	必需
kubejs	可选