当前位置：首页 > news >正文

packwiz 模组包导出教程：如何将包发布到 CurseForge 和 Modrinth

news 2026/6/13 23:09:10

packwiz 模组包导出教程：如何将包发布到 CurseForge 和 Modrinth

【免费下载链接】packwizA command line tool for editing and distributing Minecraft modpacks, using a git-friendly TOML format. Supports CurseForge and Modrinth mods with automated updates!项目地址: https://gitcode.com/gh_mirrors/pa/packwiz

如果你正在寻找一个简单高效的 Minecraft 模组包管理工具，那么 packwiz 绝对是你的最佳选择！这款强大的命令行工具专门为模组包创作者设计，提供了完整的模组包编辑和分发解决方案。无论你是想为服务器创建私有模组包，还是计划将作品发布到 CurseForge 和 Modrinth 平台，packwiz 都能帮你轻松实现。本文将为你详细介绍如何使用 packwiz 将模组包导出并发布到主流平台。

📦 什么是 packwiz？

packwiz 是一个基于 TOML 格式的命令行工具，专门用于创建和管理 Minecraft 模组包。与传统的直接管理 JAR 文件方式不同，packwiz 采用 git 友好的 TOML 元数据文件系统，让你的模组包版本控制变得异常简单。

核心优势：

✅Git 友好的 TOML 格式- 轻松进行版本控制和团队协作
✅多平台支持- 同时支持 CurseForge 和 Modrinth 导出
✅自动更新- 支持模组自动更新功能
✅灵活分发- 适合服务器私有包和公开平台发布

🚀 快速开始 packwiz

安装 packwiz

首先需要获取 packwiz 工具。你可以从项目的 GitHub Actions 页面下载预编译的二进制文件：

# 克隆仓库（如果需要从源码构建） git clone https://gitcode.com/gh_mirrors/pa/packwiz cd packwiz

或者使用 Go 直接安装：

go install github.com/packwiz/packwiz@latest

初始化模组包

创建新的模组包项目非常简单：

packwiz init

这个命令会在当前目录创建pack.toml文件，这是模组包的核心配置文件。你可以在这里设置模组包的基本信息，如名称、版本、Minecraft 版本等。

🔧 添加和管理模组

从 CurseForge 添加模组

packwiz 支持直接从 CurseForge 添加模组：

packwiz curseforge add <mod-slug-or-id>

从 Modrinth 添加模组

同样支持 Modrinth 模组：

packwiz modrinth add <mod-slug-or-id>

更新所有模组

保持模组包最新：

packwiz update --all

📤 导出到 CurseForge 格式

准备导出配置

在导出之前，确保你的pack.toml文件包含完整的导出配置。packwiz 会自动处理大部分配置，但你可能需要检查以下内容：

模组包名称和描述- 确保信息完整
Minecraft 版本- 正确设置目标版本
模组加载器- 指定 Forge、Fabric 或 Quilt

执行 CurseForge 导出

使用以下命令将模组包导出为 CurseForge 兼容的 .zip 格式：

packwiz curseforge export

导出选项：

-s, --side- 指定导出的模组侧（client/server/both）
-o, --output- 指定输出文件名

导出过程：

加载模组包- packwiz 读取当前目录的模组包配置
刷新索引- 确保所有模组文件信息是最新的
过滤模组- 根据指定的侧过滤模组
创建 ZIP 文件- 生成包含manifest.json和modlist.html的标准 CurseForge 包
包含覆盖文件- 自动处理非 CurseForge 模组的本地文件

导出文件结构

生成的 .zip 文件包含以下结构：

模组包名称.zip ├── manifest.json # CurseForge 清单文件 ├── modlist.html # 模组列表文档 └── overrides/ # 本地覆盖文件目录

📤 导出到 Modrinth 格式

Modrinth 导出特点

Modrinth 导出功能在 modrinth/export.go 中实现，提供了专门针对 Modrinth 平台的优化：

packwiz modrinth export

关键特性：

自动哈希计算- 为每个文件生成 SHA1 和 SHA512 哈希值
环境支持- 正确处理客户端/服务器端模组
域限制选项- 可配置允许的下载域名
标准 .mrpack 格式- 完全符合 Modrinth 规范

导出配置选项

packwiz modrinth export --restrictDomains=true -o "我的模组包.mrpack"

参数说明：

--restrictDomains- 限制下载域名（默认为 true）
-o, --output- 指定输出文件名（默认为 pack.toml 中的名称）

Modrinth 包结构

生成的 .mrpack 文件包含：

模组包名称.mrpack ├── modrinth.index.json # Modrinth 清单文件 ├── overrides/ # 通用覆盖文件 ├── client-overrides/ # 客户端专用文件 └── server-overrides/ # 服务器端专用文件

🔄 高级导出技巧

1. 批量导出多个版本

你可以通过脚本自动化导出过程：

#!/bin/bash # 导出到 CurseForge packwiz curseforge export -o "我的模组包-CF.zip" # 导出到 Modrinth packwiz modrinth export -o "我的模组包-MR.mrpack" echo "导出完成！"

2. 自定义导出配置

在pack.toml中添加导出特定配置：

[export.curseforge] project-id = "你的项目ID" additional-files = ["config/", "resourcepacks/"] [export.modrinth] game-versions = ["1.20.1"] loaders = ["fabric"]

3. 处理特殊模组类型

packwiz 智能处理不同类型的模组：

CurseForge 模组- 直接引用 CurseForge 文件 ID
Modrinth 模组- 使用 Modrinth 文件哈希和下载链接
第三方模组- 自动下载并包含在覆盖文件夹中
可选模组- 支持可选模组标记

🛠️ 故障排除指南

常见问题解决

问题1：导出时出现 "Invalid side" 错误

# 确保使用正确的侧参数 packwiz curseforge export -s client # 仅客户端 packwiz curseforge export -s server # 仅服务器 packwiz curseforge export -s both # 默认，两者都包含

问题2：Modrinth 导出失败

检查网络连接，确保可以访问 Modrinth API
验证模组下载链接是否在允许的域名内
确认 pack.toml 中的版本字段不为空

问题3：文件哈希计算错误

确保所有模组文件都能正常下载
检查磁盘空间是否充足
验证文件权限设置

调试技巧

使用详细输出模式查看导出过程：

# 查看详细日志 packwiz curseforge export -v

检查生成的清单文件是否正确：

# 检查 CurseForge manifest.json unzip -p "模组包名称.zip" manifest.json | jq . # 检查 Modrinth modrinth.index.json unzip -p "模组包名称.mrpack" modrinth.index.json | jq .