游戏Mod整合与自动化部署完全指南：DoL-Lyra整合包使用手册

DoL-Lyra是一个基于Degrees of Lewdity游戏的开源游戏插件整合项目，通过ModLoader配置实现多种模组组合管理。本指南将帮助你快速掌握整合包的安装部署、核心组件使用及常见问题解决，让游戏体验定制化变得轻松简单。

快速上手：三步完成整合包部署

环境准备清单

• 🌟 基础工具：Git客户端（版本控制工具）、现代浏览器
• 🔧 设备支持：Android设备（APK安装）或电脑（ZIP解压运行）
• ⚠️ 前置检查：执行以下命令确认环境就绪

# 检查Git是否安装
git --version
# 检查网络连接
ping -c 3 github.com

实战部署流程

1️⃣ 获取项目源码
打开终端执行克隆命令，将仓库复制到本地：

git clone https://gitcode.com/gh_mirrors/do/DoL-Lyra.git

2️⃣ 进入工作目录
通过命令导航到项目文件夹：

cd DoL-Lyra

3️⃣ 选择整合包版本
查看assets目录下的可用资源：

ls -l assets/
# 典型输出：BJ_Extend.zip  KR_Extend.zip

💡 记忆口诀：克隆→进入→选择，三步搞定基础部署！

核心组件解析：整合包架构详解

自动化构建系统

• GitHub Actions（持续集成自动化工具）：像工厂流水线一样自动完成模组打包，确保每次更新都能快速生成可用版本
• Shell脚本引擎：通过mod.sh文件实现打包逻辑控制，就像厨师的菜谱一样精确调配各种模组原料

模组管理机制

• 完整整合包：包含游戏本体+精选模组的一站式解决方案，无需额外下载基础游戏
• 版本标识规则：文件名格式遵循dol-{原版版本}-chsmods-{汉化版本}-{MODS}-{日期}.{格式}，例如dol-v1.3.0-chsmods-20240415-BJ_Extend-20240415.zip

资源包结构

DoL-Lyra/
├── assets/           # 模组资源压缩包
│   ├── BJ_Extend.zip # BJ特写扩展包
│   └── KR_Extend.zip # KR特写扩展包
├── mod.sh            # 自动化打包脚本
└── README.md         # 项目说明文档

实战配置指南：设备差异化部署方案

Android设备安装流程

1. 从assets目录获取APK文件（若未找到可访问项目发布页）
2. 通过USB或云存储将APK传输到设备
3. 点击安装并允许"未知来源"权限
4. 首次启动时等待资源初始化（约30秒）

⚠️ 常见问题：若出现英文界面或无ModLoader，执行以下操作：

• 更新系统WebView组件
• 尝试"兼容版"APK
• 备用方案：使用浏览器访问在线版

电脑版运行指南

1. 解压assets目录中的ZIP文件到任意位置
2. 打开解压文件夹，找到index.html
3. 用Chrome/Firefox等现代浏览器打开该文件
4. 游戏会自动加载内置模组配置

💡 优化建议：浏览器中按F11进入全屏模式获得更佳体验

问题诊断手册：常见错误代码速查

模组加载类问题

错误现象	可能原因	解决方案
"bootJson文件无效"	将整合包当作普通模组加载	直接运行整合包，无需通过ModLoader导入
中英文混杂显示	冲突的汉化模组	卸载ModLoader中的其他汉化插件
美化资源不生效	图片包模组优先级过高	移除GameOriginalImagePack-*.mod.zip

版本兼容类问题

• ⚠️ APK安装失败：检查Android系统版本是否≥7.0
• ⚠️ 存档无法迁移：使用游戏内"导出存档"功能生成备份文件
• ⚠️ 在线版卡顿：清除浏览器缓存或切换至Chrome浏览器

高级应用技巧：定制化游戏体验

模组组合策略

• 战斗强化包：选择包含CSD（战斗状态显示）的版本
• 视觉优化包：优先使用带BJ/KR特写的整合包
• 纯净体验包：基础版仅包含核心汉化和必要修复

更新维护技巧

1. 定期执行git pull获取最新代码
2. 关注更新日志中的"点击展开"部分查看变更记录
3. 重大版本更新前建议备份存档文件

💡 专业提示：使用git log -p mod.sh命令可查看打包脚本的历史修改，了解整合逻辑变化

整合包使用须知

• 本整合包为独立完整版本，禁止通过ModLoader再次加载
• Android版应用名称为"DoL Lyra"，可与官方版共存
• 出现问题时请先使用纯汉化版测试，确认是否为整合包特有问题
• 图片资源通过游戏目录直接加载，无需额外Mod支持

通过本指南，你已掌握DoL-Lyra整合包的安装部署、组件解析和问题处理全部技能。现在就开始定制属于你的游戏体验吧！如有其他疑问，可查阅项目README.md获取更多细节。