Skip to content

Publish to Pumpkin Market ​v0.0.4

Upload a built Pumpkin plugin .wasm file to a Market listing that already exists. Select the listing by its exact name or numeric/public ID. The action runs on GitHub Actions' Node 24 runtime and needs no setup step; it does not build the plugin or create a listing.

See the action guide and API reference on the documentation site.

yaml
steps:
  - uses: filiphsps/pumpkin-plugins/actions/publish-to-pumpkin-market@publish-to-pumpkin-market-v0.0.4
    with:
      plugin-name: MyPlugin
      version: 1.2.3
      wasm-file: dist/my-plugin.wasm
      api-token: ${{ secrets.MARKET_API_TOKEN }}
      release-notes: |
        ## Changes
        - Fix plugin behavior

The version reference above is this action's Release Please tag. Action releases are independent from plugin releases and other actions, and Release Please creates a new versioned tag when this action changes. The action runs locally in this repository's release workflow from ./actions/publish-to-pumpkin-market.

Use plugin-id instead of plugin-name when the workflow already knows the listing's numeric or public ID. Set exactly one of those inputs.

Inputs ​

InputRequiredDefaultDescription
plugin-nameNoExact listing name; set this or plugin-id, but not both
plugin-idNoNumeric database ID or public ID; set this or plugin-name, but not both
versionYesPlugin version to publish, without a leading v
wasm-fileYesPath to the plugin .wasm file
api-tokenNoMarket API token with plugins:update and plugins:versions:upload scopes; required unless warn is true
api-urlNohttps://market.pumpkinmc.orgPumpkin Market base URL
trackNostableRelease track
release-notesNo""Release notes to include in Market version metadata
warnNofalseWarn instead of failing when credentials or the Market listing are unavailable

Outputs ​

OutputDescription
listing-idResolved numeric Market database ID
listing-nameCanonical Market listing name
statusOperation result (success or skipped)
published-versionVersion successfully published to the listing

Listing lookup follows PPM: try the direct plugin endpoint, then search a limited result set and require a case-insensitive exact name match. An empty token, missing listing, or unpublished listing fails by default. Set warn: true to emit a warning and skip the upload; API errors always fail the action. Successful and skipped uploads are added to the GitHub Actions step summary when one is available.

Pumpkin Plugins documentation