> 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/reference/classes.md).

# classes

See [class guide](file:///4985688/configuration/classes.md) and [Hero guide](file:///4985688/configuration/heroes.md). Hero options are optional and may not be present on a default ordinary class.

**Server path:** `config/stellarskills/classes.yml`

{% hint style="warning" %}
Shipped snapshot only; do not overwrite an existing server file blindly.
{% endhint %}

```yaml
schema-version: 1
enabled: true

required-for-progression: true

main-menu-theme: guild_hall

restrict-tree-access: true

selection:
  minimum: 1
  maximum: 1
  mode: permanent

respec:
  currency: skill_points
  cost: 0
  cooldown-seconds: 86400

classes:
  capture_specialist:
    title: Pokemon Catcher
    description: A Poké Ball expert who studies wild Pokemon, adapts to every type, and turns difficult captures into reliable successes.
    icon: pixelmon:ultra_ball
    accent-color: "#F04F5F"
    background-color: "#29131A"
    order: 10
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [capture_specialist]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Improves Poké Ball power and critical captures
      - Specializes against Fire, Water, and Grass Pokemon
      - Earns better rewards and friendship from successful catches
    metadata: { role: capture, difficulty: approachable }

  ace_trainer:
    title: Ace Trainer
    description: A disciplined battler who develops stronger partners through experience, EV training, friendship, type mastery, and decisive PvE victories.
    icon: minecraft:diamond_sword
    accent-color: "#FFB44D"
    background-color: "#2D1A10"
    order: 20
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [ace_trainer]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Accelerates Pokemon XP, EVs, and friendship
      - Adds PvE battle damage, healing, and critical-hit bonuses
      - Offers Fire, Water, and Electric move specializations
    metadata: { role: battle, difficulty: intermediate }

  pokemon_breeder:
    title: Pokemon Breeder
    description: A patient Day Care specialist focused on eggs, hatching, inherited IVs, natures, abilities, friendship, and rare offspring.
    icon: minecraft:dragon_egg
    accent-color: "#FF9ED7"
    background-color: "#32172B"
    order: 30
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [pokemon_breeder]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Produces eggs and hatches them more efficiently
      - Improves inherited IVs, natures, and abilities
      - Develops happier offspring with rare genetic potential
    metadata: { role: breeding, difficulty: strategic }

  pokemon_professor:
    title: Pokemon Professor
    description: A field researcher who expands the Pokédex, scans distant habitats, studies rare spawns, and identifies exceptional wild Pokemon.
    icon: minecraft:book
    accent-color: "#6ED8FF"
    background-color: "#102638"
    order: 40
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [pokemon_professor]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Improves Pokédex research and registration rewards
      - Extends scanners and reveals rare nearby encounters
      - Studies shiny, hidden-ability, legendary, and high-IV Pokemon
    metadata: { role: research, difficulty: strategic }

  pokeball_artisan:
    title: Poké Ball Artisan
    description: A resourceful craftsperson who cultivates Apricorns and Berries, improves Poké Ball efficiency, and builds a thriving Pokemon economy.
    icon: pixelmon:poke_ball
    accent-color: "#67E39B"
    background-color: "#112B20"
    order: 50
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [pokeball_artisan]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Increases Apricorn, Berry, drop, and fishing yields
      - Improves crafting efficiency and failed-ball recovery
      - Buys for less, sells for more, and earns better battle income
    metadata: { role: economy, difficulty: approachable }

  naturalist:
    title: Pokémon Naturalist
    description: An explorer and field ecologist who documents habitats, follows rare signals, expands the Pokédex, and thrives far from civilization.
    icon: minecraft:recovery_compass
    accent-color: "#7BE09B"
    background-color: "#10291F"
    order: 55
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [naturalist]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Explores faster and detects rare Pokémon and Zygarde cells
      - Improves habitat encounters and Pokédex field research
      - Earns stronger capture and registration benefits outdoors
    metadata: { role: exploration, difficulty: approachable }

  raid_champion:
    title: Raid Champion
    description: A fearless specialist trained to challenge boss Pokemon and raids with greater damage, durability, recovery, and reward potential.
    icon: minecraft:nether_star
    accent-color: "#B88BFF"
    background-color: "#241538"
    order: 60
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [raid_champion]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Deals more damage to boss Pokemon and raid targets
      - Reduces incoming PvE boss and raid damage
      - Improves healing, raid reward rolls, and rare drops
    metadata: { role: raids, difficulty: advanced }

  dungeon_delver:
    title: Dungeon Delver
    description: A resilient expedition specialist built for hostile structures, difficult PvE encounters, rare treasure, and optional Titan hunts.
    icon: minecraft:trial_key
    accent-color: "#E29A5B"
    background-color: "#2B1911"
    order: 70
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [dungeon_delver]
    starting-rewards: { skill_points: 3 }
    highlights:
      - Improves PvE survival, mining, movement, and generated chest rewards
      - Supports optional Titan damage, loot, and dungeon XP when Titans is installed
      - Remains fully useful without Titans because the integration is a soft dependency
    metadata: { role: dungeons, difficulty: advanced, optional-integration: titans }

  chosen_of_arceus:
    title: Chosen of Arceus
    description: A vanishingly rare calling bestowed by fate. Its bearer walks a mythic path among legendary Pokemon, but is never forced to accept the mantle.
    icon: minecraft:nether_star
    accent-color: "#FFE58A"
    background-color: "#241B3B"
    order: 1000
    enabled: true
    hidden: false
    permission: ""
    requires: []
    conflicts: []
    trees: [raid_champion]
    starting-rewards: { skill_points: 5 }
    highlights:
      - A fate-only class that cannot be discovered by reopening the menu
      - Follows the Raid Champion tree as a safe packaged example
      - May be accepted or ignored like any other available class
    hero:
      enabled: true
      chance-percent: 0.1
      badge: MYTHIC HERO CLASS
      reveal-title: A STAR HAS CHOSEN YOU
      reveal-subtitle: Against impossible odds, the Chosen of Arceus has answered your fate.
      reveal-style: divine
      primary-color: "#FFE58A"
      secondary-color: "#B47CFF"
      duration-milliseconds: 8500
      animation-intensity: 1.6
      sound: true
      show-chance: true
      maximum-holders: 1
      inactivity-timeout: 7d
      global-roll-sound: arc
      global-sound-volume: 1.0
      global-sound-pitch: 1.0
    metadata: { role: mythic, difficulty: legendary }
```