Passport Commands & Integrations

Concept Phase

Passport needs a polished player surface and a strict staff surface. Identity systems are high-trust: every link, profile edit, and external render should be auditable.

Player Commands

Command	Purpose
`/passport`	Open your trainer card editor.
`/passport view [player]`	View a public or server-visible trainer card.
`/passport title [title]`	Equip an earned title.
`/passport badges`	Browse earned badges and pin display badges.
`/passport showcase`	Manage Pokemon, Relic, cosmetic, or achievement showcases.
`/passport link`	Generate a web/Discord linking code.
`/passport privacy`	Configure profile visibility and searchable status.

Admin Commands

Command	Purpose	Risk
`/passport admin inspect <player>`	View the full Passport record and audit trail.	Medium
`/passport admin mint badge <player> <badge>`	Manually issue a badge.	Medium
`/passport admin revoke badge <player> <badge>`	Remove a badge with reason.	High
`/passport admin title grant <player> <title>`	Grant a title.	Medium
`/passport admin unlink <player> <provider>`	Remove a web/Discord link.	High
`/passport admin hide <player> [reason]`	Force-hide a public profile.	High
`/passport admin reload`	Reload badges, titles, frames, and display config.	Low

Permission Nodes

Node	Default	Purpose
`passport.use`	true	Access personal profile and trainer card.
`passport.view`	true	View other public profiles.
`passport.link`	true	Link web/Discord accounts.
`passport.admin.inspect`	op	Inspect full records.
`passport.admin.mint`	op	Mint badges/titles manually.
`passport.admin.moderate`	op	Hide profiles, revoke items, unlink accounts.
`passport.admin.reload`	op	Reload Passport config.

Web Integration

Public Profiles

Searchable profile pages for players who opt in, including selected title, badges, showcases, and season history.

Profile Editor

Linked players can manage visibility, badges, titles, showcase slots, and card themes from the browser.

Staff Review

Moderators can inspect link state, audit edits, force-hide profiles, and review reports.

Embeddable Cards

Small rendered profile cards for Discord bots, websites, forum signatures, or server landing pages.

Discord Integration

/passport link DM flow for account linking.
Profile card embeds when a player shares their public Passport.
Optional role sync from titles/badges if staff explicitly maps them.
Staff alerts for suspicious relinks or profile reports.
Event recap cards generated from Jubilee/Festival achievements.

Integration Contract

Other mods should mint Passport artifacts through a small API rather than writing profile state directly.

{
  "type": "passport.badge.mint",
  "player": "uuid",
  "badge": "jubilee:verdant_skies_completion",
  "source": "jubilee:season:verdant_skies_2027",
  "display": {
    "name": "Verdant Skies Finisher",
    "rarity": "epic"
  }
}

Passport validates that the badge definition exists, stores the mint receipt, and emits an unlock notification.

Config Shape

passport {
  profiles {
    defaultVisibility = "server_only"
    allowPublicDirectory = true
    maxShowcaseSlots = 6
  }

  linking {
    web = true
    discord = true
    codeTtlSeconds = 300
  }

  moderation {
    requireAuditReason = true
    staffWebhook = "env:PASSPORT_STAFF_WEBHOOK"
  }
}