# Mod Distribution Publisher Guide

The modding distribution helpers model marketplace workflows without binding the
game to a specific provider SDK. Steam Workshop and mod.io adapters can map
these plans to real platform calls at the application boundary.

## Provider Publishing

- `createSteamWorkshopPublishPlan` prepares archive and metadata fields for
  Steam Workshop publishing.
- `createModIoPublishPlan` prepares equivalent mod.io publishing metadata.
- `createProviderDownloadPlan` turns a provider listing into a deterministic
  download plan for install, update, collection, and multiplayer flows.

## Browser and Updates

`createModBrowserViewModel` filters listings by text, tag, provider, and
installed state, then sorts by rating, downloads, update time, or name. Rows
include preview imagery, install state, and update availability.

`createModAutoUpdatePlan` compares subscriptions against current provider
listings and returns download plans only when auto-update is enabled and a newer
version exists.

## Review and Policy

`reviewModSubmission` checks declared license, archive budget, text policy, and
declared script packaging. The returned decision records findings with severity
so publisher tools can approve, reject, or request changes.

Use policy inputs from your moderation and legal teams rather than baking
provider-specific rules into mods.

## Ratings, Collections, and Analytics

- `createModRatingSummary` aggregates star ratings and helpful votes.
- `createModCollection` deduplicates curated modpack contents.
- `createCollectionDownloadPlans` resolves a collection into provider downloads.
- `createModDownloadStats` reports total and recent download activity.
- `createModAuthorDashboard` summarizes author listings, downloads, ratings,
  pending reviews, and update actions.

## Compatibility

`detectModDistributionConflicts` reports shared asset or entity resources across
packages. `checkModSaveCompatibility` identifies missing mods for a save file.
`createModMultiplayerCompatibilityReport` compares host requirements against a
client's installed versions and prepares download plans for missing provider
listings.

## Legal Acceptance

`createModLegalPolicy`, `recordModLegalAcceptance`, and `canPublishMod` keep
publisher-side EULA and license checks explicit. Store acceptance records with
the publishing account before uploads are enabled.
