# Live Ops Season, Events, And Hotfix Playbook

This playbook covers the `LiveOpsSubsystem` surfaces for season passes, live
events, content delivery, hotfixes, DLC, patch notes, compensation, planning,
and analytics.

## Season Passes

Define each season with start/end times, ordered XP tiers, and separate free and
premium reward lists. Rewards use a stable reward ID and one of the supported
reward types: cosmetic, currency, item, emote, or title.

XP sources should identify where XP came from:

- match completion
- daily challenge
- weekly challenge
- event bonus

The progression helper applies XP sources, calculates level changes, and returns
claimable rewards. Claim rewards only through the claim helper so already
claimed reward IDs remain stable.

## Challenges

Daily and weekly challenge rotations are selected from a weighted pool with a
stable seed. This keeps rotations reproducible for support, QA, and rollback
analysis while still giving variety across rotation windows.

Challenge definitions should include cadence, objective, XP reward, optional
currency reward, weight, and any player-level gate.

## Events And Content Delivery

Live events define active windows, event game modes, rewards, and asset IDs. The
event helpers return active events and enabled limited-time modes for a given
timestamp.

Content delivery plans resolve requested asset IDs to CDN assets, enforce DLC or
expansion entitlements, total the download size, and report missing or locked
assets. Use this plan to download event maps, cosmetics, NPC dialogue, and other
data packs on demand.

## Hotfixes

Hotfix patches target a specific config version and carry data-only config
changes plus a reason and timestamp. Apply hotfixes to create a new version
based on the targeted config.

Run the hotfix testing pipeline before deployment. A hotfix can deploy only when
all regression tests pass.

## DLC And Patch Notes

DLC packs define an entitlement and asset list. Unlocking a pack verifies the
player entitlement and returns the downloadable assets.

Patch notes are structured by category so clients can display balance changes,
bug fixes, new content, events, and systems updates in-game.

## Compensation

Compensation grants identify affected players, active grant windows, reason, and
reward payloads. Resolve compensation by player ID and timestamp before granting
items or currency.

## Calendar And Analytics

The content calendar normalizes planned item status and detects overlapping
items of the same kind. Use it to plan seasons, events, patches, and hotfixes
months ahead.

Live ops analytics summarizes:

- season pass completion rate
- live event participation rate
- hotfix incident reduction

Review analytics after every event and hotfix so the next calendar update is
based on measured player behavior and operational impact.
