Itch.io 是國外最大的獨(dú)立游戲分享平臺，免費(fèi)的發(fā)布平臺，開放源代碼，但對國內(nèi)網(wǎng)絡(luò)可能不是很友好。2013 由 Leaf Corcoran 推出網(wǎng)站，之后推出了全平臺客戶端，該網(wǎng)站的政策對于獨(dú)立制作游戲非常友好，對于獨(dú)立游戲的審核也相對寬松，經(jīng)常鼓勵游戲獨(dú)立制作人并且上架他們的作品。

開發(fā)者可以在 Revenue Sharing 設(shè)置中任意調(diào)整分成比例，截至可以不給 Itch.io 抽成，提供參考配置：

? ? itch.io default (10%)

? ? Industry standard (30%)

The itch book https://itch.io/docs/itch/

https://itch.io/docs/butler/

https://broth.itch.ovh/butler

Web 上傳限制作品容量不能超過 2GB，但可以使用 butler 上工具上傳高達(dá) 30GB 的作品。

butler is a small command-line tool that lets you:

1. Upload builds of your games quickly & reliably to itch.io

2. Generate patches and apply them offline

3. Run a few other utility commands

butler is easily integrated into an automated build/deploy pipeline.?Like most of the itch.io delivery infrastructure, it is open-source (MIT licensed):

https://github.com/itchio/butler

It is also a good showcase of the Wharf open specification, using only openly?documented algorithms and file formats, encouraging the development of ompatible tools:

https://docs.itch.ovh/wharf

And is used by the itch app for various operations.

Keep reading to learn how to use it! First you'll want to install butler.

Accepting Payments and Getting Paid?

https://itch.io/docs/creators/payments

Itch.io 收付款只支持兩種方式：

1. **PayPal** — Pay with PayPal balance, card, or bank

2. **Stripe** — Pay with credit or debit card

國內(nèi)注冊 PayPal 賬戶需要提供一個營業(yè)執(zhí)照給 PayPal 才能收款。

還有一種 itch 平臺代收的收款方式，自己注冊一個 Payoneer 賬號綁定國內(nèi)銀行卡。

To close up, here’s a quick recap of the two payout modes itch.io supports:

?* `Direct to you` – Each transaction is handled directly through your PayPal or?Stripe account. You are the merchant of record

?* `Collected by itch.io, paid later` – itch.io’s Stripe and PayPal accounts??handle all transactions, you can request a payout to collect you earnings? in bulk at a later time

https://itch.io/user/settings/seller/get-started

Itch.io 為游戲評論家和作家提供了專門的新聞賬戶 Press Accounts，如果開發(fā)者選擇將游戲加入系統(tǒng)，這些評論家、作家們可以免費(fèi)下載這些付費(fèi)游戲。Partner & Affiliate 合作伙伴和聯(lián)盟計劃是為那些創(chuàng)建專注于游戲和其他媒體內(nèi)容的人提供的一系列工具：

01. A way to verify your identity on itch.io?

? ? — Link your Twitter, Twitch, YouTube, email, etc. —?

? ? So creators can confidently give review copies to trusted people?in the community

02. Access a large collection of paid games (the partner library) that have?opted into the partner system for free access

03. A partner profile page that shows your publications, accounts, and??contributions

04. Affiliate codes — Tag your links to attribute purchases to your account

開發(fā)者可以創(chuàng)建任意 API keys 來訪問 itch.io API 服務(wù)，獲取開發(fā)者賬戶中的游戲產(chǎn)品相關(guān)數(shù)據(jù)。也可以注冊 OAuth Applications 用于開發(fā)第三方登錄應(yīng)用。

https://itch.io/docs/api/overview

https://itch.io/docs/api/serverside

https://itch.io/docs/itch/integrating/api/

服務(wù)器端 API 接口如下，可以獲取開發(fā)者賬戶信息、游戲產(chǎn)品數(shù)據(jù)、用戶已經(jīng)購買的下載鏈接等等：

? ? https://itch.io/api/1/KEY/credentials/info

? ? https://itch.io/api/1/KEY/me

? ? https://itch.io/api/1/KEY/my-games

? ? https://itch.io/api/1/KEY/game/GAME_ID/download_keys

? ? https://itch.io/api/1/KEY/game/GAME_ID/purchases

You can integrate your game with the itch.io API in different ways, depending?on whether they're using the app or not.

When using the app, you can include an app manifest which will directly pass?your game an API key using an environment variable.

Combined with the rest of our server-side API, you can do things like:

01. Authenticate a user (ie. know for sure which itch.io account is playing?your game)

02. Retrieve user information (such as their username, avatar, whether they?have a press account, etc.)

03. Get a proof of purchase

For example, you might want your online play servers to be only accessible by?users who have purchased a legitimate copy of your game, and to all press users.

https://itch.io/docs/itch/integrating/manifest.html

https://itch.io/docs/itch/integrating/manifest-actions.html

https://itch.io/docs/itch/integrating/manifest/validating-your-manifest.html

https://itch.io/docs/itch/integrating/troubleshooting-guide.html

如果使用 itch.io app，則可以使用游戲配置清單文件 manifest，名稱為 `.itch.toml`，App manifests 文件存放于游戲主目錄中。

There are several good reasons to include an app manifest with your game:

1. You want to provide a choice between multiple launch targets

2. Examples: game, level editor, etc.

3. Your app needs access to the itch.io API, for authentication or more

"It launches the wrong thing" is usually a bad reason to ship a manifest,?see Troubleshooting.

清單中添加動作時，path 可以指定一個相于清單文件的路徑，或者一個 URL 地址。如果路徑指向的目錄、程序不存在會觸發(fā)運(yùn)行錯誤，并且路徑相對于安裝目錄，程序路徑使用絕對路徑將不會執(zhí)行。可以給已經(jīng)安裝的游戲添加配置清單，清單動作可以指定 platform 為可執(zhí)行的平臺信息，如 windows/osx/linux，這樣就不會在不兼容的平臺顯示相應(yīng)的動作?？梢允褂?butler 命令行工具驗(yàn)證清單文件的正確性。

動作名稱可以使用任意字符串，但需要自行提供本地化翻譯如果有需要，以下常用的名稱自動多語言適應(yīng)：

1. **play**: shows up as **Play Now** in english, is highlighted

2. **editor**: shows up as **Editor** in english

3. **manual**: shows up as **User Manual** in english

4. **forums**: shows up as **Forums** in english

對于控制臺界面的游戲，可以指定 `console = true` 方式運(yùn)行。

通過指定 `scope = "profile:me"`，游戲程序可以獲取指定作用域配置的 API key。目前唯一支持的作用域 `me` 表示當(dāng)前用戶。設(shè)置此參數(shù)后，itch.io app 會設(shè)置兩個包含 API key 信息的環(huán)境變量，游戲程序可以使用 API key 可以訪問接口提供的各種功能。游戲也可以直接嵌入 API key 訪問服務(wù)接口。

Valid values for scope:

1. `profile:me`: grants access to https://itch.io/api/1/jwt/me

2. (This is the only valid scope for now)

When the `scope` parameter is set, the itch.io app sets the following environment?

variables:

1. `ITCHIO_API_KEY` :a game-specific, session-specific API key

2. `ITCHIO_API_KEY_EXPIRES_AT` the expiration date of the key, in iso-8601 format.

Making requests with the API key

The itch.io API key provided to the game should be the value of an HTTP

header named Authorization.

For example, using the JavaScript library needle, one would do:

Accessing the API key in HTML5 games

The HTML5 environment doesn't grant access to environment variables by design,

so the itch app injects a global object named Itch into the JavaScript runtime.

Here's the proper way to check that it's there:

https://itch.io/docs/itch/using/sandbox.html

使用 `sandbox = true` 選項(xiàng)可以啟用 itch.io 提供的沙箱環(huán)境，防止一些典型的惡意程序搞破壞：

1. Limit what files a process can read

2. Limit what files a process can write to

3. On Linux, be more permissive about writes, but redirect them to a safe, per-game folder

4. On Windows, run games as a different, less-privileged user

一個打印程序接收參數(shù)的 print_args.py 腳本參考：

例如，以下可以通過 print_args.py 腳本來打印 itch.io app 啟動游戲時傳遞的參數(shù)，需要手動復(fù)制 Python 可執(zhí)行程序到游戲主目錄中：

https://itch.io/docs/creators/download-keys

當(dāng)用戶完成支付后，就會獲得相應(yīng)的 Download keys & URLs 以下載游戲文件，以下三種情形都會生成一個 download key：

1. Someone pays for your project (or purchases a bundle that includes your project)

2. You, the project owner, generate one from the project edit page

3. Someone “claims” your project in a 100% off sale/bundle that has claiming enabled

但是用戶下載免費(fèi)項(xiàng)目時，不會生成 download key，用戶不會因?yàn)槊赓M(fèi)下載而擁有一個游戲。但是用戶支持了一個游戲項(xiàng)目，包括價格為 0 的情況，他們?nèi)匀粫@取 download key，并且在項(xiàng)目漲價后依然有效。Download key 對應(yīng)的 URL 鏈接是唯一的，并且不應(yīng)該分享。

Hosting a sale or bundle?

https://itch.io/docs/creators/sales

https://itch.io/docs/creators/bundles

itch.io 上的銷售可以讓你在任何時間段內(nèi)以折扣價提供任何已付款商品的組合。任何人都可以在任何時候舉辦促銷活動！如果你的銷售中有多件商品，那么它們可以捆綁在一起供用戶購買。你可以選擇添加捆綁價格，當(dāng)所有東西一起購買時的自定義價格。每個 Bundle 銷售僅限于 itch.io 上單個帳戶的項(xiàng)目，如果您需要在多個帳戶上托管捆綁包，需要使用配套功能合作捆綁包 co-op bundle。

https://itch.io/docs/creators/html5

https://itch.io/docs/itch/integrating/platforms/web.html

https://github.com/itchio/itch

開發(fā) HTML5 游戲可以直接在 itch.io 頁面上運(yùn)行，無需用戶下載。

桌面程序 itch.io app 基于 Electron 和 React 等開源 Web 框架，使用 TypeScript 語言編寫。App 登錄成功一次之后，就可以離線運(yùn)行。通過 Shift+F12 打開 Chrome Developer Tools 調(diào)試程序。

https://itch.io/docs/creators/css-guide

支持 CSS 編輯，可以在 itch.io 以下頁面中定制樣式：

1. Project pages (Including Devlog posts)

2. Jam pages

3. Profile pages

https://itch.io/jams

https://itch.io/docs/creators/game-jams

itch.io 主頁上有 Game Jams 活動，開發(fā)者可以隨機(jī)加入，并上托管自己的 Jam 作品，或創(chuàng)建比賽。Game Jams 是游戲開發(fā)者用于快速制作游戲的一種賽事，常用于鍛煉和提升游戲開發(fā)者的技能水平。Jam Calendar 中可以看到那些響動正在進(jìn)行，那么已經(jīng)結(jié)束，或者還沒有開始。

最后，歡迎訪問個人主頁?https://jeangowhy.itch.io/ 盡管還沒有任何游戲作品！