DashLoader (Unofficial Continuation)

DashLoader（非官方延续版）

这是对AlphaQ 制作的 DashLoader的非官方延续版本。原版最高支持 Minecraft 1.21.4；1.21.5 及更新版本的内容都在这里。继续采用 LGPL-3.0-only 许可证，并向 AlphaQ 和所有贡献者致以完整谢意。

功能介绍

厌倦了每次启动游戏时，都要看着加载界面从头解析所有方块模型、材质、精灵图和字体字形吗？

DashLoader 是一个客户端资源重载缓存。首次启动游戏时，它会照常完成资源加载，并将结果写入磁盘。之后每次启动游戏都会读取缓存，因此世界加载速度会大幅提升。整合包越大，效果越明显。

不改变游戏玩法。不需要服务端组件。无需任何设置：安装后启动游戏两次，亲自感受区别即可。

工作原理

1. 首次启动 – DashLoader 会进行正常的资源重载，并将结果写入实例目录旁边的dashloader-cache。完成后会显示提示。
2. 之后每次启动 – 直接读取缓存中的模型、精灵图和字体，不再重新烘焙。
3. 自动使缓存失效 – 缓存键根据模组列表、模组版本和已启用的资源包生成，因此添加模组或更换资源包时，会自动创建新缓存。

按下F3 + T即可强制重建缓存，方便你迭代资源文件。

支持的版本

| 状态 | Minecraft | Java | 加载器 |
|—|—|—|—|
| 稳定版 | 1.21.4 – 1.21.11 | 21 | Fabric、Quilt |
| Beta | 26.1、26.1.1、26.1.2、26.2、26.3 | 25 | Fabric、Quilt |
| Beta | 26.2、26.3、1.21.11 | 21 / 25 | NeoForge |
| 开发中 | 1.16.5 | 8 | Forge，初步移植版 |

仓库中每个 Minecraft 版本都有各自的分支，请准确选择与你的版本对应的下载文件。为某个 Minecraft 版本构建的 jar 文件无法在其他版本中加载。

值得了解的事项

• 首次启动会比较慢。 此时会写入缓存；之后每次启动都会更快。
• 无法缓存的资源会被跳过，不会导致程序崩溃。无法转换的模组资源会记录警告，然后按原版方式加载，因此单个模组出问题也不会导致整个缓存失效。
• 1.21.5 及更新版本不再支持 GPU 端缓存。 Mojang 移除了 DashLoader 之前用于拼接图集和光影缓存的接口。不过模型、精灵图、字体和翻译缓存仍然有效。
• Forge 1.16.5 版本只是初步移植版。 它与其他移植版本没有共用代码，也不包含下文列出的任何修复。请在 1.21.4 或更新版本使用 Fabric 或 NeoForge。

5.1.0-beta.9.7 和 5.1.0-beta.9.8 修复内容

• 序列化流程中存在原生内存泄漏。每个片段的缓冲区都是直接缓冲区，而且从未被释放；由于所有片段都是并行写入的，峰值内存占用会达到整个未压缩缓存的大小。在大型整合包中，这可能会导致 OutOfMemoryError: Direct buffer memory，而此时 Java 堆看起来仍然几乎没有占用。
• 缓存写入可能被中断。保存操作运行在非守护线程上，并直接写入缓存目录，因此如果在保存过程中关闭游戏，下次启动时就会尝试加载一个写入了一半的目录，最终加载失败。现在缓存会先写入临时目录，再移动到目标位置；同时线程也改成了守护线程。
• 进度条可能卡在 100% 以下。片段计数器由多个线程同时更新，导致部分递增操作丢失。
• 缓存发布时存在数据竞争。加载状态可能会在其所指向的数据载荷可见之前变为可见，导致模组悄悄退回原版行为，而不是使用缓存。
• 方块模型的每个四边形都被重复注册了两次，而且扫描方块状态时使用了二次复杂度的算法。
• 缓存提示有时会瞬间消失，看不到结果。

问题反馈

请提供你的 Minecraft 版本、加载器、完整模组列表，以及 latest.log 中相关的部分。如果问题涉及缓存，也请附上实例中的 dashloader-cache 文件夹。

代码仓库：https://github.com/Malionaro/DashLoader