Skip to content

Repository files navigation

✦ IRL-editor

Standalone real-time light editor for Minecraft + Iris

Place dynamic point lights & spotlights anywhere — with shadows, volumetrics, and per-light specular — through an in-game ImGui editor. Same lighting engine as IRLights, but no BBS required.

Minecraft Fabric ImGui License


What is IRL-editor?

IRL-editor is a client-side Fabric mod that brings the IRLights lighting system to vanilla worlds and Replay Mod — no BBS Mod Studio needed.

Press L in-game to open a Dear ImGui editor where you place lights, drag them with a 3D gizmo, tune every parameter live, and save scenes to disk. Under the hood it shares the exact same GPU pipeline and shaderpack patcher as IRLights, via the common irl-core engine.


Features

Feature Details
ImGui editor In-game light panel — press L, no Minecraft screen needed
3D gizmo Drag, rotate & position lights directly in the world
Point & spotlights Radius, cone angle, color, intensity, falloff
Shadows Per-light cube-map (point) & atlas (spot) shadow baking
Volumetrics Per-light ray-marched light shafts
Auto block-lights Emissive blocks → point lights via a rolling section scan
Patcher UI One-click .irlights injection into supported shaderpacks
Persistence Save & restore light scenes
Replay Mod Editor opens & works inside standalone Replay Mod

Minecraft versions

Each Minecraft version lives on its own branch — pick the one that matches your instance:

Branch Minecraft Notes
main 1.20.4 primary line
port/1.20.1 1.20.1
port/1.21.1 1.21.1
port/1.21.4 1.21.4
port/1.21.11 1.21.11 raw-GL shadow path

Supported Shaderpacks

Ready-to-use .irlights patches ship with the mod — apply them once from the patcher panel, no manual GLSL edits required.

Shaderpack Author
Photon SixthSurge
Complementary Reimagined EminGT
BSL Shaders CaptTatsu
Solas Septonious
Bliss X0nk
Rethinking Voxels gri573
IterationRP † Tahnass

IterationRP is a paid shaderpack — buy it from the author. Our .irlights patch is free and public, but it only applies on top of a copy you already own.


Installation

Requirements: Fabric Loader · Fabric API · Iris · a Minecraft version matching your branch.

  1. Drop the irl-redactor-*.jar into your mods/ folder alongside Fabric API and Iris.
  2. Launch the game and load a world.
  3. Press L to open the light editor.
  4. In the Patcher panel, pick your shaderpack and click Apply — the GLSL is injected automatically.
  5. Enable the patched pack in Iris and reload shaders (F3 + R).

Usage

  1. Press L to toggle the editor.
  2. Add a Point Light or Spotlight; drag it with the gizmo.
  3. Tune color, intensity, radius, cone, and shadow quality live.
  4. Save the scene — it persists across sessions.

Building from Source

The editor consumes the shared irl-core engine as a per-version Maven dependency, so publish the matching core to mavenLocal first:

# 1) publish the matching core (from the irl-core repo, on your MC version's branch)
../irl-core/gradlew publishToMavenLocal

# 2) build the editor — the checked-out branch determines the target Minecraft version
./gradlew build --refresh-dependencies
# output: build/libs/irl-redactor-1.1+mc<version>.jar

irl-core is remapped to the branch's mappings and JiJ-bundled via Loom's include, alongside imgui-java (binding + lwjgl3 + natives), so the prod jar runs standalone.


The trilogy

Repo Role
irl-editor (this repo) IRL-editor — standalone ImGui editor
bbs-irlights-addon IRLights — BBS Mod Studio add-on
irl-core Shared engine: light SSBO + .irlights patcher

License

Released under the MIT License — © 2026 qualet.

Third-party shaderpacks referenced by the patcher remain under the licenses of their respective authors.

About

IRL-redactor - standalone ImGui light editor + shaderpack patcher (Fabric)

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages