> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/codexmomentum/momentum/visuals.md).

# Visual Effects

Titles, sounds, particles and auras are configured under `visuals:` in `config.yml`, and every level can override any of them under its own `effects:` / `aura:` keys (see [Levels](/p/codexmomentum/momentum/levels.md)).

## Titles

```yaml
visuals:
  title:
    fade-in: 5     # ticks
    stay: 40
    fade-out: 10
```

## Level-up defaults

Fired on every level-up unless the level overrides them:

```yaml
  level-up:
    title: '&#FFD75A&l⛏ MOMENTUM {level_roman}'
    subtitle: '{multiplier}'
    sound: ENTITY_PLAYER_LEVELUP;1;1.4      # SOUND;volume;pitch
    particles:
      type: CRIT
      count: 40
      offset: 0.8
      speed: 0.3
      height: 1.0
```

* **Sounds** use the format `SOUND_NAME;volume;pitch`.
* **Particles** take a Bukkit particle `type` plus `count`, `offset`, `speed` and `height`.
* An empty `title` **and** `subtitle` on a level means no title for that level.

## Level-down

```yaml
  level-down:
    sound: BLOCK_NOTE_BLOCK_BASS;1;0.7
```

Played each time decay drops the player a level.

## Auras

Levels that define an `aura:` emit a continuous particle effect while the level is **held** — the default ladder gives level X a `SOUL_FIRE_FLAME` aura:

```yaml
  aura-interval-ticks: 4       # how often aura particles are emitted
  aura-while-decaying: true    # keep the aura visible while draining (level still held)
```

```yaml
levels:
  10:
    aura:
      type: SOUL_FIRE_FLAME
      count: 3
      offset: 0.4
      speed: 0.02
      height: 1.0
```

## Chat lines

The level-up and momentum-lost chat messages live in `messages.yml` (`level-up-chat`, `lost-chat`) — see [Messages](/p/codexmomentum/getting-started/messages.md).