Content generated with AI — it may contain mistakes.

ExyliaMines/GuidesUpdated in v1.8.0

Move to ExyliaMines

Bring over mines from ExyliaSurvivalCore, CataMines or RealMines.

Page 15 of 284 min read

From ExyliaSurvivalCore#

Mines used to be a module of ExyliaSurvivalCore. They are now this plugin, and since 1.6.0 ExyliaMines no longer imports anything from there: the mines, the blocks they were regrowing, the settings, the messages and the mining history are only brought over by an earlier release.

Import with a 1.5 release

A server still running the survival core's mines installs an ExyliaMines release before 1.6.0 next to it, with the survival core's mines module off, and starts once. That release reads the mines from the survival core's database and writes plugins/ExyliaMines/.imported-survivalcore when they are in.

Update to the current release

With the mines in ExyliaMines' own tables, replace the jar with the current one. Nothing is read from the survival core again.

What else changes#

  • Permissions. exyliasurvivalcore.mines.admin is no longer declared. Staff who had it need exyliamines.admin. Mine permissions are stored on each mine and came over with it.
  • Commands. /minesadmin keeps its name.
  • Placeholders. Inside Exylia plugins' own files the names are the same, %mine_reset_<id>%. Through PlaceholderAPI the plugin in front changes: %exyliasurvivalcore_mine_reset_<id>% becomes %exyliamines_mine_reset_<id>%. See Placeholders.
  • The API. Plugins that broke mine blocks through ExyliaSurvivalCore move to MinesService. See API.

From CataMines or RealMines#

Load your worlds

Locations only come over in worlds that are loaded when the import runs.

Run the import

Run /minesadmin import catamines or /minesadmin import realmines, as below.

Finish the setup

Add holograms, loot tables and the rest from /minesadmin.

Check that it works: the answer says how many mines were imported and how many skipped, and /minesadmin now lists them as classic mines.

/minesadmin import catamines
/minesadmin import realmines

The mines are read straight from the other plugin's folder, plugins/CataMines/mines/ or plugins/RealMines/mines/, one .yml file per mine. That plugin does not have to be installed, and nothing in its files is changed.

Every mine comes over as a classic mine of this server, enabled. Its id is its name in lower case, with anything other than letters, digits, _ and - turned into _. A mine whose id is already taken — on any server of the database — is skipped, so running an import again only adds what is new. The answer says how many were imported and how many skipped; a file that could not be read is named in the console.

Imported mines are set up at once and refill on their first interval. Their holograms, loot tables and everything else this plugin adds are set afterwards from /minesadmin.

CataMines 2.x#

CataMinesExyliaMines
nameId and display name
region (world, p1, p2)The area. Only cuboid regions; any other region type is skipped.
composition (block, chance)The composition, each chance as a weight
resetDelayReset interval; the default from config.yml when it is not set
resetMode with PERCENTAGE, and resetPercentageThreshold: CataMines resets when the share left falls to its value, ExyliaMines when the share mined reaches it, so 100 − resetPercentage
warn.enableWarn, warn.warnSecondsReset warning: the longest of the warning seconds
teleportLocationEntry teleport
teleportResetLocation, with teleportPlayersToResetLocationSafe teleport

CataMines loot tables are not imported.

RealMines 1.x#

RealMinesExyliaMines
typeOnly BLOCKS mines. Schematic and farm mines have no counterpart and are skipped.
name, displayNameId, and display name with its & colour codes removed
world, pos1, pos2The area
block-sets (default, or the first set), or blocksThe composition, each percentage as a weight
reset.time.active, reset.time.valueReset interval, at least 5 seconds; the default from config.yml when time resets are off
reset.percentage.active, reset.percentage.valueThreshold, as 100 − value
settings.send-mined-items-to-inventoryAuto-pickup
settings.break-permissionMine permission realmines.<name>.break
iconIcon, when it names a material
teleportEntry teleport, centred on the block

Locations are only imported in worlds that are loaded when the import runs; load the worlds first.

Something missing on this page? Tell us on Discord