十、上传与启用 MOD

制作好 .gsdzmod 后，通过游戏内置的 MOD 管理器上传到你的账户云端，即可启用/停用。

10.1 完整流程

1. 登录：主菜单 → 登录（需已注册账号）；
2. 进入主菜单 → M O D 打开 MOD 管理器；
3. 点击「导入 …」，选择你的 .gsdzmod 文件；
4. 文件上传并解压到服务器，自动加入列表（默认未启用）；
5. 在列表中点击该 MOD → 圆点变绿 = 已启用，数据即时热切换生效；
6. 再次点击 → 变灰 = 已停用，数据还原。

10.2 界面按钮说明

按钮	作用
安装	启用当前选中的 MOD（绿色圆点）
导入 …	上传新的 .gsdzmod 文件
卸载	删除选中的用户 MOD（服务器文件 + 记录一并移除）
查看文件夹	打开服务器 mod 目录（只读提示）
上一页	返回主菜单

10.3 官方 MOD

• 官方 MOD 位于 data/mod/ 目录，由官方发布，与你的 MOD 一同显示在列表中（绿色「官方」标签）；
• 官方 MOD 始终启用、只读，不可卸载、不可停用；
• 官方 MOD 的数据文件结构与用户 MOD 完全一致。

10.4 热切换规则

• 仅能在主菜单或 MOD 管理界面切换——对局中已生成的单位持有旧数据引用，无法热迁移；
• 对局中进入 MOD 管理界面操作会提示「请回到主菜单后再切换」；
• 切换后建议重新开始对局以应用新内容。

10.5 云端存储

• MOD 上传后存储在你的账户云端（服务器文件系统），换设备登录同一账号即可看到并启用；
• 本地不保留 MOD 文件（仅列表缓存）；
• 官方 MOD 从服务器 data/mod/ 读取，本地 file:// 模式仅显示官方 MOD，用户 MOD 需登录后使用。

10.6 常见上传错误

错误提示	原因 / 解决
请先登录	未登录账号，先登录再导入
仅支持 .gsdzmod 文件	扩展名不是 .gsdzmod（本质是 zip，改名即可）
不是有效的 ZIP 文件	文件损坏或不是 zip 格式
压缩包缺少根 mod.ini	mod.ini 必须在压缩包根目录（不要多包一层文件夹）
mod.ini 缺少 [mod] name	mod.ini 里没有 name 字段
mod.ini 引用文件不存在：xxx	引用的 units.ini 等文件不在包内
res/ 仅支持 .png 与 .r	res/ 里有其它类型文件
map/ 仅支持 .json	map/ 里有非 .json 文件（战役地图必须 JSON）
文件超过 20MB / 60MB / 200	超限，精简 MOD
压缩包包含非法路径	包内有 .. 或绝对路径，已拒绝（安全防护）
列表显示「语法错误」标签	加载时严格语法校验失败，该 MOD 未生效。点击弹出详细错误（表/文件/节/字段/行/原因），修复后重新导入或停用再启用。见 MOD 语法校验规则