Content generated with AI — it may contain mistakes.

ExyliaMines/GuidesUpdated in v1.8.0

Set up a classic mine

Choose the blocks a mine is filled with, when it refills, the warning, and what happens to players inside.

Page 6 of 287 min read

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 entryWhat it does
Left-clickWeight +1.
Right-clickWeight -1, never below 0.1.
Shift-left-clickAsks for an exact weight, at least 0.1.
Middle-clickOpens the entry's loot table. See Loot and effects.
Drop key (Q)Opens the entry's break effects.
Shift-right-clickRemoves 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:

TriggerSet inWhat it does
IntervalResets ▸ IntervalRefills it every interval. 5 minutes by default, 5 seconds at the least.
ThresholdResets ▸ ThresholdRefills 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 resetResets ▸ Force resetRefills 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.

An unloaded mine waits

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.

A refill overwrites everything in the shape

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#

ButtonClickWhat it is
Teleports ▸ Entry teleportleft / shiftWhere /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 teleportleft / shiftWhere players inside are sent at the start of every refill. Optional.
Teleports ▸ Lift buried playersclickToggles 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):

ValueWho
OFFNobody.
NEARBYPlayers within announcements.radius blocks of the mine's centre, 64 by default. The default.
SERVEREveryone 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