DoL-Lyra整合包构建系统:一键自动化打包的终极指南
【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS
还在为Degrees of Lewdity游戏的各种MOD组合打包而烦恼吗?DoL-Lyra构建系统就像你的专属游戏打包助手,彻底告别手动操作的繁琐流程!这款基于Python的自动化工具专为CI/CD环境设计,让你轻松生成数十种MOD组合的整合包,无论是PC端的ZIP文件还是Android端的APK安装包,都能一键搞定。
🚀 为什么选择DoL-Lyra构建系统?
想象一下这样的场景:你需要为不同玩家群体提供定制化的游戏体验,每个组合都要手动下载资源、修改配置、打包测试。这不仅耗时耗力,还容易出错。DoL-Lyra构建系统正是为了解决这个痛点而生!
核心优势亮点: ✨完全自动化:从资源下载到最终打包,全程无需人工干预 ✨配置驱动:所有MOD组合规则通过TOML配置文件管理,修改简单 ✨并行构建:充分利用多核CPU,性能提升2-6倍 ✨双平台支持:同时生成ZIP(PC/Web)和APK(Android)版本 ✨版本管理:完整的版本信息追踪和记录
🛠️ 快速开始:五分钟上手体验
环境准备超简单
首先确保你的系统满足基本要求:
- Python 3.8+:现代Python版本确保最佳兼容性
- Java 17+:APK构建的必备环境
- Git:版本控制工具
一键安装部署
# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS cd DOL-CHS-MODS # 安装Python依赖 pip install -r requirements.txt # 验证环境 python main.py --help完整的构建流程
DoL-Lyra采用四阶段构建流程,确保每一步都可靠稳定:
# 1. 准备游戏资源 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 # 2. 预热美化资源 python main.py warmup # 3. 并行构建所有组合 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 8 # 4. 生成下载页面 python main.py page --tag v0.5.7.9-5.0.2a-0112 -o download.md🎯 核心功能深度解析
智能MOD组合管理
系统内置了强大的MOD组合计算引擎,支持13种不同的游戏美化功能:
基础美化包:
- BESC:BEEESSS社区精灵合集,提供丰富的角色造型
- Hikari特写:精美的动态特写系统
- UCB:通用战斗美化,提升战斗界面体验
AU身体变体:
- AU Female:女性身体变体
- AU Male:男性身体变体
- AU Androgynous:双性身体变体
功能增强:
- 作弊模块:内置游戏作弊功能
- CSD:战斗状态显示优化
配置文件结构清晰
所有配置都集中在config目录下,管理起来一目了然:
# config/features.toml - MOD功能定义 [[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 = [] # 黑名单并行构建加速技术
系统采用多进程并行构建策略,每个MOD组合都在独立的工作目录中处理:
# 并行构建核心逻辑 success, fail = build_all_parallel( paths=paths, version=version, pack_types=pack_types, max_workers=args.jobs, include_polyfill=True, verbose=args.verbose, )并发配置建议:
- 4GB内存/4核CPU:推荐使用2个进程
- 8GB内存/8核CPU:推荐使用4-6个进程
- 16GB内存/16核CPU:推荐使用8-12个进程
- 32GB+内存/32核+CPU:可使用16+进程
📊 项目架构设计精妙
模块化设计
DoL-Lyra采用高度模块化的架构,每个组件都有明确的职责:
lyra/ ├── paths.py # 路径管理 ├── version.py # 版本信息管理 ├── config.py # MOD代码定义 ├── config_loader.py # 配置文件加载 ├── downloader.py # 资源下载 ├── warmup.py # 资源预热 ├── prepare.py # 游戏预处理 ├── build.py # 核心构建逻辑 ├── parallel.py # 并行构建管理 ├── combo.py # MOD组合计算 ├── gen_page.py # 下载页面生成 └── utils.py # 工具函数资源预热机制
为了避免并行构建时的资源冲突,系统设计了独特的预热机制:
- 串行下载:主进程提前下载所有美化资源
- 固定位置存储:资源解压到workspace/dolp/和workspace/au/目录
- 并行复制:构建时直接从预热目录复制,避免重复下载
版本信息追踪
系统自动记录所有组件的版本信息,便于问题追溯:
{ "汉化仓库": { "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" } }🔧 实用技巧与最佳实践
自定义MOD组合
想要创建自己的MOD组合?只需编辑配置文件:
# 添加新的推荐组合 recommended = [3, 35, 259, 291, 1058, 2082, 4130, 1059] # 修改必须包含的MOD must_include = [] # 取消强制作弊功能 # 添加新的互斥规则 [[rules.exclusive_groups]] mods = [8, 16] # BJ和KR特写互斥 reason = "Sideview样式冲突"优化构建性能
根据你的硬件配置调整并发参数:
# 低配置机器 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 2 # 标准配置 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 4 # 高性能服务器 python main.py build --tag v0.5.7.9-5.0.2a-0112 --jobs 16使用镜像加速下载
当官方资源下载缓慢时,可以配置镜像地址:
[urls] # 使用代理加速 dolp_base = "https://ghproxy.com/https://gitgud.io/Frostberg/degrees-of-lewdity-plus/-/archive/master/degrees-of-lewdity-plus-master.tar.gz"🚨 常见问题解决方案
构建过程中断怎么办?
如果构建过程意外中断,系统会自动清理临时文件。你可以重新运行:
# 重新开始完整流程 python main.py prepare --tag v0.5.7.9-5.0.2a-0112 python main.py warmup python main.py build --tag v0.5.7.9-5.0.2a-0112如何验证构建结果?
系统提供了多种验证方式:
# 列出所有有效组合 python main.py list # 检查汉化仓库更新 python main.py check # 生成构建矩阵(用于CI/CD) python main.py matrix --output-format json内存不足如何处理?
如果遇到内存不足的问题,可以:
- 减少并发进程数:使用--jobs参数控制
- 清理临时文件:删除workspace/extract/目录
- 分批构建:先构建ZIP,再构建APK
# 分批构建示例 python main.py build zip --tag v0.5.7.9-5.0.2a-0112 python main.py build apk --tag v0.5.7.9-5.0.2a-0112📈 高级用法与扩展
集成到CI/CD流水线
DoL-Lyra天生为CI/CD设计,可以轻松集成到GitHub Actions、GitLab CI等平台:
# GitHub Actions示例 name: Build DoL-Lyra on: workflow_dispatch: schedule: - cron: '0 0 * * *' # 每天自动构建 jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.10' - name: Install dependencies run: pip install -r requirements.txt - name: Build packages run: | python main.py prepare --tag ${{ secrets.VERSION_TAG }} python main.py warmup python main.py build --tag ${{ secrets.VERSION_TAG }} --jobs 4自定义APK配置
想要修改APK的包名或版本信息?编辑配置文件即可:
[[apk.replacements]] file = "AndroidManifest.xml" pattern = '"com.vrelnir.dol"' replacement = '"com.yourname.dol"' # 自定义包名 [[apk.replacements]] file = "apktool.yml" pattern = 'versionName: .*' replacement = 'versionName: "Lyra {version}"' # 自定义版本格式添加新的MOD支持
扩展系统支持新的MOD非常简单:
- 定义MOD功能:在config/features.toml中添加
- 配置组合规则:在config/combinations.toml中设置
- 实现构建逻辑:在lyra/build.py中添加处理代码
🎉 开始你的自动化构建之旅
DoL-Lyra构建系统不仅仅是一个工具,更是一套完整的解决方案。它解决了游戏MOD打包中的诸多痛点:
✅自动化程度高:从下载到打包全自动完成 ✅配置灵活:通过配置文件轻松调整MOD组合 ✅性能优秀:并行构建大幅提升效率 ✅可靠性强:完善的错误处理和资源管理 ✅易于扩展:模块化设计便于功能扩展
无论你是个人开发者想要快速生成游戏整合包,还是团队需要建立自动化的构建流水线,DoL-Lyra都能满足你的需求。现在就开始使用这个强大的构建系统,告别繁琐的手动操作,享受自动化带来的便利吧!
官方文档:docs/official.md构建系统源码:lyra/
记住,好的工具让工作事半功倍。DoL-Lyra构建系统正是这样一款能够显著提升你工作效率的工具。立即尝试,体验自动化构建的魅力!
【免费下载链接】DOL-CHS-MODSDegrees of Lewdity 整合项目地址: https://gitcode.com/gh_mirrors/do/DOL-CHS-MODS
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考