Items API

A library that provides item creation tools for Mimesis.

How to use

This is an API for mod developers, so this mod does not do anything by itself.
It helps creators add new items to the game.

Developer Guide

A complete guide with tutorials is currently a WIP.

Until then, here is a short guide on how to use the API:

1. Export the Unity project using AssetRipper and open it in Unity 6.0 (6000.0.59f2)
2. Create your item's prefab using another item as a reference (search for prefab_miscellnary_ for examples)
3. Assign your item (and its icon) to a new AssetBundle and build it
4. Create a MelonLoader mod project
5. Add ItemsAPI.dll as a project dependency (keep ItemsAPI.xml in the same directory to access the documentation)
6. Load your AssetBundle during OnInitializeMelon
7. Register it in ItemsAPI using LootItemBuilder.RegisterAssetBundle
8. Create a new LootItemDescriptor instance with:
   • a unique object ID,
   • the prefab asset name from your bundle,
   • and the display name of the item
9. Configure the other properties (price, weight, spawn rate, etc.)
10. Register your new item with LootItemBuilder.RegisterItem
11. Enjoy your new item!

FAQ

➡️ I'm not a mod developer. Do I need to install this mod anyway?

Only if you want to use mods that add new items to the game using this library.

➡️ Do I need the mod if I'm not hosting the game?

Yes, both the host and all clients need the mod for it to work.

➡️ I can't see the items / I don't see the same items as my friends.

You are probably missing an item mod. The game can start even if you do not have the same item mods as the host, but the item tables will be out of sync. Make sure you have the same mods as the host and check the logs at startup. The API logs the number of registered items.