🧱 Grid Mode

#What Grid Mode Does

A Free Mode map needs every arena instance placed and defined by hand, which is the slow part of running a practice server at scale. A Grid Mode map takes the one arena you already built, captures it, and pastes it across a flat grid of copies, registering each one as a playable instance as it goes.

You still build and define exactly one arena. Everything after that is generated.

#Step 1: Pick the Type

A new map asks for its type before anything else. Choosing Grid Mode here changes the rest of the wizard; the choice is made once, when the map is created.

#Step 2: Build the Template

This step is the same as a Free Mode map: define the universal region, the battle region, the team spawns, and optionally the FFA and spectator positions, then create the template. What you define here is what gets copied, so the universal region has to enclose the entire build. Anything outside it is not part of the arena and will not be pasted.

#Step 3: Lay Out the Grid

The last wizard screen asks for three numbers.

Spacing Between Arenas is the gap left between one copy and the next, in blocks. It is added to the universal region's own width, so the real distance between two arena origins is the region size plus this value. Leave enough room for anything that travels outside the build, such as arrows or ender pearls, or players in one arena will end up interfering with the next.

Columns (X axis) and Rows (Z axis) are how many copies to generate along each axis. The total number of arenas is columns multiplied by rows. Neither can be set below 2.

The Generate button only becomes active once all three are set, and lists which of them are still missing until then. Grid generation is flat: every copy sits at the same Y as the original.

The arena you already built counts as the first cell, so generating a 5 by 5 grid from it produces 24 new instances rather than 25.

#Undoing a Generation

Generation runs in the background and reports progress as it goes. When it finishes, it sends a clickable message that runs /pduels undogrid, which removes everything that run pasted. This is the moment to check the spacing: once you move on, the copies are ordinary arena instances and have to be deleted individually.

#Auto Generation

Separate from the grid wizard, and available to any map, Auto Generation handles the case where every arena of a map is already busy. Rather than making players wait, the plugin pastes a new permanent instance into a world you nominate and hands the match to it.

Auto Generation Status turns it on for this map. Generation World picks which world the new instances are pasted into, chosen from a list of the worlds on your server. Pointing this at a dedicated flat or void world keeps generated arenas out of the way of your builds. Minimum Spacing is the smallest gap allowed between a new instance and anything already placed, defaulting to 250 blocks.

Instances created this way are permanent. They stay registered after the match ends and are reused like any other arena, so a busy map grows once and then settles.

Auto Generation has one silent prerequisite: the map needs a captured copy of its arena to paste. Maps on the internal regeneration engine get this once their regeneration state is built, and maps on the WorldEdit engine need WorldEdit installed with a generated schematic. Without one, nothing is generated and players queue as normal.