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 Sounds

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 cinco seções. Todas as seções têm um campo enabled global — setar enabled: false na raiz da seção desativa ela inteira sem precisar remover as entradas individuais.

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

Menu principal

menu:
  enabled: true
  volume: 0.6000
  clip: "minha_musica.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: "meadows.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:

Territórios têm prioridade sobre biomas. Se o player estiver dentro de um território com mode: vanilla, a música do bioma é ignorada e o vanilla toca normalmente.

Bosses

Toca enquanto o boss estiver vivo dentro do raio configurado. Tem prioridade sobre território e bioma.

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 conhecidos: 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 precisar reiniciar o jogo. Arquivos de áudio novos referenciados no YAML também são carregados automaticamente.

Clipes removidos do YAML são descarregados da memória no mesmo reload.

Estrutura de pastas

BepInEx/
├── plugins/
│   └── GlitnirMusicZones.dll
└── config/
    └── glitnir.musiczones/
        ├── music_config.yaml
        └── music/
            ├── meadows.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
• O mod é cliente-only — não precisa estar instalado no servidor dedicado
• Cada música carregada ocupa memória RAM durante toda a sessão (3–15 MB por arquivo dependendo da duração)