butler 增量上传:只传差异的发布方式
butler 是 itch.io 的命令行上传工具,玩家侧下载的增量补丁就是它生成的。对更新频繁的项目,它是发布效率的分水岭。
增量在哪里
- 上传侧:butler 对比本地构建与云端旧版本,只上传有差异的块。300 MB 的补丁可能只传 20 MB。
- 下载侧:玩家的客户端收到的是差异补丁,几百 MB 的游戏更新可能几 MB 就打完(见 游戏自动更新)。
两端都省,而且正因为只涉及差异,经常更新的作品(抢先体验、赛季制、jam 后连修)收益最大。
与网页端上传的对比
不想用命令行时,网页端也能上传新版本,但行为差异要知道:
| 操作 | 效果 |
|---|---|
| 网页端上传同名文件 | 替换旧文件,保留下载统计;上传期间该下载暂时不可用 |
| 网页端传新文件再删旧的 | 无停机,但旧文件的下载统计丢失(隐藏旧文件可保留一段时间) |
| butler 推送 | 增量上传,统计与连续性都保住 |
官方文档把网页端流程评价为「不适合频繁更新的游戏」,推荐一律走 butler。别忘了一定要给新构建标对平台标签,玩家侧的兼容过滤靠它(见 跨平台下载)。
更新时对玩家文件的处理
butler 推的版本在玩家侧应用时:旧版本消失的文件被清掉,玩家运行期生成的文件(存档、配置)保留。这意味着重命名关键文件会造成玩家存档悬空,发版前检查文件命名。
在应用里也能推
最新的客户端把 butler 推送集成进了界面,见 创作者面板;命令行形态仍适合接入自动化发布流水线。