Select a mine's area
Mark the region of a mine, pick its shape, and see how a break inside it works and what cannot farm it.
The area is the box of blocks that is the mine. You mark two corners with ExyliaLib's selection wand, no WorldEdit needed, and optionally cut the box into a sphere or a cylinder.
Before you start#
Create the mine first, see Create and edit mines. You do not need an area to create it, but a mine without one cannot fill, reset or be mined.
Steps#
Open the area section
Run /minesadmin, left-click your mine, then click Mine ▸ Area.
Mark the region
Click Area ▸ Mine region. You get the selection wand: mark two opposite corners of the box and confirm. Both corners are part of the mine and it does not matter which one you mark first.
Pick a shape (optional)
Click Area ▸ Shape to cycle between the shapes below. A new mine is a cuboid.
Add a hologram (optional)
Stand where you want it and left-click Area ▸ Hologram. See Holograms.
Selecting again later corrects the corners and keeps the shape the mine already had. Backing out of the selection leaves the old region as it was.
Check that it works#
Back in /minesadmin the mine shows its region as set. For a classic mine, click Resets ▸ Force reset and the whole shape fills (see Set up a classic mine). Then break a block inside it as a player: it breaks, pays its drops and counts.
Shapes#
Area ▸ Shape cycles through three, each cut out of the box you selected:
| Shape | What the mine is |
|---|---|
| Cuboid | The whole box. The default. |
| Sphere | The largest sphere that fits in the box, centred in it: as wide as the box's shortest side. |
| Cylinder | An upright cylinder as wide as the box's narrower horizontal side and as tall as the box. |
A block belongs to a rounded mine when its centre is inside the shape. The corners of the box outside it are not part of the mine: a refill leaves them alone, breaking there is not the mine's business, and a player standing there is not inside it.
The sphere is as wide as the box's shortest side. Select a box as tall as it is wide and deep, or the sphere comes out smaller than you expect.
A world that loads late#
A mine whose world is not loaded simply waits. With a world manager such as Worlds or Multiverse-Core that loads worlds after the plugins, the mine's area is registered the moment its world loads, and the realistic blocks it was regrowing there are picked up again.
How a break inside a mine works#
Inside an enabled mine, the server's own break is always cancelled for every player, and the mine performs the break itself. This is what lets a mine coexist with everything else on the server:
- Anticheats and other guards decide first. The plugin listens at
LOWpriority and ignores breaks already cancelled, so a fast-break or nuker check that refuses a break is respected. - Protection plugins such as WorldGuard decide at
NORMALand see the break already cancelled. There is no flag to set for mines and no fight over who wins: a mine never forces a cancelled break through. - The mine applies its own rules: its permission, its blocks, its loot, its regeneration.
When the mine performs the break it reproduces what the server would have done: drops worked out with the tool in hand (Fortune, Silk Touch and the correct-tool rules included), durability (Unbreaking applies, the tool breaks with its sound), hunger exhaustion, and experience. Experience goes straight to the miner, Mending included, instead of dropping an orb. A player in creative mode gets no drops and spends no durability, as in vanilla.
Because the server's break is cancelled, a plugin that ignores cancelled break events never sees a mine break, a block logger for instance. Plugins that want to react to mine breaks listen to MineBlockBreakEvent instead, see API. Block-break statistics and advancements are not credited either.
Tools that break several blocks#
A 3x3 pickaxe or a vein miner from another plugin should hand each block to the mine through the API. Each one is then treated as a swing of its own, with the permission check, the loot and the regeneration, so a 3x3 pickaxe in a mine is nine breaks rather than one break and eight holes the mine never refills.
What cannot farm a mine#
A mine pays for and regrows only blocks it put there. Every way to slip one in is closed:
| What | What happens |
|---|---|
| Placing one of the mine's own blocks inside it | Refused with "The mine's own blocks can't be placed inside it." Anything else may be placed. Admins are exempt. |
| Lava and water meeting inside it | A stone, cobblestone or obsidian that would form is cancelled when it is one of the mine's blocks. |
| Explosions | Blocks inside a mine are taken out of the explosion; everything around it is still hit. |
| Pistons | A piston may neither pull a block out of a mine nor push anything into it. |
Without these, an ore carried in with Silk Touch would pay the mine's loot again, count towards its reset and, in a realistic mine, make that spot regrow the ore for good.
Overlapping mines#
Two mines may overlap, but avoid it: a block in the overlap belongs to whichever enabled mine the region index answers with first, and a player is only ever in one mine's session at a time. Walking out of one of two overlapping mines keeps the session of the one the player is still in.
Something missing on this page? Tell us on Discord