Skip to main content
Relics SMP writes two files you edit: plugins/RelicsSMP/config.yml for rules and numbers, and plugins/RelicsSMP/messages.yml for every line of text. Change either, then run /relics admin reload. A bad value never stops the plugin. It falls back to the shipped default and the console names the key, for example config.yml reveal.glow-seconds: '-5' is not valid, using the default. Reload tells you how many values were ignored. PRO-only keys: license_key, spawning.random, spawning.worldevents, seasons and the Void, Gravity, Blood and Orbital relics. Lite reads them and ignores them.

Licence

Custody

Reveal

Protection

See Where powers work.

Abilities

Spawning

See Altars and Relic Rain.

Seasons

The defaults give 2 netherite ingots, 3 diamond blocks and 16 diamonds. See Seasons.

Hints

Titles

The title text lives in messages.yml under titles:. Leave both lines of a title empty to skip it. The /relics board has 3 rows (slots 0 to 26), plus one extra row per seven custom relics on PRO. Materials are Bukkit material names. A name that isn’t an item shows as stone. An invalid slot list falls back to the defaults. The title and lore are in messages.yml under menu:.

Sounds

Every sound the plugin plays is an entry under sounds::
  • key is a Minecraft sound id
  • volume is 0 or more
  • pitch runs from 0.5 to 2
  • enabled: false mutes the entry
On PRO 1.1.0+ you can add your own entries for custom relics. See Custom relics.

Particles

Every particle the plugin shows is an entry under particles::
  • type is a Minecraft particle id
  • count is 0 or more. 0 hides it
  • color (#RRGGBB) and size apply to dust only
  • enabled: false hides the entry
Particles that need block or item data are not supported and are skipped with a console warning.

Relics

Each relic has a section under relics: with its item, boss bar colour, cooldown, passive and power numbers. See Tune a relic for the built-ins and Custom relics for your own.

Messages

messages.yml holds every line of text in MiniMessage: chat, the item tooltip, the relic board, boss bars and titles. Chat lines get the prefix automatically. From 1.1.0, keys you leave out fall back to the built-in English, so new lines from an update show up even with an older file. Tags you can use. Every line about a relic takes <relic> (its styled name), <symbol>, <key> (its id), <active> and <passive>. Lines also get the values that fit them:

Reloading

/relics admin reload:
  • Reloads config.yml and messages.yml
  • Rebuilds every altar display
  • Restarts the reveal timer and, on PRO, the Relic Rain timer
  • Replies with how many values were invalid
It does not re-check the licence key, and it can’t add or remove custom relics. Restart for those. From 1.1.0, if config.yml has a YAML syntax error, reload changes nothing and shows the error.
plugins/RelicsSMP/config.yml
This is the 1.1.0 file. The 1.0 jars ship the same keys without the custom-* sounds and particles and the custom relics comment. The comment on break-blocks mentions Storm, but Storm’s lightning is visual only and never breaks blocks.