Valheim

I designed this mod to allow users to have FULL control over their auto pins. This is partly because everyone's tastes are different, what might be an important pin to someone might be completely useless to someone else. But mostly because the day might come when I stop playing valheim and this mod needs an update to pin the newest and greatest items from a DLC. 

With AMPED anyone can make and upload their very own Pin Pack adding or overwriting pins with custom icons!

How to make your own pin pack:

  • Create a new json configuration file
    You can name it anything as log as it's has the prefix `amp_`. Example: `amp_my_custompins.json`
  • Add new pin configurations
    You can use the default `amp_pin_types.json` file as an example of how to structure your json configuration.
  • Set the pin type
    The `type` has to be a numeric integer. It is recommeded to use 200 or more for the type so as to not overlap with the official configuration. You may also want to check out other pin packs and make sure there is no overlap.
  • Overwrite default or other pins.
    You can overwrite a pin by using the same `type`. The mod will use which ever json config file it loads last. The config files will always load with the default `amp_pin_types.json` file first and then in alpha numeric order after that. You can see the order in which the config files are loaded by enabling logging in the AMPED bepInEx config file and looking at the LogOutput.log file in your BepInEx folder.
  • Set the pin icon
    You can use any image you would like, it is recommended to keep the image height and width the same as the pins will be resized to 20 x 20px (or what ever you have the size set to in the json config) AMPED will find the icon anywhere in your plugins folder as long as the name of the image file matches what you put in your json config.
  • Finding object ids
    The object_ids section of the json config can be set using the Jotunn data documentation. https://valheim-modding.github.io/Jotunn/data/intro.html, some may not work so you might have to play with it to get the correct object id that works for what you're trying to pin.

    For Locations: https://valheim-modding.github.io/Jotunn/data/zones/location-list.html
    For Pickable items: https://valheim-modding.github.io/Jotunn/data/zones/vegetation-list.html
    For Creatures: https://valheim-modding.github.io/Jotunn/data/prefabs/character-list.html
    For Spawners: You can find some in here but this one is tough to pin down. https://valheim-modding.github.io/Jotunn/data/prefabs/material-list.html
  • Package your Pin Pack
    As long as the json file and the icon images are all within the `<valheim>/bepInEx/plugins/` it doesn't matter what your file structure is, AMPED will hunt it down! Though I'm sure most people would prefer to have your new icons in their own folder so they aren't just floating around the plugins folder ;)

Here is an example json file that would match the required format:

`amp_my_custompins.json`:
{
  "pins": [
    {
      "type": 400,
      "label": "Branch",
      "icon": "rad-looking-stick.png",
      "size": 20,
      "object_ids": ["Pickable_Branch"]
    },
    {
      "type": 401,
      "label": "Stone",
      "icon": "picture-of-a-rock.png",
      "size": 20,
      "object_ids": ["Pickable_Stone", "Pickable_Flint"]
    }
  ]
}

Once your done you can use an online JSON validator (like json lint) just to make double sure you did it right.

You can now also check two new articles (by LuxZg) for a little help about obtaining object IDs not described in JotunnDocs:
List of known object IDs
How to get object IDs and names using logging and Excel

Article information

Added on

Edited on

Written by

raziell74

0 comments