动力核心
KineticCore是Kinetic模组家族的基础。它提供了共享API层、模块引导系统、统一配置中心
KineticCore 是 Kinetic 模组系列的基础。它提供共享 API 层、模块引导系统、统一配置中心、网络通信、压缩负载工具、可复用 GUI 组件和命令扩展框架。它还包含一组属于核心的底层游戏调整和稳定性修复。
主要功能
- 为已安装的 Kinetic 模块提供统一的
F6配置中心。 - 服务器权威配置 API，带权限检查和服务器端持久化。
- 用于大型配置数据的共享网络和压缩负载工具。
- 可复用的 GUI、选择器、虚拟画布、HUD 编辑器和高级 RGB 调色板 API。
- 供配套模块使用的
/kt命令扩展框架。 - 飞行、惯性和穿墙控制，支持客户端/服务器同步。
- 手动爬行支持。
- TPS/MSPT/FPS 监控和可编辑 HUD。
- 首次加入奖励、装备和命令执行。
- 世界初始化和出生点管理系统。
- 按属性覆盖最小值/最大值范围。
- 通用游戏调整，如食物、耕地、蜘蛛网、创造模式和 PVP 规则。
- NBT 检查和物品数据复制工具。
- 资源包/数据包排序辅助工具。
- 紧凑状态效果 HUD 和夜视闪烁修复。
- 日志清理、启动信息、实体修复、世界删除保护和其他底层稳定性工具。
配置
大多数核心配置文件存储在：
config/kineticcore/
服务器游戏规则由服务器持久化。纯客户端偏好设置（如 HUD 位置）保留为本地客户端设置。
需求
- Java 17
- Curios：可选集成
- JEI：可选集成
完整功能参考
详细配置参考
| 项目 | 描述 |
|---|---|
| 自动扫描已注册属性 | 添加新属性，移除过时条目，并自动刷新翻译注释。 |
| 属性范围限制 | 为每个已注册的范围属性配置启用状态和数值边界。 |
| %s — 启用 | 为 %s 启用自定义边界。 |
| infinity | 此边界极大、极小或无限。支持科学计数法、Infinity 和 -Infinity。 |
| %s — 最大值 | %s 允许的最大值。 |
| %s — 最小值 | %s 允许的最小值。 |
| 默认客户端选项 | 将当前 Minecraft 客户端选项导出为 KineticCore 的全新选项文件默认值。 |
| 将当前选项保存为默认值 | 用当前 options.txt 覆盖 config/kineticcore/defaultoptions.txt。 |
| FPS HUD | 配置仅客户端的 FPS 叠加层并打开其视觉位置编辑器。 |
| 显示 FPS HUD | 是否显示 FPS HUD。 |
| FPS HUD | 客户端 FPS HUD 设置。 |
| 水平偏移 | 水平位置偏移。正值向左移动；负值向右移动。 |
| 垂直偏移 | 垂直位置偏移。正值向上移动；负值向下移动。 |
| 打开视觉位置编辑器 | 拖动 HUD 进行定位，使用鼠标滚轮调整其缩放。 |
| HUD 缩放 | HUD 缩放；在编辑器中使用鼠标滚轮调整。 |
| 发放前清空物品栏 | 在发放新手礼包前清空玩家物品栏。 |
| 首次加入命令 | 打开首次加入命令列表。添加或点击现有条目会打开专用编辑器，输入 / 后带原版客户端命令建议。 |
| 发放延迟（秒） | 登录后发放奖励前的秒数。0 表示立即发放；精度为 0.05 秒。 |
| 启用新手礼包 | 为尚未收到奖励的玩家启用首次加入奖励。 |
| 新手装备 | 格式：数量x 命名空间:物品{NBT}；留空表示此槽位不给予任何物品。 |
| 新手物品列表 | 打开可视化奖励物品编辑器以选择物品并编辑 NBT 和数量。 |
| 日志去重 | 将连续重复的 ERROR/FATAL 日志合并为一条带重复次数的条目。 |
| 日志清理器 | 仅输出 ERROR/FATAL 日志；重复错误被合并，旧日志自动清理。 |
| 退出时清理旧日志 | 游戏退出时在后台清理旧日志和崩溃报告。 |
| 过滤日志关键词 | 从控制台和日志文件中隐藏匹配的日志行。多个关键词用 ASCII 逗号（,）分隔。 |
| 保留崩溃报告数 | 保留的最大崩溃报告数；最小为 1。 |
| 保留调试日志数 | 保留的最大归档调试日志数（不含 debug.log）；最小为 1。 |
| 保留归档日志数 | 保留的最大归档常规日志数（不含 latest.log）；最小为 1。 |
| 启用暴食模式 | 允许玩家在食物条已满时进食。 |
| 持久生物白名单 | 打开实体选择器以选择绝不应被此优化移除的生物。 |
| 实体属性修复器 | 修复由模组错误导致的 NaN 生命值（非数值）实体，防止它们变成无法杀死的“幽灵”实体。 |
| 耕地保护 | 穿着带保护的靴子跳跃时不会踩踏耕地。 |
| 快速破坏蜘蛛网 | 允许斧和类似工具像剑或剪刀一样快速破坏蜘蛛网。 |
| 死亡经验损失（%） | 即使启用 KeepInventory 也在死亡时损失的经验百分比（0 禁用）。 |
| 启用“让我消失” | 允许拾取物品的生物正常消失。这防止生物堆积导致的服务器卡顿。生物消失时会掉落拾取的物品。 |
| 移除配方书 | 完全移除配方书和进度以优化性能。 |
| 增强 PVP 保护 | 启用后，拥有 PVP 保护的玩家（及其宠物/仆从）不能伤害他人或被其他玩家伤害。它还阻止宠物以受保护方为目标并自动清除仇恨。 |
| 世界回收站 | 启用后，删除世界会将其移至系统回收站而非永久删除。 |
| 虚空伤害百分比 | 设置每次虚空伤害 tick 扣除最大生命值的百分比。 范围：0 - 100 将造成最低 4 点伤害。 |
| 原版虚空伤害白名单 | 此列表中的实体将保留原版虚空伤害速率。 支持格式： @modid（排除整个模组） #namespace:tag（排除特定标签） namespace:entity_id（排除特定实体） |
| 创造模式虚空免疫 | 防止创造模式下落入虚空或 /kill 导致的死亡。 |
| 紧凑状态效果 | 在此客户端上配置紧凑状态效果显示。 |
| 按住 Tab 展开效果 | 需要按住 TAB 才显示展开的效果。 |
| 在左侧显示效果 | 在物品栏左侧显示效果。 |
| 使用药水物品作为紧凑图标 | 在紧凑模式下使用药水物品而非效果纹理。 |
| 紧凑状态效果 | 紧凑状态效果的客户端显示设置。 |
| RangedAttributeAccessor | 属性范围解除上限：允许将配置的最小/最大限制应用于 RangedAttribute 实例。 |
| BeeMixins | 服务器端蜜蜂调整：移除重力效果，修复寻路漂浮漂移，修复出生位置偏移（MC-206401），防止蜜蜂破坏海龟蛋，并将物理碰撞箱和视高缩放至 25%。 |
| BeeRendererMixin | 客户端蜜蜂渲染器调整：强制蜜蜂翻转角度为 180.0F，并将音量降至原来的 25%。 |
| ClientInterfaceMixins | 客户端界面和工作流自动化增强： # 1. 移除旁白：阻止原生旁白库加载并禁用所有 TTS 功能/热键，以避免意外触发和潜在卡顿。 # 2. UI 清理：从多人游戏界面移除 Forge 模组兼容图标，获得更清爽的视觉体验。 # 3. 智能 Toast 拦截：将侵入性的“不安全服务器”系统 Toast 替换为非侵入性的金色聊天消息提醒。 # 4. 无缝世界加载：自动跳过“实验性设置”和“数据包”确认界面；强制世界生命周期为“稳定”以抑制警告。 # 5. UI 重定向阻止：阻止由版本不匹配、存档缺失或数据包错误触发的自动跳转到“创建新世界”界面，允许玩家留在当前菜单进行手动调整。 |
| AbstractContainerScreenAccessor | 复制物品容器访问器：让 Alt+C / Alt+F 能在原版和模组容器界面中准确读取悬停槽位。 |
| PlayerCrawlPoseMixin | 允许玩家主动触发爬行状态。 |
| ServerLevelMixin | 禁用伤害指示粒子以提高战斗性能。 |
| DefaultOptionsMixins | 默认选项加载器：当 options.txt 首次创建或损坏时应用 config/kineticcore/defaultoptions.txt，包括自定义默认按键绑定。 |
| MobDespawnMixins | 生物消失优化（让我消失）： # 1. 实体积压防止：修复原版中生物（僵尸、骷髅等）拾取物品后变为持久的问题，减少长期服务器卡顿。 # 2. 末影人调整：允许持有方块的末影人像其他生物一样自然消失，防止实体堆积。 # 3. 物品回收：当生物通过此逻辑消失时，任何拾取的装备会掉回地面，防止装备丢失。 # 4. 智能持久化：仅拦截由拾取物品导致的自动持久化；用命名牌命名或手动生成的生物仍保持持久。 |
| MiniEffectsMixins | 状态效果 HUD 改造（迷你效果）： # 1. 智能布局：打破原版挤压限制。卡片现在使用最多 90% 的垂直空间，均匀分布。 # 2. 悬停置顶：悬停任何卡片会立即将其置于顶层，突破原版渲染遮挡。 # 3. 兼容性：完全避开 JEI 区域并修复越界的左侧渲染。 # 4. 夜视防闪烁：覆盖 GameRenderer 夜视亮度计算并移除效果即将结束时原版的窦性闪烁。 |
| FlightClientMixins | 客户端移动与物理： # 1. 惯性抑制：释放输入时立即停止移动，便于精确建造。 # 2. 穿墙物理：覆盖本地玩家物理以实现流畅的客户端穿墙。 # 3. 动态速度：用 Alt+Shift+滚轮 调整创造飞行速度（0.1x-100x）。 # 4. 防抖动：修复游戏模式切换时的视觉下落故障。 |
| FlightServerMixins | 服务器飞行核心： # 1. 飞行守护：防止由模组冲突或网络抖动导致的意外飞行丢失。 # 2. 状态继承：在跨维度、重生或游戏模式切换时保留飞行状态。 # 3. 检查拦截：在穿墙时绕过服务器端移动“橡皮筋”拉回。 # 4. 速度限制移除：禁用原版服务器端行走/鞘翅/载具速度检查。 # 5. 维度破解：在穿墙时修改碰撞箱和视高。 |
| RenderTargetMixin | GPU 内存泄漏修复： # 1. 拦截 RenderTarget 的垃圾回收。 # 2. 捕获未正确删除即被废弃的 OpenGL 纹理和帧缓冲 ID。 # 3. 将它们排队在主线程上安全删除，防止长时间游玩时的 VRAM 泄漏。 |
| NetworkLimitMixins | 网络数据包和协议解除上限： # 1. 突破硬编码限制：完全覆盖原版 Netty 对 NBT、字符串、区块数据和负载数据包的限制。 # 2. 大型模组包支持：解决由网络溢出导致的“Payload may not be larger than...”或“VarInt too big”断开连接错误。 # 3. 动态缩放：配合全局网络限制配置，提供安全且高弹性的网络吞吐量。 |
| RecipeBookClientMixins | 配方书客户端移除：阻止客户端配方收集设置并移除原版配方书按钮。 |
| RecipeBookServerMixins | 配方书服务器移除：停止配方书保存/加载/同步/授予操作并过滤配方/进度。 |
| ServerMixin | TPS/MSPT 采样：记录服务器 tick 时间，用于 /kt tps 报告和 TPS HUD。 |
| WorldManagementMixins | 世界管理：包括回收站和导航逻辑。 |
| 区块数据包大小 | 读取区块数据包数据的最大字节限制。 原版默认：2097152（2MB） 范围：2097152 ~ 2147483647 |
| 解码器最大大小 | 网络数据包解码器（解压缩）的最大处理限制。 原版默认：8388608（8MB） 范围：8388608 ~ 2147483647 |
| NBT 最大大小 | 读取 NBT 数据结构树的最大允许字节数。 原版默认：2097152（2MB） 范围：2097152 ~ 4194304（4MB） |
| 最大数据包大小 | 自定义负载/查询数据包的最大负载限制。 原版默认：1048576（1MB） 范围：1048576 ~ 33554432（32MB） |
| 字符串最大大小 | 通过网络传输的字符串最大字符长度限制。 原版默认：32767 范围：32767 ~ 2147483647 |
| 连接超时 | 网络连接超时（秒）。 原版默认：30 范围：30 ~ 99999 |
| VarInt 字节限制 | VarInt 变量的最大字节长度。 原版默认：5 范围：5 ~ 10 |
| VarInt21 解码器限制 | 21 位 VarInt 帧解码器的最大长度限制。 原版默认：3 范围：3 ~ 16 |
| VarLong 字节限制 | VarLong 变量的最大字节长度。 原版默认：10 范围：10 ~ 20 |
| 叠加层 X 位置 | 信息叠加层的左侧 X 坐标。 |
| 叠加层 Y 位置 | 信息叠加层的顶部 Y 坐标。 |
| 启动信息 | 配置在此客户端显示的启动时间和账户信息。 |
| 显示登录信息 | 是否显示当前登录账户信息。 |
| 显示启动时间 | 是否显示游戏启动时间。 |
| TPS/MSPT HUD | 配置客户端 TPS/MSPT 叠加层以及此连接是否订阅服务器采样。 |
| 显示 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 支持的物品编辑器 |
GUI 和编辑器参考
| 项目 | 描述 |
|---|---|
| 重置 | 恢复此选项的默认值。 |
| search | 搜索...（@mod #tag） |
| 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 编辑器。 |
可编辑字段、模式和分类
- 已注册属性
- 全局属性设置
- 蜜蜂修复与调整
- 客户端 UI 与交互
- 飞行与移动控制
- 模组兼容性
- 网络协议
- 优化与实体调整
- 性能与渲染修复
- 性能监控
- 玩家与实体逻辑
- 原版系统调整
- 世界管理
- 仅存储在此客户端的配置中。
- 客户端设置
- 客户端
- 存储在此 Minecraft 安装中；它不会修改连接的远程服务器。
- 本地安装
- 服务器设置
- 服务器
- 方块
- 战斗
- 食物与饮品
- 材料
- 模组
- 红石
- 刷怪蛋
- 工具
- 应用
- %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.tomlconfig/kineticcore/defaultoptions.txtconfig/kineticcore/general.tomlconfig/kineticcore/network.tomlconfig/kineticcore/player.tomlconfig/kineticcore/setspawn.tomlconfig/kineticcore/spawnegg.tomlconfig/kineticcore/world_init.toml
依赖项和可选集成
| 模组 ID | 关系 |
|---|---|
curios |
可选 |
jei |
可选 |
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表，这里同步展示。