Lasers Enigma

Lasers Enigma — Free and open-source light puzzle editor

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.

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.

> Active project — regular updates, Active project available for download.

---

✦ Try before you install

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.

→ The fastest way to know if Lasers Enigma is the right fit for your server is to log in and play for ten minutes.

---

✦ Three pillars

🧠 Solve

Give your players fun, replayable, brain-bending challenges — 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.

<img src="https://lasers-enigma.eu/docs/uploads/67f4443f1c6b14ce18ab4953aefba846/solve_mirror.gif" alt="Solve a Lasers-Enigma level with a mirror" width="900">

<img src="https://lasers-enigma.eu/docs/uploads/0d682cfebc66479a50b1726aa23a2fed/solve_solidifier.gif" alt="Solve a Lasers-Enigma level with a laser solidifier" width="900">

<img src="https://lasers-enigma.eu/docs/uploads/cdd90d6acf1b7fe9c93a839b374ccea7/solve_portal_fly.gif" alt="Solve a Lasers-Enigma level by flying through portals" width="900">

🎨 Design

Assemble modular, orientable and colourable components to manipulate the flow of light. Configure victory conditions, sound and visual atmosphere with precision — 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.

<img src="https://lasers-enigma.eu/docs/uploads/d2a836b4f71a7198711b9fb1b892889a/design.gif" alt="Create Lasers-Enigma level" width="900">

🔗 Share

Copy your puzzles to other locations within the game, export schematics to other servers, or upload them to share with the community — and pull any community-made puzzle directly into your own server in one click.

---

✦ Use it for more than puzzles

Lasers Enigma is built around puzzles, but most of its building blocks are useful anywhere on a server — adventure maps, MMORPG worlds, minigame lobbies, even PVP arenas:

- A Background music playground — the / drives doors, pistons and contraptions from any in-game state, with no repeaters and no command blocks. - A Background music playground — the blocks turns into a clean access-control system for quest endings, member-only rooms or scavenger hunts. - A Background music playground — %%MD3%% / %%MD4%% blocks let you pop staircases and walls in and out without any command block. - A Background music playground — coloured beams that sweep, cycle and pulse — perfect for A Background music playground or any decorative build. - A Background music playground — the %%MD5%% plays custom Note Block Studio songs tied to player presence, condition or schedule. - A Background music playground at spawn or in a minigame area — momentum-preserving teleportation is fun on its own, no puzzle required.

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" — you can build it in-game in a few minutes.

---

✦ What's in the box

Puzzle components

<img src="https://lasers-enigma.eu/docs/uploads/f24c4e54310178d511227648eb2f85f5/components.gif" alt="Create Lasers-Enigma level" width="900">

Every component can be placed on the floor, walls or ceiling. floor, walls or ceiling

- %%MD2%% — emits a colored laser; rotatable, can be conditional or redstone-driven. - %%MD3%% — 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. - %%MD4%% — redirects incoming lasers and combines their colors before re-emitting. Rotatable. - %%MD5%% — decomposes secondary and white lasers into their constituent colors. - %%MD6%% — holds a colored, white or black mirror at any orientation. Hit the Conditional edge / %%MD1%% block: the laser is reflected. Slide along the Conditional edge / %%MD1%% block: the laser passes through and is only filtered. A black mirror duplicates the light. - %%MD7%% — a full-block mirror (Minecraft concrete powder) that reflects matching colors. - %%MD8%% — gives players mirrors, and optionally the Portal Gun, inside a puzzle. - %%MD9%% — holds a mirror; filters incoming lasers based on the mirror's color. - %%MD10%% — holds a mirror; reflects matching colors back in all directions. - %%MD11%% — attracts or repels lasers within a configurable radius. - %%MD12%% — colored stained glass that filters laser beams. - %%MD13%% — destroyed when hit by the right laser color. - %%MD14%% — turns a laser's path into a solid trail of colored glass. Can be conditional. - Conditional edge / %%MD1%% block — appears or disappears when its condition is met (great for hidden doors and opening passages). - %%MD15%% — turns into a redstone block when its condition is met, driving vanilla redstone contraptions. - %%MD16%% — feeds external redstone signals back into the condition system. - %%MD17%% — a locked mechanism that opens once the matching keys are collected from key chests scattered around the puzzle. - %%MD18%% — a moving cabin that travels between floors on player input. Can be conditional. - %%MD19%% — dispenses physical %%MD20%% that players grab and carry. Standard cubes block lasers; concentrators absorb and re-emit a merged-color laser. Conditional dispensing. - %%MD21%% — 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. - %%MD22%% — collectible reward, tracked per run and globally. - %%MD23%% — plays a custom song from the server's song library. Can be conditional. - %%MD24%% — quartz blocks and stairs on which the Portal Gun can place portals. - %%MD25%% — in-world ranking of players across 15 different criteria.

Portal Gun

A first-person teleportation item that turns any own unique color pair 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 own unique color pair. 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 — opening up light-storage and re-routing puzzles impossible to build with mirrors alone.

Cubes

Physical puzzle objects dispensed by re-emit that players can re-emit. Standard cubes act as re-emit for lasers; cube concentrators re-emit 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 — opening puzzle patterns that require physically moving an obstacle or a directional emitter into the laser path.

A real color system

Primary (red/green/blue), secondary (yellow/magenta/cyan) and white lasers — combine, decompose with prisms, filter through stained glass, partial-reflect with colored mirrors, duplicate with black mirrors. Configurable strict or lenient color matching.

Color-blind friendly info tool

The info item 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 — no need to rely on the visual color alone. With the optional %%MD1%% 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.

Wireless-redstone-style condition engine

Components and area victories use a powerful condition system with multiple modes:

- Victory area — number of activated receivers in the area. - Victory area — number of players currently in the area. - Victory area — number of redstone-powered sensors in the area. - Victory area — number of opened locks in the area. - Victory area — seconds elapsed since the first player entered the area. - Victory area — unique bonuses collected in the area during the current run. - Victory area — best lifetime bonus count among the players currently in the area, accumulated across every area they've ever won. - Victory area — 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. - Victory area — keeps a laser sender or solidifier permanently active. - Victory area — drives a laser sender or solidifier from a vanilla redstone signal (lever, button, pressure plate…). - Victory area — for area victories only: players win only if they exit through a designated victory zone.

Each numeric mode supports min/max ranges (with optional ∞ upper bound). It can replace most wireless-redstone needs without a single repeater or command block.

Player progression & stats

- Per-area, per-player and server-wide statistics (duration, steps, actions, bonuses). - Personal records and puzzle records, with anti-cheat tainted-run detection (records require solo runs). - 15-criteria **Leaderboard** component for in-world rankings. - Persistent victory message with first-victory celebration. - `/le stats` commands for player, area and server stats.

Checkpoints

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.

Scheduled actions

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 — no command blocks needed.

Sync between components

Pair two components so they share state automatically: gravitational sphere strength (horizontal, vertical, or both), gravitational sphere strength, or gravitational sphere strength. Move one mirror — its synced twin moves with it. Perfect for symmetric puzzles, mirrored mechanisms or coordinated multi-laser challenges, with no redstone or commands required.

Schematics & copy/paste

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 Build it once, deploy it everywhere. — fetch a community puzzle directly with %%MD1%% (with tab-completion suggesting all available puzzles).

Integrations

- **BetonQuest** — native conditions, events and objectives to weave puzzles into quest systems.

Vanilla command compatibility

Every command accepts standard Minecraft selectors (`@a`, `@p`, `@e[...]`) and relative coordinates (`~`, `^`), and participates correctly in `/execute at|as` chains — drop Lasers Enigma into your existing command-block, datapack or BetonQuest setup without friction.

Permissions

Fine-grained permission nodes (`lasers.edit`, `lasers.admin`, …) 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.

Highly configurable

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 — rotating mirror supports, concentrators, laser senders or laser receivers, resizing gravitational spheres, using the info item — without touching any file.

Performance

Lasers Enigma is Battle-tested for years on the — empty puzzle areas cost almost nothing. Battle-tested for years on the Battle-tested for years on the under live community traffic.

No resource pack required

Lasers Enigma works out of the box with vanilla Minecraft assets — 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.

Storage

SQLite by default, MySQL supported. All data lives under `/plugins/LasersEnigma/`.

License

Lasers Enigma is published under non-commercial purpose. 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 — and to prevent it from being repackaged or paywalled as a paid feature on monetized networks.

> 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 — 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.

That said, we're open to discussion: if you'd still like to use the plugin in a commercial context or without attribution, we're open to discussion and we'll evaluate case by case whether we can grant you a tailored license.

25 built-in languages

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 — with per-player language preference (`/le lang <language>`) and an open process to add your own.

---

✦ Free resources

- 🔌 **The plugin** — open-source, works on any modern Spigot/Paper server. - 🧩 **Downloadable levels** — community-made puzzles, ready to import in-game. - 🗂️ **Server pack** — a pre-configured server to get started in minutes. - 🎮 **Test server** — connect to `play.lasers-enigma.eu` to try it before installing.

---

✦ Links

Documentation · Support & Community Discord · Source code · SpigotMC · Hangar (PaperMC)

More info, screenshots and tutorials at lasers-enigma.eu.

---

🚀 Ready to install?

1. Five minutes later, your first laser puzzle is up and running.. 2. Drop the plugin's `.jar` in your `plugins/` folder, alongside %%MD1%% and %%MD2%%. 3. Restart the server and run %%MD3%% in-game. 4. Five minutes later, your first laser puzzle is up and running. (%%MD4%%.)

---

🎥 First-puzzle walkthrough

If you want a guided walkthrough of building a basic laser puzzle from scratch: