Glitnir Sounds

Glitnir Sounds é o sistema oficial de música dinâmica do projeto Glitnir. Cada bioma, dungeon, território e encontro ganha sua própria trilha sonora, transformando a jornada do jogador em uma experiência imersiva.

Glitnir Music Zones

Substitui a trilha sonora do Valheim por músicas locais, organizadas por bioma, território (zona por coordenada XZ), location (pontos de interesse/dungeons), boss e menu principal. Tudo configurado via YAML com recarga automática sem precisar reiniciar o jogo.

Mod cliente — não precisa estar instalado no servidor dedicado.

Dependências

• BepInEx 5
• YamlDotNet

Instalação

1. Instale as dependências acima
2. Coloque GlitnirMusicZones.dll em BepInEx/plugins/
3. Inicie o jogo uma vez — a config padrão será criada automaticamente em:

   BepInEx/config/glitnir.musiczones/music_config.yaml
   

4. Coloque seus arquivos de música em:

   BepInEx/config/glitnir.musiczones/music/
   

5. Edite o YAML com os nomes dos arquivos e salve — a config recarrega automaticamente com o jogo aberto

Formatos de áudio suportados

.mp3 .ogg .wav

Configuração

O arquivo music_config.yaml é dividido em seis seções. Todas têm um campo enabled global — setar enabled: false na raiz desativa a seção inteira sem precisar remover as entradas individuais.

O campo volume aceita valores de 0.0 a 1.0 e é multiplicado pelo slider de música das configurações do jogo, então o slider continua funcionando normalmente e em tempo real.

Performance

performance:
  preload_all_clips: false
  max_cached_clips: 5
  unload_unused_after_seconds: 600

No modo padrão (preload_all_clips: false), músicas que o jogador nunca visitar não chegam a ocupar RAM. O cache LRU descarrega automaticamente os clipes menos usados quando o limite é atingido.

Menu principal

menu:
  enabled: true
  volume: 0.6000
  clip: "menu.mp3"

Se enabled: false ou clip estiver vazio, a música vanilla do menu toca normalmente.

Biomas

biomes:
  enabled: true
  volume: 0.6000
  tracks:
    Meadows:
      enabled: true
      mode: custom
      clip: "pradaria.mp3"
    BlackForest:
      enabled: true
      mode: vanilla
      clip: ""

Biomas disponíveis: Meadows, BlackForest, Swamp, Mountain, Plains, Mistlands, AshLands, DeepNorth, Ocean

Modos (mode):

Locations

Pontos de interesse do ZoneSystem (dungeons, templos, etc.). A detecção é por distância ao ponto de spawn da location.

locations:
  enabled: true
  volume: 0.6000
  radius: 90.0
  dungeon_y_min: 4500.0
  dungeon_y_max: 5500.0
  tracks:
    - enabled: true
      location: Crypt3
      radius: 90.0
      dungeon_only: true
      dungeon_y_min: 4500
      dungeon_y_max: 5500
      clip: "dungeon.mp3"

Campos por entrada:

Territories

Zonas circulares definidas por coordenada XZ. Útil para cidades, reinos e áreas especiais do servidor.

territories:
  enabled: true
  tracks:
    - enabled: true
      name: Skjalfhame
      x: -37714.0
      z: 9799.0
      radius: 100.0
      volume: 0.6000
      mode: custom
      clip: "vila.mp3"

Campos por entrada:

Bosses

Toca enquanto o boss estiver vivo dentro do raio configurado. Tem prioridade sobre todas as outras zonas.

bosses:
  enabled: true
  volume: 0.6000
  radius: 120.0
  tracks:
    Eikthyr:
      enabled: true
      clip: "boss.mp3"
    brutoGLIT:
      enabled: true
      clip: "boss_custom.mp3"

O nome da entrada deve ser o prefab name do boss sem (Clone). Bosses vanilla: Eikthyr, gd_king, Bonemass, Dragon, GoblinKing, SeekerQueen, Fader. Bosses customizados de outros mods também são suportados pelo nome do prefab.

Prioridade de reprodução

Quando múltiplas zonas se sobrepõem, a ordem de prioridade é:

Boss  >  Location  >  Territory  >  Bioma

Ao sair de uma zona de maior prioridade, a música retorna automaticamente para a zona ativa de menor prioridade.

Hot-reload

Qualquer alteração salva no music_config.yaml é detectada automaticamente e a config recarrega sem reiniciar o jogo. No modo sob demanda, clipes removidos do YAML são descarregados da memória imediatamente. Clipes novos são carregados ao entrar na zona correspondente.

Estrutura de pastas

BepInEx/
├── plugins/
│   └── GlitnirMusicZones.dll
└── config/
    └── glitnir.musiczones/
        ├── music_config.yaml
        └── music/
            ├── pradaria.mp3
            ├── boss.mp3
            └── ...

Notas

• O slider de volume de música nas configurações do jogo afeta todas as músicas do mod em tempo real
• Nomes de arquivo com .. ou separadores de caminho são rejeitados por segurança
• Cada música carregada ocupa entre 3–15 MB de RAM dependendo da duração
• Mod cliente puro — nenhum dado é sincronizado pela rede