You are viewing a potentially older version of this package. View all versions.
JereKuusela-Item_Stand_All_Items-1.10.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.10.0
Download link JereKuusela-Item_Stand_All_Items-1.10.0.zip
Downloads 8190
Dependency string JereKuusela-Item_Stand_All_Items-1.10.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.

Check any modding guide for installation instructions.

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_info: Prints item, offset, rotation, scale and hide information.
  • 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. A single value sets all sides. 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.
  • Item stand ids (default: itemstand,itemstandh, key: item_stands_ids): Which item stands are affected by this mod.
  • 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.10

    • Fixes version 1.9 resetting the config.
  • v1.9

    • Adds a new command itemstand_info to print item stand properties.
    • Changes the mod GUID.
  • v1.8

    • Adds a new setting item_stand_ids to change which item stands are affected by the mod (other mods may add new item stands).
    • Adds support for removing items from boss stones (if added to the id setting).
  • v1.7

    • Adds the missing config lock setting to the config sync.
    • Fixes item stand hiding not working when reloading the area.
    • Fixes the command itemstand_scale not setting all axis with a single value.
    • Fixes acorns not appearing on item stands.
  • 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.