You are viewing a potentially older version of this package. View all versions.
JereKuusela-Item_Stand_All_Items-1.6.0 icon

Item Stand All Items

Allows putting any item on item stands and customize their transformations. The config can be synced by installing on the server.

Date uploaded 2 years ago
Version 1.6.0
Download link JereKuusela-Item_Stand_All_Items-1.6.0.zip
Downloads 2445
Dependency string JereKuusela-Item_Stand_All_Items-1.6.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2200 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2200

README

Item Stand All Items

Client side mod that allows putting any item on item stands and customizing the item transformations.

The config can be synced by also installing on the server.

Manual Installation:

  1. Install the BepInExPack Valheim
  2. Download the latest zip.
  3. Extract it in the <GameDirectory>\BepInEx\plugins\ folder.
  4. Optionally also install the Configuration manager.

Configuration

If transformations are enabled, the hovered item stand be configured with commands:

  • itemstand_hide [-1/0/1]: Sets automatic hiding. 1 to hide, 0 to use the default value and -1 to always show.
  • itemstand_offset [forward,right,up=0,0,0]: Sets the item offset. Limited by maximum offset setting.
  • itemstand_rotation [roll,pitch,yaw=0,0,0]: Sets the item rotation.
  • itemstand_scale [x,y,z=1,1,1]: Sets the item scale. Limited by maximum scale setting.

Following settings are available:

  • Custom transformations (key: custom_transformations): Allows setting default offset, rotation and scale for each item. See below for more info.
  • Enable transformations (default: false, key: enable_transformations): Required to customize item offset, rotation or scale. May cause lower performance with lots of item stands.
  • Hide automatically (default: false, key: hide_automatically): Hides item stands which have items.
  • Maximum scale (key: maximum_scale): Limits how big items can be made with the command itemstand_scale.
  • Maximum offset (key: maximum_offset): Limits how far items can be moved with the command itemstand_offset.
  • Move items closer (default: false, key: move_items_closer): Removes the base offset to make items attach closer to the wall.
  • Use legacy attaching (default: false, key: use_legacy_attaching): Reverts to the version 1.1.0 attaching method. If the mod causes any issues this can be tried. It works very reliably but some items will be disabled or may not contain all parts of the model.

Custom transformations

The format is id,distance,offset_x,offset_y,angle_1,angle_2,angle_3,scale_1,scale_2,scale_3|id,distance,...

  • id: Id of item (check wiki for item ids if needed).
  • distance: Distance from the item stand (use negative value to move closer).
  • offset: Position offset to x and y directions.
  • rotation: Rotation to different directions.
  • scale: Scaling to different directions (usually you want the same number for each value).

For example:

  • Wood,0,0,0,0,0,0,10,10,10 would cause attached wood items to have 10x size.
  • Wood,0,0,0,0,0,20 would rotate attached wood items slightly.
  • Wood,-0.1|CarrotSoup,-0.1 would move carrot soup and wood items slightly towards the item stand.

How it works

The mod uses a few different ways to attach the items:

  1. The default way is to use "attach" child object of items. This is how the base game works. However not all items have this child object.
  2. The next way is to check if the item has a single child object and use that. This requires some extra logic to filter out unnecessary child objects but otherwise works the same as "attach" child object.
  3. If there are multiple children, then the whole item must be used. Unfortunately the parent object contains scripts like ItemDrop which would make the item fall on ground (basically duplicating it). In this case, a dummy object is created to replace the parent object.

The legacy attaching uses the first children. This means the whole is never returned but the attached item may miss some parts of the model.

Changelog

  • v1.6:

    • Adds config syncing (if installed server side).
    • Adds a command itemstand_offset to set offset of an individual item stand.
    • Adds a command itemstand_rotation to set rotation of an individual item stand.
    • Adds a command itemstand_scale to set scale of an individual item stand.
    • Adds a command itemstand_hide to set automatic hiding for an individual item stand.
    • Adds a command itemstand_config which allows changing settings.
    • Adds a setting maximum_offset to limit how far items can be from item stands.
    • Adds a setting maximum_scale to limit how big items can be on item stands.
  • v1.5:

    • Adds setting to hide item stands with items.
    • Adds setting to have items closer towards the item stand.
    • Improves custom transformations (applied gradually instead of overwriting natural transformation).
    • Changes parameters in custom transformations so that the distance is first (probably the most needed).
  • v1.4:

    • Improves attaching.
    • Adds setting to allow custom position, rotation and scaling for attached items.
    • Removes some settings as obsolete.
    • Fixes conflict with Epic Loot.
  • v1.3:

    • Adds a new less instrusive attach method (automatically used for items that support it).
    • Adds a setting to revert back to v1.2 behavior.
    • Adds removal of the root rotation (to fix weird angles of some items).
    • Adds a setting to disable the automatic rotation removal.
    • Adds a setting to disable the automatic offset removal (implemented in v1.2).
  • v1.2:

    • Adds support for seeds.
    • Adds glow back to attached Greydwarf Eyes.
    • Adds setting which allows using the attach method from the previous version.
    • Adds setting for less supported items but also less intrusive attach method.
  • v1.1:

    • Fixes some items not appearing.
  • v1.0:

    • Initial release.

CHANGELOG

  • v1.20

    • Fixed for the new update.
  • v1.19

    • Fixed for the new update.
  • v1.18

    • Updated for the new game version.
    • Removes the itemstand_migrate command.
  • v1.17

    • Improves performance.
    • Fixes higher level fish not being scaled.
  • v1.16

    • Fixes slightly wrong positions on some equippable items.