Saiyaheim

A Dragon Ball mod for Valheim: ki, flight, unarmed combat, ki attacks and Super Saiyan transformations gated behind the game's bosses.

This is my first mod, and it is a work in progress. It is playable from start to finish of what it currently covers, but it is not finished — more transformations and more ki attacks are the whole point of the next versions. Feedback is very welcome, and so is patience.

---

What it does

Saiyaheim adds a second progression path next to the vanilla one. Turn ki on and your gear stops mattering: damage, armor, flight speed and everything else come from your own power instead. Turn it off and you are back to plain Valheim.

Ki

A resource of its own, with its own bar — not Eitr, so it works from the very first day in Meadows and not only after Mistlands.

• Regenerates over time; the vanilla Rested buff makes it regenerate faster.
• Hold the charge key to charge it much faster than passive regeneration.
• Spent on punches, damage taken, ki attacks, flight and the drain of staying transformed.

Ki toggle

One key switches the mod's mechanics on and off per player. With ki off, the mod behaves as if you had zero ki: vanilla damage, vanilla armor from equipment, no XP, and no power readings on the HUD. Useful for fair PvP, or for playing a normal Valheim session without uninstalling anything. Switching is instant and destroys nothing — your gear stays equipped and counts again the moment ki goes off.

Battle Power and the Power Level skill

Power Level is a custom 0–100 skill and the axis of progression while ki is on. It feeds Battle Power, a derived number built from your health and your level that decides:

• how hard your punches hit (added to base damage, not multiplied — so it stays sane against Valheim's roughly linear enemy HP curve),
• how much armor you have (equipment is ignored while ki is on),
• how fast you fly.

Battle Power is shown on the HUD, and enemies show theirs under their health bar, on the same scale. Reading power is a ki ability: turn ki off and the numbers disappear for you too.

Unarmed combat

Punching is the core of the mod. Damage does not come from multiplying Valheim's very weak vanilla unarmed hit — it comes from Battle Power, so it scales predictably from Meadows to Plains. Transformations add their own flavor on top: slash damage on SSJ, lightning damage on SSJ3.

Flight

Standing upright, Dragon Ball style, using the game's own flying movement — so no fall damage by construction.

• Toggle key to take off and land, or a quick double tap of Jump to take off.
• While flying, the usual controls apply: Jump climbs, Crouch descends, Run flies fast.
• Costs ki continuously. Running out in mid-air means you fall.
• Speed scales with your Flight skill (its own custom skill) and with Battle Power, and drops with carried weight — on a curve, so a light load costs almost nothing and a full inventory costs a lot. Goku's weighted clothing, essentially.
• Touching the ground lands you.

Transformations

Three steps today, each gated behind a boss:

Form	Unlocked by	Power	What sets it apart
SSJ	Eikthyr	×2	Yellow spiked version of your own hair, golden aura, slash damage
SSJ2	The Elder	×3	Brighter hair, blue lightning, heavier ki drain
SSJ3	Bonemass	×4	Long spiked hair (changes your silhouette), white lightning, strongest glow

There is no activation cost — what a form costs is the continuous ki drain, so stepping up and down is free. One key transforms straight into the highest form you have unlocked; another drops you back to base. Shift plus those keys walks the ladder one step at a time. Running out of ki drops you out of the form on its own.

Transformed characters glow, light up the terrain around them, and can be seen doing it by other players.

Mastery

Each form has its own mastery skill. The longer you hold a form, the more mastery you gain in it, and mastery pays in ki efficiency: the drain goes down, and the extra ki cost that the form charges you for fighting comes back. Early on you can barely hold a transformation; at mastery 100 a form costs nothing to keep.

Holding a high form also trains every form below it, so climbing the ladder never freezes the progress of the step you already use.

Ki attacks

Aimed where you are looking, costing ki whether they hit or not:

Attack	Unlocked by
Ki Blast	Eikthyr
Kamehameha	The Elder — charges up, with three charge tells on the hands, and fires a beam

One key fires the selected attack, Shift plus that key cycles through the ones you have unlocked.

Boss gating

Unlocks use Valheim's own global keys, which means they are per world, not per character. Whoever joins your server later arrives with whatever the world has already unlocked. For a world played with friends this is the intended behavior.

---

Default keys

All of them are configurable.

Key	Action
K	Toggle ki on/off
R (hold)	Charge ki
F	Take off / land (or double tap Jump to take off)
T	Transform into your highest unlocked form
Shift+T	Step up one form
G	Drop straight back to base form
Shift+G	Step down one form
V	Fire the selected ki attack
Shift+V	Cycle ki attacks

Note that G is also the vanilla radial menu key in current Valheim versions. If that bothers you, rebind PowerDownKey in the config.

---

Installation

Install with a mod manager (r2modman or Thunderstore Mod Manager) and it pulls the dependencies for you. Manual install: drop Saiyaheim.dll into BepInEx/plugins/.

Requires:

• BepInExPack Valheim
• Jotunn

---

Multiplayer

It works, and everyone on the server needs the mod at the same version — the plugin enforces that. Transformations, auras, glow and ki attacks are synchronized, and boss unlocks come from the world itself.

That said, multiplayer is the least tested part of the mod: it has only been played by a handful of friends on one server. If something desynchronizes, please report it — see Bugs and feedback.

---

Configuration

Everything that can be balanced lives in com.hman.saiyaheim.cfg, generated on first launch: multipliers, drains, ki costs, XP rates, HUD positions, colors, keybinds and the global key each form and attack is gated behind. Gameplay values are server-enforced; keybinds and HUD tweaks are per client.

The config file is watched, so editing it while the game runs applies the change without a restart. Handy for nudging the HUD around.

---

About the art (and my limits)

I am a programmer, not an artist, and the visual side of this mod is where that shows. I would rather say it up front than have you find out.

The hair is generated by a script. I do not know how to use Blender. The spiked hair of the Super Saiyan forms is not sculpted by hand — a Python script reads Valheim's own hair meshes, grows strands out of them, and the result gets packed into an AssetBundle. It is good enough to read as Super Saiyan from a distance, which is what I was after, but it is not the work of an artist and I know it.

The visual effects are Valheim's own prefabs. I do not know how to author new particle effects either, so nothing here is made from scratch: the auras, the ki charge, the lightning, the blast and the beam are all existing game effects, recolored, rescaled, sometimes stripped down to a piece of themselves and recombined. It goes further than it sounds — the game has around 1200 effect prefabs, and a fair amount of this mod's look came out of digging through them — but it is still assembly, not creation.

I would like to improve both later, either by learning the tools properly or with help from someone who already has. If you are a 3D or VFX artist and any of this makes you wince, I am genuinely open to advice.

---

Roadmap

This is the first public version, and the mod is far from done. What I want to add next, roughly in this order:

• More transformations — the ladder is designed to grow, and each new step is mostly configuration.
• More ki attacks, and a radial menu to pick forms and attacks instead of cycling through hotkeys.
• Finishing the multiplayer pass, including comparing Battle Power between players and a proper scan.
• Polish: better visual effects, sounds, and eventually better hair.

---

Bugs and feedback

Thunderstore pages have no comment section, so everything goes through GitHub:

github.com/HenriqueANunes/Saiyaheim/issues

Open an issue for anything — a crash, a form that will not unlock, something desynchronizing in multiplayer, a number that feels wrong, or advice on the art. For a bug, the useful things to include are your Valheim and Saiyaheim versions, whether you were on a server or in singleplayer, and your BepInEx/LogOutput.log.

Balance complaints are welcome too, and you do not have to wait for me: almost every number in this mod lives in the config file, so you can try your own value first and tell me if it plays better.

---

Credits and disclaimer

Built with BepInEx and Jotunn. Visual effects reuse Valheim's own prefabs.

Dragon Ball is the property of Akira Toriyama, Shueisha, Toei Animation and Bird Studio. This is a free, non-commercial fan project with no affiliation to any of them, made because I wanted to throw a Kamehameha at a troll.