NovaRelics

### 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 ` | `novarelics.use` | Everyone | | `/nr give ` | `novarelics.give` | OP | | `/nr take ` | `novarelics.take` | OP | | `/nr editor [id]` | `novarelics.editor` | OP | | `/nr create ` | `novarelics.create` | OP | | `/nr delete ` | `novarelics.delete` | OP | | `/nr import ` | `novarelics.import` | OP | | `/nr export ` | `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.*