> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Relics SMP

> Six one-of-a-kind power relics for Paper. Hold one and the whole server hunts you.

![Relic powers cast in game while the boss bar names the current holder](https://mintcdn.com/mbcz/QkWCVhRsXYrGqZUc/images/relics-smp/abilities.gif?s=a00366f9e04f964210d7288e5e87c55d)

**Relics SMP** puts legendary relics on your server, and only one copy of each. Claim one from its altar and you get a right-click power and a passive buff. You also get a boss bar with your name on it, on every player's screen.

Every few minutes the holder glows and their coordinates go to chat. Kill them and the relic drops where they fell. Log out to hide and it waits for you, then flies home to its altar. Relics can't be stored, stashed or copied.

Gems plugins give everyone a gem. Relics SMP gives your server one.

## Get Relics SMP

### Relics SMP PRO

> [card] [BuiltByBit](https://builtbybit.com/resources/relics-smp-one-of-a-kind-power-relics.134621/)
>
> All six relics, Relic Rain, the WorldEvents PRO hook, seasons, PlaceholderAPI and admin give/spawn. Custom relics from PRO 1.1.0.

> [!NOTE]
>
> PRO needs a licence key. After you buy, join the [Discord](https://discord.gg/kgHNjJsB2t), run `/verify`, then `/claim RELICS_SMP`. Paste the key into `license_key` in `plugins/RelicsSMP/config.yml` and restart. See [Installation](https://mbcz.mintlify.site/relics-smp/installation.md).

### Relics SMP Lite (free)

> [card] [Modrinth](https://modrinth.com/plugin/relics-smp-lite)
>
> Storm and Inferno relics with the full hunt.

> [card] [SpigotMC](https://www.spigotmc.org/resources/140148/)
>
> Storm and Inferno relics with the full hunt.

## What it does

* **One of each.** Every relic exists once on the whole server
* **Altars.** The relic floats over its altar with a beam until the first player right-clicks it
* **Nowhere to hide.** A boss bar names every holder. Timed reveals make holders glow and post their coordinates
* **Earned, not kept.** Relics drop where you die, even with keepInventory on
* **No logout cheese.** Log out with a relic and it waits 10 minutes, then goes home
* **No stashing.** Chests, ender chests, shulker boxes, hoppers, bundles, item frames and armor stands all refuse it. Copies crumble to dust
* **Fair fights.** Powers switch off where PvP is off: world PvP, WorldGuard regions, listed worlds and the spawn area
* **Relic board.** `/relics` shows every relic's status, holder, last-seen spot and cooldown
* **Yours to tune.** Every number in `config.yml`, every line in `messages.yml` (MiniMessage), plus every sound, particle, title and boss bar colour

## Lite vs PRO

| Feature | Lite (free) | PRO |
| - | - | - |
| Relics | Storm, Inferno | Storm, Inferno, Void, Gravity, Blood, Orbital |
| [Custom relics](https://mbcz.mintlify.site/relics-smp/custom-relics.md) | No | Up to 21 of your own (PRO 1.1.0+) |
| Altars, boss bars, timed reveals | Yes | Yes |
| Drops on death, offline return, no storing, copies crumble | Yes | Yes |
| Relic board (`/relics`) | Yes | Yes |
| [Relic Rain](https://mbcz.mintlify.site/relics-smp/spawning.md#relic-rain) random drops | No | Yes |
| [WorldEvents PRO hook](https://mbcz.mintlify.site/relics-smp/spawning.md#worldevents-pro-drops) | No | Yes |
| [Seasons](https://mbcz.mintlify.site/relics-smp/seasons.md), `/relics top`, rewards | No | Yes |
| [PlaceholderAPI](https://mbcz.mintlify.site/relics-smp/placeholders.md) | No | Yes |
| `/relics admin give` and `/relics admin spawn` | No | Yes |
| Licence key | Not needed | Required |

On Lite, admins see the four PRO relics as locked icons on the relic board. Turn that off with `hints.pro: false`. Players run `/relics pro` to see what PRO adds.

## Compatibility

* **Server software:** Paper. Tested on Paper **1.21.4** and **26.1**
* **Java:** 21 or newer, or whatever your Paper build needs
* **Dependencies:** none required
* **Optional:** WorldGuard (PvP regions), PlaceholderAPI (PRO placeholders), WorldEvents PRO (PRO event drops)
* **Not supported:** Spigot and Folia. The plugin uses Paper APIs and does not declare Folia support

## Quick commands

```text theme={null}
/relics
/relics info storm
/relics admin setaltar storm
/relics admin reload
```

## Documentation sections

> [card] [Installation](https://mbcz.mintlify.site/relics-smp/installation.md)
>
> Jar, licence key, first altars and the files it writes.

> [card] [How the hunt works](https://mbcz.mintlify.site/relics-smp/how-it-works.md)
>
> Claiming, powers, reveals, death drops, escrow and the no-stash rules.

> [card] [The six relics](https://mbcz.mintlify.site/relics-smp/relics.md)
>
> Every active, passive and default number.

> [card] [Custom relics](https://mbcz.mintlify.site/relics-smp/custom-relics.md)
>
> PRO 1.1.0+. Build your own relics from ability steps.

> [card] [Altars and Relic Rain](https://mbcz.mintlify.site/relics-smp/spawning.md)
>
> Altars, random drops, the WorldEvents PRO hook and admin spawn.

> [card] [Seasons](https://mbcz.mintlify.site/relics-smp/seasons.md)
>
> PRO hold-time leaderboard and season rewards.

> [card] [Commands](https://mbcz.mintlify.site/relics-smp/commands.md)
>
> `/relics`, the relic board and admin tools.

> [card] [Permissions](https://mbcz.mintlify.site/relics-smp/permissions.md)
>
> `relics.use` and `relics.admin`.

> [card] [Configuration](https://mbcz.mintlify.site/relics-smp/configuration.md)
>
> Every key in `config.yml`, plus `messages.yml`.

> [card] [Placeholders](https://mbcz.mintlify.site/relics-smp/placeholders.md)
>
> PRO PlaceholderAPI placeholders for holders, states and the leaderboard.

> [card] [FAQ](https://mbcz.mintlify.site/relics-smp/faq.md)
>
> Licence, editions, keepInventory, block damage and more.

## Support

> [card] [Discord](https://discord.gg/kgHNjJsB2t)
>
> Licence claims, questions and support.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.