packwiz 使用教程从零打造一个能自动更新的 Minecraft 模组包【免费下载链接】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/packwizpackwiz 是一款命令行工具专门用来创建和分发 Minecraft 模组包它的核心思路是不直接管理那一堆 jar 文件而是用一套 Git 友好的 TOML 元数据来描述整个包并且原生支持 CurseForge 与 Modrinth 模组自带自动更新能力。这篇 packwiz 使用教程会按真实上手顺序带你走一遍先装好工具再建出第一个模组包然后往里加模组、让模组保持最新最后把包发出去给别人玩。如果你曾因为手动搬运 jar、整理依赖而头疼或者想给自己的服务器维护一份私有的整合包这篇文章就是为你准备的。读完你大概能掌握packwiz 的安装步骤、核心命令的用法、以及一条从创建到分发的完整路径。这套玩法到底解决了什么问题先说说 packwiz 和传统整合包工具的本质差别。传统做法是直接把所有 mod 的 jar 文件堆进文件夹再手动挑版本、查依赖改一个版本就要重新折腾一遍。而 packwiz 的做法是每个 mod 只对应一个小体积的 TOML 元数据文件.pw.toml里面记录下载地址、文件名、哈希值等信息整个包再通过pack.toml和index.toml两份文件把元数据串起来。这样一来你仓库里存的其实是一堆几百字节的文本文件而不是几十兆的二进制 jar。它们可以放进 Git 里管理团队成员改了什么一目了然合并冲突也好处理得多。玩家拿到的也不再是一次性的压缩包而是一个能持续更新的活的包——这是 packwiz 最打动人的地方。一句话总结packwiz 把整合包从一个静态文件集合变成了一个可版本化、可自动更新的工程。装好 packwiz两种方式任选其一安装属于典型的一次装好长期受用这里给你两条路。直接用现成二进制新手首选。项目为各主流系统都提供了预编译产物下载对应你系统的版本解压后把可执行文件所在的目录加入系统 PATH 环境变量即可。之后在任何终端敲packwiz --help能列出全部子命令就说明装好了。想尝鲜源码一条命令编译。如果你本机装了 Go1.19 或更新版本可以先把仓库克隆到本地git clone https://gitcode.com/gh_mirrors/pa/packwiz进入目录后执行go build编译出的packwiz可执行文件就在当前目录里。整个过程可能需要等一会儿因为要拉取并编译全部依赖耐心一点。装好后建议先跑一遍packwiz --help你会看到 init、add、remove、update、refresh、serve、export 等一长串子命令后面的步骤基本都在围着它们转。第一步三分钟生成你的第一个模组包打开终端新建一个空文件夹并进入它然后输入packwiz init命令会开始一段交互式问答模组包叫什么名字、作者是谁、版本号多少、要支持哪个 Minecraft 版本、用哪个模组加载器Fabric、Quilt、Forge、NeoForge 都可以选也可以选 none 表示不带加载器。大部分问题都给了默认值你直接按回车就能一路走完不想被问就提前用参数指定例如packwiz init --name My Pack --author Me --mc-version 1.20.1 --modloader fabric。执行完毕后文件夹里会多出两份关键文件pack.toml模组包的总配置记录名称、作者、版本、Minecraft 版本、加载器版本等信息index.toml文件索引记录包里所有文件的位置和哈希值。顺便看一眼pack.toml的内容它长这样name My Pack author Me version 1.0.0 pack-format packwiz:1.1.0 [index] file index.toml hash-format sha256 [versions] minecraft 1.20.1 fabric 0.15.11全是普通文本可以直接塞进 Git。这份文件就是以后所有操作的锚点packwiz 的每个命令都会先读它。第二步把模组装进包里只需要一行命令模组包光有骨架可不行接下来往里加模组。packwiz 针对不同模组来源提供了对应的子命令其中 CurseForge 和 Modrinth 是最常用的两个平台。用 slug 或搜索词添加模组。比如在 Modrinth 上你可以直接写模组的短标识名slugpackwiz modrinth add sodium如果拿不准 slug直接把搜索词丢进去也行packwiz 会列出候选结果让你挑选。CurseForge 侧同理用packwiz curseforge add slug即可。直接粘贴链接更省事。从浏览器里复制模组详情页的完整 URL同样可以添加packwiz curseforge add https://www.curseforge.com/minecraft/mc-mods/jei它还有一个通用子命令packwiz add会自动识别你给的是哪种链接。值得一提的是装模组时 packwiz 会自动检查它是否支持当前的 Minecraft 版本和加载器版本不匹配会给出提示避免你装上一个跑不起来的 mod。装错了一条命令撤回。packwiz remove 模组名会把对应的元数据文件和索引条目一起清掉干净利落。每次添加或移除模组后packwiz 都会自动更新index.toml里的哈希确保索引与文件保持一致。你也可以随时用packwiz list查看包里目前有哪些模组还能按客户端/服务端侧过滤方便你区分哪些模组只需在服务器上装。第三步让所有模组自动跟上最新版模组更新是整合包维护里最磨人的环节而 packwiz 把这件事简化成了一条命令。由于每个 mod 的元数据里都记录了来源平台的版本信息和更新接口packwiz 可以主动去查询新版本packwiz update --all运行后它会逐个检查所有模组列出哪些有可用更新并询问你是否确认升级。你也可以只更新某一个模组把它的名字作为参数传给packwiz update 名字即可。配套的两个小工具命令值得记住packwiz pin 名字把一个模组钉在当前版本之后update会跳过它。适合那些换了版本就出事的关键依赖比如前置库packwiz unpin 名字解除钉住状态让它可以继续跟随更新。另外还有一个常被忽略但很重要的命令packwiz refresh。它会把当前文件夹里所有文件重新扫描一遍重新计算哈希并同步到索引。当你手动往包里塞了资源包、配置文件之类的非模组文件时跑一次 refresh 就能让它们进入索引别忘记这一步。第四步把模组包发出去让别人也能玩模组包整理完毕接下来是分发环节packwiz 给了三种由易到难的方案。先用内置服务器本地自测。在包目录下运行packwiz serve它会启动一个本地 HTTP 服务默认端口 8080把整个包作为可下载资源对外提供。这是模拟线上分发的绝佳方式——你可以先在局域网里让朋友试装确认没问题再正式发布。如果只想临时传文件而不做索引刷新还可以加--basic参数退回成最朴素的静态文件服务。导出成平台整合包格式。想发布到 CurseForge 或 Modrinth 生态用packwiz export curseforge或packwiz export modrinth即可它会自动生成平台要求的 zip/mrpack 文件省去手动整理清单的功夫。追求极致体验交给 packwiz-installer。这是 packwiz 生态里最亮眼的一环把模组包托管到任意 HTTP 服务器后玩家用 packwiz-installer 安装一次之后每次启动客户端都会自动检查并拉取更新连检查更新这个动作都不用手动做。私有服务器整合包用这套方案尤其合适——你只需把新版本的元数据推上去玩家的游戏就在下次启动时自动同步。这也是我前面说活着的整合包的真正含义。收尾再往深处走几步回顾一下这条完整路径用init建包、用add装模组、用update保持新鲜、用serve或export分发核心就这四板斧。日常维护里再配合refresh同步索引、pin锁住关键版本基本能覆盖 90% 的使用场景。如果你想把 packwiz 真正玩熟还有几个值得探索的方向migrate子命令可以把 CurseForge 的整合包迁移成 packwiz 格式settings模块可以调整可接受的 Minecraft 版本范围等全局行为想深挖实现原理的话core/目录承载了所有元数据解析和哈希逻辑curseforge/、modrinth/、github/三个目录分别对应各平台的对接实现读一读能对元数据驱动这套设计有更直观的理解。现在就可以动手了打开终端packwiz init建一个你自己的模组包把它推到 Git 仓库里你会立刻感受到文本元数据带来的清爽。祝你早日打造出属于自己的整合包。【免费下载链接】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），仅供参考