KAllFix

模组

· 作者 n1luik

优化和多线程由 n1luik 编写

0 本站下载 0 关注 更新于 2 个月前

最新 1.1.0.6 · 1.21.1 · NeoForge

一键开服(送7天)

概览

  • 本项目用于修复和优化由其他模组引发的问题,支持在服务器端运行。
  • 项目包含两个主要部分:k_all_fix 和 k_multi_threading,功能主要通过 JVM 参数进行控制。
  • 不提供常规配置文件;配置主要通过启动参数完成。
  • 从 1.0.4.0 版本开始支持客户端使用(需要 JVM 参数 -DKMT_Client=true)。
  • 在多模组且单线程基线环境下,不保证完全无问题,但您可以在 Github 上提交 ISSUE,作者会尽快修复。
  • 在某些模组组合下,即使本模组没有可见效果,客户端可能仍需安装此模组。

功能与用例

优化

修复

多线程

简介

  • 多线程支持包括方块刻、方块实体刻、实体、维度、玩家数据包接收(手动切换,仅客户端)以及玩家登录(手动切换),并通过应用多线程来修复一些有问题的单线程模组。
  • 服务端默认启用多线程。
  • 在多线程场景下,可能会出现线程池拦截或超出限制的错误,但通常不会导致服务器崩溃。
  • 建议手动设置 -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

连接与超时

  • -DKAF-ClientboundKeepAlivePacket_Max=[milliseconds]
    • 更改 ClientboundKeepAlivePacket 的时间要求(默认 15 秒;原版必须 <30 秒,否则玩家会因超时而断开连接)。
  • -DKAF-ServerTimeout=[seconds]
    • 设置服务器连接超时时间。
    • 在某些情况下可能无效(需要同时设置这两个参数,因为 Forge 的 forge.readTimeout 仅涵盖服务端数据包读取超时,不包括带有玩家的客户端/服务端网络线程)。
  • -Dforge.readTimeout=[seconds]
    • Forge 数据包读取超时参数(与前一个参数配合使用)。

Mixin / NBT / 自动命令

  • -DKAF-RemoveMixin:[类名]
    • 禁用指定的 mixin(也可禁用 k_multi_threading mixins)。
  • -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 特性。
  • -DKAF-FixTFMGDestroy=true
    • 修复 Destroy 与 Create 之间的兼容性(Creative Pump 无法正确连接到 Create 的管道)。
  • -DKAF-Fix_fabric-object-builder-api.jar=true
    • 修复 Sinytra Connector 的 fabric-object-builder-api 与 forge-47.3.27 之间的兼容性。
  • -DKAF-FixAllPacket=true
  • -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 函数的限制。
  • -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 可以自动禁用以下内容:
    • Cupboard 中的 logOffthreadEntityAdd。
    • Canary / Lithium 中的 world.tick_scheduler 和 entity_by_type(你必须在 config/canary.properties 或 config/lithium.properties 中手动添加 mixin.world.tick_scheduler=false;否则这些模组会覆盖针对 ClassInstanceMultiMap 的多线程修复)。
  • 不应使用 -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 的裂变反应堆在服务器重启后可能会偶尔计算冷却数据错误。

命令

  • /debug_GetterClassFile [类名]

    • 将最终运行时类数据导出至游戏目录,文件名为 timestamp_save.class。
  • /SetterWorldConfig [世界, ClearErrorSize, RemoveRemoveErrorSize]

    • 此命令的设置不会持久保存。
    • ClearErrorSize:清除记录的“导致服务器崩溃风险的错误”计数。
    • RemoveRemoveErrorSize:停止记录崩溃风险计数并继续拦截。
    • 在 world [维度注册表 ID] 下,可用选项包括:
      • setM2 [true,false]:切换到另一种维度实现模式;优先级高于 setMultiThreading,但可能导致游戏冻结。
      • setMultiThreading [数量](默认 0):设置该维度的多线程并行任务数;与 setM2 独立运行,也可能导致游戏冻结。

其他

  • 由于 Minecraft 和许多模组从根本上都是围绕单线程行为设计的,因此无法保证完全修复所有问题。

源代码使用

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源