> For the complete documentation index, see [llms.txt](https://stellarskills.gitbook.io/stellarskills-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stellarskills.gitbook.io/stellarskills-docs/journey-expansions.md).

# journey expansions

Additional modules are merged into the main suite. See [Journey guide](file:///4985688/configuration/journey.md).

Server path: `config/stellarskills/journey_expansions.yml`. Shipped snapshot only; do not overwrite an existing server file blindly.

```yaml
schema-version: 1
enabled: true
title: Trainer Journey
subtitle: Advanced server-authored progression systems.
theme: inherit
settings: {}
modules:
  node_trials:
    kind: node-trial
    title: Node Trials
    description: Complete focused field trials before purchasing specially gated node ranks.
    icon: minecraft:trial_key
    accent-color: "#FFCB6B"
    order: 210
    entries:
      critical_throw_exam:
        title: Critical Throw Field Exam
        description: Capture twenty-five Fire-type Pokemon before purchasing rank three of Critical Throw.
        icon: minecraft:target
        event: capture
        target: 25
        filters: { type: fire }
        reward: { experience: 250, title: Trial Certified }
        metadata:
          tree: capture_specialist
          node: critical_throw
          required-rank: 3
          trackable: true

  team_resonance:
    kind: team-resonance
    title: Team Resonance
    description: Live party compositions activate bonuses immediately and deactivate safely when the party changes.
    icon: minecraft:beacon
    accent-color: "#69E8D2"
    order: 220
    entries:
      prismatic_six:
        title: Prismatic Six
        description: Field a full, healthy team with at least six represented types and no duplicate species.
        icon: minecraft:amethyst_cluster
        metadata:
          minimum-party-size: 6
          minimum-unique-types: 6
          unique-species: true
          all-healthy: true
          trackable: false
        effects:
          - key: pixelmon.battle_damage
            operation: multiply-final
            values: [1.03]
      elemental_core:
        title: Elemental Core
        description: Keep Fire, Water, and Grass Pokemon represented in a battle-ready party.
        icon: minecraft:heart_of_the_sea
        order: 20
        metadata:
          minimum-party-size: 3
          required-types: fire,water,grass
          all-healthy: true
          trackable: false
        effects:
          - key: pixelmon.pokemon_xp
            operation: multiply-final
            values: [1.04]

  convergence:
    kind: convergence
    title: Convergence Trees
    description: Multi-class capstones become available when a server permits multiple classes and their requirements meet.
    icon: minecraft:conduit
    accent-color: "#B69CFF"
    order: 230
    entries:
      field_scholar:
        title: Field Scholar Convergence
        description: Select Pokemon Catcher and Pokemon Professor to unlock the packaged Field Scholar convergence tree.
        icon: minecraft:knowledge_book
        required-classes: [capture_specialist, pokemon_professor]
        metadata:
          tree: field_scholar
          trackable: false

  campaign_studio:
    kind: campaign
    title: Branching Field Campaign
    description: A sample campaign with mutually exclusive routes, staged requirements, rewards, and permanent history.
    icon: minecraft:filled_map
    accent-color: "#FF9E6D"
    order: 240
    maximum-selections: 1
    settings: { allow-removal: false }
    entries:
      survey_route:
        title: Survey Route
        description: Commit this campaign to habitat research and careful field records.
        icon: minecraft:spyglass
        selectable: true
        conflicts: [guardian_route]
        metadata: { branch-group: opening_route, trackable: false }
      guardian_route:
        title: Guardian Route
        description: Commit this campaign to defending wild habitats through controlled battles.
        icon: minecraft:shield
        order: 20
        selectable: true
        conflicts: [survey_route]
        metadata: { branch-group: opening_route, trackable: false }
      survey_findings:
        title: Survey Findings
        description: Capture forty different encounters while following the Survey Route.
        icon: minecraft:writable_book
        order: 30
        event: capture
        target: 40
        requires: [survey_route]
        reward: { currency: skill_points, amount: 2, experience: 400 }
      guardian_patrol:
        title: Guardian Patrol
        description: Defeat forty wild Pokemon while following the Guardian Route.
        icon: minecraft:iron_sword
        order: 40
        event: defeat
        target: 40
        requires: [guardian_route]
        reward: { currency: skill_points, amount: 2, experience: 400 }

  seasonal_expedition:
    kind: season
    title: Seasonal Expedition
    description: A configurable seasonal track with UTC scheduling, catch-up multipliers, resets, and repeatable rewards.
    icon: minecraft:clock
    accent-color: "#75BFFF"
    order: 250
    reset: seasonal
    settings:
      season-id: launch_expedition
      progress-multiplier: 1.0
      catch-up-after-percent: 70
      catch-up-multiplier: 1.5
    entries:
      expedition_captures:
        title: Expedition Naturalist
        description: Capture two hundred Pokemon during the active expedition.
        icon: pixelmon:poke_ball
        event: capture
        target: 200
        reward: { currency: skill_points, amount: 4, experience: 1200, badge: Expedition Naturalist }
      expedition_victories:
        title: Expedition Vanguard
        description: Defeat one hundred and fifty wild Pokemon during the active expedition.
        icon: minecraft:diamond_sword
        order: 20
        event: defeat
        target: 150
        reward: { currency: skill_points, amount: 4, experience: 1200, badge: Expedition Vanguard }

  community_projects:
    kind: community-project
    title: Community Projects
    description: Every eligible player contributes to a shared server target; qualifying contributors claim rewards exactly once.
    icon: minecraft:bell
    accent-color: "#76E09D"
    order: 260
    reset: monthly
    settings: { broadcast-completion: true }
    entries:
      fire_habitat_census:
        title: Fire Habitat Census
        description: The server community must document one thousand Fire-type captures this month.
        icon: minecraft:blaze_powder
        event: capture
        target: 1000
        repeat: repeatable
        maximum-completions: 3
        filters: { type: fire }
        reward: { currency: skill_points, amount: 3, experience: 700, badge: Census Contributor }
        metadata: { minimum-contribution: 10, trackable: true }

  field_attunements:
    kind: field-attunement
    title: Field Attunements
    description: Temporary bonuses react to dimension, biome, weather, time, altitude, moon phase, and spawn distance.
    icon: minecraft:recovery_compass
    accent-color: "#7DE8FF"
    order: 270
    entries:
      storm_observer:
        title: Storm Observer
        description: Rain and thunder attune your party to Water-type captures.
        icon: minecraft:lightning_rod
        metadata: { weather: rain,thunder, trackable: false }
        effects:
          - key: pixelmon.capture_power.water
            operation: multiply-final
            values: [1.05]
      moonlit_hunter:
        title: Moonlit Hunter
        description: Nighttime fieldwork improves Dark-type move damage against wild Pokemon.
        icon: minecraft:echo_shard
        order: 20
        metadata: { time: night, trackable: false }
        effects:
          - key: pixelmon.move_damage.dark
            operation: multiply-final
            values: [1.04]

  challenge_oaths:
    kind: oath
    title: Challenge Oaths
    description: Voluntary challenges grant live benefits, track progress, and break immediately on configured failure events.
    icon: minecraft:goat_horn
    accent-color: "#FF718D"
    order: 280
    maximum-selections: 1
    settings: { allow-removal: true }
    entries:
      untouched_streak:
        title: Untouched Challenger
        description: Voluntarily win fifty wild battles without taking Minecraft damage, fainting, healing, or losing a battle.
        icon: minecraft:totem_of_undying
        selectable: true
        event: defeat
        target: 50
        reward: { currency: skill_points, amount: 5, experience: 1500, title: Untouched Challenger }
        metadata:
          break-events: player_damaged,player_death,heal_team,battle_lost
          trackable: true
        effects:
          - key: pixelmon.battle_xp
            operation: multiply-final
            values: [1.08]

  build_advisor:
    kind: build-advisor
    title: Build Advisor
    description: Read-only recommendations score server-authored builds against a player's classes and current party.
    icon: minecraft:compass
    accent-color: "#FFD76A"
    order: 290
    settings: { recommended-score: 50 }
    entries:
      fire_capture_path:
        title: Fire Capture Specialist
        description: Recommended for Catchers fielding Fire Pokemon and investing in type-specific capture power.
        icon: minecraft:blaze_powder
        metadata:
          base-score: 10
          recommended-classes: capture_specialist
          recommended-types: fire
          class-weight: 50
          type-weight: 25
          trackable: false
      balanced_research_path:
        title: Balanced Research Party
        description: Recommended for Professors with broad party type coverage.
        icon: minecraft:book
        order: 20
        metadata:
          base-score: 10
          recommended-classes: pokemon_professor
          prefer-unique-types: true
          class-weight: 55
          trackable: false

  mastery_codex:
    kind: mastery-codex
    title: Mastery Codex
    description: A permanent, searchable record of meaningful species, type, evolution, breeding, and battle milestones.
    icon: minecraft:enchanted_book
    accent-color: "#D4A5FF"
    order: 300
    entries:
      moltres_field_record:
        title: Moltres Field Record
        description: Capture Moltres once to complete this Legendary species page.
        icon: minecraft:fire_charge
        event: capture
        target: 1
        filters: { species: moltres }
        reward: { experience: 500, badge: Moltres Researcher }
      fire_type_volume:
        title: Fire-Type Volume
        description: Record one hundred Fire-type captures in the Mastery Codex.
        icon: minecraft:blaze_powder
        order: 20
        event: capture
        target: 100
        filters: { type: fire }
        reward: { experience: 800 }
      evolution_volume:
        title: Evolution Volume
        description: Witness fifty evolutions across your training career.
        icon: minecraft:nether_star
        order: 30
        event: evolve
        target: 50
        reward: { experience: 800 }

  objective_tracker:
    kind: objective-tracker
    title: Pinned Objective HUD
    description: Pin Journey entries from their detail panel, then control HUD anchor, scale, opacity, and visibility in player settings.
    icon: minecraft:map
    accent-color: "#72F1D1"
    order: 310
    entries:
      tracker_guide:
        title: Tracker Guide
        description: Open any Journey entry and press Pin. Up to eight choices are saved per player and three display at once.
        icon: minecraft:recovery_compass
        metadata: { trackable: false }

  balance_dashboard:
    kind: balance-dashboard
    title: Advanced Balance Dashboard
    description: Admin-only live diagnostics summarize configuration scale, progression, participation, and economy signals.
    icon: minecraft:comparator
    accent-color: "#FFB36B"
    order: 320
    entries:
      live_health:
        title: Live Server Health
        description: Review current configuration and participation diagnostics before changing rewards or progression rates.
        icon: minecraft:calibrated_sculk_sensor
        metadata: { admin-only: true, trackable: false }
```