DeathTweaks

Death Tweaks

Configurable death behaviour for Valheim 1.0: decide which items are kept, dropped or destroyed, keep your food, tune or disable skill loss, and choose where you respawn.

A from-scratch reimplementation of aedenthorn's DeathTweaks for the current game version. The feature set and the config keys are the same, so an existing aedenthorn.DeathTweaks.cfg can be reused by renaming it to muindor.DeathTweaks.cfg.

Client-side: install it on every player's game that should use it. Nothing is needed on the server, and players without the mod can play on the same server.

Source, issues and releases: github.com/egor-muindor/ValheimMods.

Features

• Keep, drop or destroy items by item type or prefab name.
• Keep equipped items, hotbar items, teleportable items, or everything.
• Keep items in quick slots of EquipmentAndQuickSlots 3.x or Extra Slots, through their public APIs.
• Drop items on the ground instead of into a tombstone.
• Keep active food after respawn.
• Disable death effects.
• Change the skill loss fraction, disable skill loss, or remove the skill-loss protection after a recent death.
• Respawn at the start location or at fixed coordinates.

Kept equipped items stay equipped after respawn.

Installation

Requires BepInEx 5.

• With a mod manager (r2modman, Thunderstore Mod Manager): install as usual.
• By hand: unzip the release and copy the plugins/DeathTweaks folder into

BepInEx/plugins, so the mod ends up at BepInEx/plugins/DeathTweaks/DeathTweaks.dll.

The config file BepInEx/config/muindor.DeathTweaks.cfg is created on first launch.

Configuration

Server

| Key | Default | Description | |-----|---------|-------------| | ConfigPriority | false | Server only. When on, this server's settings replace those of every client that also has the mod. |

Install the mod on a dedicated server, or on the machine hosting the session, and turn ConfigPriority on to make a death mean the same thing for everyone: every client that also has Death Tweaks then runs on the server's settings instead of its own. Everything except IsDebug travels; those settings are marked [synced] in the generated .cfg.

This never makes the mod required on either side:

• Players without it are unaffected. The mod is not part of the game's version

check, so it never blocks a connection either way.

• A player with it can still join a server that does not have it, or one that

leaves ConfigPriority off, and keeps their own settings.

• The client's .cfg is never written to. The server's values live in memory

for as long as the connection lasts and are dropped when it ends.

• Changing a setting on a running server sends it to the connected players

right away.

General

| Key | Default | Description | |-----|---------|-------------| | Enabled | true | Enable the mod. | | IsDebug | false | Log every item decision on death. |

Toggles

| Key | Default | Description | |-----|---------|-------------| | KeepAllItems | false | Keep everything. Overrides all other item options. | | DestroyAllItems | false | Destroy everything except quest items. Overrides all other item options except KeepAllItems. | | KeepEquippedItems | false | Keep equipped items. Overrides the item lists. | | KeepHotbarItems | false | Keep items in the first inventory row. Overrides the item lists. | | KeepQuickSlotItems | false | Keep items in quick slots. EquipmentAndQuickSlots 3.x: the quick slots. Extra Slots: quick, food, ammo and misc slots. Overrides the item lists. A warning is logged when neither mod is loaded. | | KeepTeleportableItems | false | Keep items that can go through portals. Does not override the item lists. | | UseTombStone | true | Put dropped items in a tombstone. When false they are scattered on the ground. | | CreateDeathEffects | true | Create the ragdoll and particle effects. | | KeepFoodLevels | false | Keep active food after respawn. |

ItemLists

All lists are comma-separated. Type names are the ItemDrop.ItemData.ItemType values (Material, Consumable, OneHandedWeapon, Bow, Shield, Helmet, Chest, Ammo, Customization, Legs, Hands, Trophy, TwoHandedWeapon, Torch, Misc, Shoulder, Utility, Tool, Attach_Atgeir, Fish, TwoHandedWeaponLeft, AmmoNonEquipable, Trinket). Item names are prefab names such as Iron, CopperOre, TrophyBoar; the $item_* name token is accepted too. Matching is case-insensitive.

| Key | Description | |-----|-------------| | KeepItemTypes / KeepItems | Items to keep. | | DropItemTypes / DropItems | Items to drop even when KeepTeleportableItems would keep them. | | DestroyItemTypes / DestroyItems | Items to destroy. Overrides the keep and drop lists. |

Rule precedence

For every item, the first matching rule decides:

1. World modifier Keep inventory on death or KeepAllItems: keep.
2. Quest item: keep.
3. Equipped and world modifier Keep equipment on death: keep.
4. DestroyAllItems: destroy.
5. KeepEquippedItems, KeepHotbarItems, KeepQuickSlotItems: keep.
6. Destroy lists: destroy.
7. Keep lists: keep.
8. Drop lists: drop.
9. KeepTeleportableItems: keep.
10. Otherwise: drop.

The world modifiers Delete items on death and Delete unequipped items on death then turn drops into destroys, as in vanilla. Items the mod keeps are never affected by them.

Skills