ValheimLoading...GlitnirSounds

Last Updated

First Uploaded

Downloads

661

Likes

Size

164KB

Dependency string

GlitnirBr-GlitnirSounds-0.1.9

Dependants

2 other mods

Mods Audio Client-side AI Generated

Download

Details Required (2)Wiki Changelog Versions Analysis

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

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`	Raio em metros
`volume`	Volume específico desta entrada
`mode`	`custom`, `vanilla` ou `mute`

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

GlitnirSounds

Details

Categories

Glitnir Sounds

Glitnir Music Zones

Dependências

Instalação

Formatos de áudio suportados

Configuração

Performance

Menu principal

Biomas

Locations

Territories

Bosses

Prioridade de reprodução

Hot-reload

Estrutura de pastas

Notas

Categories

Glitnir Sounds

Glitnir Music Zones

Dependências

Instalação

Formatos de áudio suportados

Configuração

Performance

Menu principal

Biomas

Locations

Territories

Bosses

Prioridade de reprodução

Hot-reload

Estrutura de pastas

Notas

Categories