SMMODS
Active WIP

Starminer modding is not fully stable yet. Use SMMODS and mod packages at your own risk, and bring questions to the official Starminer Discord in modding-discussions.

Modder account flow

Upload a Starminer mod

Browser uploads are disabled until accounts, storage, AV/deep-inspection validation workers, and moderation are deployed. This page exposes the intended fields without submitting package data.

Disabled submission form

Keep using the manual import path until the deployed backend, storage, antivirus scan, file-signature inspection, archive content policy, and moderation services are validated end to end.

This backend flow stays gated until SMMODS readiness reports live backend coverage.

Upload API

Backend boundary remains explicit

The backend endpoint is POST /api/v1/uploads. Static JSON files in this portal model the published catalog output, not the authenticated upload transaction. Account creation, upload ownership, and moderation review are not live services yet. Even after the backend service is installed, upload creation remains blocked with uploads_disabled until SMMODS_LIVE_UPLOADS=1 is set for go-live. The gated state machine and backend API contract are published at /api/v1/publishing/workflow.json and /api/v1/publishing/backend-contract.json, with a JSON Schema beside the backend contract. Framework validation rules are published at /api/v1/publishing/starminer-publishing-validation.v1.json, and upload status responses will use /api/v1/publishing/upload-submission.schema.json.

Account availability Moderation states Publishing workflow JSON Backend contract JSON Backend schema Validation contract Upload status schema Sidecar schema Read package rules Published catalog shape

Interim publishing

Reviewed releases can be imported manually.

Until real accounts and upload storage exist, maintainers can publish an approved release with a versioned ZIP plus sidecar metadata. The importer verifies manifest identity, target build, dependencies, safe ZIP paths, AV/deep-inspection evidence, immutable artifact paths, and SHA256 before updating the catalog API. 

.\tools\Import-ModRelease.ps1 -PackagePath ".\mod.zip" -MetadataPath ".\mod.release.json"
API publishing notes Portal repository Manager API contract Moderation states