如何使用 Butler 为 itch.io 上传游戏包


当需要在 itch.io 网站上头发售游戏的时候,命令行工具 Butler 可能是你逃不脱的玩意,相较于其他平台更为繁琐的上传流程与步骤,Butler 其实提供了一个相当清爽的游戏包提上传的方式,而学习怎么使用 Butler 其实相当容易,下面就将简单介绍一下这个工具的使用方法。

👨‍💻 安装 Butler

安装 Butler 其实相当容易,访问 https://itchio.itch.io/butler

Butler

在该网页中选择自己使用的系统版本,下载解压即可,解压完毕之后会看到如下的内容。

解压后的内容

🛣️ 将 Butler 加入 PATH 中(可选步骤)

如果想要在之后的使用中,让整个操作更加丝滑,可以考虑下直接将 Butler 加入到 PATH 中,而不是每次先通过 Terminal 找到 Butler 然后再使用 Butler 上传游戏包的模式。

💻 Windows:将 Butler 加入到 PATH 中

本指南使用的 Windows 版本为 Windows 11, 其他版本应也能够通过类似的方法找到对应的设置

  1. 按 Windows + Q,调用搜索栏,查找查找**高级系统设置**(或者你跟我一样搜索 Advanced System Settings),

Screenshot 6_6_2024 2_36_36 PM.png

  1. 点击打开后,在系统属性窗口中选择右下角的**环境变量**。

 6_6_2024 2_36_49 PM.png

  1. 在随后的环境变量窗口下找到下方系统变量的中的 Path,点击**编辑**

 6_6_2024 2_37_03 PM.png

  1. 随后在新出现的编辑窗口中,选择**新建**,把刚刚下载好的 Butler 的路径写到环境变量里头即可

 6_6_2024 2_37_11 PM.png

💻 macOS:将 Butler 加入到 Path 中

相当简单,使用 export PATH=$PATH:加上Butler所在的路径 ,即可。不过在使用前记得检查一下 butler 是否可运行,如果出现不可运行的提示,记得在System Setting - Privacy & Security 中点允许运行。

🎈 使用 Butler 进行游戏包上传

1. 检查一下是否配置妥当

如果你已经按照如上所诉的指南完成了 Butler 的下载安装,那么现在就来看一下 butler 是否可以正常运行了!

在命令行中输入 butler -V (记得是大写的 V),看到类似如下的文字即代表你已经准备就绪

Screenshot 2024-06-06 at 3.22.42PM.png

2. 登录 Itch 账号

为了能够在下面继续使用 butler 为账号上传游戏包,那么接下来一步就是使用 butler 登录 itch.io。使用命令 butler login,看到类似如下的画面,等待浏览器弹出授权,点击授权通过即可。

Screenshot 2024-06-06 at 3.26.20PM.png

如果已经完成登录,那么使用 butler login如果看到如下的提示,则代表着登录成功。

Screenshot 2024-06-06 at 3.28.51PM.png

3. 使用 butler 进行传包

那么接下来的事情就相当简单了。你只需要记住一个命令:butler push 包地址 用户名/游戏名:channel

我们举个例子,我们的 Windows 版本的游戏存在了 ~/Downloads/GameBuild/GameBuild.zip 中,用户名叫 2PGames,游戏叫 ExampleGame的话。那么这段命令即为:

butler push ~/Downloads/GameBuild/GameBuild.zip 2PGames/ExampleGame:windows

因为 Itch 需要知道你的游戏包是为什么平台使用的,所以在后头的的 Channel 中需要标记所属平台,它可以是 osx, linux, soundtrack等等,看具体需求哈

如果一切顺利,那么你将看到如下的进度条:

butler-push-first.gif

随后让在上传完毕后,itch 后台将会处理一下刚刚上传的文件,大概在几分钟后,你就能够在自己的后台上看到对应的游戏包了!