fcl启动器加mod必须严格匹配版本、路径和依赖：先在“版本管理”确认完整标识（如forge-49.0.27-1.21.1），再通过“资源管理→打开游戏目录”进入android/data/com.fcl.launcher/files/.minecraft/，手动创建小写mods文件夹；下载对应版本的.jar/.zip格式mod（禁用中文与特殊符号），并放入前置依赖；开启“版本隔离”与足量jvm内存（如-xmx4g）；启动后查日志定位报错原因。
想在FCL启动器里加Mod插件却找不到mods文件夹、复制后游戏不识别、启动直接报错——这些问题都卡在几个关键动作没做对。FCL是手机端Java版MC专用启动器，它的Mod加载机制和PC端PCL2不同，不能靠自动创建目录或拖拽即生效，必须严格匹配路径、版本和前置依赖。
确认当前游戏版本与Mod兼容性
打开FCL启动器→点击右上角「设置」→进入「版本管理」→查看当前选中版本的完整标识，例如 【fabric-0.16.3-1.21.1】 或 【forge-49.0.27-1.21.1】。这个字符串必须和你要装的Mod文件名里的版本号完全一致，比如一个叫「journeymap-fabric-1.21.1-5.10.1.jar」的Mod，只适用于fabric+1.21.1环境，放进forge版本里会直接被忽略。
去Mod发布页（如Modrinth、CurseForge）下载时，务必点开「Versions」标签页，手动筛选匹配你FCL中显示的完整版本组合，别只看“1.21”就下。
找到并进入正确的mods文件夹
FCL不会在首次启动时自动创建mods文件夹，也不能用系统文件管理器随便建一个就完事。必须通过启动器内部路径定位：
在FCL主界面→点击左上角「三横线」菜单→选择「资源管理」→点击「打开游戏目录」→系统会跳转到类似 /Android/data/com.fcl.launcher/files/.minecraft/ 的路径。
在这个目录下，手动新建一个名为 mods 的纯英文文件夹，注意大小写必须是小写 mods，不能是 Mods、MODS 或 mod。如果已有该文件夹但为空，检查它是否被设为隐藏属性（部分安卓文件管理器会默认隐藏以点开头的目录，但mods不是）。
放入Mod文件并验证格式
将下载好的Mod文件（必须是 .jar 或 .zip 格式，不能是 .rar、.7z 或带解压说明的压缩包）直接复制进刚才建好的 mods 文件夹。
重点检查：文件名里不能含中文、空格、括号或特殊符号（如「我的世界光影优化_v2.1[修复版].jar」会加载失败），建议重命名为「jei-fabric-1.21.1-15.1.0.1.jar」这类纯英文+数字格式。
如果Mod说明文档提到需要前置模组（比如「Requires Fabric API v0.92.0+」），必须先把Fabric API对应版本的jar也丢进同一mods文件夹，否则启动时会提示「Missing required dependency」并跳过加载。
启动前必调的两项设置
方法一：启用版本隔离
返回FCL主界面→点击右上角「设置」→找到「高级设置」→开启「版本隔离」开关。这一步不做，多个版本共用一个mods文件夹会导致缓存混乱，旧Mod残留干扰新版本加载。
方法二：分配足够内存
仍在「设置」中→进入「JVM参数」→修改 -Xmx 值，例如改为 -Xmx4G（4GB）。含10个以上Mod的整合包至少需3GB起步，2GB以下大概率卡在加载界面不动。
启动并排查常见失败
第一步：在FCL主界面长按目标版本→选择「启动」→等待黑屏LOGO出现后观察底部日志流。
第二步：若卡在「Loading mods…」超过90秒，立即点返回键中断启动，去「资源管理」→「打开日志文件」→滑动到底部找含「Failed to load mod」或「NoSuchMethodError」的红字行。
第三步：根据报错关键词反查Mod文档——比如报「NoClassDefFoundError: net/fabricmc/fabric/api/client/rendering/v1/HudRenderCallback」，说明缺Fabric API；报「Incompatible mod version for Minecraft 1.21」，说明Mod文件本身打包错误或版本硬编码不匹配。
第四步：确认无误后，重启FCL，再次启动该版本。
