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

# integrations

These are **informational operator files**, not a universal integration loader or enable switch. Actual node effects and compatible bridge consumers control behavior. See [integrations guide](file:///4985688/configuration/integrations.md).

## stellar\_safari.yml

Server path: `config/stellarskills/integrations/stellar_safari.yml`.

```yaml
configVersion: 1
integration: stellar_safari
modId: stellar_safari
api: SafariEvents.JoinRequest, SafariEvents.CaptureAttempt, SafariEvents.Captured
effects:
  - key: safari.entry_cost_multiplier
    hook: safari_join
    value: "0.75"
    filters: "zone_id=verdant_reserve,mode=private"
    description: Makes a matching private Safari entry 25% cheaper.
  - key: safari.duration_multiplier
    hook: safari_join
    value: "1.25"
    filters: "zone_id=verdant_reserve"
    description: Gives a matching Safari expedition 25% more time.
  - key: safari.capture_limit_bonus
    hook: safari_capture
    value: "5"
    filters: "zone_id=verdant_reserve"
    description: Adds five captures to the configured per-player limit.
  - key: safari.shiny_chance
    hook: safari_spawn
    value: "0.01"
    filters: "zone_id=verdant_reserve"
    description: Adds a 1% shiny roll to Safari spawns.
  - key: safari.capture_xp
    hook: safari_capture
    value: "15"
    filters: "zone_id=verdant_reserve"
    description: Awards Stellar XP after a successful Safari capture.
  - key: safari.capture_currency
    hook: safari_capture
    value: "1"
    filters: "zone_id=verdant_reserve,currency=skill_points"
    description: Awards configured skill currency after a successful Safari capture.
notes:
  - Safari remains authoritative for zones, economy withdrawal, instance bounds, and capture validation.
```

## stellaranomalies.yml

Server path: `config/stellarskills/integrations/stellaranomalies.yml`.

```yaml
id: stellaranomalies
enabled: true
mod-id: stellar_anomalies
version-range: "[1.0,2.0)"
missing-policy: disable_effect
capabilities:
  - nearby_spawn_chance
  - machine_speed
  - genome_expression_chance
  - genome_rolls
  - cure_aura_chance
  - capture_progress
  - cure_progress
notes:
  - Effects remain purchased but inactive when StellarAnomalies is absent.
  - spawn_chance only affects eligible Pixelmon spawns near the skilled player.
  - machine_speed is snapshotted when treatment starts, so changing skills cannot alter an active treatment.
  - anomaly_capture and anomaly_cure are optional leveling/objective event sources authenticated by StellarAnomalies.
example-node-effects:
  - { key: stellaranomalies.spawn_chance, operation: multiply_final, values: [1.25, 1.50, 2.00], stacking-group: anomaly_sense, cap: 0.10, when-missing: disable_effect }
  - { key: stellaranomalies.machine_speed, operation: multiply_final, values: [1.10, 1.25, 1.50], stacking-group: reversion_engineering, cap: 5.0, when-missing: disable_effect }
  - { key: stellaranomalies.genome_chance, operation: add_percent_points, values: [2, 4, 7], stacking-group: genome_expression, cap: 0.50, when-missing: disable_effect }
  - { key: stellaranomalies.genome_rolls, operation: add_flat, values: [1], stacking-group: genome_rolls, cap: 8, when-missing: disable_effect }
  - { key: stellaranomalies.aura_chance, operation: add_percent_points, values: [1, 2, 4], stacking-group: anomaly_aura, cap: 0.75, when-missing: disable_effect }
```

## stellaraura.yml

Server path: `config/stellarskills/integrations/stellaraura.yml`.

```yaml
id: stellaraura
enabled: true
mod-id: stellar_aura
version-range: "[1.0,2.0)"
missing-policy: disable_effect
capabilities:
  - assignment_chance
  - pool_weight
  - tier_unlock
  - reroll
  - minimum_rarity
  - pity
notes: Effects remain purchased but inactive when the capability handshake is unavailable.
```

## stellarcrates.yml

Server path: `config/stellarskills/integrations/stellarcrates.yml`.

```yaml
configVersion: 1
integration: stellarcrates
modId: stellar_crates
api: CrateEvents.Completed, CrateEvents.VoucherRedeemed
effects:
  - key: stellarcrates.open_xp
    hook: crate_completed
    value: "10"
    filters: "crate_id=legendary"
    description: Awards Stellar XP after a matching crate opening completes.
  - key: stellarcrates.open_currency
    hook: crate_completed
    value: "1"
    filters: "crate_id=legendary,currency=skill_points"
    description: Awards configured skill currency after a matching crate opening.
  - key: stellarcrates.voucher_xp
    hook: voucher_redeemed
    value: "5"
    filters: "voucher_id=starter"
    description: Awards Stellar XP when a matching voucher is redeemed.
  - key: stellarcrates.voucher_currency
    hook: voucher_redeemed
    value: "1"
    filters: "credit_id=stellar:credits,currency=skill_points"
    description: Awards configured skill currency for a matching voucher redemption.
notes:
  - Crates owns opening rolls, rewards, claims, balances, and voucher delivery.
  - These effects only award StellarSkills progression or StellarSkills currencies.
```

## stellardreams.yml

Server path: `config/stellarskills/integrations/stellardreams.yml`.

```yaml
configVersion: 1
integration: stellardreams
modId: stellardreams
api: DreamEvents.EntryRoll, DreamEvents.EncounterWeight
effects:
  - key: stellardreams.entry_chance
    hook: dream_entry_roll
    value: "0.10"
    filters: "dimension=stellardreams:*"
    description: Changes the chance that a qualifying sleep starts a StellarDream.
  - key: stellardreams.encounter_weight
    hook: dream_encounter_weight
    value: "1.50"
    filters: "dream_id=oneiric_skylands,encounter_id=rare_relic"
    description: Increases the selection weight of a configured dream encounter.
  - key: stellardreams.shiny_chance
    hook: dream_spawn
    value: "0.01"
    filters: "dimension=stellardreams:oneiric_skylands"
    description: Adds a 1% shiny roll to dream encounters.
  - key: stellardreams.capture_xp
    hook: dream_capture
    value: "25"
    filters: "dream_id=oneiric_skylands,species=mew"
    description: Awards Stellar XP for a matching dream capture.
  - key: stellardreams.capture_currency
    hook: dream_capture
    value: "1"
    filters: "dream_id=oneiric_skylands,currency=skill_points"
    description: Awards configured skill currency for a matching dream capture.
notes:
  - This file documents the optional bridge; edit graph node effects to enable bonuses.
  - StellarDreams remains authoritative for dream eligibility, transport, encounters, and session state.
```

## titans.yml

Server path: `config/stellarskills/integrations/titans.yml`.

```yaml
enabled: true
required-mod-id: titans
mode: soft-dependency
api-version: 5.11.0
effects:
  outgoing-damage: titans.damage
  incoming-damage: titans.damage_taken
  reward-rolls: titans.loot_rolls
  kill-experience: titans.kill_xp
  kill-currency: titans.kill_currency
  dungeon-experience: titans.dungeon_xp
context:
  titan-id: normalized Titans boss identifier
  titan-tier: normalized Titans tier identifier
  dungeon-id: normalized Titans dungeon identifier
  phase: current boss phase
  dimension: Minecraft dimension identifier
api-calls:
  modifier: StellarSkillsApi.modifyExternal(player, effectKey, base, attributes)
  task-progress: StellarSkillsApi.recordTask(player, event, amount, uniqueKey, attributes)
  objective-progress: StellarSkillsApi.recordObjective(player, event, amount, uniqueKey, attributes)
```