SKCraft Launcher命令行工具完整参考PackageBuilder全部参数与用法终极清单【免费下载链接】Launcher Distribute your Minecraft modpacks with a custom launcher项目地址: https://gitcode.com/gh_mirrors/launc/LauncherSKCraft Launcher 是一款用于分发 Minecraft Mod 包的自定义启动器平台其命令行工具 PackageBuilder 可将本地 Mod 包工程一键构建为可上传的发布包支持 Forge、Fabric、Quilt 加载器自动处理与依赖库下载。本文完整列出其全部命令行参数、默认路径规则与常用命令示例帮助新手快速上手自动化打包。为什么要用命令行打包大多数用户使用图形界面Pack Manager来创建 Mod 包但命令行方式更适合持续集成在 CI 服务器上从 Git 自动生成 Mod 包甚至按分支/标签动态生成⚡快速批量一条命令完成扫描、收集文件、下载依赖库、写出 manifest 全流程无人值守配合脚本定期更新 Mod 包版本无需人工干预打包完成后只需将输出目录上传到任意 Web 服务器或 CDN不需要 PHP启动器即可拉取并安装。准备工作编译 launcher-builder 模块项目由 Gradle 管理launcher-builder是独立的命令行构建模块位于 launcher-builder/ 目录核心入口类为 PackageBuilder.java。编译后生成 fat-jar如launcher-builder-x.x.x-SNAPSHOT-all.jar之后即可用java -jar直接运行无需额外安装环境。项目目录约定input 目录的标准结构如果不单独指定路径PackageBuilder 会按以下默认约定解析--input目录默认文件名定义见 BuilderOptions.java默认路径用途modpack.jsonMod 包主配置名称、游戏版本、启动参数、可选特性version.json本地版本清单不指定则自动从官方服务器拉取src/客户端文件目录config、mods、resourcepacks 等loaders/加载器安装程序目录Forge / Fabric / Quilt 的 jar仓库中的示例工程可参考 sample-files/lightpack/modpack.json其完整结构如下lightpack/ ├── modpack.json # 主配置 ├── loaders/ # 加载器 jarForge/Fabric 安装程序 └── src/ ├── config/ ├── mods/ # 可用 _CLIENT / _SERVER 前缀区分端 └── resourcepacks/构建结果与仓库示例 sample-files/upload/ 目录一致包含各 Mod 包的 manifest 文件、objects/去重资源、libraries/依赖库等。PackageBuilder 全部参数终极清单以下参数定义于 BuilderOptions.java按功能分组列出。必填参数2个参数说明--version 版本号本次构建的版本号如20240223用于增量更新判定--manifest-dest 路径输出 manifestmodpack.json的保存路径配置覆盖参数参数说明--name 名称覆盖modpack.json中的name程序内部标识--title 标题覆盖显示标题--mc-version 版本覆盖 Minecraft 游戏版本整体路径参数参数说明--input/-i 目录Mod 包工程目录各输入路径的默认基础--output/-o 目录输出目录objects/libraries的默认基础输入路径参数可缺省缺省值基于--input参数默认值--config 路径--input/modpack.json--version-file 路径--input/version.json不存在则联网拉取--files 目录--input/src--loaders 目录--input/loaders输出路径参数可缺省缺省值基于--output参数说明--objects-dest 目录去重后的 Mod 文件输出目录--libraries-dest 目录依赖库输出目录URL 与格式参数参数默认值说明--libs-url 路径librariesmanifest 中依赖库的相对 URL--objects-url 路径objectsmanifest 中对象文件的相对 URL--pretty-print关输出带缩进格式化的 JSON便于人工查看构建流程一条命令背后的 6 个阶段main方法PackageBuilder.java#L401-L444按固定顺序执行以下步骤读取配置— 解析modpack.json并注册特性features规则读取版本清单— 本地version.json存在则用之否则联网获取扫描— 查找src/下的.info.json定义可选 Mod 特性与.url.txt文件重定向收集文件— 按规则将src/文件复制到objects/并做 SHA1 去重处理加载器 下载依赖库— 识别 Forge新旧两种、Fabric、Quilt 安装程序并从 Maven 仓库下载所需库写出 manifest— 校验名称与游戏版本后生成最终的 modpack.json实用命令示例最简用法利用全部默认约定java -jar launcher-builder-all.jar \ --version 20240223 \ --input lightpack \ --output upload \ --manifest-dest upload/lightpack.json \ --pretty-print指定自定义路径工程结构不规范时java -jar launcher-builder-all.jar \ --version 20240223 \ --config mypack.json \ --files mypack/src \ --loaders mypack/loaders \ --version-file mypack/version.json \ --objects-dest out/objects \ --libraries-dest out/libs \ --output out \ --manifest-dest out/mypack.jsonCI 场景覆盖版本不改配置文件直接注入版本号java -jar launcher-builder-all.jar \ --name mypack --title My Pack --mc-version 1.20.1 \ --version $BUILD_NUMBER \ --input . --output dist \ --manifest-dest dist/mypack.json 小贴士漏写可选路径而未提供--input或--output时会报ParameterException错误信息会明确指出需要补充哪个参数BuilderOptions.java#L102-L112。附赠ServerCopyExport 服务器文件导出工具同一模块还提供 ServerCopyExport.java用于从 Mod 包工程导出纯服务器文件自动跳过_CLIENT目录只有 2 个必填参数参数说明--source 目录源文件目录--dest 目录导出目标目录java -cp launcher-builder-all.jar com.skcraft.launcher.builder.ServerCopyExport \ --source lightpack/src --dest server-files常见问题速查问题原因与解决提示Package name is not definedmodpack.json缺少name字段也未传--name见 PackageBuilder.java#L315-L318加载器被跳过并警告missing metadataloaders/中放了非加载器 jar需放入含install_profile.json/fabric-installer.json的官方安装程序依赖库下载失败日志会打印Failed to download the library检查网络缺失的库会导致安装包不完整想让用户保留自己的选项文件在modpack.json的userFiles.include中列出如options.txt构建完成后将--output目录内容上传到 Web 服务器配合launcher.properties配置即可让 SKCraft Launcher 拉取你的 Mod 包【免费下载链接】Launcher Distribute your Minecraft modpacks with a custom launcher项目地址: https://gitcode.com/gh_mirrors/launc/Launcher创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SKCraft Launcher命令行工具完整参考：PackageBuilder全部参数与用法终极清单
SKCraft Launcher命令行工具完整参考PackageBuilder全部参数与用法终极清单【免费下载链接】Launcher Distribute your Minecraft modpacks with a custom launcher项目地址: https://gitcode.com/gh_mirrors/launc/LauncherSKCraft Launcher 是一款用于分发 Minecraft Mod 包的自定义启动器平台其命令行工具 PackageBuilder 可将本地 Mod 包工程一键构建为可上传的发布包支持 Forge、Fabric、Quilt 加载器自动处理与依赖库下载。本文完整列出其全部命令行参数、默认路径规则与常用命令示例帮助新手快速上手自动化打包。为什么要用命令行打包大多数用户使用图形界面Pack Manager来创建 Mod 包但命令行方式更适合持续集成在 CI 服务器上从 Git 自动生成 Mod 包甚至按分支/标签动态生成⚡快速批量一条命令完成扫描、收集文件、下载依赖库、写出 manifest 全流程无人值守配合脚本定期更新 Mod 包版本无需人工干预打包完成后只需将输出目录上传到任意 Web 服务器或 CDN不需要 PHP启动器即可拉取并安装。准备工作编译 launcher-builder 模块项目由 Gradle 管理launcher-builder是独立的命令行构建模块位于 launcher-builder/ 目录核心入口类为 PackageBuilder.java。编译后生成 fat-jar如launcher-builder-x.x.x-SNAPSHOT-all.jar之后即可用java -jar直接运行无需额外安装环境。项目目录约定input 目录的标准结构如果不单独指定路径PackageBuilder 会按以下默认约定解析--input目录默认文件名定义见 BuilderOptions.java默认路径用途modpack.jsonMod 包主配置名称、游戏版本、启动参数、可选特性version.json本地版本清单不指定则自动从官方服务器拉取src/客户端文件目录config、mods、resourcepacks 等loaders/加载器安装程序目录Forge / Fabric / Quilt 的 jar仓库中的示例工程可参考 sample-files/lightpack/modpack.json其完整结构如下lightpack/ ├── modpack.json # 主配置 ├── loaders/ # 加载器 jarForge/Fabric 安装程序 └── src/ ├── config/ ├── mods/ # 可用 _CLIENT / _SERVER 前缀区分端 └── resourcepacks/构建结果与仓库示例 sample-files/upload/ 目录一致包含各 Mod 包的 manifest 文件、objects/去重资源、libraries/依赖库等。PackageBuilder 全部参数终极清单以下参数定义于 BuilderOptions.java按功能分组列出。必填参数2个参数说明--version 版本号本次构建的版本号如20240223用于增量更新判定--manifest-dest 路径输出 manifestmodpack.json的保存路径配置覆盖参数参数说明--name 名称覆盖modpack.json中的name程序内部标识--title 标题覆盖显示标题--mc-version 版本覆盖 Minecraft 游戏版本整体路径参数参数说明--input/-i 目录Mod 包工程目录各输入路径的默认基础--output/-o 目录输出目录objects/libraries的默认基础输入路径参数可缺省缺省值基于--input参数默认值--config 路径--input/modpack.json--version-file 路径--input/version.json不存在则联网拉取--files 目录--input/src--loaders 目录--input/loaders输出路径参数可缺省缺省值基于--output参数说明--objects-dest 目录去重后的 Mod 文件输出目录--libraries-dest 目录依赖库输出目录URL 与格式参数参数默认值说明--libs-url 路径librariesmanifest 中依赖库的相对 URL--objects-url 路径objectsmanifest 中对象文件的相对 URL--pretty-print关输出带缩进格式化的 JSON便于人工查看构建流程一条命令背后的 6 个阶段main方法PackageBuilder.java#L401-L444按固定顺序执行以下步骤读取配置— 解析modpack.json并注册特性features规则读取版本清单— 本地version.json存在则用之否则联网获取扫描— 查找src/下的.info.json定义可选 Mod 特性与.url.txt文件重定向收集文件— 按规则将src/文件复制到objects/并做 SHA1 去重处理加载器 下载依赖库— 识别 Forge新旧两种、Fabric、Quilt 安装程序并从 Maven 仓库下载所需库写出 manifest— 校验名称与游戏版本后生成最终的 modpack.json实用命令示例最简用法利用全部默认约定java -jar launcher-builder-all.jar \ --version 20240223 \ --input lightpack \ --output upload \ --manifest-dest upload/lightpack.json \ --pretty-print指定自定义路径工程结构不规范时java -jar launcher-builder-all.jar \ --version 20240223 \ --config mypack.json \ --files mypack/src \ --loaders mypack/loaders \ --version-file mypack/version.json \ --objects-dest out/objects \ --libraries-dest out/libs \ --output out \ --manifest-dest out/mypack.jsonCI 场景覆盖版本不改配置文件直接注入版本号java -jar launcher-builder-all.jar \ --name mypack --title My Pack --mc-version 1.20.1 \ --version $BUILD_NUMBER \ --input . --output dist \ --manifest-dest dist/mypack.json 小贴士漏写可选路径而未提供--input或--output时会报ParameterException错误信息会明确指出需要补充哪个参数BuilderOptions.java#L102-L112。附赠ServerCopyExport 服务器文件导出工具同一模块还提供 ServerCopyExport.java用于从 Mod 包工程导出纯服务器文件自动跳过_CLIENT目录只有 2 个必填参数参数说明--source 目录源文件目录--dest 目录导出目标目录java -cp launcher-builder-all.jar com.skcraft.launcher.builder.ServerCopyExport \ --source lightpack/src --dest server-files常见问题速查问题原因与解决提示Package name is not definedmodpack.json缺少name字段也未传--name见 PackageBuilder.java#L315-L318加载器被跳过并警告missing metadataloaders/中放了非加载器 jar需放入含install_profile.json/fabric-installer.json的官方安装程序依赖库下载失败日志会打印Failed to download the library检查网络缺失的库会导致安装包不完整想让用户保留自己的选项文件在modpack.json的userFiles.include中列出如options.txt构建完成后将--output目录内容上传到 Web 服务器配合launcher.properties配置即可让 SKCraft Launcher 拉取你的 Mod 包【免费下载链接】Launcher Distribute your Minecraft modpacks with a custom launcher项目地址: https://gitcode.com/gh_mirrors/launc/Launcher创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考