DoL-Lyra整合包完全使用指南：从下载到配置的一站式教程

一、初识DoL-Lyra：整合包的核心价值

DoL-Lyra是基于Degrees of Lewdity项目开发的Mod整合解决方案，通过GitHub Actions实现自动化打包，为玩家提供开箱即用的多样化Mod组合体验。不同于传统游戏项目，该整合包的核心优势在于：

• 模块化组合：通过自动化流程整合各类功能Mod，避免手动安装冲突
• 版本一致性：每个发布版本均经过兼容性测试，确保Mod间协同工作
• 持续更新：依托GitHub Actions实现自动构建，保持与上游项目同步

💡 新手注意事项：该项目仓库仅包含构建脚本和资源文件，不直接提供可玩游戏本体，需通过Release页面获取完整整合包。

二、整合包文件结构解析

graph TD
    A[DoL-Lyra根目录] --> B[README.md 项目说明]
    A --> C[LICENSE 许可协议]
    A --> D[mod.sh 构建脚本]
    A --> E[assets 资源文件夹]
    E --> F[BJ_Extend.zip 北京地区扩展]
    E --> G[KR_Extend.zip 韩国地区扩展]

关键文件功能说明：

• mod.sh：自动化构建核心脚本，负责Mod整合与打包流程
• assets目录：存放地区性扩展资源包，根据游戏版本自动选用
• LICENSE文件：采用MIT许可证，明确用户使用权限与限制

💡 新手注意事项：仓库中未包含游戏执行文件，实际游戏数据将在整合包下载后生成。

三、如何获取与启动整合包

3.1 下载整合包（是什么）

DoL-Lyra采用发布版分发模式，玩家需通过项目发布页面获取打包完成的整合文件。这一机制确保每位用户获得经过测试的稳定版本。

3.2 为什么需要特殊下载流程（为什么）

由于Mod组合的复杂性，直接提供源码无法保证游戏正常运行，自动化构建流程能确保：

• Mod版本兼容性验证
• 资源文件完整性检查
• 平台适配性优化

3.3 具体操作步骤（怎么做）

1. 访问项目发布页面获取最新整合包
2. 使用解压工具提取.zip或.tar.gz文件到本地目录
3. 查阅解压后文件夹内的启动说明.txt执行对应启动程序
   • Java环境通常需执行.jar文件
   • 部分版本可能提供平台专用启动器

💡 新手注意事项：确保电脑已安装Java Runtime Environment (JRE) 8或更高版本，否则可能无法启动游戏。

四、配置文件管理指南

4.1 配置系统概述（是什么）

整合包的配置系统采用模块化设计，将不同Mod的设置分离存储，典型结构包含：

• config/目录：存储各Mod的专业配置文件（.toml/.json格式）
• 游戏设置.ini：全局游戏参数，如分辨率、音效等基础选项

4.2 配置修改的重要性（为什么）

合理调整配置文件可实现：

• 优化性能适配低端设备
• 定制游戏体验符合个人偏好
• 启用/禁用特定Mod功能模块

4.3 安全修改配置的步骤（怎么做）

1. 定位整合包解压目录下的config文件夹
2. 复制要修改的配置文件作为备份（建议命名为文件名_备份.后缀）
3. 使用文本编辑器修改必要参数
4. 保存后启动游戏使设置生效

💡 新手注意事项：修改前务必备份原始配置！错误的参数设置可能导致游戏崩溃或功能异常。

五、常见问题速查

下载与安装

Q: 整合包解压后找不到启动文件？
A: 请检查是否下载了完整的发布包（通常文件名含"full"标识），基础源码包不含游戏执行文件。

启动问题

Q: 双击.jar文件无反应怎么办？
A: 尝试通过命令行启动获取错误信息：java -jar 游戏主文件.jar，通常是Java环境缺失或版本不符。

配置问题

Q: 修改配置后游戏变得卡顿？
A: 建议降低图形渲染相关参数，或删除config目录后重启游戏恢复默认设置。

Mod管理

Q: 如何禁用特定Mod？
A: 在整合包的mods目录中，将对应Mod的.jar文件移动到disabled_mods文件夹即可临时禁用。

六、版本更新与维护

为获得最佳体验，建议定期检查项目发布页面获取更新。更新时只需下载最新整合包，解压后覆盖原游戏目录（注意保留个人存档和配置文件）。整合包设计为向后兼容，通常无需额外迁移操作。

💡 新手注意事项：重要存档文件建议存储在云盘或外部设备，防止更新过程中意外丢失。