![\"Solve](\"https:\/\/lasers-enigma.eu\/docs\/uploads\/67f4443f1c6b14ce18ab4953aefba846\/solve_mirror.gif\")
<\/p>\n# Lasers Enigma \u2014 Free and open-source light puzzle editor<\/p>\n
\n<\/p>\n
**Lasers Enigma** is a free, open-source Spigot\/Paper plugin that turns Minecraft into a full-featured light-puzzle game and editor. Players redirect colored laser beams using mirrors, prisms, filters, gravitational spheres, a portal gun and more to solve levels. Designers compose those components into anything from a beginner’s one-mirror tutorial to massive multi-room adventures.<\/p>\n
Whether you want to host community puzzles on your server, build your own original maps, or play through ready-made levels with friends, Lasers Enigma gives you the toolbox.<\/p>\n
> **Active project** \u2014 regular updates, **180+ community-made levels** available for download.<\/p>\n
—<\/p>\n
## \u2726 Try before you install<\/p>\n
A free public test server runs the latest plugin build at **play.lasers-enigma.eu** with **180+ community-made levels** to play right now. Anyone can also **build new puzzles directly on the server**: once published, they become playable by every other visitor and downloadable from any server in the world.<\/p>\n
\u2192 The fastest way to know if Lasers Enigma is the right fit for your server is to log in and play for ten minutes.<\/p>\n
—<\/p>\n
## \u2726 Three pillars<\/p>\n
### \ud83e\udde0 Solve<\/p>\n
Give your players fun, replayable, brain-bending challenges \u2014 alone or in groups. The built-in **automatic reset** brings every puzzle back to its initial state when no player is left inside, so a level remains playable forever without admin intervention.<\/p>\n
<\/p>\n
![\"Solve](\"https:\/\/lasers-enigma.eu\/docs\/uploads\/0d682cfebc66479a50b1726aa23a2fed\/solve_solidifier.gif\")
<\/p>\n
![\"Solve](\"https:\/\/lasers-enigma.eu\/docs\/uploads\/cdd90d6acf1b7fe9c93a839b374ccea7\/solve_portal_fly.gif\")
<\/p>\n
### \ud83c\udfa8 Design<\/p>\n
Assemble modular, orientable and colourable components to manipulate the flow of light. Configure victory conditions, sound and visual atmosphere with precision \u2014 every puzzle is built entirely in-game. Admins keep `config.yml` for server-wide tuning, but no file editing is required to design a puzzle.<\/p>\n
![\"Create](\"https:\/\/lasers-enigma.eu\/docs\/uploads\/d2a836b4f71a7198711b9fb1b892889a\/design.gif\")
<\/p>\n
### \ud83d\udd17 Share<\/p>\n
Copy your puzzles to other locations within the game, export schematics to other servers, or upload them to share with the community \u2014 and pull any community-made puzzle directly into your own server in one click.<\/p>\n
<\/p>\n
—<\/p>\n
## \u2726 Use it for more than puzzles<\/p>\n
Lasers Enigma is built around puzzles, but most of its building blocks are useful **anywhere on a server** \u2014 adventure maps, MMORPG worlds, minigame lobbies, even PVP arenas:<\/p>\n
– **Wireless redstone replacement** \u2014 the condition engine drives doors, pistons and contraptions from any in-game state, with no repeaters and no command blocks.
\n– **Locked rewards & VIP areas** \u2014 the _Lock & key chest_ turns into a clean access-control system for quest endings, member-only rooms or scavenger hunts.
\n– **Hidden passages and secret rooms** \u2014 _Conditional appearing__ \/ __disappearing__ blocks_ let you pop staircases and walls in and out without any command block.
\n– **Ambient lasers** \u2014 coloured beams that sweep, cycle and pulse \u2014 perfect for **nightclubs, concert halls, futuristic spawns** or any decorative build.
\n– **Background music** \u2014 the _Music Block_ plays custom Note Block Studio songs tied to player presence, condition or schedule.
\n– **A ****Portal Gun**** playground** at spawn or in a minigame area \u2014 momentum-preserving teleportation is fun on its own, no puzzle required.<\/p>\n
If you’ve ever wanted _”a switch that opens a door when 3 specific players are in this room”_, _”a hidden chest revealed only after collecting 5 keys”_, or _”a stage with sweeping coloured lights”_ \u2014 you can build it in-game in a few minutes.<\/p>\n
—<\/p>\n
## \u2726 What’s in the box<\/p>\n
### Puzzle components<\/p>\n
![\"Create](\"https:\/\/lasers-enigma.eu\/docs\/uploads\/f24c4e54310178d511227648eb2f85f5\/components.gif\")
<\/p>\n
Every component can be placed on the **floor, walls or ceiling**. Full component reference \u2192<\/p>\n
– **Laser sender** \u2014 emits a colored laser; rotatable, can be conditional or redstone-driven.
\n– **Laser receiver** \u2014 activates when hit by a matching color; outputs a redstone signal. Rotatable; can be configured to either stop the incoming laser or let it pass through.
\n– **Concentrator** \u2014 redirects incoming lasers and combines their colors before re-emitting. Rotatable.
\n– **Prism** \u2014 decomposes secondary and white lasers into their constituent colors.
\n– **Mirror support** \u2014 holds a colored, white or black mirror at any orientation. Hit the **face**: the laser is reflected. Slide along the **edge**: the laser passes through and is only filtered. A black mirror duplicates the light.
\n– **Mirror block** \u2014 a full-block mirror (Minecraft concrete powder) that reflects matching colors.
\n– **Mirror chest** \u2014 gives players mirrors, and optionally the Portal Gun, inside a puzzle.
\n– **Filtering sphere** \u2014 holds a mirror; filters incoming lasers based on the mirror’s color.
\n– **Reflecting sphere** \u2014 holds a mirror; reflects matching colors back in all directions.
\n– **Gravitational sphere** \u2014 attracts or repels lasers within a configurable radius.
\n– **Glass and glass panes** \u2014 colored stained glass that filters laser beams.
\n– **Burnable block** \u2014 destroyed when hit by the right laser color.
\n– **Laser solidifier** \u2014 turns a laser’s path into a solid trail of colored glass. Can be conditional.
\n– **Conditional ****appearing**** \/ ****disappearing**** block** \u2014 appears or disappears when its condition is met (great for hidden doors and opening passages).
\n– **Conditional redstone block** \u2014 turns into a redstone block when its condition is met, driving vanilla redstone contraptions.
\n– **Redstone sensor** \u2014 feeds external redstone signals back into the condition system.
\n– **Lock and key chest** \u2014 a locked mechanism that opens once the matching keys are collected from key chests scattered around the puzzle.
\n– **Elevator and call button** \u2014 a moving cabin that travels between floors on player input. Can be conditional.
\n– **Cube distributor and creation button** \u2014 dispenses physical cubes that players grab and carry. Standard cubes block lasers; concentrators absorb and re-emit a merged-color laser. Conditional dispensing.
\n– **Cube pressure plate** \u2014 floor-only plate that activates when a cube lands on it (or, optionally, when a player steps on it). Powers the surrounding redstone like a vanilla plate.
\n– **Bonus** \u2014 collectible reward, tracked per run and globally.
\n– **Music block** \u2014 plays a custom song from the server’s song library. Can be conditional.
\n– **Portal surface** \u2014 quartz blocks and stairs on which the Portal Gun can place portals.
\n– **Leaderboard** \u2014 in-world ranking of players across 15 different criteria.<\/p>\n
### Portal Gun<\/p>\n
A first-person teleportation item that turns any **portal surface** into a portal: left-click drops the primary portal, right-click drops the secondary, and walking or falling through one teleports the player to the other while **preserving the entry speed**. Aim portals on facing floors and ceilings to build infinite-momentum loops, or on walls for tight corridor travel. In multiplayer, every player gets their **own unique color pair** so puzzles stay solvable with friends in the same area. Lasers themselves can also be routed through portals \u2014 opening up light-storage and re-routing puzzles impossible to build with mirrors alone.<\/p>\n
### Cubes<\/p>\n
Physical puzzle objects dispensed by Cube Distributors that players can **grab, carry and release**. Standard cubes act as **opaque blockers** for lasers; cube concentrators **absorb** every incoming laser and **re-emit** a merged-color beam in the direction they face, locked to one of 16 horizontal cardinals on release. Cubes fall under custom gravity, stack on each other, traverse Portal Gun portals, and are immune to pistons \u2014 opening puzzle patterns that require physically moving an obstacle or a directional emitter into the laser path.<\/p>\n
### A real color system<\/p>\n
Primary (red\/green\/blue), secondary (yellow\/magenta\/cyan) and white lasers \u2014 combine, decompose with prisms, filter through stained glass, partial-reflect with colored mirrors, duplicate with black mirrors. Configurable strict or lenient color matching.<\/p>\n
#### Color-blind friendly info tool<\/p>\n
The `\/le info` command gives players an **info item**: aim it at any component, laser beam, or compatible block to read its name, color and current state directly in the chat \u2014 no need to rely on the visual color alone. With the optional **MapEngine** plugin, an in-world Venn-diagram color wheel is also displayed in front of the player to show how the color decomposes into its primary parts. Designed to keep puzzles solvable for color-blind players without compromising the visuals for everyone else.<\/p>\n
### Wireless-redstone-style condition engine<\/p>\n
Components and area victories use a powerful **condition system** with multiple modes:<\/p>\n
– **Laser receiver** \u2014 number of activated receivers in the area.
\n– **Players** \u2014 number of players currently in the area.
\n– **Redstone sensor** \u2014 number of redstone-powered sensors in the area.
\n– **Lock** \u2014 number of opened locks in the area.
\n– **Time** \u2014 seconds elapsed since the first player entered the area.
\n– **Bonus** \u2014 unique bonuses collected in the area during the current run.
\n– **Server bonus** \u2014 best lifetime bonus count among the players currently in the area, accumulated across every area they’ve ever won.
\n– **Specific component state** \u2014 mirrors another component’s activation state (with optional inversion). Supported targets: laser receiver, lock, bonus, burnable block, conditional appearing\/disappearing\/redstone block, elevator, music block, laser solidifier, redstone sensor.
\n– **Always activated** \u2014 keeps a laser sender or solidifier permanently active.
\n– **Redstone** \u2014 drives a laser sender or solidifier from a vanilla redstone signal (lever, button, pressure plate\u2026).
\n– **Victory area** \u2014 for area victories only: players win only if they exit through a designated victory zone.<\/p>\n
Each numeric mode supports min\/max ranges (with optional \u221e upper bound). It can replace most wireless-redstone needs **without a single repeater or command block**.<\/p>\n
### Player progression & stats<\/p>\n
– Per-area, per-player and server-wide statistics (duration, steps, actions, bonuses).
\n– Personal records and puzzle records, with anti-cheat tainted-run detection (records require solo runs).
\n– 15-criteria **Leaderboard** component for in-world rankings.
\n– Persistent victory message with first-victory celebration.
\n– `\/le stats` commands for player, area and server stats.<\/p>\n
### Checkpoints<\/p>\n
Set per-area respawn points so players who die or disconnect mid-puzzle reappear inside the area instead of being kicked back to the world spawn. Victory checkpoints are automatically promoted as the new spawnpoint when a player wins, smoothing progression across multi-puzzle maps.<\/p>\n
### Scheduled actions<\/p>\n
Animate components on a timer: sweep coloured beams across a hall like a **nightclub or concert light show**, cycle a stage’s laser colors on the beat, build a rhythm-based puzzle. Available on every component that supports the relevant action \u2014 no command blocks needed.<\/p>\n
### Sync between components<\/p>\n
Pair two components so they share state automatically: **rotation** (horizontal, vertical, or both), **mirror placement and color**, or **gravitational sphere strength**. Move one mirror \u2014 its synced twin moves with it. Perfect for symmetric puzzles, mirrored mechanisms or coordinated multi-laser challenges, with no redstone or commands required.<\/p>\n
### Schematics & copy\/paste<\/p>\n
**Build it once, deploy it everywhere.** Copy and paste full areas or individual components in-game, save them as schematics, and reload them on any other location, world or server you administer. Schematics can also be downloaded from the Lasers Enigma website \u2014 fetch a community puzzle directly with `\/lasers schematic download ### Integrations<\/p>\n – **BetonQuest** \u2014 native conditions, events and objectives to weave puzzles into quest systems.<\/p>\n ### Vanilla command compatibility<\/p>\n Every command accepts standard Minecraft selectors (`@a`, `@p`, `@e[…]`) and relative coordinates (`~`, `^`), and participates correctly in `\/execute at|as` chains \u2014 drop Lasers Enigma into your existing command-block, datapack or BetonQuest setup without friction.<\/p>\n ### Permissions<\/p>\n Fine-grained permission nodes (`lasers.edit`, `lasers.admin`, \u2026) let you control who can build puzzles, manage areas or use admin commands. Plays nicely with **WorldGuard** and most plot\/region plugins, so you can let your players freely create puzzles inside their own claims while keeping the rest of the world locked down.<\/p>\n ### Highly configurable<\/p>\n A single `config.yml` exposes everything an admin might want to tweak: which materials a laser can pass through, the colors and brightness of every laser type, laser-on-player damage and effects, the active language, song playback, and more. On top of that, **per-area settings** (accessible in-game via the Area Configuration menu) let puzzle creators allow or deny specific player interactions \u2014 rotating mirror supports, concentrators, laser senders or laser receivers, resizing gravitational spheres, using the info item \u2014 without touching any file.<\/p>\n ### Performance<\/p>\n Lasers Enigma is **only active when players are in levels** \u2014 empty puzzle areas cost almost nothing. **Battle-tested for years on the ****public test server** under live community traffic.<\/p>\n ### No resource pack required<\/p>\n Lasers Enigma works out of the box with vanilla Minecraft assets \u2014 no resource pack to ship to your players. If you want a different look (a more “fantasy” feel, for example), you can still apply a custom resource pack to override the visuals without breaking anything.<\/p>\n ### Storage<\/p>\n SQLite by default, MySQL supported. All data lives under `\/plugins\/LasersEnigma\/`.<\/p>\n ### License<\/p>\n Lasers Enigma is published under **Creative Commons BY-NC 4.0**. You can freely use, share, modify and redistribute the plugin for any **non-commercial purpose**, with attribution. The non-commercial clause is a deliberate choice to keep the plugin permanently free for community servers, schools, adventure-map creators and friends-only worlds \u2014 and to prevent it from being repackaged or paywalled as a paid feature on monetized networks.<\/p>\n > A small note of honesty: we describe the plugin as _”open-source”_ throughout this page, but strictly speaking CC BY-NC isn’t an OSI-approved open-source license because of its non-commercial clause. Apologies for the shortcut \u2014 for the vast majority of users (community servers, modders, map makers, contributors), the practical experience is the same: the source is public, you can read it, fork it, build with it. Even the levels are free and downloadable.<\/p>\n That said, **we’re open to discussion**: if you’d still like to use the plugin in a commercial context or without attribution, reach out on Discord and we’ll evaluate case by case whether we can grant you a tailored license.<\/p>\n ### 25 built-in languages<\/p>\n English, Chinese, Hindi, Spanish, French, Arabic, Bengali, Russian, German, Korean, Portuguese (BR), Japanese, Turkish, Polish, Italian, Dutch, Swedish, Czech, Ukrainian, Greek, Danish, Finnish, Norwegian, Hungarian, Romanian \u2014 with per-player language preference (`\/le lang —<\/p>\n ## \u2726 Free resources<\/p>\n – \ud83d\udd0c **The plugin** \u2014 open-source, works on any modern Spigot\/Paper server. —<\/p>\n ## \u2726 Links<\/p>\n Documentation \u00b7 Support & Community Discord \u00b7 Source code \u00b7 SpigotMC \u00b7 Hangar (PaperMC)<\/p>\n More info, screenshots and tutorials at **lasers-enigma.eu**.<\/p>\n —<\/p>\n ## \ud83d\ude80 Ready to install?<\/p>\n 1. Download the plugin and its dependencies. —<\/p>\n ### \ud83c\udfa5 First-puzzle walkthrough<\/p>\n If you want a guided walkthrough of building a basic laser puzzle from scratch:<\/p>\n
\n– \ud83e\udde9 **Downloadable levels** \u2014 community-made puzzles, ready to import in-game.
\n– \ud83d\uddc2\ufe0f **Server pack** \u2014 a pre-configured server to get started in minutes.
\n– \ud83c\udfae **Test server** \u2014 connect to `play.lasers-enigma.eu` to try it before installing.<\/p>\n
\n2. Drop the plugin’s `.jar` in your `plugins\/` folder, alongside WorldEdit and NoteblockAPI.
\n3. Restart the server and run `\/lasers` in-game.
\n4. **Five minutes later, your first laser puzzle is up and running.** (Step-by-step guide.)<\/p>\n