Progressive Serpent Spawner

English | Português

English

Sea Serpents are one of the rarest encounters in Valheim. In vanilla they have only a 5% chance to spawn, and that roll happens roughly once every 1000 seconds per ocean zone. Many players finish the game without ever seeing one.

Progressive Serpent Spawner makes the ocean far more dangerous as your world progresses. Every boss defeated raises the serpent spawn chance, and by default it reaches 100% after the 4th boss. Want them rarer? Every value is configurable.

How it works

• The mod reads the vanilla serpent spawn chance directly from the game. It doesn't hardcode values, so it keeps working if the game changes them.
• All vanilla spawn conditions stay exactly the same: ocean biome, night or rain/thunderstorm, spawn interval, and max of 1 serpent.
• Progression is counted with the world's global keys (defeated_eikthyr, defeated_gdking, etc.). These are synced by the server, so everyone shares the same progression.
• The chance is recalculated automatically a few seconds after a boss dies. No restart needed.

Formula:

final chance = base × (1 + BonusPerBoss × bosses defeated)

The result is clamped between the vanilla base and MaxChance.

Default progression

Even at 100%, vanilla limits still apply: one roll every ~1000s per ocean zone, only at night or during rain/thunderstorm, and max 1 serpent at a time.

Configuration

The config file is created at BepInEx/config/ProgressiveSerpentSpawner.cfg after the first launch.

Tuning tips (for rarer serpents)

• Rare: BonusPerBoss = 0.35, MaxChance = 20 (ends at ~17% with 7 bosses)
• Very rare: BonusPerBoss = 0.25, MaxChance = 15 (ends at ~13.75%)

Multiplayer

• Install the mod on the server and all clients.
• In Valheim, spawns are handled by whoever owns the zone, which is usually a player. Keep the same config on everyone so spawn rates are consistent.
• Boss progression comes from the server's global keys, so it's always shared.

Testing

With devcommands enabled:

listkeys
setkey defeated_eikthyr
removekey defeated_eikthyr

Check BepInEx/LogOutput.log for the [Registro] and [Recalc] lines to see the current spawn chance.

Compatibility

• Works with vanilla spawn data.
• Mods that fully replace world spawn tables (e.g. Spawn That, Expand World Spawns) may override or conflict with the serpent spawn entries. If you use one of them, configure serpent spawns there instead.

Support

Found a bug or have a suggestion? Reach me on Discord: Padilha

If you enjoy the mod and want to support development: Donate via PayPal

Português

As Serpentes Marinhas são um dos encontros mais raros do Valheim. No vanilla elas têm só 5% de chance de spawnar, e essa rolagem acontece mais ou menos uma vez a cada 1000 segundos por zona de oceano. Muita gente termina o jogo sem nunca ver uma.

O Progressive Serpent Spawner deixa o oceano bem mais perigoso conforme o mundo progride. Cada boss derrotado aumenta a chance de spawn da serpente e, por padrão, ela chega a 100% depois do 4º boss. Quer elas mais raras? Todos os valores são configuráveis.

Como funciona

• O mod lê a chance de spawn vanilla da serpente direto do jogo. Nada é fixo no código, então continua funcionando se o jogo mudar esses valores.
• Todas as condições de spawn vanilla continuam iguais: bioma de oceano, noite ou chuva/tempestade, intervalo de spawn e no máximo 1 serpente.
• A progressão é contada pelas global keys do mundo (defeated_eikthyr, defeated_gdking etc.). Elas são sincronizadas pelo servidor, então todo mundo compartilha a mesma progressão.
• A chance é recalculada automaticamente alguns segundos depois que um boss morre. Não precisa reiniciar.

Fórmula:

chance final = base × (1 + BonusPerBoss × bosses derrotados)

O resultado fica sempre entre a base vanilla e o MaxChance.

Progressão padrão

Mesmo em 100%, os limites vanilla continuam valendo: uma rolagem a cada ~1000s por zona de oceano, só à noite ou durante chuva/tempestade, e no máximo 1 serpente por vez.

Configuração

O arquivo de config é criado em BepInEx/config/ProgressiveSerpentSpawner.cfg depois da primeira vez que o jogo abre.

Dicas de ajuste (pra serpentes mais raras)

• Rara: BonusPerBoss = 0.35, MaxChance = 20 (termina em ~17% com 7 bosses)
• Muito rara: BonusPerBoss = 0.25, MaxChance = 15 (termina em ~13,75%)

Multiplayer

• Instale o mod no servidor e em todos os clientes.
• No Valheim, quem cuida do spawn é o dono da zona, que geralmente é um jogador. Mantenha a mesma config em todo mundo pra chance de spawn ficar igual pra todos.
• A progressão dos bosses vem das global keys do servidor, então é sempre compartilhada.

Testando

Com o devcommands ativado:

listkeys
setkey defeated_eikthyr
removekey defeated_eikthyr

Veja as linhas [Registro] e [Recalc] no BepInEx/LogOutput.log pra conferir a chance de spawn atual.

Compatibilidade

• Funciona com os dados de spawn vanilla.
• Mods que substituem as tabelas de spawn do mundo inteiras (ex: Spawn That, Expand World Spawns) podem sobrescrever ou conflitar com as entradas de spawn da serpente. Se você usa algum deles, configure o spawn da serpente por lá.

Suporte

Achou um bug ou tem uma sugestão? Fala comigo no Discord: Padilha

Se curtiu o mod e quiser apoiar o desenvolvimento: Doar via PayPal

Changelog

1.0.0

• Initial release.
• Serpent spawn chance scales with the number of bosses defeated (global keys).
• Reads vanilla spawn chance at runtime and keeps every vanilla spawn condition (night, rain/thunderstorm, interval, max spawned).
• Defaults set to the maximum: BonusPerBoss = 5, MaxChance = 100% (reaches 100% after 4 bosses).
• Configurable bonus per boss, max chance cap, base chance override, boss key list and affected prefabs.
• Automatic recalculation when progression changes; restores vanilla values on world exit.