1.21.1 NeoForge

Beam Lights for Minecraft 1.21.1 (NeoForge)

This is the current and complete version of Beam Lights: directional dynamic lighting for held and equipped items, indoor soft cone illumination, smart indoor/outdoor gating, motion-adaptive performance throttling, datapack beam definitions, and server game rules.

---

Requirements

• Minecraft: 1.21.1 with NeoForge (21.1.x+).
• Java: 21+ (built with Java 21 toolchain).
• Sides:
  • Client: Required for visible dynamic light.
  • Server: Optional. Required for server-side game rules (beamlightsBlockSpawns, beamlightsAttractMobs) and syncing datapack beam definitions.
  • Clients without the mod can join a server with it, and clients with the mod can join vanilla/unmodded servers.
• Dynamic Lights Mod (Client):
  • LambDynamicLights (4.8.x+) — Recommended: Enables both directional point rays and smooth volumetric soft cone lighting.
  • OR Sodium Dynamic Lights: Supports directional point lights (no cone).

---

Optional Integrations

All optional mods are detected safely at runtime and require no configuration:

• Omega Flashlight (1.6.6+): Native flashlight beams, bulb tier brightness, placed light sources, and low-power flickers.
• Curios API: Enables beam emission from items worn in Curios accessory slots (e.g. headlamp or belt flashlights).
• KubeJS (2101.7+): Script bindings to inspect active beams, count beams, query item beams, or assign custom beams dynamically.

---

Documentation Pages

Page	Target Audience	Content
Getting Started	Players	Installation, recommended setup, testing held lights, debug controls
Light Backends & Cone Light	Players, Pack Makers	LambDynamicLights vs Sodium Dynamic Lights, indoor cone, soft falloff
Ray Layouts & Patterns	Players, Pack Makers	Ray patterns (triangle, cross, ring, fans), indoor vs outdoor switching
Performance & Motion	Everyone	Chunk re-meshing budgets, motion governor (fast turns), performance presets
Commands & Debugging	Admins, Developers	/beamlights command reference, debug overlay, visual ray rendering
Configuration	Admins, Pack Makers	Complete guide to beamlights-client.toml and server game rules
Data-Driven Beams	Pack Makers	Datapack JSON beam definitions (data/<ns>/beamlights/beams/*.json)
Layout Profiles	Pack Makers, Resource Packs	Resource pack JSON overriding patterns and cone per provider
KubeJS Integration	Pack Makers	Script methods for assigning and inspecting beams
Java Mod API	Mod Developers	Maven artifacts, BeamProvider, BeamCollectEvent, custom components
Compatibility	Everyone	Supported loaders, shader packs, dynamic lights mods, and armor mods