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

Mod para Valheim desenvolvido para o servidor Glitnir Fantasy, que substitui o sistema de música do jogo por trilhas customizadas via URL — definidas por bioma, localização, território, chefe e criatura, com transições suaves (crossfade) e cache inteligente.

📦 Instalação

1. Instale o BepInEx e o YamlDotNet (dependências)
2. Copie GlitnirSounds.dll para BepInEx/plugins/
3. Inicie o jogo — o arquivo music_config.yaml será gerado automaticamente

🗂️ Estrutura de pastas

BepInEx/config/glitnir.musiczones/
└── music_config.yaml

A configuração é recarregada automaticamente sempre que o arquivo é salvo — não precisa reiniciar o jogo.

⚙️ Seções do music_config.yaml

🎚️ Modos de música (mode)

Cada trilha (bioma, território, etc.) aceita um dos três modos:

biomes:
  enabled: true
  volume: 0.05
  tracks:
    Meadows:
      enabled: true
      mode: custom
      url: "https://..."
    BlackForest:
      enabled: true
      mode: mute        # floresta negra em silêncio total
      url: ""

🌍 Territórios customizados

Territórios são definidos por coordenadas e raio, permitindo trilhas exclusivas para regiões específicas do servidor:

territories:
  enabled: true
  volume: 0.65
  list:
    - name: "Nome da Região"
      x: 1234
      z: -567
      radius: 90
      mode: custom
      url: "https://..."

🔊 Integração com o volume do jogo

O mod se conecta diretamente ao sistema de áudio de música do Valheim, respeitando o slider "Volume da música" das configurações de áudio — independente do volume master.

🔁 Crossfade e cache

• Transições entre trilhas usam crossfade real (duas fontes de áudio alternando entre si), sem cortes ou silêncio entre uma música e outra.
• Um cache LRU mantém os clipes mais usados em memória, evitando re-downloads constantes.
• A opção preload_on_startup: true baixa todas as URLs configuradas ainda no menu principal, antes do jogador entrar no mundo — eliminando engasgos por latência de download durante transições de bioma.

menu:
  enabled: true
  volume: 0.05
  url: "https://..."
  preload_on_startup: true

🎵 Recomendações de hospedagem de áudio

Use URLs diretas de MP3 sem expiração. Recomendado:

• GitHub Releases
• cdn.pixabay.com

⚠️ Evite links do Discord — eles expiram em poucas horas.

🔧 Dependências

• BepInEx
• YamlDotNet

🙏 Agradecimentos

Um agradecimento especial a toda a equipe Glitnir pelo apoio, incentivo e por tornarem possível o aprendizado durante o desenvolvimento deste mod. Cada sugestão, teste e feedback foi essencial para chegar até aqui.

Obrigado, guerreiros de Glitnir! ⚔️

Desenvolvido para o servidor Glitnir Fantasy.