Easy Distributions API

Streamline Your Loot Tables in Project Zomboid with Easy Distributions API

For avid Project Zomboid players and ambitious mod creators, managing loot distribution can be a complex and time-consuming process. Thankfully, the Easy Distributions API mod offers a powerful yet straightforward solution, simplifying the way new items are integrated into the game’s vast array of loot tables.

What is the Easy Distributions API?

At its core, the Easy Distributions API is a foundational library designed to assist modders. It allows for the seamless copying of loot probabilities from existing items to newly created ones. This means you can introduce custom weapons, tools, or any other item into the game world with confidence, ensuring they appear in appropriate locations and at desired frequencies without tedious manual configuration.

For the Everyday Survivor

If you’re a player who enjoys enhancing your Project Zomboid experience with various mods, you might need to install Easy Distributions API simply because another mod you wish to use requires it. It’s generally safe to add or remove this mod from your game, but always be mindful that the mods relying on it may have specific installation or uninstallation instructions.

For the Ambitious Mod Creator

Integrating the Easy Distributions API into your own Project Zomboid mods is remarkably simple.

* **Enable the Library:** Begin by adding a `require` line to your server-side Lua file.
* **Declare Your Mod:** Ensure you add `require=NepEasyDistro` to your mod’s `mod.info` file.
* **Define Loot Probabilities:** Utilize the `EasyDistro.Add` function to link your new item’s identifier with an existing item’s identifier.
* **Control Rarity:** Optionally, include a third parameter to multiply the probability, allowing for finer control over how often your custom item appears.

For instance, if you’ve created a unique handgun, you can easily make it spawn wherever the standard pistol might be found. Or, perhaps you want a rare collectible to appear with only a fraction of the chance of a common item – this API makes such adjustments effortless.

The library also includes helpful tools for debugging. An optional verbose mode can be enabled to meticulously log every loot entry as it’s processed, aiding in troubleshooting. Furthermore, a function exists to force an update of the item picker if loot tables are modified after the game has already initialized, ensuring your changes are correctly implemented. Embrace the ease and efficiency of the Easy Distributions API to enrich your Project Zomboid modding endeavors.