BlunthornAPI
by Blunthorn
BlunthornAPI is a Fabric library that gives other Blunthorn mods a set of events and a permission system to build on.
What it does
The library exposes events fired around block breaking, block placement, block use, entity use, item use, loot drops and crafting grid recipes. Each event can be listened to by other mods, and the break event fires after a block has already been removed, so it cannot be cancelled. Three ActionContext classes carry the information a listener needs to decide what action to take.
BlunthornAPI adds no blocks, items or gameplay of its own. Its main purpose is to simplify creating addons for BlockBlock, and it is the base of that mod's addon family. Fabric API is required, and the mod runs on the client, the server, or both, as the library itself does not depend on the side it is installed on. Files target 1.20.1 – 1.20.6, the latest being 1.0.7-1.20.x for 1.20.6, published 2024-10-30, under the MIT License, and the source code, issue tracker and wiki are all public.
Key features
Break and place events
Listeners can react before a block is broken, after it breaks, or when a player places one.
Interaction events
Separate events cover right-clicking a block, right-clicking an entity and using an item.
Loot and crafting events
Events fire when a killed entity drops loot and when a valid recipe is entered into a crafting grid.
ActionContext classes
Three context classes hold the data each event needs, so addons can decide what action to run.
Permission system
Addons can use the built-in permission checks alongside the event hooks.
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.
Required 1
Required by 2 mods
Use cases
Who it’s for: Mod developers writing addons for BlockBlock, and authors of other Fabric mods who want block, item and entity events without wiring them up by hand.
How it compares
tweak-api is Fabric only, open source under the Apache License 2.0 and built for 1.20.1 – 1.21.8, and it works on either side, and neither side needs it. Simple Permissions is server-side only, open source under The Unlicense, and covers 1.16.4 – 1.21.11, so players need nothing installed. LifeCompat is client and server, open source under the MIT License, but only for 1.21, while Itematic is client and server under the Apache License 2.0 for 1.20.5 – 26.3.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| BlunthornAPI | Fabric | 1.20.1 – 1.20.6 | Not published | 2024-10-30 |
| tweak-api | Fabric | 1.20.1 – 1.21.8 | Client or server, optional | 2025-09-08 |
| Simple Permissions | Fabric | 1.16.4 – 1.21.11 | Server-side only | 2025-12-10 |
| LifeCompat | Fabric | 1.21 | Client and server | 2025-05-13 |
| Itematic | Fabric | 1.20.5 – 26.3 | Client and server | 2026-10-13 |
Questions
Does BlunthornAPI need Fabric API?
Which game versions does BlunthornAPI support?
Which mods use BlunthornAPI?
In the catalog
BlunthornAPI is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 11,154 mods support Minecraft 1.20.6.
More from Blunthorn
Similar mods
What the author says
This is an API mod that adds nothing on its own. Its main goal currently is to simplify the process of creating the BlockBlock mod and its addons. BlockBreakEvent.BEFORE - Triggered right before a block is broken
Official listing
- Modrinth page
- modrinth.com/mod/blunthornapi
- Owner
- Blunthorn
- Published
- 2024-06-30
- Updated on Modrinth
- 2024-10-30
- Facts verified
- 2026-10-15