You are viewing a potentially older version of this package. View all versions.
ReefTeam-ReefLevels-0.3.0 icon

ReefLevels

The Reef's creature levels: stars per bosses defeated (up to five, shown in the nameplate), bigger creatures per star, elemental infusions (name, tint, damage). Replaces the creature part of CLLC. Server and clients.

Date uploaded 2 weeks ago
Version 0.3.0
Download link ReefTeam-ReefLevels-0.3.0.zip
Downloads 467
Dependency string ReefTeam-ReefLevels-0.3.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333
ValheimModding-Jotunn-2.30.0 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.30.0

README

ReefLevels

The Reef's creature levels. The client nearest to a creature decides its stars when it spawns; this mod makes that roll ours: the number of stars depends on how many bosses the world has defeated, up to five, and starred creatures can carry an elemental infusion.

Install on the server and on every client. A client without it is not refused: it simply sees vanilla stars (two at most) on a creature that really has more, and fights it at its real level. Players on The Reef get it through the TheReef modpack.

What it does

  • Stars per world level. World level = number of the first six bosses defeated (Eikthyr to the Queen). At world level 0 most creatures are 0 stars, some 1 or 2; every boss raises the odds and the ceiling, up to 5 stars. Maximum stars caps the roll (server setting).
  • Health and damage per star stay vanilla: health × level, damage +50 % per star, loot × level. Nothing changes there.
  • More than two stars shown in the nameplate (5 stars per row), and creatures grow 10 % per star (not in dungeons).
  • Infusions. A starred creature can be Fire-, Frost-, Lightning-, Spirit-, Poison- or Chaos-Infused: the name says so, the creature is tinted, part of its damage becomes that element (Spirit also heals it on hit), Poison and Chaos ones burst poison on death on players within 4 m. Chances scale with the stars.
  • Breeding. A newborn of tamed animals (boar, wolf, lox, hen, asksvin) is born with stars drawn around its parents': from the parents' average, one table row per average — from 0-star parents: 80 % the same, 19 % one star, 1 % two stars; from 2-star parents: 5 % 0★, 35 % 1★, 40 % 2★, 19 % 3★, 1 % 4★ (full table in the config). Never more than two stars above the best parent, never above 4. Two 3-star boars can give you a 0-star piglet: cull, select, try again. The wild is untouched.
  • Bosses and players are never touched; tamed animals only at birth, as above.

Coming from CreatureLevelAndLootControl

ReefLevels replaces the creature part of CLLC (level roll, infusions, stars display) with our own code. Creatures already rolled by CLLC keep their level and their infusion (the mod reads CLLC's fields, never writes them). Remove CLLC from the profile: if both are loaded, ReefLevels steps aside and logs a warning. Not carried over: extra effects (Aggressive, Quick, Regenerating, Curious, Splitting, Armored), boss affixes, loot multipliers, damage-taken modifiers, infusion particles.

Config (BepInEx/config/reef.levels.cfg)

  • [Levels] Maximum stars, Chances for stars at world level 0..5, Creature size increase per star, Increase creature size in dungeons — server, synced.
  • [Infusions] Enabled, Chance for Fire/Frost/Poison/Lightning/Spirit/Chaos, Multiplier per star — server, synced.
  • [Breeding] Enabled, Species, Max stars, Draw from 0-star parents … Draw from 4-star parents (two fewer, one fewer, same, one more, two more, in %) — server, synced.
  • [Infusions] Add the infusion to the name, Tint brightness, [Debug] Log rolls — yours.

Credits and licence

Code: The Reef (Synistro), MIT. No CLLC code or asset is used.

Problems

Tell Synistro on Discord with your mod manager's log (Settings > Browse profile folder > BepInEx/LogOutput.log).

CHANGELOG

Changelog

0.3.0 — 2026-09-17

  • A newborn's stars are drawn around its parents', no longer inherited. Base = the parents' average (mother and the partner she conceived with; mother alone if none was near). One table row per parents' average (two fewer / one fewer / same / one more / two more, in %): 0★ 0/0/80/19/1 · 1★ 0/40/40/19/1 · 2★ 5/35/40/19/1 · 3★ 5/20/56/19/0 · 4★ 10/30/60/0/0. Never more than two stars above the best parent, never above Max stars (4). A 0-star litter from 3-star parents happens: cull and select. The wild is untouched.
  • Config [Breeding]: Species, Max stars, Draw from 0..4-star parents (server, synced). Replaces 0.2.0's Chances per offspring.

0.2.0 — 2026-09-17 (not published)

  • Newborns can gain a star. A tamed animal's offspring has a chance to be born one star above its parent (defaults: boar and hen 25 %, wolf 10 %, lox and asksvin 5 %), capped at 2 stars for breeding. The wild is not affected. One roll per birth, on the owning client, marked in the creature so it is never rolled twice. [Breeding] Enabled and Chances per offspring (name:percent:maxStars), server, synced.

0.1.0 — 2026-09-11

  • First build. Star roll per world level on the owning client (CLLC Medium tables, Maximum stars cap), stars beyond two in the nameplate, size per star, elemental infusions (name, tint, on-hit conversion, Spirit heal, Poison/Chaos death burst). Health and damage per star vanilla. Reads CLLC's creature fields, never writes them. Valheim 1.0.x, Jötunn 2.30.0, NotEnforced.
  • Not yet proven on the bench (restart 74 planned, docs/reeflevels-v0.md §6).