Jubilee Commands & Integrations

Concept Phase

This page sketches the operational surface for Jubilee: player commands, admin commands, permission nodes, dashboard views, Discord automation, and config shape.

Player Commands

Command	Purpose
`/jubilee`	Open the current season overview.
`/jubilee deeds`	View daily, weekly, seasonal, and community objectives.
`/jubilee garland [track]`	Open the reward track UI.
`/jubilee claim [level]`	Claim an unlocked reward through Treasury.
`/jubilee recap`	View personal season stats and highlights.
`/jubilee leaderboard [deed\|favor\|community]`	View seasonal rankings if enabled.

Admin Commands

Command	Purpose	Risk
`/jubilee admin preview <season>`	Preview an unpublished season.	Low
`/jubilee admin publish <season>`	Publish a season definition.	High
`/jubilee admin pause <season>`	Pause progress grants and scheduled unlocks.	Medium
`/jubilee admin grant favor <player> <amount> [reason]`	Manual Favor compensation.	Medium
`/jubilee admin complete deed <player> <deed>`	Force-complete a deed for support.	Medium
`/jubilee admin reload`	Reload safe config and deed definitions.	Low
`/jubilee admin dryrun rewards <player>`	Simulate claimable rewards without granting.	Low
`/jubilee admin rollback grant <grantId>`	Reverse a mistaken Favor grant if unclaimed.	High

Permission Nodes

Node	Default	Purpose
`jubilee.use`	true	Access the player UI and season status.
`jubilee.claim`	true	Claim unlocked rewards.
`jubilee.leaderboard`	true	View public leaderboards.
`jubilee.admin.preview`	op	Preview draft seasons.
`jubilee.admin.publish`	op	Publish/pause seasons.
`jubilee.admin.grant`	op	Grant Favor or complete deeds.
`jubilee.admin.reload`	op	Reload Jubilee config.

Web Dashboard

Season Landing Page

Public page with the season name, art, countdown, chapter map, reward preview, and community goals.

Player Progress

Linked players can see deeds, Favor, claimed rewards, catch-up bonuses, and recap stats from a browser.

Staff Console

Admins can preview schedules, inspect grants, dry-run rewards, compare chapter pacing, and publish safe changes.

Analytics

Track deed completion rates, track completion, claim rates, chapter drop-off, and community goal velocity.

Discord Integration

Season launch announcement with art, dates, and /jubilee deep link.
Chapter unlock posts with new deed highlights.
Community goal progress embeds.
Reward claim summaries for major milestones.
Finale recap with top contributors, completed goals, and Passport badge winners.
Staff-only alerts for failed reward grants or unsafe config publishes.

Config Shape

jubilee {
  activeSeason = "verdant_skies_2027"

  progress {
    favorPerLevel = 1000
    maxLevel = 100
    restedCatchup = true
  }

  web {
    enabled = true
    publicBaseUrl = "https://play.example.com/jubilee"
  }

  discord {
    enabled = true
    announcementWebhook = "env:JUBILEE_DISCORD_WEBHOOK"
    staffWebhook = "env:JUBILEE_STAFF_WEBHOOK"
  }
}

Integration Contract

Jubilee should receive events, not own every system. Other mods emit stable events; Jubilee maps them to deeds.

{
  "event": "frontier.match_won",
  "player": "uuid",
  "network": "main",
  "node": "survival-2",
  "payload": {
    "queue": "ranked_singles",
    "rating_delta": 14
  }
}

The deed engine turns that into progress only if a published deed is listening for it.