Legendaries SMP

A comprehensive legendary core system for Paper/Spigot servers featuring 13 unique cores with passive and active abilities, ritual-based infusion, and custom item support.

✨ Features

• 13 Unique Legendary Cores - Each with distinct passive and active abilities
• Ritual Infusion System - Ground-based rituals with public broadcasts and particle effects
• Vanilla Crafting Integration - Craft crystals and offerings using standard crafting tables
• Interactive Book GUI - Core encyclopedia, system guide, and recipe viewer
• Custom Model Data Support - Full resource pack compatibility for custom textures
• Persistent Data - Cores survive server restarts and player deaths
• Fully Configurable - Customize abilities, cooldowns, recipes, and more

---

📦 Installation

Requirements

• Minecraft Version: 1.21.11
• Server Software: Paper or Spigot

Setup Steps

1. Download the plugin JAR from Modrinth
2. Place the JAR in your server's plugins/ folder
3. Restart your server
4. Configure the plugin in plugins/LegendariesSMP/config.yml
5. (Optional) Install the resource pack that comes along with the plugin.

---

🎮 Player Usage

Getting Started

1. Craft a Pure Crystal using the vanilla crafting table (see recipes in-game with /legendary gui)
2. Craft 4 Offerings corresponding to the core you want (found in plugins/LegendariesSMP/crafts.yml)
3. Perform a Ritual by throwing 1 Pure Crystal (or balanced) + 4 Offerings on the same block (if it doesnt work, try throwing faster, and check that its a valid ritual recipe.)
4. Wait 5 Minutes for the ritual to complete
5. Collect the Core Crystal that spawns after the ritual
6. Right-Click the Core Crystal to bind it to yourself

Using Your Core

• Passive Abilities - Automatically active while you have the core bound
• Active Abilities - Use /legendary activate to trigger your core's special ability
• View Information - use /legendary gui to open the interface
• Check Status - Use /legendary info to see your current core and cooldowns

Ritual System

When you start a ritual:

• The coordinates are broadcast to all players on the server
• Particle effects spawn at the ritual location for 5 minutes
• After completion, a Core Crystal spawns at the ritual site
• Anyone can collect the crystal, so protect your ritual!

---

🔮 The 13 Legendary Cores

Abyssal

Passive: Water breathing + 15% melee damage in water
Active: Sea's Burden — Drowns nearby enemies, dealing damage over time

Infernal

Passive: Fire resistance + 25% Fire Aspect chance
Active: Molten Cage — Shoots homing fire bolt that explodes for massive damage

Cataclysm

Passive: Fire resistance + Strength while in lava
Active: Volcanic Rupture — Lifts enemies into air then explodes in fire

Titan

Passive: No fall damage + Knockback resistance
Active: Earthen Bastion — Creates a particle shield that repels nearby enemies

Tempest

Passive: Immunity to projectiles
Active: Eye of the Storm — Summons storm cloud that randomly strikes enemies with lightning

Verdant

Passive: Regeneration on grass + 2× food value
Active: Overgrowth — Drags enemies underground with grass vines

Feral

Passive: Passive mobs defend you (10 block range)
Active: Call of the Wild — Summons 3 legendary wolves for 60 seconds

Crimson

Passive: Resistance while eating meat + 20% lifesteal
Active: Crimson Pact — Sacrifice permanent hearts temporarily to gain buffs

Reaper

Passive: Killing mobs gives regen. Marked players glow
Active: Death Sentence — Mark next hit enemy, removing 3 permanent hearts from them for 3 minutes (changed in config)

Ascendant

Passive: +3 max hearts + 50% faster negative effect expiry
Active: Divine Protection — Complete immunity to death temporarily

Resonance

Passive: 10% chance to disorient enemies with sounds and random rotation on hit
Active: Deafening Silence — Launches nearby enemies / players away

Riftstep

Passive: +30% sprint speed + Double jump
Active: Phase Step — Teleport behind nearest enemy, stun them, and gain Strength II for 8 seconds

Aegis

Passive: -30% damage and no knockback while sneaking
Active: Sanctuary — Creates unbreakable protective dome for 20 seconds

---

🛠️ Commands

Player Commands

• /legendary gui - Open the legendary interface
• /legendary info [player] - View core information (defaults to yourself)
• /legendary activate - Activate your core's ability

Admin Commands

• /legendary give <crystal|offering> <type> [player] [amount] - Give legendary items
• /legendary bind <player> <core> - Bind a core to a player
• /legendary unbind <player> - Remove a player's core
• /legendary reload - Reload configuration files
• /legendary ritual start <ritual> <x> <y> <z> - Manually start a ritual
• /legendary ritual cancel <x> <y> <z> - Cancel an active ritual

📋 Permissions

• legendaries.admin - Access to all admin commands
• legendaries.use - Use legendary items and abilities (default: true)

Default Crafts

### Pure Crystal
pure_crystal:
  row1: diamond, amethyst_crystal, diamond
  row2: amethyst_crystal, enchanted_golden_apple, amethyst_crystal
  row3: diamond, amethyst_crystal, diamond

### Corrupt Crystal
corrupt_crystal:
  row1: soul_sand, obsidian, soul_sand
  row2: obsidian, wither_star, obsidian
  row3: soul_sand, obsidian, soul_sand

### Earth Offering
earth_offering:
  row1: cobblestone, obsidian, cobblestone
  row2: obsidian, enchanted_golden_apple, obsidian
  row3: cobblestone, obsidian, cobblestone

### Air Offering
air_offering:
  row1: feather, wind_charge, feather
  row2: wind_charge, enchanted_golden_apple, wind_charge
  row3: feather, wind_charge, feather

### Water Offering
water_offering:
  row1: water_bucket, kelp, water_bucket
  row2: kelp, enchanted_golden_apple, kelp
  row3: water_bucket, kelp, water_bucket

### Fire Offering
fire_offering:
  row1: blaze_rod, flint_and_steel, blaze_rod
  row2: flint_and_steel, enchanted_golden_apple, flint_and_steel
  row3: blaze_rod, flint_and_steel, blaze_rod

### Life Offering
life_offering:
  row1: golden_apple, golden_carrot, golden_apple
  row2: golden_carrot, enchanted_golden_apple, golden_carrot
  row3: golden_apple, golden_carrot, golden_apple

### Death Offering
death_offering:
  row1: ghast_tear, crying_obsidian, ghast_tear
  row2: crying_obsidian, enchanted_golden_apple, crying_obsidian
  row3: ghast_tear, crying_obsidian, ghast_tear

---

Default Rituals

water,water,water,water: abyssal
water,water,water,earth: abyssal
water,water,water,fire: abyssal
water,water,water,air: abyssal
water,water,water,life: abyssal
water,water,water,death: abyssal
water,water,earth,fire: abyssal
water,water,air,fire: abyssal
water,water,life,fire: abyssal
water,water,earth,air: abyssal
water,fire,air,life: abyssal

fire,fire,fire,fire: infernal
fire,fire,fire,earth: infernal
fire,fire,fire,water: infernal
fire,fire,fire,air: infernal
fire,fire,fire,life: infernal
fire,fire,fire,death: infernal
fire,fire,earth,air: infernal
fire,fire,earth,life: infernal
fire,fire,water,life: infernal
fire,earth,air,life: infernal
fire,earth,water,death: infernal

earth,fire,fire,fire: cataclysm
earth,earth,fire,fire: cataclysm
earth,fire,fire,water: cataclysm
earth,fire,fire,air: cataclysm
earth,fire,fire,life: cataclysm
earth,fire,fire,death: cataclysm
earth,earth,fire,air: cataclysm
earth,earth,fire,life: cataclysm
earth,fire,water,air: cataclysm
earth,earth,water,fire: cataclysm
earth,fire,air,death: cataclysm

earth,earth,earth,earth: titan
earth,earth,earth,fire: titan
earth,earth,earth,water: titan
earth,earth,earth,air: titan
earth,earth,earth,life: titan
earth,earth,earth,death: titan
earth,earth,fire,water: titan
earth,earth,fire,air: titan
earth,earth,water,air: titan
earth,fire,water,life: titan
earth,fire,air,death: titan

air,air,fire,water: tempest
air,air,fire,earth: tempest
air,air,fire,life: tempest
air,air,fire,death: tempest
air,air,water,earth: tempest
air,air,water,life: tempest
air,air,water,death: tempest
air,fire,water,life: tempest
air,fire,earth,life: tempest
air,earth,water,life: tempest

earth,earth,earth,water: verdant
earth,earth,earth,fire: verdant
earth,earth,earth,air: verdant
earth,earth,earth,life: verdant
earth,earth,earth,death: verdant
earth,earth,water,fire: verdant
earth,earth,water,air: verdant
earth,earth,water,life: verdant
earth,fire,water,life: verdant
earth,air,water,life: verdant
earth,fire,air,death: verdant

air,earth,earth,water: feral
air,earth,earth,fire: feral
air,earth,earth,life: feral
air,earth,earth,death: feral
air,earth,water,fire: feral
air,earth,water,life: feral
air,earth,water,death: feral
air,earth,fire,life: feral
air,earth,fire,death: feral
air,fire,water,life: feral
air,fire,earth,death: feral

earth,earth,fire,fire: crimson
earth,earth,fire,water: crimson
earth,earth,fire,air: crimson
earth,earth,fire,life: crimson
earth,earth,fire,death: crimson
earth,fire,fire,water: crimson
earth,fire,fire,air: crimson
earth,fire,fire,life: crimson
earth,fire,fire,death: crimson
earth,fire,water,life: crimson
earth,fire,air,death: crimson

death,death,death,fire: reaper
death,death,death,earth: reaper
death,death,death,water: reaper
death,death,death,air: reaper
death,death,death,life: reaper
death,death,fire,earth: reaper
death,death,fire,water: reaper
death,death,fire,air: reaper
death,fire,earth,life: reaper
death,fire,water,life: reaper
death,fire,air,life: reaper

air,air,air,air: ascendant
air,air,air,fire: ascendant
air,air,air,water: ascendant
air,air,air,earth: ascendant
air,air,air,life: ascendant
air,air,air,death: ascendant
air,air,fire,water: ascendant
air,air,fire,earth: ascendant
air,air,water,life: ascendant
air,air,earth,life: ascendant
air,fire,water,life: ascendant

air,air,fire,fire: resonance
air,air,fire,earth: resonance
air,air,fire,water: resonance
air,air,fire,life: resonance
air,air,fire,death: resonance
air,fire,fire,earth: resonance
air,fire,fire,water: resonance
air,fire,fire,life: resonance
air,fire,fire,death: resonance
air,fire,earth,life: resonance
air,fire,water,death: resonance

air,air,water,water: riftstep
air,air,water,fire: riftstep
air,air,water,earth: riftstep
air,air,water,life: riftstep
air,air,water,death: riftstep
air,water,water,fire: riftstep
air,water,water,earth: riftstep
air,water,water,life: riftstep
air,water,water,death: riftstep
air,water,fire,life: riftstep
air,water,earth,death: riftstep

air,air,earth,life: aegis
air,air,earth,fire: aegis
air,air,earth,water: aegis
air,air,earth,death: aegis
air,air,life,fire: aegis
air,air,life,water: aegis
air,air,life,death: aegis
air,earth,life,fire: aegis
air,earth,life,water: aegis
air,earth,life,death: aegis
air,fire,earth,life: aegis

---

🙏 Credits

Developed for the Legendaries SMP community. Special thanks to gorpted for the resource pack!