DoL-Lyra整合包全流程使用指南：从下载到启动的新手必备手册

一、项目核心概述

DoL-Lyra是基于Degrees of Lewdity开发的开源整合包项目，通过GitHub Actions实现自动化打包，为玩家提供多样化的Mod组合方案。项目采用模块化设计，核心文件包括许可证声明（LICENSE、LICENSE2）、说明文档（README.md）、自动化脚本（mod.sh）及资源包存储目录（assets/），所有资源均遵循开源协议规范。

二、资源文件快速定位

2.1 核心文件功能说明

文件路径	类型	作用描述
LICENSE	文本文件	MIT许可证声明，规定软件使用权限
mod.sh	脚本文件	Mod集成自动化处理程序
assets/	目录	存储Mod扩展包，包含KR_Extend.zip和BJ_Extend.zip

2.2 扩展资源包说明

assets目录下提供两类扩展资源：

• KR_Extend.zip：韩语本地化及特色内容扩展包
• BJ_Extend.zip：剧情扩展模组，新增角色互动场景

三、整合包获取与安装步骤

3.1 源码克隆方法

通过以下命令获取项目完整资源：

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

3.2 自动化打包流程

1. 进入项目根目录执行打包脚本：

bash mod.sh

2. 脚本将自动处理assets目录下的扩展包，生成整合后的发布版本
3. 打包完成后在生成目录获取最终整合包（通常为.zip格式）

四、游戏启动完整指南

4.1 前置准备工作

• 确保系统已安装Java运行环境（推荐JDK 11+）
• 解压生成的整合包至不含中文的路径
• 检查解压目录是否包含游戏核心文件（通常为.jar格式）

4.2 启动操作步骤

1. 打开终端并进入解压目录
2. 执行启动命令（根据实际文件名调整）：

java -jar game-core.jar

3. 首次启动会自动生成配置文件，建议等待初始化完成后再进行设置调整

五、常见问题解决

5.1 启动失败处理

• 若提示"Java未找到"，需检查环境变量配置
• 出现Mod冲突时，尝试删除assets目录下不需要的扩展包后重新打包
• 黑屏或卡顿问题可通过降低游戏画质设置解决

5.2 配置文件位置

游戏配置文件通常在首次启动后生成于以下路径：

• 玩家设置：/config/options.txt
• Mod配置：/mods/config/[mod名称].toml 建议修改前备份原始配置文件

六、许可证与合规说明

本项目采用双重许可机制：

• LICENSE：主程序MIT许可协议
• LICENSE2：扩展资源附加条款 使用时需同时遵守两者规定，禁止商用分发未经授权的修改版本

七、资源更新与维护

1. 定期通过git pull获取最新代码：

git pull origin main

2. 执行mod.sh脚本更新整合包
3. 关注项目README.md获取版本更新日志