3步配置DoL-Lyra整合包：自动化构建系统使用指南

3步配置DoL-Lyra整合包：自动化构建系统使用指南

【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS

DoL-Lyra是一个专为Degrees of Lewdity游戏设计的自动化构建系统，它能够将多个游戏美化模组和功能模块智能组合，生成定制化的游戏整合包。这个工具通过配置驱动的方式，让用户能够灵活选择不同的视觉美化、功能增强和角色模型组合，创建个性化的游戏体验。

核心功能与系统架构

DoL-Lyra构建系统采用模块化设计，将复杂的模组整合过程分解为清晰的四个阶段：资源准备、美化预热、并行构建和页面生成。系统支持13种不同的MOD功能，包括BEEESSS社区精灵合集、作弊功能、多种角色特写、战斗美化等，用户可以根据需求自由组合。

系统依赖与安装要求

在开始配置前，请确保系统满足以下基本要求：

安装系统依赖只需要执行简单的命令：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS cd DOL-CHS-MODS # 安装Python依赖 pip install -r requirements.txt

配置流程详解

第一阶段：游戏资源准备

资源准备阶段负责下载游戏基础文件和必要的功能模块。这一步骤需要指定版本标签，系统会自动从汉化仓库获取对应版本的游戏文件。

# 准备指定版本的资源 python main.py prepare --tag v0.5.7.9-5.0.2a-0112

这个命令会执行以下操作：

• 从汉化仓库下载游戏ZIP和APK文件
• 下载作弊、CSD等核心功能模块
• 获取APK构建工具（apktool和签名工具）
• 生成预处理后的基础游戏包
• 记录所有组件的版本信息

第二阶段：美化资源预热

美化资源预热阶段提前下载所有视觉美化包，避免并行构建时的资源冲突问题。

# 下载并解压所有美化资源 python main.py warmup

系统会处理以下美化资源：

• BEEESSS社区精灵合集（基础美化包）
• Hikari、Goose等角色特写模组
• AU女性、男性、双性三种角色变体
• 通用战斗美化（UCB）组件

第三阶段：并行构建处理

并行构建阶段根据配置生成所有有效的MOD组合，支持ZIP和APK两种输出格式。

# 使用8个进程并行构建所有组合 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 8

构建过程采用进程池技术，每个MOD组合在独立的工作目录中处理：

• 从基础包复制游戏文件
• 应用选定的美化资源
• 注入功能模块代码
• 重新打包为最终文件

系统采用像素艺术风格图标，体现游戏的美学特色

MOD组合配置管理

功能位标志系统

DoL-Lyra使用位运算来管理MOD组合，每个功能对应一个二进制位：

组合代码计算

MOD组合通过位或运算生成代码值。例如：

• BESC + 作弊：1 | 2 = 3
• BESC + 作弊 + Hikari特写：1 | 2 | 32 = 35
• 作弊 + Hikari特写 + AU女性：2 | 32 | 1024 = 1058

配置文件结构

系统配置存储在config目录中，使用TOML格式：

# config/features.toml - 功能定义 [[features]] id = "besc" name = "BESC" bit = 1 required = false skip = false depends_on = [] conflicts_with = ["susato", "goose", "au_f", "au_m", "au_a"] # config/combinations.toml - 组合规则 recommended = [3, 35, 514, 1026] whitelist = [770, 1282, 2306, 4354] blacklist = []

自定义配置方案

修改推荐组合

编辑config/combinations.toml文件可以调整系统推荐的MOD组合：

# 添加新的推荐组合 recommended = [3, 35, 259, 291, 1058, 2082, 4130, 771] # 设置必须包含的功能 must_include = [2] # 所有组合必须包含作弊功能

调整功能依赖关系

在features.toml中可以定义功能之间的依赖和冲突关系：

[[features]] id = "ucb" name = "UCB" bit = 256 required = false depends_on = ["besc"] # UCB需要BESC作为前置 conflicts_with = [] # 无冲突功能

创建个性化构建

通过命令行参数可以构建特定的MOD组合：

# 仅构建ZIP格式的特定组合 python main.py build zip --tag v0.5.7.9-5.0.2a-0112 --codes 3,35,259 # 仅构建APK格式 python main.py build apk --tag v0.5.7.9-5.0.2a-0112 --codes 1058,2082

输出管理与部署

生成下载页面

构建完成后，系统可以自动生成包含所有下载链接的页面：

# 生成Markdown格式的下载页面 python main.py page --tag v0.5.7.9-5.0.2a-0112 -o download.md

生成的页面包含：

• 完整的版本信息
• 所有MOD组合的下载链接
• 文件大小和修改时间
• 兼容性说明

文件命名规范

输出文件遵循统一的命名约定：

DoL-{原版版本}-chs-{汉化版本}-lyra-{MOD组合}-{日期}.{扩展名}

示例文件名：

• DoL-0.5.7.9-chs-5.0.2a-lyra-besc-cheat-0112.zip
• DoL-0.5.7.9-chs-5.0.2a-lyra-besc-cheat-hikari-0112.apk

常见问题处理

构建失败排查

当构建过程出现问题时，可以按照以下步骤排查：

1. 检查网络连接：确认能够访问汉化仓库和资源服务器
2. 验证Java环境：确保Java版本符合要求
3. 检查存储空间：确认有足够的磁盘空间
4. 查看详细日志：使用-v参数获取详细错误信息

# 启用详细日志模式 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 -v

资源下载问题

如果资源下载失败，可以手动配置镜像地址：

# 在config/build.toml中添加镜像配置 [urls] dolp_base = "https://mirror.example.com/dolp-master.tar.gz" au_female = "https://mirror.example.com/AUfemale.zip"

内存不足处理

并行构建可能消耗较多内存，可以通过调整并发数优化：

# 减少并发进程数 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 2 # 仅构建一种格式 python main.py build zip --tag v0.5.7.9-5.0.2a-0112

性能优化建议

构建速度提升

根据硬件配置调整并发参数：

存储空间管理

定期清理临时文件可以释放磁盘空间：

# 清理工作目录中的临时文件 rm -rf workspace/extract/* rm -rf workspace/temp/*

缓存利用策略

系统会自动缓存下载的资源，重复构建时无需重新下载。缓存目录位于：

• workspace/dolp/- DoL+美化包缓存
• workspace/au/- AU变体缓存
• workspace/base/- 基础游戏包缓存

版本管理与更新

版本追踪机制

系统会记录所有组件的版本信息到versions.json文件：

{ "汉化仓库": { "version": "v0.5.7.9-chs-5.0.2a", "source": "Eltirosto/Degrees-of-Lewdity-Chinese-Localization" }, "DoL+": { "version": "abc123def", "source": "gitgud.io/Frostberg/degrees-of-lewdity-plus" } }

更新检查功能

系统提供版本更新检查工具：

# 检查汉化仓库是否有新版本 python main.py check # 检查特定版本 python main.py check --tag v0.5.7.9-5.0.2a

版本回滚处理

如果需要使用旧版本，只需指定对应的版本标签：

# 构建历史版本 python main.py prepare --tag v0.5.6.8-4.9.1b-1201 python main.py build --tag v0.5.6.8-4.9.1b-1201

通过这个配置系统，用户可以轻松创建和管理个性化的Degrees of Lewdity游戏整合包，无需手动处理复杂的模组兼容性问题。系统采用自动化流程确保构建的一致性和可靠性，让玩家能够专注于游戏体验本身。

【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS