首页/资讯中心/详情

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

packwiz 模组包导出教程：如何将包发布到 CurseForge 和 Modrinth
📅 发布时间：2026/6/20 11:11:59

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- 指定输出文件名

导出过程：

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

📈 最佳实践建议

1. 版本控制策略

利用 packwiz 的 TOML 格式优势：

  • 使用 Git 进行版本控制- 所有配置都是文本文件
  • 定期提交更改- 每次添加/更新模组后提交
  • 使用分支管理- 为不同 Minecraft 版本创建分支

2. 模组包优化

  • 保持模组包轻量- 只包含必要的模组
  • 定期更新模组- 使用packwiz update保持最新
  • 测试兼容性- 在发布前进行全面测试

3. 发布准备

在发布到平台前：

  1. 完整测试- 确保模组包能正常启动和运行
  2. 检查依赖- 验证所有必需的前置模组
  3. 编写文档- 提供清晰的安装和使用说明
  4. 准备截图- 展示模组包特色内容

🎯 总结

packwiz 为 Minecraft 模组包创作者提供了一个强大而灵活的工具链。通过本文的教程，你已经掌握了：

✅packwiz 的基本安装和使用
✅模组的添加和管理方法
✅CurseForge 格式导出步骤
✅Modrinth 格式导出流程
✅高级技巧和故障排除

无论你是要为私人服务器创建模组包，还是计划在 CurseForge 和 Modrinth 上发布作品，packwiz 都能帮助你高效完成工作。记住，成功的模组包不仅需要技术实现，更需要持续的维护和社区支持。

现在就开始使用 packwiz，将你的创意转化为精彩的 Minecraft 模组包吧！ 🎮✨

提示：更多详细信息和高级功能，请参考 packwiz 的官方文档和社区资源。

【免费下载链接】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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考