Petrolpark's Library
by petrolpark
Petrolpark's Library supplies shared APIs and utilities that the author's other mods, and some modpacks, build on, with features such as data-driven flags, decays and wishes.
What it does
Flags can be attached to item stacks, fluid stacks and block entities, and they carry through crafting, smelting and several Create processes. Decays change an item or its components after a set time, even inside a modded inventory, and a barrel recipe type starts a decay that stops when the item is removed. Wishes let a player pick an item, such as one with particular enchantments, and the loot system works to fulfil open wishes whenever a loot table is rolled. The library also adds player attribute types for extra inventory and hotbar slots.
The library is closely tied to Create and integrates with it, but Create is an optional dependency: features that need it are simply disabled when it is absent. It is published for Forge and NeoForge, for 1.20.1 and 1.21.1, and is licensed as All rights reserved. Every player and the server need a copy of the mod.
Key features
Data-driven flags
Flags are tags on stacks and block entities that survive vanilla crafting, smelting and most Create recipes.
Decay system
Items can be set to change after a given time, such as rotting food or aging wine, based on the Factorio design.
Barrel decay recipes
A recipe type starts a decay for items placed in a Barrel or another implementing container, and stops it when the item is removed.
Wish items
Wishes are granted as rewards or crafted, and loot rolls are steered toward them instead of relying on repeated rolls.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Optional 1
Required by 3 mods
Use cases
Who it’s for: Mod and modpack developers who want data-driven building blocks, and server owners whose packs depend on the author's other mods.
How it compares
LanternLib is open source under the GNU Lesser General Public License v3.0 or later, is published for Forge and NeoForge for 1.20.1 – 1.21.1, and runs on client and server. Elysium API is open source under the GNU General Public License v2.0 only, covers the same versions and loaders, and is optional on either side. Rapid Leaf Decay is server-side only and not open source, published for 1.17.1 – 26.3, so it is a different kind of mod altogether.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Petrolpark's Library | Forge and NeoForge | 1.20.1 – 1.21.1 | Client and server | 2026-09-14 |
| LanternLib | Forge and NeoForge | 1.20.1 – 1.21.1 | Client and server | 2026-04-01 |
| Elysium API | Forge and NeoForge | 1.20.1 – 1.21.1 | Client or server, optional | 2026-08-22 |
| Rapid Leaf Decay | Forge and NeoForge | 1.17.1 – 26.3 | Server-side only | 2026-10-10 |
Questions
Does Petrolpark's Library need Create?
Which loader should be used with Petrolpark's Library?
Which mods depend on Petrolpark's Library?
In the catalog
Petrolpark's Library is one of 3,514 Library mods on ModsFinder, and one of 1,576 Library mods for Forge. 32,366 mods support Minecraft 1.21.1.
More from petrolpark
Similar mods
What the author says
This library provides a variety of largely data-driven APIs for mod and modpack developers, and contains code common to my Create add-ons and other mods. Most of its systems are designed to be very versatile to allow modders and modpack developers to do things with the game they can't normally. The library is heavily…
Official listing
- Modrinth page
- modrinth.com/mod/petrolpark
- Owner
- petrolpark
- Published
- 2024-08-24
- Updated on Modrinth
- 2026-09-14
- Facts verified
- 2026-10-15