KineticCore 是 Kinetic 系列的核心基础模组。它负责公共 API、模块注册、统一配置中心、网络通信、压缩传输、通用 GUI 工具与命令扩展，同时保留一批适合直接放在核心中的基础机制与修复功能。

其他 Kinetic 附属模块会依赖 KineticCore 提供的基础设施，因此建议核心与附属模块使用匹配版本。

主要功能 F6 统一配置中心：集中展示已安装的 Kinetic 模块，支持模块级配置页、专用编辑器入口与搜索。 服务端权威配置 API：凡影响服务端规则的配置统一由服务端读取、校验、保存与同步；单人游戏也通过集成服务器走同一套保存路线。 网络与压缩工具：为大型 JSON、列表、NBT、规则快照等提供统一的网络编解码与压缩能力，供附属模块复用。 公共 GUI / 选择器工具：提供虚拟画布、配置页面、物品选择器、实体选择器、HUD 编辑器和高级 RGB 调色板 API 等通用客户端组件。 命令扩展框架：其他模块可以把自己的子命令挂载到统一的 /kt 命令树。 飞行与穿墙控制：提供飞行速度、惯性控制、穿墙状态与服务端同步等能力。 主动爬行：允许玩家通过按键主动进入 1 格高爬行状态。 TPS / MSPT / FPS HUD：提供服务器 TPS/MSPT 采样与客户端 HUD，以及可视化位置和缩放编辑。 首次加入系统：支持首次加入奖励物品、初始装备与首次加入命令。 世界初始化：可在新世界初始化阶段执行指定规则或命令。 SetSpawn 出生地系统：支持出生点接管、结构相关出生规则与可视化配置。 属性上下限扩展：允许针对属性单独调整最小值与最大值，兼容超出原版范围的属性系统。 通用机制调整：包含暴食、农田保护、斧头快速破坏蜘蛛网、创造模式保护、PVP 保护等基础规则。 NBT 与物品数据工具：提供手持物品、实体 NBT 查看以及面向整合包作者的物品数据复制工具。 资源包 / 数据包顺序管理：提供相关加载顺序配置与重载辅助。 Mini Effects：重构状态效果 HUD，并包含夜视闪烁修正等客户端体验优化。 日志清理与启动信息：提供日志保留策略、启动耗时与登录信息显示。 稳定性修复：包含异常实体属性修复、部分 GPU/渲染资源清理、世界删除保护、网络限制调整等底层修复。 常用入口 F6：打开 Kinetic 统一配置中心。 /kt reload：重载支持热重载的 Kinetic 配置与模块数据。 /kt tps：查看或控制 TPS/MSPT 监控。 /kt nbt hand：查看手持物品 NBT。 /kt nbt entity：查看目标实体 NBT。 /kt setfirstjoin：首次加入相关管理入口。 /kt world ...：出生地与结构相关管理命令。 配置目录 核心配置主要位于：

config/kineticcore/ 常见文件包括：

general.toml：通用机制。 attributes.toml：属性上下限。 network.toml：网络相关限制。 player.toml：首次加入配置。 setspawn.toml：出生地系统。 world_init.toml：世界初始化。 tps_client.toml / fps_client.toml：客户端 HUD。 spawnegg.toml：可投掷刷怪蛋。 startup.toml：启动与登录显示。 依赖 Forge 47.4.0+ Curios：可选兼容 JEI：可选兼容 完整功能参考 配置项详细说明 项目 说明 自动扫描注册属性 自动加入新属性、清理失效条目并刷新翻译注释。 属性范围限制 编辑所有已注册范围属性的启用状态、最小值和最大值。 %s — 启用 启用 %s 的自定义范围。 infinity 此边界为极大值、极小值或无限值；支持科学计数法、Infinity 与 -Infinity。 %s — 最大值 %s 允许的最大值。 %s — 最小值 %s 允许的最小值。 客户端默认选项 将当前 Minecraft 客户端选项导出为 KineticCore 在新建选项文件时使用的默认值。 将当前选项保存为默认值 用当前 options.txt 覆盖 config/kineticcore/defaultoptions.txt。 FPS HUD 配置仅作用于此客户端的 FPS HUD，并可打开可视化位置编辑器。 显示 FPS HUD 是否显示 FPS HUD。 FPS HUD FPS HUD 客户端显示设置。 水平偏移 横向位置偏移，正数向左移动，负数向右移动。 垂直偏移 纵向位置偏移，正数向上移动，负数向下移动。 打开可视化位置编辑器 拖动 HUD 调整位置，并将鼠标停在 HUD 上滚动滚轮调整缩放。 HUD 缩放 HUD 缩放比例；编辑界面可用鼠标滚轮调整。 发放前清空背包 发放新手奖励前先清空玩家背包。 首次加入指令 打开首次加入指令列表。新增或点击已有条目会进入独立编辑页，并支持输入 / 后使用客户端原版命令补全。 奖励发放延迟（秒） 玩家进入服务器后延迟多少秒发放礼包；0 表示立即发放，最小时间精度为 0.05 秒。 启用新手奖励 为尚未领取过奖励的玩家启用首次加入奖励。 初始装备 格式：数量x namespace:item{NBT}；留空表示该槽位不发放物品。 奖励物品列表 打开可视化奖励物品编辑器，可直接选择物品并编辑 NBT 与数量。 日志过滤去重 合并连续重复的 ERROR/FATAL 错误日志，只保留一条并显示重复次数。 日志清理 仅输出 ERROR/FATAL 错误日志，并保留重复错误合并与旧日志自动清理。 退出时清理旧日志 游戏退出时在后台清理旧日志和崩溃报告。 日志过滤关键词 同时屏蔽控制台和日志文件中包含关键词的行；多个关键词请使用英文逗号（,）分隔。 保留崩溃报告数量 最多保留的崩溃报告数量，最小值为 1。 保留调试日志数量 最多保留的旧调试日志数量，不包括 debug.log；最小值为 1。 保留归档日志数量 最多保留的旧普通日志数量，不包括 latest.log；最小值为 1。 开启暴食模式 允许玩家在满腹度时继续进食。 永久保留生物白名单 打开实体选择器配置永久保留的生物；已加入名单的生物不会被该优化刷掉。 实体属性修复 修复因模组运算错误导致的 NaN（非数字）血量实体，防止其变成无法杀死的“幽灵”实体。 耕地保护 穿着带“保护”附魔的靴子时，跳跃不会踩坏耕地。 快速破网 允许斧头等工具像剑或剪刀一样快速破坏蜘蛛网。 死亡经验扣除(%) 开启死亡不掉落时，死亡仍扣除的经验百分比（0为不扣）。 生物消失优化 允许捡起物品的怪物正常被刷掉，防止由于地上的垃圾导致怪物堆积引起服务器卡顿。怪物消失时会掉落它们捡起的物品。 移除配方书 彻底移除配方书功能和相关进度，显著优化性能。 增强型 PVP 保护 开启后，开启 PVP 保护的玩家及其宠物/仆从无法伤害他人或被他人伤害。同时防止仆从相互锁定为攻击目标，并自动清除已存在的仇恨。 存档回收站保护 开启后，在主界面删除世界存档时，文件夹将被移至操作系统回收站。这为你提供了找回误删存档的机会。 虚空伤害扣血比例 设置实体在虚空中每次受伤扣除最大生命值的百分比。 范围：0 - 100 保底会受到 4 点伤害。 虚空伤害原版白名单 填入此列表的生物在虚空将保持原版的掉血速度。 支持格式： @模组id (排除整个模组) #命名空间:标签名 (排除对应标签) 命名空间:实体id (排除特定实体) 创造虚空免疫 防止创造模式玩家因掉入虚空或 /kill 指令死亡。 紧凑状态效果 配置此客户端上的紧凑状态效果显示。 按住 Tab 展开状态效果 仅在按住 TAB 时展开状态效果。 在背包左侧显示状态效果 在物品栏左侧显示状态效果。 紧凑模式使用药水物品图标 紧凑模式使用药水物品图标，而不是效果纹理。 紧凑状态效果 紧凑状态效果的客户端显示设置。 RangedAttributeAccessor 属性范围解限：允许配置并修改 RangedAttribute 的最小值与最大值。 BeeMixins 服务端蜜蜂修复与微型化：移除重力影响、修复寻路浮点数漂移导致的偏移、修复生成位置偏移(MC-206401)、防止蜜蜂破坏海龟蛋，并将物理碰撞箱与视线高度缩小至 25%。 BeeRendererMixin 客户端蜜蜂渲染修复与微型化：为蜜蜂强制设定翻转角度（180度），并将体积缩小至原来的 25%。 ClientInterfaceMixins 客户端界面与流程自动化增强：

1. 彻底禁用复述器：阻止 Narrator 底层库加载，禁用其所有功能及快捷键，避免误触和潜在的库加载卡顿。

2. 多人列表清理：移除多人服务器列表中 Forge 模组版本的详细信息图标，使界面更整洁。

3. 智能弹窗拦截：将进入非正版/离线服务器时的全屏系统弹窗拦截，改为非侵入式的聊天栏金色文字提醒。

4. 自动化存档加载：创建世界或加载实验性存档时，自动跳过“实验性设置”和“数据包确认”二次弹窗，并强制标记生命周期为稳定，防止警告刷屏。

5. 阻止 UI 强制跳转：拦截因版本不兼容、数据包损坏或存档缺失而导致的自动跳转至“创建新世界”界面的行为，允许玩家保留在当前菜单进行手动调整。

AbstractContainerScreenAccessor 物品复制工具容器访问器：允许 Alt+C / Alt+F 在原版及模组容器界面准确读取鼠标悬浮槽位。 PlayerCrawlPoseMixin 允许玩家主动进入爬行姿态。 ServerLevelMixin 禁用伤害指示器粒子生成，优化战斗性能。 DefaultOptionsMixins 默认选项加载：在 options.txt 首次创建或异常损坏时应用 config/kineticcore/defaultoptions.txt，并同步自定义默认按键。 MobDespawnMixins 生物消失逻辑优化（Let Me Despawn）：

1. 防止实体积压：解决原版中僵尸、骷髅等生物捡起地上的垃圾物品后会永久占据实体位而不消失的问题，有效缓解服务器长期运行后的卡顿。

2. 末影人优化：允许手持方块的末影人像普通生物一样自然消失，防止末地或主世界地表堆积大量末影人。

3. 物品掉落：当受此逻辑影响的生物消失（Despawn）时，它捡起的物品会重新掉落在地上，不会导致玩家掉落的装备永久丢失。

4. 智能识别：仅针对捡起物品产生的“强制持久化”进行拦截，玩家通过命名牌命名或手动生成的生物依然会保留。

MiniEffectsMixins 状态效果 HUD 重构 (Mini Effects)：

1. 智能布局：突破原版挤压限制，效果卡片会利用屏幕 90% 的垂直空间自动等距排开，彻底告别重叠盲区。

2. 悬停置顶：鼠标悬停任意卡片时，该卡片立刻突破图层遮挡，置于最顶层清晰显示。

3. 兼容防冲突：完全避开 JEI 区域；完美接管并修复部分模组左侧渲染越界问题。

4. 夜视防闪烁：接管 GameRenderer 的夜视亮度计算，移除原版夜视快结束时的正弦闪烁，避免屏幕忽明忽暗。

FlightClientMixins 客户端移动与物理：

1. 惯性抑制：当停止按键时，强制清除飞行惯性，实现瞬间起停，大幅提升建筑操作精准度。

2. 穿墙物理：接管 LocalPlayer 物理循环，实现客户端平滑穿墙。

3. 动态调速：支持创造模式下通过 Alt+Shift+滚轮 动态调节飞行速度（0.1x-100x）。

4. 视觉防抖：修正模式切换瞬间玩家会向下坠落一下的视觉抖动问题。

FlightServerMixins 服务端飞行核心：

1. 飞行守门员：防止第三方模组或网络波动意外关闭玩家飞行姿态，解决掉落问题。

2. 跨维度恢复：确保玩家在跨维度、死亡重生或切换游戏模式后仍能继承飞行状态。

3. 拦截校验：拦截服务端对创造模式穿墙(No-Clip)的非法移动拉回。

4. 速度限制移除：彻底禁用原版服务端对行走、鞘翅飞行、载具移动的 256/300 码速度限制校验。

5. 实体尺寸干涉：允许在启用穿墙时动态修改玩家碰撞箱和眼高。

RenderTargetMixin GPU 内存泄漏修复 (VRAM Leak Fix)：

1. 拦截 RenderTarget (帧缓冲区对象) 的垃圾回收过程。

2. 当底层 OpenGL 纹理或缓冲区未被正常释放即被 Java 销毁时，接管其句柄。

3. 将遗留的 OpenGL ID 放入主线程队列进行安全销毁，有效防止长时间游戏后的显存溢出。

NetworkLimitMixins 网络数据包与底层协议解限：

1. 突破硬编码限制：彻底接管并解除原版 Netty 底层对 NBT、字符串、区块数据、Payload 通信包的大小限制。

2. 大型模组支持：完美解决 "Payload may not be larger than..." 或 "VarInt too big" 等导致玩家断开连接的网络溢出错误。

3. 动态扩展：配合 config 中的全局网络限制参数，提供安全且极具弹性的网络数据流吐吞能力。

RecipeBookClientMixins 配方书客户端移除：阻止客户端构建配方集合，并移除原版配方书按钮。 RecipeBookServerMixins 配方书服务端移除：停止保存、读取、同步和授予配方，并过滤 recipes/ 进度数据。 ServerMixin TPS/MSPT 采样：记录服务端 Tick 耗时，为 /kt tps 与 TPS HUD 提供统计数据。 WorldManagementMixins 存档管理：包含存档回收站和界面返回逻辑。 区块包上限 区块数据包读取时的最大字节限制。 原版默认: 2097152 (2MB) 范围: 2097152 ~ 2147483647 解码器上限 网络数据包解码器（解压）的最大处理限制。 原版默认: 8388608 (8MB) 范围: 8388608 ~ 2147483647 NBT最大限制 读取 NBT 数据结构树时允许的最大字节数。 原版默认值：2097152（2MB） 范围：2097152 ~ 4194304（4MB） 单数据包上限 自定义 Payload/Query 等单数据包的最大承载限制。 原版默认: 1048576 (1MB) 范围: 1048576 ~ 33554432（32MB） 字符串上限 网络通讯中可传输的最大字符串长度限制。 原版默认: 32767 范围: 32767 ~ 2147483647 连接超时时间 网络连接超时时间（秒）。 原版默认值：30 范围：30 ~ 99999 VarInt 字节上限 VarInt 类型变量的最大字节数。 过大可能导致底层安全检查失效。 原版默认: 5 范围: 5 ~ 10 21位解码器上限 21 位 VarInt 帧解码器允许的最大长度。 原版默认值：3 范围：3 ~ 16 VarLong 字节上限 VarLong 类型变量的最大字节数。 过大可能导致反序列化崩溃。 原版默认: 10 范围: 10 ~ 20 信息层 X 坐标 整体信息显示的左侧 X 坐标。 信息层 Y 坐标 整体信息显示的顶部 Y 坐标。 启动信息 配置此客户端显示的启动耗时与登录账号信息。 显示登录信息 是否显示当前登录账号信息。 显示启动耗时 是否显示游戏启动耗时。 TPS/MSPT HUD 配置客户端 TPS/MSPT HUD，以及当前连接是否订阅服务端采样数据。 显示 TPS/MSPT HUD 是否显示 TPS/MSPT HUD；关闭时服务器会停止发送采样数据。 TPS/MSPT HUD TPS/MSPT HUD 客户端显示设置。 初始化指令列表 每个列表项或每一行都会被当作一条独立指令执行。某条失败不会阻止后续指令。失败后会提醒在线管理员。不要加 /，误加会自动去掉。以 # 开头的行会被跳过。 启用初始化逻辑 是否在首次加载世界时执行初始化逻辑。 数据包优先级 优先级规则：列表越靠上优先级越高；内容冲突时，以上方数据包为准。 操作：按住 Ctrl + 左键抓住整行拖动，条目会跟随鼠标悬浮移动，其他条目实时让位；松开后落位。也可使用 ↑ / ↓。 资源包优先级 覆盖规则：列表越靠上优先级越高；内容冲突时，上面的资源包会覆盖下面的资源包。 操作：按住 Ctrl + 左键抓住整行拖动，条目会像图标一样跟随鼠标移动，其他条目实时让位；松开后落位。也可使用 ↑ / ↓。 群系搜索采样步长 群系搜索时的采样步长 (建议: 32-64)。 值越小搜索越精确(能找到细小群系)但越耗时，值越大搜索越快。 自定义出生点 设置新世界出生点搜索的基础参数。维度、群系和结构列表请使用下方专用规则编辑器，不需要手动修改配置文件。 启用自定义出生点 启用自定义出生点搜索。不会覆盖玩家通过床等方式设置的个人出生点。 最大搜索半径 群系模式的最大搜索半径，单位为方块。必须为非负整数；范围越大，最坏情况下搜索耗时越高。 出生规则 规则优先级依次为维度、群系、结构。复杂列表由专用选择器编辑并由服务器按实际注册表校验。 打开出生规则编辑器 选择允许的维度、群系和结构，并控制每类规则开关。minecraft:overworld 不允许写入维度限制；服务器会拒绝无效或已不存在的 ID。 结构搜索半径 (区块) 结构模式最大搜索半径，单位为区块，1 区块 = 16 方块。数值过大（如 > 512）可能造成建图严重卡顿；末地外岛结构通常需要大于 64。 结构搜索超时秒数 创建新世界时，如果出生点结构搜索超过这个秒数还没有找到结果，会自动回退到群系/维度逻辑。如果仍然找不到，就交回原版默认出生。建议 8-20 秒，不要设置太大。 属性编辑 打开完整属性列表，编辑每个属性的启用状态、最小值和最大值。 刷怪蛋投掷 将刷怪蛋像雪球一样投掷出去，命中后在安全位置生成对应实体。命中刷怪笼时会直接修改刷怪笼的实体类型。 启用刷怪蛋投掷 允许右键将刷怪蛋作为投射物扔出。可使用 Alt+O 在投掷模式与原版模式之间切换。 投掷飞行速度 控制刷怪蛋投射物的飞行速度。默认值：1.5。 投掷散布 控制刷怪蛋投射物的散布程度。数值越低越精准，默认值：0.2。 初始装备编辑器 打开物品格子编辑器，支持物品选择和NBT 界面操作与编辑器说明 项目 说明 重置 恢复此选项的默认值。 search 搜索... (@模组 #标签) command edit 输入 / 后使用客户端指令树补全，支持 Tab、上下方向键和鼠标选择。 初始装备编辑 左键选择物品，右键打开 NBT 编辑器，中键清空槽位 奖励物品编辑 左键图标选择物品，右键图标打开 NBT 编辑器。 取消 放弃本次颜色修改。 应用 应用当前颜色或调色板。 HEX 输入 6 位十六进制 RGB，例如 FF00FF。 rgb 输入 0 到 255 的 RGB 数值。 复制 HEX 复制当前颜色的 #RRGGBB。 加入调色板 把当前精确颜色加入调色板。 RGB 色盘 按住左键拖动，选择饱和度与亮度。 hue 按住左键拖动，选择色相。 当前颜色 当前颜色：#%s swatch #%s 左键载入，右键打开颜色菜单。 color picker 点击打开高级 RGB 调色板。 命令功能说明 项目 说明 pvp 切换PVP保护模式 reload 管理员重载模组配置文件 setfirstjoin 将当前背包和装备保存为首次进服奖励 tps 查看服务器 TPS 与 MSPT 状态 world 世界与结构定位指令帮助 list structures 列出所有结构ID structure 查询所在位置的结构 nbt NBT 编辑 hand 打开主手物品的 NBT 编辑器。 entity 打开准星指向的实体或方块实体 NBT 编辑器。 可编辑字段、模式与分类索引 已注册属性 全局属性设置 蜜蜂修复与优化 客户端界面优化 飞行与移动控制 模组兼容性 网络与协议解限 性能与实体优化 性能与渲染修复 性能监控 玩家与实体逻辑 原版系统优化 存档管理 仅保存在当前客户端配置中。 客户端配置 客户端 保存在当前 Minecraft 安装中，不会修改所连接的远程服务器。 本机安装 配置始终由当前游戏服务器保存；单人游戏同样通过集成服务器处理，拥有 OP 2 级或更高权限时可编辑。 服务端配置 服务器 方块 战斗 食物与饮品 材料 模组 红石 刷怪蛋 工具 应用 %s 全部 背包 配置键与默认值 配置键 默认值 anchor_x 2 anchor_y 2 creative.enableVoidImmunity true death.keep_inventory_drop_xp_percentage 50 enabled true first_join.clear_inventory true first_join.delay_ticks 20 first_join.enable true log_cleaner.deduplication true log_cleaner.enable true log_cleaner.filtered_keywords "Tried to load a block entity for block" log_cleaner.max_crash_reports 3 log_cleaner.max_debug_logs 3 log_cleaner.max_logs 3 mechanics.enableAlwaysEdible true mechanics.enableEntityAttributeFixer true mechanics.enableFarmlandProtection true mechanics.enablePvpProtection true mechanics.fastCobWebBreaking true mechanics.recycleBinWorlds true mobs.enableLetMeDespawn true offsetX 0 offsetY 0 recipe_book.removeRecipeBook true scale 1.0D setspawn.biome_step 48 setspawn.enable true setspawn.radius 10000 setspawn.rule_biome.enable false setspawn.rule_dimension.enable false setspawn.rule_structure.enable true setspawn.structure_radius 256 setspawn.structure_timeout_seconds 12 show_login_info true show_startup_time true void_damage.percentage 10 world_init.enable true 配置与数据路径 主要配置/数据路径：

config/kineticcore/attributes.toml config/kineticcore/defaultoptions.txt config/kineticcore/general.toml config/kineticcore/network.toml config/kineticcore/player.toml config/kineticcore/setspawn.toml config/kineticcore/spawnegg.toml config/kineticcore/world_init.toml 依赖与可选兼容 模组 ID 关系 curios 可选 jei 可选