You are viewing a potentially older version of this package. View all versions.
LynxInc-ChaosPolymorph-1.0.0 icon

ChaosPolymorph

A Black Forest staff that lobs an orb turning nearby creatures into random creatures you've killed. Health, stars and mod affixes carry over; death breaks the spell. Needs early eitr food (Wizardry, PoV).

By LynxInc
Date uploaded 2 days ago
Version 1.0.0
Download link LynxInc-ChaosPolymorph-1.0.0.zip
Downloads 16
Dependency string LynxInc-ChaosPolymorph-1.0.0

This mod requires the following mods to function

ValheimModding-Jotunn-2.30.2 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.2
denikson-BepInExPack_Valheim-5.4.2360 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.2360

README

Chaos Polymorph

Adds the Staff of the Chaos Polymorph, a Black Forest staff. It lobs a magic orb. Every creature caught in the burst turns into a random creature you have killed before. They change back after 5 seconds at quality 1. Each upgrade adds a little less than the last: 9.25s at Q2, about 16s at Q4. Past that, every level adds at least 2 seconds, so Forge of Potential upgrades still help without making it last forever.

A half-dead Troll becomes a half-dead Neck. A starred Greydwarf becomes a starred Boar and keeps its bonus abilities from other mods. When the time runs out, it turns back exactly as it was, at the same health percentage it had in its new form.

This mod gives no eitr on its own. Use it with a mod that adds early eitr food, such as Therzie's Wizardry or Path of Valheiman.

Install on the server and every client. Config is server-synced.

Features

  • Crafting: at the Forge (level 1), from Black Forest materials: 10 Core wood, 4 Bronze, 2 Surtling core, 1 Ancient seed. Upgrades to quality 4.
  • The orb: one lobbed orb that bursts on the first thing it touches. A creature it hits directly is always caught. It does no damage by default.
  • Your shape pool: every creature you've landed the killing blow on, saved per character. Creatures whose trophy you've discovered count too, so existing characters don't start empty. Variants count as one shape, so Skeleton_Meadows, Skeleton_NoArcher and the rest are all just "Skeleton". A creature never turns into its own kind.
  • Weighted toward weaker forms: lower-biome creatures are more likely, and forms stronger than the target are rarer still. Both are configurable.
  • Everything carries over: star level, health percentage, and any data other mods store on the creature (Monstrum, Path of Valheiman, CLLC…). That data is restored exactly when it changes back.
  • Death breaks the spell: a killing blow on a transformed creature turns it back, and the same hit then kills the real creature. Loot, kill credit, world-progress keys, and other mods' kill rewards (Path of Valheiman XP, Monstrum, CLLC) all come from the original creature, exactly like a normal kill.
  • It's angry at you: transformed creatures target the caster, both when they change and when they change back.
  • Always immune: players, bosses, tamed creatures, summons, water creatures, Gammeltrolls, boss aspects and Hildir's minibosses. Babies, flyers and water creatures are never picked as forms.

Eitr cost

By default, a cast costs 60% of your max eitr, never less than 20. You can cast it with any real eitr food, but it uses up most of your pool. If one Black Forest eitr food from your eitr mod gives less than 20, lower Minimum. Flat-cost mode and an optional cooldown are also available.

Console commands

Command Cheat What it does
chaospoly_pool no Lists the shapes your staff can use
chaospoly_eitr no Shows your max eitr, the current cast cost and the duration at each quality
chaospoly_learn <prefab> yes Adds a shape (for testing)
chaospoly_forget <prefab|all> yes Removes killed shapes (for testing)

Configuration

BepInEx/config/lynx.chaospolymorph.cfg is created on first launch.

Section Highlights
1 - Staff Recipe, station, max quality, duration (base seconds, falloff, per-level floor), impact damage
2 - Eitr Cost mode, percent of max, minimum, flat cost, cooldown
3 - Projectile v2 Blast radius, bounces (off by default), gravity, fuse, launch speed
4 - Forms Tier weights, higher-tier penalty, tier overrides, exclusion lists (* wildcards), variant suffixes, trophies count as kills
5 - Behaviour Death breaks the polymorph, aggro on transform/revert, messages, effects, VerboseLogging for troubleshooting
6 - Model Custom model file, fit (scale/twist/offset/flip), outline, glow, icon pose

Recipe and model settings need a restart. Everything else applies live.

Known limits

  • Kill credit goes only to the player who lands the killing blow.
  • If you uninstall the mod while a creature is transformed, it stays in that form permanently.

Credits

CHANGELOG

Changelog

1.3.0

New: Staff of the Masquerade, a Meadows-tier toy that turns you into the creature it holds.

  • Drag a trophy onto the staff to choose the creature; any size works, bosses included. Big creatures are shrunk to viking size, so you get a pocket Troll.
  • Creatures of the same kind ignore you, and stop chasing you. Doors, chests, pickups and crafting still work.
  • Attacking, taking damage or running out of eitr changes you back. Casting again counts as attacking. The attack that ends it is cancelled, and nearby creatures of that kind become alert, so there's no free sneak attack.
  • 10 eitr to cast, then 1 eitr per tick with no regeneration. Quality slows the tick: 1s, 1.5s, 1.9s, 2.2s at Q1 to Q4.
  • Humanoid forms hold your staff; while you're disguised, the staff's topper shows a green viking.
  • Recipe (Workbench): 10 Wood, 6 Flint, 6 Leather scraps, 4 Dandelions. Settings are in 9 - Masquerade Staff and 10 - Masquerade Staff Model.

1.2.0

New: Staff of the Ember Hen, a Plains-tier panic button.

  • A quick cast turns every creature around you into a tame, passive, unkillable copy of the staff's creature for 4 seconds. They panic and run away from you, and take no damage from anything. Bosses, tamed creatures and the usual exclusions are immune.
  • Quality increases the radius, not the duration: 4m at Q1, 5.4m, 6.6m and 7.6m at Q4, and at least +0.25m per level after that. The cooldown is a fixed 45 seconds. The eitr cost is half your max eitr, never below 25.
  • Drag a trophy onto the staff in your inventory to change its creature; an egg sets it back to a Hen. Anything up to about 3m tall works. The tooltip shows which creature a staff holds.
  • An ember burst on cast, the creature's own sound, and a puff where each creature changes.
  • Built from Staff of Protection's shaft with an animated ember copy of the creature perched on top, both borrowed from the game, so there are no extra model files. Other players see your staff's creature too.
  • Recipe (Forge): 8 Black metal, 6 Linen thread, 10 Feathers. Settings are in 7 - Hen Staff and 8 - Hen Staff Model.

Chaos staff:

  • The burst now reaches creatures by their body, not their centre, so big creatures like Lox can be caught when you're next to them.

New testing command: chaospoly_nocooldown (cheat) turns both staves' cooldowns off until restart.

1.1.0

Balance: the polymorph no longer skips a creature's health bar.

  • New health model Pool (default): a creature keeps its own health pool in any body. A 600 HP Troll becomes a 600 HP Skeleton, with the Skeleton's attacks, speed and weaknesses. Damage carries over 1:1 in both directions.
  • In 1.0.0, a creature kept its health percentage instead, so killing a weak borrowed body killed the original outright. That behaviour is still available as HealthModel = Percent. Borrowed gives the borrowed body's own health and banks the damage against the original, which is a much weaker version.
  • New setting: HealthModel in 5 - Behaviour (server-synced).
  • Server and clients must all update: 1.0.x and 1.1.x won't connect to each other.

1.0.0

First release.

  • Staff of the Chaos Polymorph: Black Forest tier, crafted at the Forge, upgrades to quality 4.
  • Lobbed orb, cloned from Staff of the Wild with its roots removed, that bursts on first impact.
  • Polymorphs creatures into random shapes from your kill pool. Duration has diminishing returns: 5s at Q1, 9.25s at Q2, ~16s at Q4, and at least +2s for each level after that.
  • Shape pool is saved per character; discovered trophies count as kills.
  • Creature variants count as one shape, and a creature never turns into its own kind.
  • Weighting favours lower-biome forms; creatures in the Deep North content get the correct tier.
  • Star level, health percentage, and other mods' creature data carry over both ways.
  • Reverting is exact: anything the temporary body added (like a tamed flag) is removed. Forms that start tame, like Hens, are never picked.
  • Death breaks the polymorph: the killing blow turns a creature back and kills the original, so loot, kill credit and other mods' kill rewards (e.g. Path of Valheiman XP) come from the real creature.
  • Transformed creatures target the caster.
  • Transformed creatures show only their new body's own gear (no Troll logs on Skeletons); the original's gear returns on revert. (Miss the log-wielding Skeletons? Check the config file.)
  • Eitr cost is a share of max eitr with a minimum; flat-cost mode and a cooldown are optional.
  • Custom monkey staff model with its own posed inventory icon. The vanilla Staff of the Wild is untouched.
  • Server-synced config; detailed logging is behind VerboseLogging.