Skip to content

Home

Jump to bottom
Antti Mäki edited this page Nov 9, 2021 · 14 revisions

Thunderstore CLI (tcli) is a command line tool for building and uploading game mod packages to Thunderstore mod database.

Authentication

A Thunderstore API token is required to publish packages with tcli. To acquire API token:

  1. Log in to thunderstore.io
  2. Navigate to your team page: Settings > Teams > [Your team name]
  3. From the left sidebar, select Service Accounts
  4. Select Add service account and fill the name of the account into the form
  5. The API token is shown on the following confirmation page

API token is required only for the publish command. There's two ways to use it:

  1. Set it as TCLI_AUTH_TOKEN environment variable
  2. Pass it as a parameter to command: tcli publish --token tss_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If both methods are used, the command parameter takes precedence.

Installation

tcli doesn't currently support installation. Instead, pre-built single-file executables are distributed for each release on Releases page under the Assets section.

Initiation

To initiate package run tcli init. This creates three files in the current directory:

  • icon.png, which will be used as the package's icon on thunderstore.io
    • This is a boring default icon, so preferably replace it with something unique and suitable for your package
  • README.md, which will be included in the package and shown on package's page on thunderstore.io
  • thunderstore.toml which is a configuration file for your package
    • This contains placeholder values which should be updated manually

For full list or parameters run tcli init --help

Building

To build a package run tcli build in a initiated package directory. By default, all the values are read from thunderstore.toml, but some values can be overwritten with parameters.

For full list or parameters run tcli build --help

Publishing

To build and publish a package run tcli publish in a initiated package directory. To publish a package, you must authenticate with API token.

A previously built package can be published with --file parameter.

For full list or parameters run tcli publish --help

Clone this wiki locally