You are viewing a potentially older version of this package. View all versions.
ZenDragon-ZenPlayer-0.2.3 icon

ZenPlayer

Player related settings: autopickup, death & skill loss, durability, food, health, inventory, equip after swim, sleep, stamina, knowledge, etc.

Date uploaded 10 months ago
Version 0.2.3
Download link ZenDragon-ZenPlayer-0.2.3.zip
Downloads 1122
Dependency string ZenDragon-ZenPlayer-0.2.3

This mod requires the following mods to function

ZenDragon-Zen_ModLib-1.5.6 icon
ZenDragon-Zen_ModLib

Shared code library used in all ZenMods.

Preferred version: 1.5.6

README

ZenPlayer

Player related configuration, customization, and behaviors all in one place.

Full gamepad support.

Inventory:

  • Automatically re-equip items after swimming.
  • Dropping items drops them in the direction of the camera, not your character's direction.
  • Pressing the "Place Stacks" button in the inventory combines all the stacks in the container.
  • When fueling something it always draws from your smallest stack first.
  • When stacking items into containers it will now automatically combine existing stacks in the container.
  • When stacking items it ignores your hotbar.
  • Autopickup only what's already in your inventory. Press the autopickup toggle button to cycle between 3 modes: Inventory, All, None.

Stamina:

  • Stand still to regain stamina if encumbered or swimming.
  • UNLESS you are encumbered in the water, then you do not regain stamina. Drop stuff or drown.

Skills:

  • Suppress skill notifications. (does not prevent skill gain)

Food:

  • Food does not degrade quality over time, except stamina. (configurable)

Health:

  • Heal more per comfort level
  • Heal when resting
  • Bonus heal if seated.

Death:

  • Keep 1 random equipped items when you die (configurable).
  • Keep all food in your belly when you die.
  • Disable the corpse run buffs.
  • Set skill reduction rate (default 0)

Sleep:

  • You can sleep in a bed without claiming it or owning it.

Knowledge:

  • You do not discover item knowledge by just walking near a workstation, instead you have to interact with it. This is mainly for multiplayer so that player progression isn't spoiled by simply visiting your friend's house.

Client / Server Requirements

NOTE: Technically it is not required on the server. However, if it is installed on the server then it will force all clients to have it installed as well. This is to enable two modes of usage:

  1. Dedicated server admins can put the mod on the server to enforce all clients to have the mod installed and sync admin configs.
  2. Trusted friends can agree to run the same mods and connect through a vanilla dedicated server with no enforcement but with locked admin configs.

Client Only

This mod operates entirely client side. That means you can connect to any vanilla server with this mod installed. Other players do not need to have the mod installed.

NOTE: If you host a game session with this mod installed then it will be considered to be installed on the server since your session is the server. Therefor, all clients will be required to have it. If you don't want to require all players to have this mod then you will need to host your game in a dedicated server. You can easily download and run the Valheim Dedicated Server from Steam or host one in the cloud.

Improve Your Experience

CORE MODS

The full collection of all Zen MODS:

  • Radically improved QoL
  • Incredible performance
  • Pre-configured
  • 100% Gamepad support
  • Spectacularly immersive

Enjoy!

Sample Config File

## Settings file was created by plugin ZenPlayer v0.1.0
## Plugin GUID: ZenDragon.ZenPlayer

[Autopickup]

## If enabled then pressing the Toggle Autopickup button will cycle through 3 states:
## - Everything: Vanilla
## - Inventory: Only pickup items already in your inventory
## - Nothing: Off
# Setting type: Boolean
# Default value: true
Enable - Have In Inventory = true

## Autopickup mode set on game start when "Enable - Have In Inventory" is enabled.
# Setting type: PickupMode
# Default value: HaveInInventory
# Acceptable values: Everything, HaveInInventory, Nothing
Autopickup - Default Mode = HaveInInventory

[Death]

## [Admin] This many equipped items will be selected at random and kept on death. (Vanilla: 0)
## Any kept items will be removed from your corpse ragdoll for visuall accuracy.
## NOTE: Ammo is never protected, it will always be something more useful that you had equipped.
## This is a kindness from the Gods. ;)
# Setting type: Int32
# Default value: 1
# Acceptable value range: From 0 to 8
Keep Equipment Min = 1

## [Admin] Keep all the food in your belly when you die. (Vanilla: false)
# Setting type: Boolean
# Default value: true
Keep Eaten Food = true

## [Admin] Enable the No Skill Loss buff. No reason to show the buff if you don't lose skills. (Vanilla: true)
## Use global key: skillreductionrate 0 to prevent skill loss.
# Setting type: Boolean
# Default value: false
Enable Buff - No Skill Loss = false

## [Admin] Enable the Corpse Run buff. No need for this buff if you don't lose skills. (Vanilla: true)
## Use global key: skillreductionrate 0 to prevent skill loss.
# Setting type: Boolean
# Default value: false
Enable Buff - Corpse Run = false

[Durability]

## [Admin] Rate of torch burning consumption (Vanilla: 0.0333)
# Setting type: Single
# Default value: 0.0333
Torch Burn Rate = 0.0333

## [Admin] When used as an attack (Vanilla: 1)
# Setting type: Single
# Default value: 1
Torch Attack = 1

## [Admin] Rate of use (Vanilla: 1)
# Setting type: Single
# Default value: 1
Hammer = 1

## [Admin] Rate of use (Vanilla: 1)
# Setting type: Single
# Default value: 1
Hoe = 1

## [Admin] Rate of use (Vanilla: 1)
# Setting type: Single
# Default value: 1
Cultivator = 1

[Food]

## [Admin] Food loses Health potency over time (Vanilla: True)
# Setting type: Boolean
# Default value: false
Food Degrade Enabled - HP = false

## [Admin] Food loses Stamina potency over time (Vanilla: True)
# Setting type: Boolean
# Default value: true
Food Degrade Enabled - Stamina = true

## [Admin] Food loses Eitr potency over time (Vanilla: True)
# Setting type: Boolean
# Default value: false
Food Degrade Enabled - Eitr = false

[Health]

## [Admin] Regenerate health per comfort level while resting every interval
# Setting type: Single
# Default value: 1
Heal Amount Per Comfort = 1

## [Admin] Regenerate health every X seconds while resting
# Setting type: Single
# Default value: 2
Heal Interval When Resting = 2

## [Admin] Bonus Percent extra to apply when seated and resting. Example: 0.5 = +50%
# Setting type: Single
# Default value: 0.5
# Acceptable value range: From 0 to 1
Heal Seated Bonus Percent = 0.5

[Inventory]

## When dropping items on the ground throw them towards the camera or
## the vanilla method of chucking them in the direction the character is facing
# Setting type: DropStyle
# Default value: CameraDirection
# Acceptable values: Vanilla, CameraDirection
Drop Style = CameraDirection

## [Admin] Restore equipped items after swimming
# Setting type: Boolean
# Default value: true
Re-equip Items After Swimming = true

## [Admin] When items are automatically removed from your inventory, such as when fueling a fireplace or crafting always draw from the smallest stacks first
# Setting type: Boolean
# Default value: true
Withdraw Items From Smallest Stack First = true

## [Admin] When stacking items in a container the existing items are combined into as few stacks as possible. (Vanilla: false)
# Setting type: Boolean
# Default value: true
Stacking Combines Existing Stacks = true

## [Admin] When stacking items into a container any items on the hotbar are skipped. (Vanilla: false)
# Setting type: Boolean
# Default value: true
Exclude Hotbar When Stacking = true

[Knowledge]

## [Admin] How far away the player needs to be from a crafting station in order to 'discover' it.
## Set to 0 to disable ranged discovery and force direct interaction instead. (Vanilla: 4)
# Setting type: Single
# Default value: 0
# Acceptable value range: From 0 to 4
Station Discovery Radius = 0

[Skills]

## [Admin] Show the notifications when skills are gained
# Setting type: Boolean
# Default value: false
Display Skill Notifications = false

[Sleep]

## [Admin] When true you can sleep in any bed, not just owned beds. (Vanilla: false)
# Setting type: Boolean
# Default value: true
Sleep In Any Bed = true

[Stamina]

## [Admin] Stamina drain when encumbered. [-1 do not use config] (Vanilla: 10)
# Setting type: Single
# Default value: -1
# Acceptable value range: From -1 to 100
Drain Encumbered = -1

## [Admin] Stamina drain when sneaking. [-1 = do not use config] (Vanilla: 5)
# Setting type: Single
# Default value: 0
# Acceptable value range: From -1 to 100
Drain Sneak = 0

## [Admin] Stamina usage when jumping. [-1 = do not use config] (Vanilla: 10)
# Setting type: Single
# Default value: -1
# Acceptable value range: From -1 to 100
Usage Jump = -1

## [Admin] Allow stamina to regen when you stop moving while encumbered (Vanilla: false)
# Setting type: Boolean
# Default value: true
Regen Encumbered = true

## [Admin] Allow stamina to regen when you stop moving while swimming (Vanilla: false)
# Setting type: Boolean
# Default value: true
Regen Swimming = true

Like My Mods? Donations Welcome

Bitcoin

Donation QR

CHANGELOG

v0.6.2

  • changed default config options for skills to -1 (bypass) instead of 0 if the skill category is locked.

v0.6.1

  • added zen_player console command to print inventory and skills on the console. useful in conjunction with the relay command from Zen.ModLib for admins to easily peek at player's avatars.

v0.6.0

  • update for Zen.ModLib v1.5.0

v0.5.15

  • fix: default config for Stamina Drain: Sneak was set to 0 instead of -1 (bypass) like all the other skills. This meant that a default installation would not consume stamina while sneaking. Update your configs accordingly.

v0.5.14

  • prevent hide helmet hotkey from activating when text input is open.

v0.5.13

  • add a "Hide Helmet" keybind for quick toggle of helmet visibility.

v0.5.12

  • add "Hide Helmet" config options for hiding the visual presentation of your helmet. Stats still apply even if hidden.

v0.5.11

  • do not use this version: error on game start

v0.5.10

  • fix: AutoPickup InventoryOnly mode now allows pickup of a spear you threw when using ZenCombat to restrict AutoPickup ownership of thrown spears.

v0.5.9

  • bugfix: compatibility issue with WeaponHolsterOverhaul when entering water.

v0.5.8

  • add translations
    • German
    • Russian

v0.5.7

  • add config to use items in water, default Hammer.

v0.5.6

  • increase max carry config value range 0-1000 instead of 0-600
  • check your configs
  • renamed config section "Inventory" to "Equipment"
  • moved the following inventoryUI related configs to ZenUI because they make more sense there:
    • RemoveItemFromSmallestStack
    • CombineExistingStacks
    • ExcludeHotbarWhenStacking
    • DiscardStyle

v0.5.5

  • same as v0.5.6, forgot to update readme.

v0.5.4

  • same as 0.5.6 except no increase to max carry config range.

v0.5.3

  • added a config option to plant crops in any biome based on farming skill level.

v0.5.2

  • incorrect config name in v0.5.2, use v0.5.3 instead.

v0.5.1

  • Add config option: Drop On Death
    • All - Vanilla behavior, drop all items on death
    • NoTeleport - Only drop no-teleport items on death
    • None - Drop nothing, keep all items on death.

v0.5.0

  • Update for Valheim v0.221.4 Call to Arms

v0.4.1

  • gamepad fix: sleep button was not working, require Zen.ModLib v1.2.8

v0.4.0

  • updated for Zen.ModLib v1.2.0
  • recompile for BepInEx v5.4.2332
  • recompile for JVL v2.26.0

v0.3.6

  • fix: Config option "Exclude Hotbar When Stacking," add a check to verify that it is stacking from the player's inventory before ignoring the hotbar.

v0.3.5

  • updated readme to reflect new feature from v0.3.4, no code changes.

v0.3.4

  • new feature: added an option to define default starting equipment for new characters: Defaults to Torch and unlike vanilla does not include any rag armor. I felt that having the rag armor by default took away from the experience of crafting it for new players. You can customize the config option however you like, with whatever gear you like. Install on the server to enforce for all players.
  • Bugfix: when a new player first died, the tombstone would say survived 555 days. This should now be fixed.

v0.3.3

  • null check for edge cases when using other mods that affect mount riding before the player has loaded.

v0.3.2

  • Add tracking for cause of death on tombstones and map pins

v0.3.1

  • fix description in manifest. no code changes.

v0.3.0

  • enhanced config options for Riding stamina drain and handle cases for encumbrance as well.
  • pair with ZenCombat to enable your mounts to become combat mounts and fight!
  • fix: Food degrade options were conflicting with Jewelcrafting Vitality gems.

v0.2.14

  • Extra check to make sure the mount is mounted by the local player before applying configs.

v0.2.13

  • Introduced configurable options for mounts:
  • Stable cameras
  • Riding while encumbered
  • Speed reduction when encumbered

v0.2.12

  • fix null ref when using CraftyCartsRemake

v0.2.11

  • fix: player max weight config setting was being reset to default when the player died.

v0.2.10

  • bugfix: when starting the game if you have knowledge discovery radius set to 0 then it would have not been possible to create a roof for your first workbench because you would not be able to unlock the build pieces to make a roof. This update fixes the chicken-and-egg issue by allowing workbench knowledge discovery when you interact with the workbench even without a roof over it. that way you can build the first roof. However, you are still prevented from using the workbench to craft anything until after you have built a roof over it.

v0.2.9

  • fix so that "Change Gear While Moving" focuses only on equip/unequip animations instead of all animations.

v0.2.8

  • add config "Change Gear While Moving" - Swap your weapons while in motion and prevent the movement slowdown when doing so.

v0.2.7

  • added config options:
    • Dodge stamina use
    • Block stamina use
    • Adjust max carry weight

v0.2.6

  • update readme, no code changes.

v0.2.5

  • fix bug introduced in v0.2.4: skill notification would spam when notifications were enabled.
  • improved skill locking configurations and divided them into categories. Can now easily lock the skills for all players on the server at once.

v0.2.4

  • added configs for all vanilla skills.
  • misc fixes and tweaks
  • update for Zen.ModLib v1.1.0

v0.2.3

  • fixed config sync

v0.2.2

  • add config option to set skill loss on death
  • add config option to keep skill progress when loss is set to 0.

v0.2.1

  • removed BepInEx from dependency, Zen.ModLib handles it.

v0.2.0

  • use Zen.ModLib

v0.1.4

  • update readme, no code changes.

v0.1.3

  • moved SingleUseDoorKeys to ZenWorldSettings
  • update logging and configs subsystem

v0.1.2

  • UPDATE FOR VALHEIM V0.220.3

v0.1.1

  • update description, no code changes.

v0.1.0

  • Initial release
  • Migrated this from ZenWorldSettings v0.1.20
  • Only compatible with the latest version of ZenWorldSettings v0.2.0 or higher.