Set up a classic mine
Choose the blocks a mine is filled with, when it refills, the warning, and what happens to players inside.
A classic mine is refilled as a whole from its composition: every block of its area is replaced by a block drawn at random from a weighted list, on a timer you choose.
Before you start#
You need a classic mine with its area selected. See Create and edit mines and Select a mine's area. For a full walkthrough from nothing, see Your first mine.
Steps#
Open the mine
Run /minesadmin and left-click your classic mine.
Choose its blocks
Click Mine ▸ Composition, then Composition ▸ Add block and pick a block. It arrives with a weight of 10. Add every block the mine should contain.
Set when it refills
Back on the setup screen click Mine ▸ Resets. Click Resets ▸ Interval and type a time such as 90, 5m or 1h30m. The minimum is 5 seconds.
Set the warning
Click Resets ▸ Warning and type how long before a refill players inside are told, for example 10s. 0s switches the warning off.
Refill it now
Click Resets ▸ Force reset. It needs a region and at least one block in the composition.
A new classic mine starts with an interval of 5 minutes and a warning of 10 seconds. These come from settings.default-reset-interval-seconds (300) and settings.default-reset-warning-seconds (10) in config.yml; change them there, or under Plugin ▸ Settings ▸ New mines, to change what new mines start with. Existing mines keep their own values.
Check that it works#
Run /mine <id> as a player and break a few blocks, then run /minesadmin reset <id>: the area refills at once. To see the timer, wait for the interval, or set a short interval such as 30s while you test. Walking in plays a sound, shows the "MINE" title and a "next reset" boss bar that empties as the refill comes closer. If something does not work, see Common problems.
The composition#
Composition lists every entry with its weight and the chance it works out to: the entry's weight over the sum of all weights. Weights are relative, not percentages. Stone at 70 and coal ore at 30 is the same mine as stone at 7 and coal ore at 3.
| Click on an entry | What it does |
|---|---|
| Left-click | Weight +1. |
| Right-click | Weight -1, never below 0.1. |
| Shift-left-click | Asks for an exact weight, at least 0.1. |
| Middle-click | Opens the entry's loot table. See Loot and effects. |
Drop key (Q) | Opens the entry's break effects. |
| Shift-right-click | Removes the entry, after a confirmation. |
A material that cannot be placed as a block is refused. Use each material once: loot and effects are looked up by material, so a second entry would only weigh into the draw.
Only the materials of the composition are the mine's own. Breaking one is a mine break, with its loot and its count towards the threshold; anything else inside the area is left alone, or refused with Mining ▸ Restrict breaking on. See Create and edit mines.
When it refills#
Three things refill a classic mine:
| Trigger | Set in | What it does |
|---|---|---|
| Interval | Resets ▸ Interval | Refills it every interval. 5 minutes by default, 5 seconds at the least. |
| Threshold | Resets ▸ Threshold | Refills it early once this share of it has been mined since the last refill. 0, the default, turns it off. Left-click adds 5%, right-click removes 5%, middle-click asks for an exact value from 0 to 100. |
| Force reset | Resets ▸ Force reset | Refills it now. |
Every refill, whatever caused it, starts the interval over. Shortening the interval applies at once; lengthening it applies from the next refill. The threshold counts the blocks broken through the mine since its last refill, against the number of blocks in its shape.
A refill that falls due while none of the mine's chunks are loaded is held until they all are. Nobody can mine a mine nobody is near, and filling it would load every chunk at once. It happens as soon as somebody comes close enough.
The warning#
Resets ▸ Warning sets how long before an interval refill the players inside are told: 10 seconds by default. When it starts, everyone inside sees the visuals.reset-warning-title title and the visuals.reset-bossbar countdown, which takes the place of the "next reset" bar until the refill. The warning belongs to the interval: a threshold or a forced refill happens straight away.
What happens to players inside#
In order, when a refill begins:
The safe teleport
If Teleports ▸ Safe teleport is set, everyone inside is sent there first.
Loose entities are cleared
With settings.clean-entities-on-reset on (the default), dropped items, experience orbs, projectiles, minecarts, end crystals and fireworks inside the shape are removed. Mobs, armour stands, item frames and paintings are left. Players never are.
The area is refilled
Over a few ticks. All the refills running at once share about 4 milliseconds a tick, so several mines resetting together cost what one does, spread over more ticks. A block that already is the material drawn for it is not touched.
Buried players are lifted
With Teleports ▸ Lift buried players on (the default), anyone the new blocks buried is moved up to the first gap two blocks tall above them, at most two blocks above the mine's top. Somebody under a roof with no gap goes to the safe teleport, or else the entry teleport.
It is announced
The sounds.reset sound plays to the players inside, other plugins receive MineResetEvent, and the reset-announcement line goes to whoever announcements.reset says.
Every block inside the shape is redrawn from the composition, including anything a player placed there since the last refill. Keep decoration outside the selected box, or outside the sphere or cylinder cut out of it.
Teleports#
| Button | Click | What it is |
|---|---|---|
| Teleports ▸ Entry teleport | left / shift | Where /mine <id> and the /mines menu send players. Left-click sets it where you stand; shift-click clears it. Without one, /mine answers "This mine has no entry point." |
| Teleports ▸ Safe teleport | left / shift | Where players inside are sent at the start of every refill. Optional. |
| Teleports ▸ Lift buried players | click | Toggles lifting players the refill buried. On by default. |
Going further#
Who reads the reset announcement#
announcements.reset in config.yml (also under Plugin ▸ Settings ▸ Announcements):
| Value | Who |
|---|---|
OFF | Nobody. |
NEARBY | Players within announcements.radius blocks of the mine's centre, 64 by default. The default. |
SERVER | Everyone online. |
The default line carries a clickable [Go] that runs /mine <id>.
Silence the titles and bars#
Empty a title's or a bar's text in messages.yml to turn it off, or set a sound to "" in config.yml.
Technical details
Where each classic mine stands in its cycle (blocks mined since the last refill, and when the next one is due) is saved every 30 seconds and when the server stops. After a restart the countdown takes up where it was and the threshold keeps counting from the same share. A refill that fell due while the server was off happens as soon as the mine's chunks are loaded. settings.classic-tick-interval-seconds (1 by default) is how often classic mines are checked for a due refill.
Something missing on this page? Tell us on Discord