Skip to main content

Configuration

language​

Sets the server default language. This language is used for console messages, and as the default for players who have not chosen their own language via /le lang.

The following built-in translations are available: en (English), zh (Chinese), hi (Hindi), es (Spanish), fr (French), ar (Arabic), bn (Bengali), ru (Russian), de (German), ko (Korean), pt (Portuguese), ja (Japanese), tr (Turkish), pl (Polish), it (Italian), nl (Dutch), sv (Swedish), cs (Czech), uk (Ukrainian), el (Greek), da (Danish), fi (Finnish), no (Norwegian), hu (Hungarian), ro (Romanian). You can also create your own language by creating a file in plugins/LasersEnigma/lang/myLanguage.json and setting the language config option accordingly. See Translations for details.

only_needed_colors​

All received colors are decomposed into their primary components (red, green, blue) before comparison. Sending a primary color that is already contained in another received color is tolerated (e.g. RED + RED + BLUE activates a MAGENTA receiver).

  • TRUE: The received primary components must match exactly the expected ones. No extra, no missing. A green laser receiver will only activate if it receives a green laser. It will not activate if it receives a white laser (which contains extra primaries).
  • FALSE: The received primary components must contain at least the expected ones. Extras are tolerated. A green laser receiver will activate even if white light is given (since white contains green).

music_blocks​

Turn on or off music blocks

music_blocks_scoreboards​

Turn on or off the scoreboard used to scroll the sound list

show_stats_on_player_left_area​

Turn on or off the scores display when a player leaves an area

save_victory_even_if_player_changed_world​

Turn on the player's victory inside the area (and its record) even if he left by changing the world.

save_victory_even_if_player_teleported​

Turn on the saving of the player's victory inside the area (and its record) even if he teleported more than 50 blocks away.

laser_affect_mobs​

Turn on if you want the animals/hostiles mobs to be affected by lasers.

laser_affect_players​

Turn on if you want the players to be affected by lasers.

laser_burns_tick_duration​

The burning duration (in ticks, where 20 ticks = 1 second), of entities touching a laser. Set it to 0 to disable.

laser_additional_damage​

Extra damage that is taken by an entity that is touching the laser. Set it to 0 to disable.

laser_knockback_multiplier​

Adjusts how much force an entity feels when hit by a laser. Set it to 0 to turn it off.

burnable_block_damage_multiplier​

Scales the damage dealt to a nearby player when a burnable block melts down. Default 1.0 keeps the historical behaviour. Set it to 0 to deal no damage at all (the knockback is unaffected). Negative values are treated as 0.

debug_level​

Sets how much information will be displayed on the console. Available values, OFF,SEVERE,WARNING,INFO,FINE,FINER,FINEST,ALL

opening_locks_consumes_keys​

If enabled, key(s) will be removed from the opener's inventory when a lock is opened.

clear_keys_on_exit_world​

Remove any lock's key(s) when the player exits the world.

clear_keys_on_death​

Remove any lock's key(s) when the player dies.

clear_keys_on_quit​

Remove any lock's key(s) when the player leaves the server.

use_checkpoint_system​

Disable the checkpoint system if set to false

checkpoint_in_victory_area​

Adds a new checkpoint outside the puzzle area, if the player leaves the puzzle area via a victory area.

player_respawn_event_priority, player_changed_world_event_priority and player_join_event_priority​

Change the events priority for this plugin, this may help if you are facing issues with the conflicting plugin(s), Available values are, LOWEST, LOW, NORMAL, HIGH, HIGHEST

get_back_to_checkpoint_on_death​

Player(s) will get teleported back to the last checkpoint if they die.

get_back_to_checkpoint_on_change_world​

Player(s) will get teleported back to the last checkpoint of their world.

get_back_to_checkpoint_on_join​

Player(s) will get teleported back to the last checkout when they join the server.

clear_checkpoints_on_quit​

Remove any saved checkpoints for a player when they leave the server.

clear_world_checkpoints_on_exit_world​

Remove any saved checkpoints for a player when they leave the world.

check_for_new_versions​

Notify the administrator in the console and in-game whenever a new version of the plugin is available.

check_for_new_beta_versions​

Notify the administrator in the console and in-game whenever a new beta version of the plugin is available. (Beta versions might not be stable!)

crossable_materials​

The list of materials the laser can pass through.

laser_light​

If you have the plugin LightAPI, lasers will emit light unless this is set to false.

laser_default_light_level​

The light level of the block while the laser passes through it. In Minecart, there are 0 to 15 light levels, 0 being the darkest & 15 being the maximum brightness. Setting the light level too high might cause impact on performance!

clear_inventory_on_enter_area​

If turned on, the player's inventory will be cleared when they join a puzzle but, will be given back once they exit!

component_blocked_message​

Set to true in order to send a message to a player who tries to do something they are not allowed to do to a component — turn it, take its mirror, resize it. Since 9.0.0 this message reaches every refused action; before, it only fired for a mirror support locked on its own.

player_edit_rights​

The server-wide defaults for what players may modify on each kind of component, as player_edit_rights.<component_type>.<right> keys (for example player_edit_rights.mirror_support.rotate_h). The rights are rotate_h, rotate_v, handle_mirror and resize, each on the component types it applies to.

⚠️ These are a seed, not a live setting. They are read once, when an area is created, and copied into it. Editing them changes the areas you build afterwards; it never touches a puzzle that already exists. The full three-level model is described in Component edit rights.

The shipped values reproduce exactly what a new area got before 9.0.0, so a server that leaves them alone sees no change.

music_blocks_sound_category​

The channel where the music blocks songs will be played. (Available values: MASTER, MUSIC, RECORDS, WEATHER, BLOCKS, HOSTILE, NEUTRAL, PLAYERS, AMBIENT, VOICE)

other_sounds_sound_category​

The channel where non-music block-related sound will be played. (Available values: MASTER, MUSIC, RECORDS, WEATHER, BLOCKS, HOSTILE, NEUTRAL, PLAYERS, AMBIENT, VOICE)

laser_display_mode​

Defines how laser beams are rendered in the world. Available values:

  • PARTICLE: Classic Redstone dust particles (legacy behavior).
  • DISPLAY_ENTITY (default): Block Display Entities for continuous laser beams. Significantly better performance, especially with many lasers. Requires Minecraft 1.19.4+.
  • BOTH: Both particles and display entities are rendered simultaneously. Useful for debugging or visual comparison.

rotation_preview​

When enabled (default: true), a curved arrow made of Block Display Entities is displayed around rotatable components when a player selects a rotation button in the shortcut bar. The arrow previews the direction of the upcoming rotation from the player's perspective. It is only visible to the player performing the rotation.

If the space around the component is obstructed by solid blocks, the arrow is not displayed.

Requires ProtocolLib to be installed on the server. If ProtocolLib is absent, the preview is silently disabled regardless of this setting.

close_rotation_menu_on_look_away​

Controls whether a player's component rotation/resize menu closes when they look away from the component (default: true).

  • TRUE: the menu closes automatically as soon as the player looks away from the component (original behavior).
  • FALSE: the menu stays open as long as the player remains within range, regardless of where they are looking.

The distance rule and the other closing conditions (leaving the area, changing world, etc.) are unaffected by this option.

component_info​

Globally enables or disables the component info feature (default: true). When set to false, the /le info command sends an error message to the sender and does not give the item. The per-area toggle has no effect when this is disabled.

laser_ambient_sound​

Enables or disables the ambient sound played near active lasers (default: true). When enabled, a low-volume ambient sound is played to players who are within 1.5 blocks of an active laser beam. The sound loops every 10 seconds and stops when the player moves away or the laser is deactivated.

portal_velocity_multiplier​

Multiplier applied to the magnitude of the player's entry velocity to compute the exit speed (default: 1.0, range: 1.0–2.0). The exit velocity is always directed along the exit portal's normal, at this multiplied magnitude plus the fixed portal_exit_impulse below. A value of 1.0 (default) gives pure speed conservation — the player comes out at exactly the speed they entered. Values above 1.0 add energy at each teleportation, useful to sustain long aerial loops against Minecraft's air drag, but they also risk launching the player into ceilings on short vertical loops. Values outside the range are clamped automatically.

portal_exit_impulse​

Fixed velocity added along the exit portal's normal after teleportation, in blocks per tick (default: 0.2, range: 0.0–2.0). Guarantees a small "pop" out of the portal even when the player entered at very low speed, so a player walking into a portal always exits with a noticeable push instead of dribbling stuck at the exit surface. Applies on top of the speed derived from portal_velocity_multiplier. Set to 0.0 to disable. Values outside the range are clamped automatically.

portal_drag_compensation​

Whether to cancel Minecraft's horizontal air drag for players in post-portal flight (default: true). When enabled, the plugin divides the player's horizontal velocity by 0.91 every tick while they are airborne after a portal teleportation, so aerial trajectories keep their horizontal speed across consecutive portals instead of decaying by about 9% per tick. Compensation stops automatically when the player lands, enters water or lava, starts gliding with an elytra, or toggles creative/spectator flight. Set to false to restore vanilla Minecraft air drag during portal flights.

portal_entry_speed_quantization​

Bucket size used to smooth out tick-alignment noise on the measured entry speed before computing the exit speed, in blocks per tick (default: 0.5, range: 0.0–5.0). Minecraft's movement events carry small per-tick variations in the reported velocity that would otherwise propagate and amplify across consecutive portal bounces — a stable aerial loop could never converge. Rounding the entry speed to the nearest bucket of this size absorbs that noise: as long as successive entries fall into the same bucket, they produce identical exits and consecutive jumps land at the same spot. Set to 0.0 to disable quantisation. Values outside the range are clamped automatically.