ModsFinder

Refraction

by Clockwork Interactive

Refraction is a library mod of shared helper code for Forge and NeoForge, used by other mods to build features such as cutscenes.

ForgeNeoForgeClient and serverGNU General Public License v3.0 or laterOpen source1.20.1 – 1.21.1

What it does

Refraction bundles code that several projects in the same author's catalog need, so each mod can avoid copying it. It provides a config system with automatic syncing, persistent data storage, and a way to send custom data channels between server and client. Other mods that depend on it can call these utilities directly instead of writing their own versions.

Its parts cover several areas. Syncables let a class exist on both server and client with its state kept in step. A named channel API provides extension channel schemes, and a delayed-ticking handler runs runnables on either side after a set number of ticks. An event system supports multiloader builds, and voxel generation utilities handle block-shaped data.

Refraction runs on client and server, so both sides need it. It is published for 1.20.1 and 1.21.1 on Forge and NeoForge, with the latest Forge build at 1.3.5 and the latest NeoForge build at 1.3.0. The source code is open source under the GNU General Public License v3.0 or later, and the issue tracker is public.

Key features

  1. Config with auto syncing

    A configuration system keeps settings in step between server and client without manual work.

  2. Persistent data storage

    Atda stores data that survives restarts, so mods can keep state between sessions.

  3. Custom data channels

    Named channels with headers carry custom data between server and client, with a named API for extension schemes.

  4. Delayed runnables and events

    A handler runs delayed ticking tasks on both sides, and an event system works across multiple loaders.

Compatibility

Latest build for each game version and loader.

1.21.1Not available1.3.0
1.20.11.3.51.3.5
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Required by 3 mods

[SCP] | Secure Craft Protect1.20.1Fazbear Franchise Package - FNAF1.21.1Spawnable1.20.1 – 1.21.1

Use cases

Building cutscenes

The author notes that the shared methods make features such as cutscenes easier to implement.

Sharing code between projects

Mods made by the same team reuse the library instead of duplicating networking, config and data code.

Who it’s for: Mod developers who want shared helper code for Forge or NeoForge projects. Players only need it when a mod they install requires it.

Questions

Which mods require Refraction?

Three catalog mods require it: [SCP] | Secure Craft Protect, Fazbear Franchise Package - FNAF and Spawnable.

Does Refraction have to be installed on both sides?

Yes. A server running it needs every connecting player to have it too.

Which game versions does Refraction support?

Files exist for 1.20.1 and 1.21.1, on Forge for 1.20.1 and on NeoForge for 1.21.1.

More from Clockwork Interactive

All projects
Cannibal Conundrum1.20.1 – 1.20.2[SCP] | Secure Craft Protect1.20.1

What the author says

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.
Clockwork Interactive, on the Modrinth page

Official listing

Owner
Clockwork Interactive
Published
2024-05-19
Updated on Modrinth
2026-02-05
Facts verified
2026-10-15
Open on ModrinthCompare