概览
- 本项目用于修复和优化由其他模组引发的问题,支持在服务器端运行。
- 项目包含两个主要部分:
k_all_fix和k_multi_threading,功能主要通过 JVM 参数进行控制。 - 不提供常规配置文件;配置主要通过启动参数完成。
- 从
1.0.4.0版本开始支持客户端使用(需要 JVM 参数-DKMT_Client=true)。 - 在多模组且单线程基线环境下,不保证完全无问题,但您可以在 Github 上提交 ISSUE,作者会尽快修复。
- 在某些模组组合下,即使本模组没有可见效果,客户端可能仍需安装此模组。
功能与用例
优化
- 优化 Upgraded Additional Trims 的性能。
- 优化 Atmospheric 中与愚人节日期检查相关的开销。
- 优化 Upgraded Core 的性能。
- 优化 [Let's Do] Farm & Charm 中鸡舍 AI 的性能。
- 优化 Event Wrapper 的性能
- 优化 Create:FluidLogistic 的性能
- 使用
-DKAF-fluidlogistics.DisabledDynamicUp=true禁用旧 ID 的更新,否则可能导致性能下降。
- 使用
- 优化 AE2 的游戏计算
- 优化 ItemStack.isSameItemSameTags 的性能
- 优化 PPMO2 的性能
- 删除 Apotheosis 和 Create:Connected 中的无用代码
修复
- 修复在搭配 MineColonies 的服务器上运行时,L_Ender's Cataclysm 中与实体数量相关的性能问题。
- 修复 [Let's Do] Farm & Charm 中过多的无效数据包发送问题。
- 修复 Biolith 与某些 MCreator 世界生成模组(如 Terramity)之间的兼容性问题。
- 修复 Gregicality Rocketry 与 Canary 之间的兼容性问题,但在空间站边界处仍可能出现碰撞箱问题。
- 修复 Petrolpark's Library 1.4.2 在某些 Java 环境中无法使用的问题;可通过
-DKAF-DisablePetrolpark=false禁用此修复。 - 修复/优化 Alex's Caves 中与磁场相关的性能问题。
- 修复 Create: Diesel Generators 中的 mixin 性能问题。
- 修复旧版 Destroy 因数据库连接失败导致的服务器崩溃问题。
多线程
简介
- 多线程支持包括方块刻、方块实体刻、实体、维度、玩家数据包接收(手动切换,仅客户端)以及玩家登录(手动切换),并通过应用多线程来修复一些有问题的单线程模组。
- 服务端默认启用多线程。
- 在多线程场景下,可能会出现线程池拦截或超出限制的错误,但通常不会导致服务器崩溃。
- 建议手动设置
-DKMT-threadMax=[CPU 线程数];否则世界生成可能会冻结。如果设置后仍然出现冻结,请增大该值。 - 在
1.0.4.0之前,客户端无法使用多线程;从1.0.4.0开始,客户端可以通过-DKMT_Client=true启用它。 - 在
1.0.3.3之后,ParaServerChunkProvider、TaskRun和部分区块生成代码更依赖 C2 编译(JVM 会在运行一段时间后自动进入 C2 模式)。 - 在 Windows Server 2022 Datacenter 21H2 20348.3091(作者的环境)中,偶尔会出现线程调度异常并导致 CPU 占用率异常升高;解决方法是重启服务器。
相关 JVM 参数
-DKMT-threadMax=[number]- 设置线程池线程数。
-DKMT-callMax=[number]- 设置多线程任务默认可使用的最大线程数。
-DKMT-ThreadpoolKeepAliveTime=[milliseconds]- 设置空闲线程在被回收前保持存活的时间。
-DKMT_D=[any characters]- 禁用多线程。
-DKMT-OpenVanillaServerChunkCache=true- 强制使用原版
ServerChunkCache修复路径(1.0.5.3 版本添加)。
- 强制使用原版
JVM 参数概览(全部保留)
基本与通用
-DKAllFix_D=[any characters]- 禁用 KAllFix。
-DKMT_Client=true- 在客户端启用多线程相关功能(1.0.4.0+)。
-DKAF-DisablePetrolpark=false- 禁用与 Petrolpark's Library 1.4.2 相关的修复。
连接与超时
-DKAF-ClientboundKeepAlivePacket_Max=[milliseconds]- 更改
ClientboundKeepAlivePacket的时间要求(默认 15 秒;原版必须 <30 秒,否则玩家会因超时而断开连接)。
- 更改
-DKAF-ServerTimeout=[seconds]- 设置服务器连接超时时间。
- 在某些情况下可能无效(需要同时设置这两个参数,因为 Forge 的
forge.readTimeout仅涵盖服务端数据包读取超时,不包括带有玩家的客户端/服务端网络线程)。
-Dforge.readTimeout=[seconds]- Forge 数据包读取超时参数(与前一个参数配合使用)。
Mixin / NBT / 自动命令
-DKAF-RemoveMixin:[类名]- 禁用指定的 mixin(也可禁用
k_multi_threadingmixins)。
- 禁用指定的 mixin(也可禁用
-DKAF-NbtIoMixin_NotGZip=true- 为非 gzip 场景的 NBT IO 添加 try-catch(不安全;需要环境中包含 commons-compress)。
-DKMT-ChunkGeneratorMode2Start=[true,false]- 自动运行:
/SetterWorldConfig world setM2 %%KMT-ChunkGeneratorMode2Start%%。
- 自动运行:
繁殖控制
-DKAF-ChunkBreedingControlSize=[数值]- 当区块实体数量超过给定值时禁用繁殖;如果参数缺失、不是数值数组或为空,则此功能被禁用。
-DKAF-ChunkBreedingControlSizeEnable=[true,false]- 检测结果的内部缓存开关;手动设置可能会被程序覆盖。
可选特性
-DKMT-SafeUnloadChunk=true- 在区块生成线程中启用区块卸载(仅在
<1.0.4.2版本且出现相关卡顿时才推荐使用)。
- 在区块生成线程中启用区块卸载(仅在
-DIndependencePlayer=true- 启用异步玩家处理(可能提供极少甚至没有优化效果)。
-DFixBiolithBugMode2=true- 尝试修复大多数 Biolith 兼容性问题(可能会引入严重错误)。
-DKAF-gtceu.MedicalConditionTrackerMixin=true- 禁用 GTM 中的辐射效果。
-DKAF-RemoveClientboundKeepAlivePacket=true- 禁用原版
ClientboundKeepAlivePacket(无法再计算延迟/ping)。
- 禁用原版
-DKAF-RemoveFlyingTest=true- 移除飞行检测。
-DKAF-moonrise_fast_palette=true- 禁用 Moonrise 的
fast_palette特性。
- 禁用 Moonrise 的
-DKAF-FixTFMGDestroy=true-DKAF-Fix_fabric-object-builder-api.jar=true- 修复 Sinytra Connector 的
fabric-object-builder-api与forge-47.3.27之间的兼容性。
- 修复 Sinytra Connector 的
-DKAF-FixAllPacket=true- 修复网络数据包(必须在客户端和服务端同时启用);相关模组:Mekanism Explosives、Create、The Abyss II。
-DKAF-ChunkAwareBlockCollisionSweeperFast=true- 使用近似算法替换 Lithium 的 ChunkAwareBlockCollisionSweeper。
登录多线程
-DKMT-LoginMultiThreading=true- 启用多线程登录。
-DKMT-LoginMultiThreading.ConnectionLock=true- 在刻结束时等待异步执行完成(禁用可能会略微提升性能,但会降低登录稳定性并可能导致崩溃)。
-DKMT-LoginMultiThreading.TaskSizeMax=[数值]- 限制并发登录任务的数量(默认值为 8)。
- 登录多线程可能导致服务器过早收到
ServerboundMovePlayerPacket,从而产生一条错误日志。
数据包优化
-DKAF-packetOptimize=true- 优化部分原版数据包(必须在客户端和服务端同时启用)。
-DKAF-packetOptimize.AttributesReOutputTime=[毫秒]- 设置属性相关数据的强制重发间隔(默认 2 分钟)。
-DKAF-packetOptimize.CompatibilityMode.ClientboundBlockEntityDataPacket=true- 对
ClientboundBlockEntityDataPacket使用更保守的压缩方式(会影响性能)。
- 对
-DKAF-packetOptimize.CompatibilityMode.ClientboundSectionBlocksUpdatePacket=true- 对
ClientboundSectionBlocksUpdatePacket使用更保守的压缩方式。
- 对
其他
-DKAF-UnsafeCinderscapesFix1=true- 调整 Cinderscapes 中高开销的
enableAshFall函数的限制。
- 调整 Cinderscapes 中高开销的
-DKAF-fix.asynchronous.ClientboundCustomQueryPacket=true- 使握手过程异步化,减少因安装模组过多而无法加入服务器的几率。
-DKAF-FixConfigAuto=true- 自动更改部分配置选项以实现兼容性。
安装与运行时说明
- 从
1.0.3.18版本开始,可以直接运行(仍保留安装功能)。 - 在
1.0.3.18之前,请先运行模组的安装程序,或使用以下命令:java -jar k_multi_threading-xxx.jar -i [空目录 或 安装目录]
- 安装仅会生成
k_multi_threading-base.jar和k_multi_threading-asm.jar。 - 部分功能可能会下载依赖项(
Zstd-jni 1.5.7-2);如果下载失败,请手动将其放入game_directory/lib。
兼容性说明
- 使用
-DKAF-FixConfigAuto=true可以自动禁用以下内容: - 不应使用
-DKAF-FixConfigAuto=true的情况:- 可能与 ModernFix 中的
mixin.perf.cache_upgraded_structures发生冲突(请在config/modernfix-mixins.properties中通过设置mixin.perf.cache_upgraded_structures=false来禁用)。 - 在启用登录多线程的情况下,ParCool (页面显示为 Parkour) 可能在玩家加入后需要死亡一次才能正常工作。
- Ars Creo 可能会偶尔记录
Modifier is already applied on this attribute!错误,但不会导致崩溃。 - NuclearCraft: Neoteric 的裂变反应堆在服务器重启后可能会偶尔计算冷却数据错误。
- 可能与 ModernFix 中的
命令
-
/debug_GetterClassFile [类名]- 将最终运行时类数据导出至游戏目录,文件名为
timestamp_save.class。
- 将最终运行时类数据导出至游戏目录,文件名为
-
/SetterWorldConfig [世界, ClearErrorSize, RemoveRemoveErrorSize]- 此命令的设置不会持久保存。
ClearErrorSize:清除记录的“导致服务器崩溃风险的错误”计数。RemoveRemoveErrorSize:停止记录崩溃风险计数并继续拦截。- 在
world [维度注册表 ID]下,可用选项包括:setM2 [true,false]:切换到另一种维度实现模式;优先级高于setMultiThreading,但可能导致游戏冻结。setMultiThreading [数量](默认0):设置该维度的多线程并行任务数;与setM2独立运行,也可能导致游戏冻结。
其他
- 由于 Minecraft 和许多模组从根本上都是围绕单线程行为设计的,因此无法保证完全修复所有问题。
源代码使用
moonrise_fast_palette使用了来自 Moonrise 的源代码。- 针对 Gregicality Rocketry 和 Canary 的兼容性修复使用了来自 Canary 的源代码。
你是这个资源的作者?登录后可认领此资源。
相似资源
Ixeris
decce6
缓冲的原始输入和线程化的事件轮询
优化
413
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
229
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
227
Fast Noise
omo50
原版世界生成优化模组
优化世界生成
222
评论 0
登录后参与评分
还没有评论,来抢沙发吧