Skip to main content

Server pack

The Lasers-Enigma server pack is a ready-to-play Minecraft server archive containing the Lasers-Enigma plugin, all its dependencies, and a complete set of puzzle areas from the community server.

It is the fastest way to try the plugin without any setup.

Download​

Download the latest server pack from the download page or directly via: https://lasers-enigma.eu/download.php?type=server-pack.

The archive is regenerated weekly from the community server.

How to run​

  1. Extract the .tar.gz archive to a folder of your choice.
  2. Accept the EULA: open eula.txt and set eula=true.
  3. Generate a start script adapted to your OS: Use papermc start script generator and add it to the server directory.
  4. Connect to the server from Minecraft: localhost.

Requirements: Java 21 or later. The server runs on Paper.

What's included​

  • Paper server JAR (latest version from the community server)
  • Lasers-Enigma plugin and all required dependencies (WorldEdit, NoteBlockAPI, etc.)
  • All puzzle areas, world, and configurations from the community server
  • Additional plugins used on the community server

What's excluded​

  • Useless data (log files, old backups, cache, ...)
  • Sensitive configuration (API keys, SSH keys, webhook URLs, and the documentation agent address and token are sanitized)

Starting with fresh stats​

The server pack ships with all the statistics accumulated on the community server (player records, victories, leaderboards, race results, ...). If you run your own copy and want players to start from a clean slate, you can wipe the stats directly in the SQLite database.

See Resetting stats for the full procedure and the exact SQL to run.

Weekly refresh​

The server pack is automatically regenerated every week from the latest state of the community server. This ensures that new puzzle areas and plugin updates are always included.

If the download link shows an error, the archive may be in the process of being regenerated. Please try again in a few minutes.

Features unavailable out of the box​

The following features require credentials that have been removed from the server pack for security reasons.

Completely non-functional:

  • /puzzle download — Uploads the current puzzle as a schematic to an SFTP server. Requires a valid SFTP host, username, and SSH private key.
  • /puzzle solution — Checks whether a wiki solution page exists on GitLab and sends a request to Discord if it does not. Requires a GitLab API access token, project ID, project URL, and a Discord webhook URL.

Partially functional (review is saved locally, but Discord notification crashes in the background):

  • /puzzle review create — Opens the review GUI (note → difficulty → comment). The review data is saved correctly, but the delayed Discord notification fails with a logged error.
  • "Rate this puzzle" menu on room exit — The same review GUI appears automatically when a player exits a puzzle room through an exit portal. Same limitation as above.

All other features (portals, rooms, hints, teleportation menu, review viewing, lobby, etc.) work normally.

Restoring the unavailable features​

All credentials are stored in plugins/LEPlayServerUtils/config.json. Edit the following fields to re-enable each feature:

SFTP — /puzzle download

"sftp-authentication": {
  "host": "<your-sftp-host>",
  "username": "<your-sftp-username>"
}

Also place your SSH private key at plugins/LEPlayServerUtils/.ssh/id_rsa (the key file path is configurable via the key-file field).

GitLab API — /puzzle solution

"gitlab-api-authentication": {
  "access-token": "<your-gitlab-access-token>",
  "project-id": <your-project-id>,
  "project-url-part": "<namespace/project-slug>"
}

Discord webhooks — review notifications and solution requests

"solution-request-discord-webhook-url": "<your-discord-webhook-url>",
"review-discord-webhook-url": "<your-discord-webhook-url>"

Note: Beyond credentials, some features may require code changes to work on a different infrastructure. For example, the schematic availability check in /puzzle download points to a hardcoded lasers-enigma.eu API URL (PuzzleSchematicService.java). Please contact me if you try to restore these features and run into issues.