README

Fold Craft Launcher




!Downloads
!Release







🌍 语言  
简体中文 | English | Русский язык

 你说得对，但是「FoldCraft Launcher」是由FCL-Team基于HMCL的核心功能，使用PojavLauncher后端开发的Minecraft Java版启动器。启动器运行在一个被称作「安卓」的系统，在这里，被系统选中的人将被授予「JVM」，导引Java之力。你将扮演一位名为「小白」的神秘用户，在自由的使用中安装不同版本、各有千秋独特的模组，和它们一起运行，找出崩溃闪退的原因，同时逐步发掘「xxException:」的真相。

 ✨ 项目简介  
 「Fold Craft Launcher」是由FCL团队开发的Android平台Minecraft: Java Edition启动器。基于HMCL的核心功能，使用Amethyst-Android后端，让您能在移动设备上畅玩Java版MC，支持模组加载与全版本运行。

---

 🚀 核心特性

✅ 全版本支持  
- 原生支持 Minecraft 全版本（包括最新快照）
- 模组加载器支持：Forge/NeoForge/LiteLoader/OptiFine/Fabric/Quilt/Cleanroom...

⚙️ 功能亮点  
- 内置多版本 Java 运行时（Java 8/17/21/25）同时支持导入Java
- 虚拟鼠标与自定义按键映射
- 支持 FCL/ZalithLauncher2 控制布局互转，导入 ZL2 布局自动转换
- 光影支持（需VirGL/Zink/MG渲染器）
- 动态资源管理（模组/整合包/材质/光影/存档）
- 个性化主题定制（背景/颜色方案）
- 支持渲染器插件化

---

 🎮 使用截图


  
  
  


---

 📜 开源协议

本项目采用 GPL-3.0 License 授权

---

 🌍 翻译

欢迎参与翻译！本项目通过 Weblate 管理本地化，无需安装任何工具，直接在网页上贡献翻译即可。

---

 🤝 贡献与致谢
 贡献者墙

  


 相关项目
- HMCL：核心功能来源（fclcore 移植自 org.jackhuang.hmcl）
- Boat 及其相关项目
- Amethyst-Android（PojavLauncher Android fork）：JVM 启动与渲染后端
- authlib-injector
- EasyTier：局域网联机组网底层
- Terracotta：基于 EasyTier 的联机方案（Terracotta 模块 JNI 封装）
- TouchController：触摸控制器依赖
- NG-GL4ES：gl4es fork 渲染器
- FCLRendererPlugin：渲染器插件扩展
- FCLDriverPlugin：驱动（Turnip 等）插件扩展

 依赖

本启动器使用了以下开源库：

| 库 | 版权 | 许可证 | 官方链接 |
|---|---|---|---|
| Amethyst-Android（PojavLauncher Android fork） | AngelAuraMC | GPL-3.0 | https://github.com/AngelAuraMC/Amethyst-Android |
| AndroidX（appcompat / constraintlayout / core-ktx / core-splashscreen / datastore / lifecycle / material / palette / recyclerview / viewpager2 / room） | The Android Open Source Project | Apache-2.0 | https://developer.android.com/jetpack |
| ANGLE | The ANGLE Project Authors | BSD-3-Clause | https://chromium.googlesource.com/angle/angle |
| Apache Commons（IO / Compress） | The Apache Software Foundation | Apache-2.0 | https://commons.apache.org/ |
| bhook（ByteHook，exit code 捕获） | ByteDance | MIT | https://github.com/bytedance/bhook |
| Caciocavallo / cacio-tta（AWT 支持） | FCL-Team | GPL-2.0 + Classpath Exception | https://github.com/FCL-Team/caciocavallo17 |
| chardet（编码探测） | Glavo | MPL-1.1 / GPL-3.0 / LGPL-3.0 | https://github.com/Glavo/java-chardet |
| constant-pool-scanner | Jenkins 社区 | CDDL-1.0 / GPL-2.0 | https://github.com/jenkinsci/constant-pool-scanner |
| control-converter（FCL↔ZL2 控制布局转换语义基准） | NingZeStudio | MIT | https://github.com/anylyralabs/control-converter |
| discord-rpc | Discord Inc. | MIT | https://github.com/discord/discord-rpc |
| EasyTier（Terracotta 内嵌组网底层） | EasyTier Authors | LGPL-3.0 | https://github.com/EasyTier/EasyTier |
| Gamepad Remapper | Mathias-Boulay | LGPL-3.0 | https://github.com/Mathias-Boulay/android_gamepad_remapper |
| Glide | Google Inc. | Apache-2.0 | https://github.com/bumptech/glide |
| Gson | Google Inc. | Apache-2.0 | https://github.com/google/gson |
| jelf | fornwall | MIT | https://github.com/fornwall/jelf |
| JNA（Java Native Access） | JNA contributors | Apache-2.0 / LGPL

Top issues

Latest release

中文

 ✨ 新功能

1. 文件下载并行续传 (1960)：单流读循环新增并行续传钩子，复用 BMCLAPI 慢速节点切换同款的 10 秒速度窗口——单连接持续低于 128KB/s 且剩余量按当前速度还需超过一个窗口时，自动切换多连接分块拉取剩余区间，突破网盘直链等按连接数限速的慢速源（修复 Cleanroom alist 镜像 50KB/s 下载缓慢）；触发前零额外请求，快服务器完全不受影响。链路：1 字节 Range 探测（核对 206 响应与总大小，不支持则维持单流）→ 剩余区间按 ≥2MB/块均分最多 8 连接 → 按绝对偏移 FileChannel 写入同一临时文件（保留已完成前缀）→ 复用原有落盘/ZIP 校验/缓存流程；分块读超时放宽至 30 秒且在 resolveConnection 之后设置（按连接限速的服务器数据间歇性滴流，常规 10 秒会反复掐断正常工作的分块连接）；分块失败按轮次统一重试（retry 轮 + 轮间退避），续传请求从已写偏移发 Range 只补未完成区间；全局进度 = 已完成前缀 + Σ(分块已写偏移)，严格单调，修复分块重试重复计字节把进度顶破 100% 导致整轮报废、进度条反复跑满清零的问题；BMCLAPI 链路原慢速节点切换优先级不变（同命中时仍优先换节点，仅末次尝试由并行接管）；并行续传完成后按最终文件重算校验摘要，修复带完整性校验或