ValheimLoading...GlitnirSounds0.1.5

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

3 weeks ago

Downloads

662

Size

165KB

Dependency string

GlitnirBr-GlitnirSounds-0.1.5

Download

Details Required (2)Versions

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

Instale o BepInEx e o YamlDotNet (dependências)
Copie GlitnirSounds.dll para BepInEx/plugins/
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`

Seção	O que faz
`menu`	Música tocada no menu principal
`biomes`	Trilha customizada por bioma (Meadows, BlackForest, Swamp, Mountain, Plains, Mistlands, AshLands, DeepNorth, Ocean)
`locations`	Músicas vinculadas a pontos de interesse do mundo (masmorras, ruínas, etc.)
`territories`	Zonas customizadas por coordenadas XZ + raio (vilas, reinos e outras regiões do servidor)
`bosses`	Trilha tocada durante lutas contra chefes
`creatures`	Trilha por tipo de criatura

🎚️ Modos de música (`mode`)

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

Modo	Comportamento
`custom`	Toca a URL configurada e silencia a música vanilla
`vanilla`	Mantém a música original do jogo, sem interferência do mod
`mute`	Silêncio total — nem mod, nem vanilla

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

🙏 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.

⚙️ Seções do music_config.yaml

Seção

O que faz

menu

Música tocada no menu principal

biomes

Trilha customizada por bioma (Meadows, BlackForest, Swamp, Mountain, Plains, Mistlands, AshLands, DeepNorth, Ocean)

locations

Músicas vinculadas a pontos de interesse do mundo (masmorras, ruínas, etc.)

territories

Zonas customizadas por coordenadas XZ + raio (vilas, reinos e outras regiões do servidor)

bosses

Trilha tocada durante lutas contra chefes

creatures

Trilha por tipo de criatura

🎚️ Modos de música (mode)

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

Modo

Comportamento

custom

Toca a URL configurada e silencia a música vanilla

vanilla

Mantém a música original do jogo, sem interferência do mod

mute

Silêncio total — nem mod, nem vanilla

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

🔁 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

🙏 Agradecimentos

Obrigado, guerreiros de Glitnir! ⚔️

Desenvolvido para o servidor Glitnir Fantasy.

Details

Glitnir Sounds

Glitnir Sounds

📦 Instalação

🗂️ Estrutura de pastas

⚙️ Seções do music_config.yaml

🎚️ Modos de música (mode)

🌍 Territórios customizados

🔊 Integração com o volume do jogo

🔁 Crossfade e cache

🎵 Recomendações de hospedagem de áudio

🔧 Dependências

🙏 Agradecimentos

Glitnir Sounds

Glitnir Sounds

📦 Instalação

🗂️ Estrutura de pastas

⚙️ Seções do music_config.yaml

🎚️ Modos de música (mode)

🌍 Territórios customizados

🔊 Integração com o volume do jogo

🔁 Crossfade e cache

🎵 Recomendações de hospedagem de áudio

🔧 Dependências

🙏 Agradecimentos

⚙️ Seções do `music_config.yaml`

🎚️ Modos de música (`mode`)

⚙️ Seções do `music_config.yaml`

🎚️ Modos de música (`mode`)