JotunnLibTeam-JotunnLib icon

JotunnLib

JotunnLib is a modding library for Valheim, with the goal of making the lives of mod developers easier. It's a centralized API to allow mod developers to easily add custom items, recipes, prefabs, and more to the game, working for both servers and clients.

Last updated a month ago
Total downloads 22762
Total rating 10 
Categories Libraries Utility
Dependency string JotunnLibTeam-JotunnLib-0.1.8
Dependants 59 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.800 icon
denikson-BepInExPack_Valheim

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

Preferred version: 5.4.800

README

JotunnLib

Jötunn (/ˈjɔːtʊn/, "giant") Lib is a modding library for Valheim, with the goal of making the lives of mod developers easier.
Get the mod on NexusMods!

⚠️ Merger in progress ⚠️

We're currently working with a few other developers and are in the process of merging JotunnLib and ValheimLib to create a brand new library. You can view our progress here.

In the meantime, JotunnLib will no longer be under active development. However, we will still fix any remaining compatibility issues or breaking bugs.

With this merger, we're hoping to unify the Valheim modding community, and provide one central library for everyone to use. Due to this, we will be focusing on making the new merged library more powerful, easy to use, and well documented than both ValheimLib and JotunnLib ever were. We will take all feature requests and issues raised on this repo into consideration for the new merged library. For any new feature requests, feel free to raise issues on the new repository here.

Additionally, we have plans to make extensive documentation to allow current JotunnLib mods to switch to the new library with minimal effort as soon as it is ready :)

Installation

Instructions for installing and using JotunnLib as a user:

  1. You will first need to download BepInEx for Valheim.
    Move the contents of BepInExPack_Valheim folder into <Steam Location>\steamapps\common\Valheim.
    Note: If you already have used any other mods, you likely already have this installed.
  2. Download JotunnLib from the Releases page. Unzip the downloaded files into <Steam Location>\steamapps\common\Valheim\BepInEx\plugins.
  3. That's it! Now download some mods which use JotunnLib! :)

Features & Roadmap

Currently, JotunnLib lets you create & add all of the following custom things into Valheim:

  • [x] Custom prefabs
  • [x] Custom inventory items
  • [x] Custom recipes
    • [ ] Create using JSON
  • [x] Custom input buttons
    • [ ] Ability to change custom keybinds in-game via settings menu
  • [x] Custom skills
    • [ ] Add using JSON
  • [x] Custom localizations for current language
    • [ ] Localizations for other languages
    • [ ] Localizations from JSON file
  • [x] Custom piece tables (create your own variant of the Hammer, Cultivator, etc.)
    • [ ] Create using JSON
  • [x] Custom pieces to existing piece tables (adding extra items to Hammer, Cultivator, etc.)
    • [ ] Add using JSON
  • [x] Custom vegetation spawning in the world
  • [x] Utils for loading custom assets at runtime
    • [x] Loading 2D textures
    • [x] Loading meshes from .obj model files
  • [ ] Custom commands
    • [x] Custom console commands
    • [ ] Custom chat commands
  • [ ] Listening to game events
    • [x] (Currently very few event listeners implemented)
    • [ ] All game events
  • [ ] Custom tabs for in-game settings menu

Developing mods

Visit our documentation site for more info.

Repo structure

The repository is split up into a few parts:

Issues

Have any issues or feature requests? Open a pull request or submit an issue!

Contributing

For information about contributing to the repo, see the Contributing instructions.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2021-8-16 0.1.8 5425 Version 0.1.8 Install
2021-7-4 0.1.7 4770 Version 0.1.7 Install
2021-4-8 0.1.6 10932 Version 0.1.6 Install
2021-4-8 0.1.5 74 Version 0.1.5 Install
2021-3-26 0.1.4 1136 Version 0.1.4 Install
2021-3-26 0.1.3 104 Version 0.1.3 Install
2021-3-20 0.1.2 248 Version 0.1.2 Install
2021-3-20 0.1.1 73 Version 0.1.1 Install