GlitnirSounds

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

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

BepInEx/config/glitnir.musiczones/music_config.yaml

• Coloque seus arquivos de música em:

BepInEx/config/glitnir.musiczones/music/

• 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

| Campo | Descrição |

|---|---|

| preload_all_clips | false = carrega só ao entrar na zona, libera automaticamente (padrão). true = pré-carrega tudo na inicialização |

| max_cached_clips | Máximo de músicas mantidas em RAM simultaneamente (modo sob demanda) |

| unload_unused_after_seconds | Tempo sem uso antes de descarregar um clipe da memória |

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):

| Valor | Comportamento |

|---|---|

| custom | Toca o clip configurado, silencia a música vanilla |

| vanilla | Deixa a música original do jogo tocar normalmente |

| mute | Silêncio total — nem mod nem vanilla tocam |

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:

| Campo | Descrição |

|---|---|

| location | Nome interno da location (ex: Crypt3, StartTemple, Vendor_BlackForest) |

| radius | Raio de detecção em metros. 0 usa o valor global da seção |

| dungeon_only | Se true, só ativa quando o player estiver na faixa Y configurada |

| dungeon_y_min / dungeon_y_max | Faixa de altitude que define "dentro da dungeon". -1 usa o valor global |

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:

| Campo | Descrição |

|---|---|

| name | Nome identificador (aparece no log ao entrar na zona) |

| x / z | Coordenadas do centro da zona |

| radius |