Skip to content

Refraction

Refraction is an API for general use purposes.

by Zeus
NeoForgeForge
Loaders
NeoForgeForge
Downloads on Modrinth
41.2K
Followers on Modrinth
9
versions
5
Updated
February 6, 2026Feb 6
Published
in 2024
🤤🤤🤤 · swipe

At a glance

Runs on NeoForge and Forge
For Minecraft 1.20.1, 1.21.1
Needed in the game and on the server
Latest version — 1.3.0 from February 6, 2026
License GPL-3.0-or-later — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.20.1, 1.21.1

Refraction mod logo


Refraction Library was made for commonly used code between multiple projects & includes many useful methods to make adding features such as cutscenes easier to implement and to make the overall development process easier.

Refraction was made by ZeusIGN & ConnorTron110.


Refraction

All big things that Refraction offers:

  • ReConfig—Config system with auto syncing support
  • Atda—Persistent data storage system
  • Syncables—Server → Client class syncing capability
  • Channels—Custom data channels between server and client w/ headers
  • NamedAPI—Extension of Channels for named API channel schemes
  • Runnabler—Handler for delayed and ticking runnables on client / server
  • RefractionEvents—Event system with multiloader support
  • VoxelUtils—Voxel generation utilities
  • Particler—Particle wrapper with render and tick manipulation
  • RAABB—Allows for non-axis aligned boxes with collision
  • Cutscenes—Customizable cutscenes through code (future command support)
  • Custom debuggers—Similar to Minecraft's system of debugging, Refraction has custom debug support
  • Interactions—NPC Interaction handler
  • Quests—Quest handler system, doesn't offer quest stacking by default (future change)
  • Server Screens—Full server side control of screens without extra packets including closing, opening and sharing data between client ↔ server
  • Registrable tracking sounds—Ticking sounds that can be registered on the client and called from the server
  • Flood Filler—Highly customizable flood filler
  • Camera shake—Provides a camera shake interface
  • SyncConfig—Automatic syncing for player joins
  • Vec3Helper—A lot of vec3 util
    And a lot more, just take a look for yourself, mainly in @helper and @feature dirs :D

FAQ

How to install Refraction?

Install NeoForge for your Minecraft version, download Refraction for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Refraction support?

Refraction has builds for Minecraft 1.20.1, 1.21.1.

Is Refraction needed on the server?

Needed in the game and on the server

License and source
GNU General Public License v3.0 or laterfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More