RefractionAPI
If you have ever tried to build a Minecraft mod from scratch, you know the pain of rewriting the same helper code across multiple projects. That is exactly the problem RefractionAPI was designed to solve. Created by ZeusIGN and ConnorTron110, this library bundles the most commonly used code between projects into a single, constantly updated toolkit. Whether you are building a simple quality-of-life mod or an ambitious adventure map, this API gives you a head start on the tedious parts so you can focus on the fun stuff.
What Makes RefractionAPI Worth Using
RefractionAPI is not just a random collection of utilities. It is a thoughtfully organized framework that covers a huge range of development needs. The project is actively maintained on GitHub, meaning features, bug fixes, and improvements land regularly. The authors themselves note that many of the most exciting features are available on unpublished builds, so there is always something new on the horizon.
Core Systems and Utilities
Here is a quick look at some of the standout tools included:
- ReConfig — a config system with automatic syncing support, so client and server stay on the same page.
- Atda — a persistent data storage system for saving information across sessions.
- Syncables — server-to-client class syncing capability that removes a lot of boilerplate.
- Channels and NamedAPI — custom data channels between server and client, complete with headers and named API schemes.
- Runnabler — a handler for delayed and ticking runnables on both client and server.
- RefractionEvents — an event system with multiloader support.
- VoxelUtils and Particler — voxel generation utilities and a particle wrapper with render and tick manipulation.
- RAABB — support for non-axis-aligned boxes with collision.
Beyond those, RefractionAPI also ships cutscenes that can be customized through code, custom debuggers similar to Minecraft's own debugging system, an NPC interaction handler, a quest handler, server-side screen control without extra packets, registrable ticking sounds, a highly customizable flood filler, a camera shake interface, Vec3Helper for vec3 math, and RScanner for scanning files by package. That is a serious amount of functionality in one dependency.
Supported Versions and Loaders
RefractionAPI for Minecraft currently supports 1.21.1 on NeoForge and Fabric, along with 1.20.1 on Forge and Fabric. That multiloader coverage is one of the API's biggest strengths, since you can develop once and target multiple mod loaders without rewriting your integration layer. If you are maintaining mods across versions, this alone can save you hours of work.
When you download RefractionAPI, make sure you grab the build that matches your Minecraft version and loader. Mixing a Forge build with a Fabric installation will not work, so double-check before dropping it into your mods folder. If you want a smoother experience, the foxygame.net launcher handles version matching for you, pulling the correct RefractionAPI build straight into your instance with one click and keeping it updated automatically.
How to Install RefractionAPI
Getting started is straightforward. First, confirm which mod loader you are running and which Minecraft version your modpack targets. Next, place the matching RefractionAPI jar file into your mods directory. If you are a player using a mod that depends on this API, simply install it alongside that mod. If you are a developer, add it as a dependency in your build configuration and start calling the helper and feature packages.
Tips for Developers
Spend some time exploring the helper and feature directories in the source. The authors point players there for a reason: the documentation lives in the code itself. You will find practical examples of cutscene implementation, config syncing, and server-to-client data channels that you can adapt to your own project in minutes rather than days.
Final Thoughts
RefractionAPI fills a real gap in the Minecraft modding ecosystem. Instead of every developer reinventing config syncing, event handling, and particle manipulation, this library provides a shared foundation that is actively improved. Whether you are a seasoned modder or just starting out, adding RefractionAPI to your toolkit is a smart move. Download RefractionAPI for Minecraft today and see how much faster your next project comes together.
===END===