NovaRelics is the most powerful and flexible custom item framework for Paper Minecraft servers.
NovaRelics — Build Your Own Relic System
NovaRelics is the most powerful and flexible custom item framework for Paper Minecraft servers. Create relics, charms, artifacts, consumables, keys, and magical equipment entirely through YAML files. Your players, your rules — no Java required.
Why NovaRelics?
Most custom item plugins give you a static set of abilities. NovaRelics gives you a full framework:
- Any trigger. Any ability. Any combination. Stack multiple abilities on a single trigger. Chain particle effects with sounds, commands, and healing — all from one YAML key.
- Visual identity. Each relic carries a premium particle aura that follows the player. Choose from 21 aura styles, configure colors, radius, speed, and density.
- No client mods required. All visual effects use vanilla particles. Optional texture support via ItemsAdder, Oraxen, Nexo, and HeadDatabase when those plugins are installed.
- Survival-ready performance. Aura rendering uses render-distance-squared checks, chunk-loaded guards, and per-world disabling. The system adds zero overhead for players without relics.
What Can Relics Do?
50 built-in ability types:
| Category | Abilities |
|---|---|
| Repair | Full Repair, Repair by % |
| Survival | Auto-Smelt, Vein Mine, Tree Feller, Double Drops, Auto-Replant |
| Combat | Boost Damage, Reduce Damage, Lightning, Fireball, Gain Health on Kill, Explosion, Set on Fire, Knockback, Steal Health, Shockwave, Phantom Strike |
| Magic | Teleport, Look Teleport, Potion Effect, Spawn Entity, Prevent Death, Keep Item, Flight, Invincibility, Charge, Web Trap, Glow, Cure |
| Economy | Give Money, Take Money, Give XP, Give Item |
| Social | Broadcast, Firework, Nearby Heal |
| Utility | Command, Message, Title, Action Bar, Sound, Particle, Cooldown Reduction, Pull, Launch, Consume Relic |
28 trigger types:
Right-click, left-click, shift+click, anvil, smithing table, grindstone, kill mob, kill player, break block, place block, deal damage, take damage, consume item, fish, shoot projectile, die, respawn, move, jump, sneak, equip/unequip, join, quit, world change, run command, and a custom event hook for developers.
Aura System
Every relic can have its own animated particle aura. Choose from:
- Spiral, Double Spiral, Circle, Ground Ring
- Pulse, Magic, Fire, Ice
- Nature, Shadow, Lightning, Celestial
- Void, Totem, and more
Configure particle type, color (hex or named), radius, density, animation speed, and whether the aura shows only when the relic is held. Performance-safe: particles are never rendered beyond the configured distance and never in unloaded chunks.
Rarity System
Seven fully configurable rarities from Common to Divine. Each rarity defines:
- A MiniMessage display name (gradient text supported)
- A prefix shown in lore
- Glow toggle
- Aura-enabled toggle
- A trigger sound
- Particle burst on ability fire
Storage & Data
Player data, cooldowns, and relic charges are stored in SQLite by default (zero configuration). Switch to MySQL in config.yml for multi-server environments. All database operations are async — the main thread is never blocked.
Plugin Compatibility
| Plugin | Integration |
|---|---|
| Vault | Economy costs for abilities |
| PlaceholderAPI | %novarelics_*% expansion |
| LuckPerms | Group-based relic restrictions |
| ItemsAdder | Custom item textures |
| Oraxen | Custom item textures |
| Nexo | Custom item textures |
| HeadDatabase | Player skull heads |
| ProtocolLib | Extended packet support |
| MythicMobs | Mob-based triggers |
| ModelEngine | 3D model relic displays |
All integrations are optional and detected at startup. NovaRelics works without any of them.
Included Relics
15 production-ready relics included out of the box:
| Relic | Rarity | Effect |
|---|---|---|
| Mending Wool | Uncommon | Place in anvil to fully repair any item |
| Teleport Crystal | Rare | Right-click to teleport randomly up to 50 blocks |
| Vampire Fang | Rare | Heal on every mob kill |
| Ore Charm | Uncommon | Double drops from ore types |
| Harvest Charm | Common | Auto-replant crops after breaking |
| Storm Caller | Legendary | AoE lightning strike + shockwave on right-click |
| Phoenix Feather | Epic | Prevent death, full heal, and launch on death |
| Berserker Blood | Rare | Strength + lifesteal on every mob kill |
| Shadow Shroud | Rare | Invisibility + speed + charge on shift-click |
| Gravity Gem | Epic | Pull all nearby enemies + shockwave |
| Vitality Locket | Uncommon | Passive Regeneration I while held |
| Void Dagger | Mythic | Blink behind a target + void explosion |
| Web Weaver | Uncommon | Ensnare nearby enemies in cobwebs |
| Angler's Charm | Common | Earn money and XP on every fish catch |
| Swift Talisman | Common | Passive Speed I while held |
Commands & Permissions
/novarelics · /nr · /relics
| Command | Permission | Default |
|---|---|---|
/nr help |
novarelics.use |
Everyone |
/nr list |
novarelics.use |
Everyone |
/nr info <id> |
novarelics.use |
Everyone |
/nr give <player> <id> |
novarelics.give |
OP |
/nr take <player> <id> |
novarelics.take |
OP |
/nr editor [id] |
novarelics.editor |
OP |
/nr create <id> |
novarelics.create |
OP |
/nr delete <id> |
novarelics.delete |
OP |
/nr import <file> |
novarelics.import |
OP |
/nr export <id> |
novarelics.export |
OP |
/nr reload |
novarelics.reload |
OP |
Grant novarelics.admin to give a group all OP-level permissions at once. Full tab completion on all subcommands.
Requirements
- Paper 1.18.2, 1.19.4, 1.20.6, 1.21.11, or 26.1.2
- Java 17 or newer
- No other plugins required
Support
Dedicated Discord, full wiki, and GitHub issue tracker. Relics can be shared as single YAML files — no Java, no compilation.
NovaRelics — Your world. Your relics.
Included Relics
15 production-ready relics included out of the box:
| Relic | Rarity | Effect |
|---|---|---|
| Mending Wool | Uncommon | Place in anvil to fully repair any item |
| Teleport Crystal | Rare | Right-click to teleport randomly up to 50 blocks |
| Vampire Fang | Rare | Heal on every mob kill |
| Ore Charm | Uncommon | Double drops from ore types |
| Harvest Charm | Common | Auto-replant crops after breaking |
| Storm Caller | Legendary | AoE lightning strike + shockwave on right-click |
| Phoenix Feather | Epic | Prevent death, full heal, and launch on death |
| Berserker Blood | Rare | Strength + lifesteal on every mob kill |
| Shadow Shroud | Rare | Invisibility + speed + charge on shift-click |
| Gravity Gem | Epic | Pull all nearby enemies + shockwave |
| Vitality Locket | Uncommon | Passive Regeneration I while held |
| Void Dagger | Mythic | Blink behind a target + void explosion |
| Web Weaver | Uncommon | Ensnare nearby enemies in cobwebs |
| Angler's Charm | Common | Earn money and XP on every fish catch |
| Swift Talisman | Common | Passive Speed I while held |
Commands
/novarelics · /nr · /relics
help list info give take editor create delete import export reload
Full tab completion. Granular permissions.
Requirements
- Paper 1.18.2, 1.19.4, 1.20.6, 1.21.11, or 26.1.2
- Java 17 or newer
- No other plugins required
Support
Dedicated Discord, full wiki, and GitHub issue tracker. Relics can be shared as single YAML files — no Java, no compilation.
NovaRelics — Your world. Your relics.
Pages
Members
