{"full_name":"FCL-Team/FoldCraftLauncher","owner":"FCL-Team","name":"FoldCraftLauncher","shard":"1","url":"https://github.com/FCL-Team/FoldCraftLauncher","description":"Fold Craft Launcher, an Android Minecraft : Java Edition launcher.","homepage":"","topics":[],"tag_pages":[],"language":"Java","license":"GPL-3.0","avatar":"https://avatars.githubusercontent.com/u/114871581?v=4","created_at":"2022-10-19T10:12:18Z","pushed_at":"2026-11-15T13:51:32Z","metrics":{"stars":5204,"forks":385,"watchers":58,"issues":1603,"prs":309,"releases":197,"issues_open":334,"issues_closed":1269,"prs_open":5,"prs_closed":65,"prs_merged":239,"discussions":0},"growth":{"day":{"stars":8,"forks":2,"base_day":"2026-11-15"},"week":{"stars":41,"forks":11,"base_day":"2026-11-09"}},"history":{"dates":["2026-11-09","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[5163,5166,5171,5175,5176,5186,5196,5204],"forks":[374,376,379,380,381,383,383,385],"watchers":[58,58,58,58,58,58,58,58],"issues_open":[null,null,328,329,332,332,334,334],"prs_open":[null,null,4,4,4,4,4,5]},"boards":{},"same_owner":[],"issues":[{"number":514,"title":"Error launching minecraft with volcano mod when using the corresponding library.","comments":85,"created_at":"2024-08-14T22:15:31Z"},{"number":1601,"title":"离线模式部分机型不能切换皮肤","comments":18,"created_at":"2026-05-30T05:53:30Z"},{"number":348,"title":"Create mod 1.20.1 fabric crash 😭😭","comments":17,"created_at":"2024-04-14T03:40:14Z"},{"number":370,"title":"Panfrost OpenGL2/3 render method for Mali graphics ","comments":14,"created_at":"2024-05-11T17:53:36Z"},{"number":2009,"title":"附加的jvm参数使用javaagent打开X11窗口，但是X11窗口不显示","comments":13,"created_at":"2026-11-08T09:12:37Z"},{"number":1598,"title":"[renderer]","comments":13,"created_at":"2026-05-27T09:49:08Z"},{"number":1914,"title":"在红米手机上 启动器刷新率锁帧60帧且无法在系统设置里面更改","comments":12,"created_at":"2026-10-05T16:18:03Z"},{"number":1898,"title":"[Bug] FCL 下载高版本 Forge 进度条卡死，网络速率降为 0.0 B/s","comments":12,"created_at":"2026-10-02T12:58:09Z"}],"discussions":[],"latest_release":{"name":"1.3.4.6","tag":"1.3.4.6","published_at":"2026-11-12T03:05:35Z","body":"\n### 中文\n\n#### ✨ 新功能\n\n1. **每版本渲染器覆盖 (#1975)**：渲染器设置此前是全局（或版本特定设置）单值，多个版本使用不同渲染器时每次切换都要进设置页反复改；现支持按版本覆盖——Profile 新增 rendererOverrides 映射（版本 id → 渲染器 id），随配置 JSON 持久化、独立于「启用游戏特定设置」；启动解析单点接入 getLaunchOptions，优先级为 覆盖 > 特定设置 > 全局；版本列表页左下角新增渲染器入口，打开「渲染器覆盖」对话框，列出当前配置的全部版本逐行下拉指定渲染器，默认「跟随设置」（即不覆盖）；存在覆盖时从其他位置（全局设置页、版本特定设置页、长按启动）修改渲染器会弹遮蔽提示，提供「更新覆盖 / 清除覆盖 / 保留覆盖」三选项——全局设置页仅检测当前选中版本，并与既有「该版本启用独立设置」提示合并展示；长按启动被遮蔽提示打断时不自动启动，选择更新/清除覆盖后沿用本次选择继续启动；覆盖指向已卸载或禁用的渲染器时视同无覆盖（启动解析不再回落默认渲染器），对话框打开时顺手清除失效覆盖并落盘；遮蔽提示选择取消时回滚本次已写入版本设置的渲染器，避免放弃启动仍残留修改\n2. **游戏内 DEBUG 分类新增「启动进度遮罩」开关 (#2005)**：游戏菜单设置新增 showLaunchProgress（默认开启，随菜单设置持久化）——开启时启动显示遮罩背景与进度圈（既有默认行为），关闭后启动不再显示遮罩，游戏画面自首帧直接显示；顺带修复日志窗自动显示的首帧误判：GameMenu 现记录 onGraphicOutput 置位的 graphicOutput 标志作为「游戏已渲染首帧」的阶段判断依据，日志窗显隐切换仅在首帧渲染前即时生效，首帧渲染后切换开关不再打断当前状态\n\n#### ⚡ 优化\n\n1. **任务列表任务行增删改为批量刷新 (#2010)**：TaskDialog 任务列表此前每个任务行的增删事件都立即全量刷新 ListView，高速下载时任务行高频变动导致整页卡顿；现任务行增删改为 100ms 批量合并刷新，高频变动一帧只刷一次；页面释放（release）时先摘除任务监听再清理批量刷新队列，避免摘除前窗口期入队的操作在释放后触发刷新\n2. **启动解包内置 jar 前按 .sha1 比对跳过重复释放**：assets 内置 jar（MioLaunchWrapper.jar、MioLibPatcher.jar）新增随包 .sha1 校验文件（构建脚本注册 updateBuiltinJarSha1 任务自动生成续期），启动解包前先比对目标文件摘要，一致则跳过释放，二次启动不再重复写盘\n3. **移除运行环境解压时对小文件的人为延时**：RuntimeUtils 解压运行环境的循环中，对 ≤20KB 的小文件每次人为 sleep 25ms 的逻辑删除（历史遗留的进度展示平滑手段），解压耗时回归真实 IO\n\n#### 🐛 修复\n\n1. **微软账户重新登录等待授权期间允许取消，退出登录页面后对话框卡死 (#2013)**：OAuthAccountLoginDialog 触发重新登录后立即禁用了取消按钮，等待设备码授权期间（可能长达数分钟）既不能取消也不能离开，退出登录页面后对话框卡死；现等待授权期间保留取消按钮，点击即取消进行中的登录任务并静默关闭对话框（不弹错误）；授权超时（NoSelectedCharacterException）同样静默关闭；登录失败弹出错误对话框后，确认按钮恢复可用，可直接重试\n2. **Controlify 需重连手柄才能直通（同步 ZalithLauncher2 PR #2204）**：SDL 的 Android 后端初始化设备扫描受 3 秒节流且跨 SDL_Quit 不重置，游戏启动时可能错过已连接的手柄、或残留上一局的失效设备；标准流程中由 SDLActivity.onCreate 创建的 HIDDeviceManager（USB/蓝牙插拔广播接收器与 hidapi 通道）在本项目的启动路径中缺失，而 Controlify 强制启用 HIDAPI，缺少它时 hid_init 静默失败；现 SdlBridge 在 JNI 就绪后立即主动同步一次 SDL 设备列表（与实际设备的差异直接转为热插拔事件，保证 Controlify 初始发现可用），手动 acquire HIDDeviceManager（进程级仅创建一次，其广播接收器在退出游戏后仍存活以持续感知插拔），并注册系统 InputManager 输入设备监听，手柄插拔时主动同步 SDL 设备列表\n3. **无法启动 Minecraft 13w16a~13w23b 快照 (#2002)**：这批快照缺少非英语语言的外部语言资源包，启动前写入 lang（语言）设置后游戏会卡在 Mojang 加载界面；现该区间快照不再写入 lang，历史已写入的 lang 一并重置为默认英语；同时 has_custom_resolution 特性标志增加版本门控——1.6（快照 13w25a）之前的版本不支持自定义分辨率参数，不再注入。参考 HMCL（https://github.com/HMCL-dev/HMCL/commit/087b2b678d51782f0d6bd64db8a2acd7608c8ee7）\n4. **运行环境安装失败无法定位原因 (#2011)**：RuntimeFragment 安装失败时弹窗仅显示 error.toString()，异常 message 可能为空（如 ROM 层 IO 错误）导致无从排查；现按组件名记录 SEVERE 级日志并在弹窗展示完整调用栈\n5. **游戏内按键投影阴影 (#2007 #2008)**：悬浮于游戏画面上的自定义按键因 elevation 绘制投影阴影，视觉上多出一圈模糊黑边；现 ControlButton 置空 outline（ViewOutlineProvider 返回空轮廓），按键不再投影阴影，elevation 仅保留按键堆叠 z 序\n6. **主界面版本卡片长方形图标被压扁**：版本卡片图标此前以 background 方式承载，30dp×30dp 固定尺寸会将长方形 icon 拉伸变形；现改用 setImageDrawable + fitCenter 等比缩放，任意比例图标不再压扁（无版本时的默认草方块图标同步修正）\n7. **HMCL/MultiMC 整合包启动 NPE**：LauncherHelper Kotlin 化时对 createCompletionTask 误加了非空处理，而 HMCL/MultiMC 类型整合包无补全任务、provider 返回 null，启动直接崩溃；现恢复可空约定，null 时不加入任务列表\n8. **渲染器覆盖对话框行内下拉框撞色**：对话框内 FCLSpinner 的 autoTint 与对话框固定背景撞色（对比色文字看不清），行内 Spinner 关闭自动文字着色\n\n### English\n\n#### ✨ New Features\n\n1. **Per-version renderer overrides (#1975)**: Renderer settings were previously a single global (or per-instance) value, forcing repeated trips into the settings page whenever versions using different renderers were switched; overrides are now supported per version — Profile gained a rendererOverrides map (version id → renderer id), persisted with the config JSON and independent of \"Enable per-instance settings\"; launch resolution hooks into getLaunchOptions at a single point with the priority override > per-instance setting > global; a new renderer entry at the bottom-left of the version list opens a \"Renderer Overrides\" dialog listing every version in the current config with a per-row dropdown to assign a renderer, defaulting to \"Follow settings\" (no override); when an override exists and the renderer is changed elsewhere (global settings page, per-instance settings page, or long-press launch), a masking prompt offers \"Update override / Clear override / Keep override\" — the global settings","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}