tweak-api
tweak-api is a Fabric library that gives mod developers additional callback events for game options, entity damage, screens and commands.
What it does
The library exposes event hooks that other mods can subscribe to. The author lists callbacks for game options being changed, for an entity taking damage, for a screen about to open and for a command about to run. Developers use these hooks to react to those moments without patching the game themselves.
tweak-api needs Fabric API to function, and it also depends on debug-helper, so both must be installed next to it. Either side can run it, and neither needs it. Files target 1.20.1 – 1.21.8 and are released under the Apache License 2.0, which makes the code open source. Source code and the issue tracker are linked publicly.
Key features
Game option callbacks
A callback fires when a game option is changed, letting dependent mods respond to new settings.
Entity damage callback
A callback fires when an entity takes damage, so mods can read or alter damage handling.
Pre-screen and pre-command callbacks
Callbacks run before a screen opens and before a command executes, giving mods a chance to intervene.
Public source repository
The source code is open and the project keeps a public issue tracker for reports and discussion.
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 2
Use cases
Hooking into gameplay events
A mod developer can attach to damage or screen events without writing custom injection code.
Who it’s for: Fabric mod developers who need event callbacks for game options, damage, screens or commands. Players who only use finished mods have no direct use for it.
How it compares
Eva's Scroll Tweaks is a client-side only Fabric mod under the CC0 1.0 Universal license, covering 1.20.1 – 26.1.2, so it is a player-facing tweak rather than a developer library. BlunthornAPI is a Fabric library under the MIT License that covers 1.20.1 – 1.20.6, a narrower range than tweak-api. TslatEffectsLib is a client and server library for Fabric, Forge and NeoForge, covering 1.19 – 1.21.5, and is open source under the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| tweak-api | Fabric | 1.20.1 – 1.21.8 | Client or server, optional | 2025-09-08 |
| Eva's Scroll Tweaks | Fabric | 1.20.1 – 26.1.2 | Client-side only | 2026-04-03 |
| BlunthornAPI | Fabric | 1.20.1 – 1.20.6 | Not published | 2024-10-30 |
| TslatEffectsLib | Fabric, Forge and NeoForge | 1.19 – 1.21.5 | Client and server | 2025-09-17 |
Questions
Does tweak-api need Fabric API?
Which dependencies must be installed with tweak-api?
Can tweak-api run on a server without clients installing it?
Which Minecraft versions have tweak-api files?
In the catalog
tweak-api is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 17,695 mods support Minecraft 1.21.8.
More from zhengzhengyiyi
Similar mods
What the author says
A powerful extension API for Minecraft Fabric mod developers, providing rich callback and event systems. Please report any issues on our GitHub Issue Tracker.
Official listing
- Modrinth page
- modrinth.com/mod/tweak-api
- Owner
- zhengzhengyiyi
- Published
- 2025-09-03
- Updated on Modrinth
- 2025-09-08
- Facts verified
- 2026-10-15