SentinelLib
A light-weight hitbox library for more engaging mob battles.
About this Mod
This is a small lib made out of necessity that's only purpose is to make mob combat a bit more engaging. The typical way Minecraft handles melee combat is checking whether an entity is within a certain distance of another entity and dealing damage, which is kinda boring. Then of course you can apply a hitbox to every attack, but writing the code for the hitbox repeatedly becomes redundant and messy. Not to mention, they don't natively render and MC restricts hitboxes to AABBs (Axis Aligned Bounding Box).
With SentinelLib, developers can now easily define hitboxes, not just AABBs, but OBBs (Oriented Bounding Box) as well that will rotate with entity movement, apply custom functionality with ease, and can actually see their entities attack hitboxes.
Why fight a boring zombie, when you can fight a Sentinel.
NOTE
This mod is still very much in the beta stage, some functionalities to be implemented soon:
Dynamic Rotational Sentinel Boxes
Dynamic Scaling Sentinel Boxes
Geckolib compatibility (GeoBone based Sentinel Boxes)
Available Versions
How to Install SentinelLib on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "SentinelLib". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
SentinelLib server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is SentinelLib compatible with neoforge?
SentinelLib officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with SentinelLib – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if SentinelLib consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install SentinelLib with just one click on your server.