Valheimon

Craft the new Spirit Stone item! Weaken creatures and mercilessly pelt them with empty Spirit Stones to capture them and make them your own!

Capture small creatures. Capture large creatures. Capture bosses. Capture your friends (not really).

Just what is customizable? Nearly everything:

• The number of quality levels (defined by how many crafting recipes you set)
• The crafting requirements for each quality level
• The rune colors for each quality level
• The ranges of creature levels that map to Spirit Stone quality levels

How to capture things

In order to capture a creature and make it your own, you have to first craft a Spirit Stone, and then throw it and hit a weakened creature with it. Spirit Stones don't magically return to your hand, either. If you fail, you'll hear a sound and see the Spirit Stone you threw bounce off the creature. If you succeed, you will see the runes of the Spirit Stone activate and capture the spirit of the creature.

Capturing a creature's spirit isn't guaranteed, though. The odds of capturing a creature are inversely proportional to how hurt the creature is. Modifying those odds is a calculation comparing the creature's level to the quality of the Spirit Stone you're using. The tooltip popups in-game will show you the success odds modifiers versus the applicable creature levels set by the server, as well as which spirit is captured and which player originally captured it.

Creature level groupings explained

To support other mods that increase creature levels, Valheimon has Creature Level Groupings. These define a ranges of creature levels that will be compared to which Spirit Stone quality values in order to determine capture success modifiers. In the configuration file, Creature Level Groupings are set by a single string containing numbers separated by commas. For example, the default value of "1,2,3" defines the following groupings:

Group 1 contains creature level 1 Group 2 contains creature level 2 Group 3 contains creature levels 3 and up

The default is acceptable for playing Valheim without any higher creature levels. If you want to increase the size of a group, you increase the value of the following group's level. For example, the string "1,4, 7" defines the follow groupings:

Group 1 contains creature levels 1 through 3 Group 2 contains creature levels 4 through 6 Group 3 contains creature levels 7 and up

You can have as many groupings defined as you want. The order of groupings sets the Spirit Stone quality that will be used to compare against creature levels, so having more groupings than you do Spirit Stone quality levels is pointless, and having fewer groupings defined than Spirit Stone quality levels will lead to players being able to capture creatures of higher levels more easily.

Crafting recipes format explained

The Spirit Stone Crafting Recipes configuration variable directly sets how many Spirit Stone quality levels there will be in-game. The string value is a series of recipe definitions separated by commas. Each recipe definition has the following format:

[prefab name of the desired crafting station]:[required level of the crafting station]:[first crafting material required]:[amount of crafting material required]:<up to 3 more defined crafting materials with their amounts required, all separated by colons (:)>

Each recipe must have crafting station, crafting station level, and at least one crafting material with its required amount. The maximum number of crafting materials is 4 (in keeping with Valheim's built-in limit for display in the GUI)

Frequently Asked Questions

Why does Valheimon require Mod Config Enforcer?

Mod Config Enforcer not only simplifies configuration management and enforces configuration settings for a server onto connecting clients, it also has support for reloading configuration settings from file, for when you're wanting to make configuration changes at run-time. By relying on MCE as an external dependency, MCE can be updated for future Valheim versions without requiring an update for Valheimon.

How do I make the game see changes I've made to the configuration file?

If you're making changes manually, once you've saved the file, in-game open the console (F5, if that doesn't work, close Valheim and restart it with the commandline option of "-console"). If you have the console open, just type "mce reload valheimon", and MCE will reload the configuration file and Valheimon will process those changes immediately.

Support

If you have any questions or need help, find me on the Valheim Modding discord server.

If you'd like to donate, head to my Patreon page.

1.1

• Fixed an issue with creating a new character.
• Added a configuration option for capturing a creature heals it to max health.

1.0.3

• Fixed a changed version value reference.

1.0.2

• Fixed creatures that normally despawn at daytime and event creatures from not being permanently captured.

1.0.1

• Fixed preserving creature's attacks/weapons when capturing.
• Fixed creatures not being commandable when released.

1.0

• Initial release