ValheimLoading...GlitnirSounds0.1.6

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

Install

Date Uploaded

2 weeks ago

Downloads

666

Size

160KB

Dependency string

GlitnirBr-GlitnirSounds-0.1.6

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

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

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 abaixo (`dungeon_y_min`/`dungeon_y_max`)
`dungeon_y_min` / `dungeon_y_max`	Faixa de altitude que define "dentro da dungeon". `-1` usa o valor global da seção

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 (sobrescreve o global)
`mode`	`custom`, `vanilla` ou `mute` — igual aos biomas

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)