Mode-Specific Settings

The plugin supports multiple regeneration modes to control how arenas are restored. The phased, selective, and wave modes have specific configuration options that allow you to customize their behavior. Below is a detailed explanation of each option under these sections.

Phased section:

phased:
  sections-per-tick: 1 # How many sections to regen per tick
  delay: 20 # Ticks between phases (1 second default)

This section configures the PHASED regeneration mode, which regenerates the arena in sections (chunks) over time, allowing for a staged regeneration process. This mode is useful for large arenas to reduce server lag by spreading the regeneration workload across multiple ticks.

sections-per-tick:

Specifies how many sections (chunks) of the arena are regenerated per server tick.

delay:

Sets the number of ticks to wait between each phase of regeneration.

Selective section:

This section configures the SELECTIVE regeneration mode, which allows you to regenerate only specific types of blocks or blocks within a certain Y-level range. This mode is ideal for scenarios where you want to restore only certain parts of an arena (e.g., only stone blocks or blocks above a certain height).

selective:
  block-types: [] # e.g., STONE, GRASS_BLOCK
  y-min: -1 # Min Y-level (-1 to disable)
  y-max: -1 # Max Y-level (-1 to disable)

block-types:

A list of block types (materials) to regenerate. If this list is empty, all block types are regenerated.

y-min:

The minimum Y-level (height) for blocks to be regenerated. Blocks below this Y-level will be ignored.

y-max:

The maximum Y-level (height) for blocks to be regenerated. Blocks above this Y-level will be ignored.

Wave section:

This section configures the WAVE regeneration mode, which regenerates the arena in a wave-like pattern starting from a specified origin point and expanding outward. This mode creates a visually appealing regeneration effect and can help distribute server load by regenerating blocks gradually.

origin:

The starting point of the regeneration wave. Valid values are: CENTER, MIN_CORNER, MAX_CORNER.

CENTER:

Starts the regeneration from the center.

MIN_CORNER:

The wave starts from the minimum corner (lowest X, Y, Z coordinates) of the arena.

MAX_CORNER:

The wave starts from the maximum corner (highest X, Y, Z coordinates) of the arena.

speed:

The number of blocks to regenerate per second in the wave. This is internally divided by 20 to determine blocks per tick (since there are 20 ticks per second in Minecraft).

radius-increment:

The number of blocks the wave’s radius expands by each tick.