Retina
Minecraft raycasting library that can detect precisely what block a player is looking at, including special block shapes like slabs & stairs.
About this Mod
Retina is a raycasting library data pack for Minecraft: Java Edition 1.20+, using voxel traversal.
Unlike other similar packs, it supports (almost) all of the different hitboxes, including both blocks & entities. It also doesn't rely on entity teleportation, meaning it runs slightly faster on average too.
Additionally, Retina supports a lot of customizable input parameters and gives detailed output information, making it a very useful resource for custom maps and datapacks, with applications ranging from magic wands to guns to custom block placing to laser beams.
For more specific information, check out the GitHub repository.
Credit for the logo: Vector image by VectorStock / vectorstock
Available Versions
How to Install Retina on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set datapack Loader
In the panel under "Egg", select the datapack loader and matching Minecraft version (1.21.5).
Install Mod
Open the mod browser in the dashboard and search for "Retina". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.5, 1.21.1, 1.21 (+9 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Retina server crashes on startup – what to do?
Most common cause: wrong datapack 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.5). You can switch loaders with one click in the panel.
Is Retina compatible with datapack and fabric and forge and neoforge and quilt?
Retina officially supports datapack, fabric, forge, neoforge, quilt for Minecraft 1.21.5, 1.21.1, 1.21. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Retina – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Retina 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.
Similar Mods
Rent Modded Server
Install Retina with just one click on your server.