1.21.1 Commands

Commands & Debugging

Version: Minecraft 1.21.1 (NeoForge).

All in-game configuration and diagnostic controls are accessed via the /beamlights root command. Any adjustments made via /beamlights are applied instantly and saved automatically to config/beamlights-client.toml (or the server configuration for gamerules).

---

Command Reference

General & Status

Command	Permission	Description
/beamlights or /beamlights status	None	Displays the active backend (lambdynamiclights or sodiumdynamiclights), active light count, current preset, and indoor/outdoor state.
/beamlights on	None	Globally enables beam lighting.
/beamlights off	None	Globally disables beam lighting (clears all active light points). Useful for A/B testing FPS differences.
/beamlights reload	None	Reloads config/beamlights-client.toml and refreshes all active beams.

---

Layout & Ray Patterns (/beamlights layout ...)

Command	Default	Description
/beamlights layout pattern <pattern>	TRIANGLE	Sets the indoor ray pattern (CENTER_ONLY, TRIANGLE, CROSS, RING, DOUBLE_RING, HORIZONTAL_FAN, VERTICAL_FAN, CUSTOM).
/beamlights layout preset <preset>	default	Applies a layout preset (default, wide, performance, cliff, floodlight).
/beamlights layout sideSpread <float>	0.55	Angular spread of side rays as a fraction of the cone angle (0.1 to 1.0).
/beamlights layout midpoints <int>	2	Number of intermediate light points placed along each ray (0 to 8).
/beamlights layout sideOffset <int>	-1	Relative light level of side rays compared to the central beam (-5 to 0).

---

Cone Light (/beamlights cone ...)

Only applicable with LambDynamicLights backend.

Command	Default	Description
/beamlights cone enabled <true|false>	false	Enables or disables the soft cone light.
/beamlights cone preset <preset>	balanced	Applies a cone preset (light, balanced, wide).
/beamlights cone maxAngle <deg>	25	Maximum half-angle of the cone in degrees (5 to 60).
/beamlights cone maxLength <blocks>	16	Maximum reach of the soft cone in blocks (4 to 48).
/beamlights cone maxDistance <blocks>	20	Beyond this distance, the cone fades out completely.
/beamlights cone openArea <pattern>	CENTER_ONLY	Ray pattern used outdoors in open sky / long range.

---

Performance & Motion (/beamlights perf ..., /beamlights motion ...)

Command	Default	Description
/beamlights perf preset <preset>	balanced	Switches performance preset (quality, balanced, performance).
/beamlights perf maxMovesPerTick <int>	6	Maximum light position updates permitted per tick.
/beamlights perf snapToBlock <bool>	true	Snaps light points to integer block centers.
/beamlights perf lodDistance <float>	24.0	Distance at which remote entity beams drop side rays.
/beamlights motion fastTurnDegrees <float>	90.0	Camera turn rate (deg/s) that triggers motion freeze.

---

Server Game Rules (Operator Level 2)

Command	Default	Description
/beamlights spawns [on|off]	true	Toggles whether beams block hostile mob spawning. Adjusts gamerule beamlightsBlockSpawns.
/beamlights attract [on|off]	false	Toggles whether illuminated beams attract idle neutral/hostile mobs. Adjusts gamerule beamlightsAttractMobs.

---

Diagnostics & Visual Tools

Command	Description
/beamlights debug overlay <on|off>	Toggles an on-screen HUD displaying active emitter count, ray counts, motion velocity, moves/s, and chunk rebuild estimates.
/beamlights debug render <on|off>	Renders colored 3D laser vectors in the game world showing the exact rays, midpoint positions, and cone boundaries.
/beamlights debug dump	Outputs a detailed diagnostic dump to the game log (latest.log), listing every active emitter, beam parameters, and backend metrics.