Maze Engine Documentation

Maze Engine

Maze Engine builds persistent mazes directly in your Minecraft world. Choose a theme, preview its layout, and create a maze with a reproducible seed. Manage the finished structure through interactive chat panels, guide players to its exit, rebuild it, or restore the terrain captured before construction.

Explore the in-game gallery for theme examples and the plugin’s preview and chat interfaces.

Maze Engine supports Paper for Minecraft 1.21.11 and later and requires Java 25. WorldEdit or FastAsyncWorldEdit, WorldGuard, and PlaceholderAPI are optional integrations.

Start Building

Getting Started Install the plugin, check requirements, and build your first maze.

Core Concepts Understand the terms in in-game help: cells, seeds, presets, placement, and snapshots.

Creating Mazes Choose cell dimensions, world coordinates, placement rules, and WorldEdit selections.

Previews and Route Guides Inspect a private visual preview and follow a personal route to the exit.

Themes and Generation

The plugin includes 30 editable presets, from open hedge gardens and desert passages to roofed dungeons, copper halls, and volcanic corridors. Presets control physical geometry, block palettes, decorations, generation settings, and display metadata.

Preset Reference Create custom themes with weighted palettes, roofs, lighting, caps, and wall inlays.

Generation and Geometry Understand deterministic seeds, perfect and braided graphs, physical size, and complexity.

In-Game Gallery See real Minecraft screenshots of themed mazes, previews, and chat controls.

Server Administration

Chat Interface See the in-game help, preset browser, maze controls, previews, and guide panels.

Commands Every public command, accepted option, and practical example.

Permissions Action permissions, maze ownership, management rights, and protection bypass.

config.yml Control operation budgets, size limits, terrain protection, and visual sessions.

messages.yml Customize MiniMessage text, chat panels, buttons, and hover information.

Integrations WorldEdit selections and snapshots, WorldGuard checks, and PlaceholderAPI.

PlaceholderAPI Use global, named-maze, player-location, and ownership placeholders.

Operations and Recovery Understand saved records, removal modes, interrupted work, and backups.

Developer API

The public API exposes immutable maze descriptions, preset metadata, graph routes, operation handles, and completion events. Integrations use the same permission, ownership, and region checks as commands.

API Getting Started Load the Bukkit service and query mazes, destinations, routes, and presets.

Operations and Events Submit creation, regeneration, repair, and removal, then observe their outcomes.

Troubleshooting Diagnose rejected regions, unavailable integrations, failed records, and visual sessions.

Source Code Read the implementation, report a reproducible issue, or contribute on GitHub.