Content generated with AI — it may contain mistakes.

ExyliaMines/GuidesUpdated in v1.8.0

Show a hologram over a mine

Place the status hologram over a mine and choose its lines.

Page 12 of 282 min read

Each mine can have a hologram over it that says what state it is in: how much of it is still standing and, for a classic mine, when it refills next.

Before you start#

Install packetevents: it is optional for the plugin but required for holograms. Nothing else is needed, no hologram plugin and no entities in the world. A disabled mine shows no hologram.

Steps#

Stand where it should go

Walk to the spot over the mine. The text floats about two blocks above where you stood, at eye level.

Place it

Run /minesadmin, open the mine, pick Area and left-click Area ▸ Hologram. It is placed where you stand.

Move or remove it

Stand somewhere else and left-click the button again to move it. Shift-click the same button takes it down.

Check that it works#

The hologram shows the mine's name, how much is still standing and, for a classic mine, the time to the next refill. If nothing appears, check that packetevents is installed and that the mine is enabled.

Its lines#

The lines are in messages.yml, one list for each kind of mine:

plugins/ExyliaMines/lang/en/messages.yml
yaml
holograms:
  classic:
    - '{primary}&l%mine_name%'
    - '{letters}Remaining {letters_black}» {info}%remaining%%'
    - '{letters}Next reset {letters_black}» {info}%next_reset% ⌚'
  realistic:
    - '{primary}&l%mine_name%'
    - '{letters}Standing {letters_black}» {info}%remaining%%'
    - '{letters}Blocks grow back one by one'
ValueWhat it is
%mine_name%The display name.
%mine_id%The id.
%mine_type%type-classic or type-realistic from messages.yml: "Classic", "Realistic".
%remaining%The share of the mine still standing, from 0 to 100.
%next_reset%Time until the next refill, written out: 4m 12s. For a realistic mine, per-block, "Per block".
%total_blocks%Blocks mined there by everybody, as of the last minute's read.
%boost%The boost on the mine, as boosts.menu-active writes it, or boosts.menu-none.

The lines are filled in once a second by the plugin itself, and a line is only re-sent to a viewer when its text changed — so a countdown costs one small packet per viewer per second, and a mine nobody touches costs nothing. /minesadmin reload redraws every hologram with the edited lines.

What "remaining" counts#

%remaining% compares what is gone with the number of blocks in the mine's shape:

  • in a classic mine, the blocks broken through the mine since its last refill;
  • in a realistic mine, the blocks waiting to grow back.

The shape's size counts every block of it, air included. A realistic mine selected around a cave with plenty of air never reads far below 100%, and a classic mine that is partly air from the start reads 100% until the first break all the same.

Something missing on this page? Tell us on Discord