MineReset

Automatic mine management and reset system for PocketMine-MP

Overview

MineReset is a mine management plugin for PocketMine-MP that allows server administrators to create, configure, and automatically reset custom mining areas.

Each mine can have its own reset interval, block distribution, reset mode, and protected region. Mines are stored persistently and restored automatically when the server starts.

Features

No external plugin dependencies are required.

Installation

1. Download the latest MineReset.phar.
2. Place the file inside your server's plugins/ directory.
3. Start or restart the server.
4. The default config.yml will be generated automatically.
5. Configure the plugin according to your server requirements.

Configuration

The main configuration file is located at:

plugin_data/MineReset/config.yml

Example:

# DO NOT TOUCH!
config-version: "1.0.0"

# Plugin prefix
prefix: "§7[§b§lMine§dReset§r§7] "

# How many blocks should be replaced before yielding.
# 20 ticks = 1 second.
blockReplaceTick: 3000

# Teleport players inside the mine to the world's safe spawn
# when the mine is reset.
teleport-to-spawn: true

messages:
  mine-reset-announcement: "{prefix} §bMine §a{mine}§b is resetting."

Configuration Options

Supported message placeholders:

Creating a Mine

Use:

/mine create  

After running the command, the plugin will ask you to select two positions.

Break one block to select the first position, then break another block to select the second position.

Example:

/mine create MineA 300

This creates a mine named MineA with a reset interval of 300 seconds.

The selection process automatically expires after one minute.

To cancel the selection process, use:

cancel38

Adding Blocks

After creating a mine, blocks can be added using:

/mine addblock   

Example:

/mine addblock MineA stone 60
/mine addblock MineA coal_ore 25
/mine addblock MineA iron_ore 10
/mine addblock MineA diamond_ore 5

The configured chance determines the weight of each block when the mine is regenerated.

The maximum configured chance for an individual block is 100.

Removing Blocks

Remove a block entry from a mine using its index:

/mine removeblock  

Example:

/mine removeblock MineA 2

Use /mine info to view the indexes of the configured blocks.

Resetting Mines

Reset a specific mine manually:

/mine reset 

Example:

/mine reset MineA

Reset every registered mine:

/mine resetall

Manual resets use the same reset process as automatic resets.

Reset Timer

Change the reset interval of an existing mine:

/mine setresettime  

Example:

/mine setresettime MineA 600

This changes the reset interval to 600 seconds.

The value is automatically treated as an absolute value.

Changed-Only Reset

MineReset supports two reset modes.

Always

The mine resets whenever its configured reset timer expires.

On Changed

The mine resets only if blocks inside the mine have been changed since its previous reset.

Enable or disable this mode with:

/mine diffreset  

Example:

/mine diffreset MineA true

When enabled, the mine waits for a block break or an explosion inside its region before allowing the next timed reset.

This can be useful for mines that should not regenerate when nobody has mined them.

Mine Information

View detailed information about a mine:

/mine info 

The information includes:

• World
• First position
• Second position
• Reset interval
• Time remaining until the next reset
• Configured blocks
• Block chances

Example:

/mine info MineA

Mine List

Display all registered mines:

/mine list

This shows every mine currently registered by MineReset.

Deleting a Mine

Delete an existing mine:

/mine delete 

Example:

/mine delete MineA

The mine is removed from the active registry and will no longer be processed.

Commands & Permissions

The minereset.command permission defaults to op.

Reset Process

When a mine is reset, MineReset:

1. Checks whether the mine is allowed to reset.
2. Fires the MineResetEvent.
3. Announces the reset using the configured message.
4. Detects players inside the mine region.
5. Teleports players to the world's safe spawn when enabled.
6. Generates a weighted random block distribution.
7. Replaces the blocks inside the configured region.
8. Processes the replacement incrementally to avoid blocking the server with the entire operation at once.
9. Updates the mine's reset timestamp.

The reset region is defined by the two positions selected during mine creation.

Events

MineReset provides a cancellable reset event:

ApexGaming\MineReset\events\MineResetEvent

The event provides access to the mine being reset and whether the reset was triggered after detecting a change.

Example:

use ApexGaming\MineReset\events\MineResetEvent;

public function onMineReset(MineResetEvent $event): void{
    $mine = $event->getMine();

    if($mine->name === "MineA"){
        $event->cancel();
    }
}

This allows other plugins to control or prevent mine resets.

Data Storage

Mine definitions are stored automatically in:

plugin_data/MineReset/config.json

The stored data includes:

• Mine name
• World
• Position 1
• Position 2
• Block configuration
• Reset interval
• Last reset timestamp
• Changed-only reset setting

The data is saved automatically when the plugin is disabled.

Building from Source

MineReset includes its required libraries inside the project.

Build the plugin using your preferred PocketMine-MP plugin build workflow.

The resulting plugin can be installed as:

MineReset.phar

License

© ApexGaming — made by TheFaRHaNiR