Skip to content
package

GitHub Action

Upload Thunderstore Package

v4.3 Latest version

Upload Thunderstore Package

package

Upload Thunderstore Package

Formats and uploads a Thunderstore package

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Upload Thunderstore Package

              
  uses: GreenTF/upload-thunderstore-package@v4.3
Learn more about this action in GreenTF/upload-thunderstore-package

Choose a version

upload-thunderstore-package

Github action that uses the thunderstore CLI to upload a package to thunderstore

Usage

warning sign
!!!IMPORTANT!!!
DON'T PUT YOUR TOKEN IN THE WORKFLOW FILE. DOING SO WILL ALLOW ANYONE TO UPLOAD ANY MODS UNDER YOUR NAME!

⚠️ Add it to your repo secrets and access it in the workflow with ${{ secrets.YOUR_TOKEN_NAME }} ⚠️

name: Publish Mod

# Run when a new release is... released
on: 
  release:
    types: [published]

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      # Use checkout to publish the files in your repo
      - uses: actions/checkout@v3
      - uses: GreenTF/upload-thunderstore-package@v4.2
        with:
          namespace: GreenTF # the thunderstore 'team' to publish under
          description: Test 
          token: ${{ secrets.YOUR_TOKEN_NAME }}
          name: test # the name of the package
          version: ${{ github.ref_name }} # Use the tag as the package version
          community: Northstar
          repo: northstar.thunderstore.io
          categories: | # <-- notice this pipe character
            foo
            bar-baz

Getting a Thunderstore token

Check the wiki here

Finding the available categories

Figuring out how to refer to your community's categories can be somewhat confusing.

To find the categories available to your community, check out https://thunderstore.io/api/experimental/community/YOUR_COMMUNITY/category/, which will return a list of categories in a JSON format. Each category will have a name value and a slug value. The slug is the value you need to put in the categories list of the action.

Example

curl -X GET "https://thunderstore.io/api/experimental/community/northstar/category/" -H  "accept: application/json" | jq # 'jq' is a command line utility that formats JSON
{
  "pagination": {
    "next_link": null,
    "previous_link": null
  },
  "results": [
    {
      "name": "Models",
      "slug": "models"
    },
    {
      "name": "Maps",
      "slug": "maps"
    },
    // a bunch of others...
  ]
}

Inputs

Input Description Required
token Service account token from Thunderstore. Should be saved as a repo secret and accessed with ${{ secrets.YOUR_TOKEN_NAME }} true
community Thunderstore community to publish to. true
namespace Name of the team to publish under. true
repo URL or hostname of the repository to publish to (see #22). false
name Name of the package. true
description Description of the package that will appear on Thunderstore. true
version Package version in SemVer format. true
file Path to a prebuilt zip file. Will skip the build step if provided. false
path Path of the files to package. Useful when using build artifacts from other steps. Defaults to using the contents of the repo. false
icon URL to download the icon from. Will try to find icon.png in the root of the repo if not provided. false
readme URL to download the readme from. Will try to find README.md in the root of the repo if not provided. false
dev Publish to https://thunderstore.dev if set, https://thunderstore.io if not set. false
wrap Directory to wrap the contents of the repo in. By default the contents of the root of the repo will be in the root of the package. false
categories A list, separated by newline characters, of categories to give to the mod when published. These must be available in the community you're publishing to. false
deps A list, separated by spaces, of mods this mod depends on. Must be in namespace-modname@1.2.3 format. The publish will fail if any of these aren't a real package. false
website The homepage URL for the mod. Defaults to the github repo URL. false
nsfw Set this to true mark the mod as NSFW false

Outputs

Output Description
url The download URL of the published package