Legendaries SMP (v1.2)

A comprehensive legendary core system for Paper/Spigot servers featuring 14 unique cores with passive and active abilities, shapeless crafting, and custom item support.

✨ Features

• 14 Unique Legendary Cores - Each with distinct passive and active abilities
• Shapeless Crafting System - Craft cores using 4 offerings in any pattern
• Vanilla Crafting Integration - All recipes use 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 with configurable death counter
• Death Counter System - Keep cores forever or drop after X deaths (configurable)
• 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 Offerings - Use the vanilla crafting table to craft 4 offerings (recipes in /legendary gui or crafts.yml)
2. Craft Core Crystal - Place 4 offerings in any pattern (shapeless recipe) to create a core crystal
3. Bind Core - Right-click the core crystal to bind it to yourself
4. Use Corrupt Crystal - Right-click to remove your core and receive a Balanced Crystal

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
• Death Counter - Track deaths before core drops (configurable in config.yml)

Core Persistence

Cores persist through death with a configurable death counter:

• Default: Drop core after 3 deaths
• Infinite Mode: Set deaths_before_drop: -1 in config.yml to never drop cores
• Custom: Set any number (e.g., deaths_before_drop: 5 for 5 deaths)
• Death count resets when binding a new core

---

🔮 The 14 Legendary Cores

🌊 Abyssal

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

🔥 Infernal

Passive: Fire resistance + 10% Fire Aspect chance
Active: Molten Cage — Shoots homing fire bolt that explodes for massive damage (90s cooldown)

🌋 Cataclysm

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

🗿 Titan

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

⚡ Tempest

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

• Configurable: Lightning damage and slowness duration can be customized in config.yml

🌿 Verdant

Passive: Regeneration on grass + 2× food value
Active: Overgrowth — Drags enemies underground with grass vines (120s cooldown)

🐺 Feral

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

🩸 Crimson

Passive: Resistance while eating meat + 20% lifesteal
Active: Crimson Pact — Sacrifice 3 hearts temporarily to gain Strength II + Speed II + Resistance (240s cooldown)

💀 Reaper

Passive: Killing mobs gives regen
Active: Death Sentence — Mark next hit enemy, removing 3 hearts from them for 3 minutes (240s cooldown)

✨ Ascendant

Passive: +5 max hearts + 50% faster negative effect expiry
Active: Divine Protection — Complete immunity to death for 2 minutes (420s cooldown)

🔊 Resonance

Passive: Silent movement + 7% chance to disorient enemies on hit
Active: Deafening Silence — Massive knockback pulse + resets enemy cooldowns (90s cooldown)

🌀 Riftstep

Passive: +30% sprint speed + Double jump + No fall damage
Active: Phase Step — Teleport behind nearest enemy and gain Strength II for 8 seconds (configurable cooldown, 0 = no cooldown)

🛡️ Aegis

Passive: 30% damage reduction while sneaking + No knockback while sneaking
Active: Sanctuary — Creates unbreakable barrier dome (20s duration, 8 block radius, 300s cooldown)

☠️ Warden

Passive: Immunity to wardens (damage + targeting) + Immunity to darkness effect
Active: Warden Beam — Sonic boom nearest player (3.5 hearts) + summons weakened warden on them (180s cooldown)

---

🛠️ 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
• /trust <player> - Add a player to your trust list (1-way trust)

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

📝 Core Recipes

Step 1: Craft Offerings

First, craft the 6 different offerings using the vanilla crafting table:

• Earth Offering: Cobblestone, Obsidian, Golden Apple
• Air Offering: Feather, Wind Charge, Golden Apple
• Water Offering: Water Bucket, Kelp, Golden Apple
• Fire Offering: Blaze Rod, Flint & Steel, Golden Apple
• Life Offering: Golden Apple, Golden Carrot, Golden Apple
• Death Offering: Ghast Tear, Crying Obsidian, Golden Apple

Step 2: Craft Core Crystals

All cores use shapeless crafting with 4 offerings in any pattern:

• Abyssal: 3x Water + 1x Death Offering
• Infernal: 2x Fire + 1x Death + 1x Earth Offering
• Cataclysm: 2x Earth + 1x Fire + 1x Water Offering
• Titan: 2x Earth + 1x Life + 1x Water Offering
• Tempest: 2x Air + 2x Life Offering
• Verdant: 1x Life + 1x Fire + 1x Earth + 1x Water Offering
• Feral: 2x Life + 1x Death + 1x Earth Offering
• Crimson: 1x Earth + 1x Fire + 2x Death Offering
• Reaper: 3x Death + 1x Life Offering
• Ascendant: 4x Life Offering
• Resonance: 2x Air + 1x Water + 1x Life Offering
• Riftstep: 2x Air + 1x Life + 1x Death Offering
• Aegis: 2x Earth + 1x Fire + 1x Water Offering
• Warden: 2x Death + 1x Earth + 1x Life Offering

Special Crystals

• Pure Crystal: Diamond, Amethyst Crystal, Enchanted Golden Apple (for crafting offerings)
• Corrupt Crystal: Soul Sand, Obsidian, Wither Star (for removing cores)

⚙️ Configuration

Death Counter System

In config.yml:

cores:
  deaths_before_drop: 3  # Set to -1 for infinite (never drop)

Customizable Settings

• All ability cooldowns, durations, and damage values
• Tempest Lightning: Configurable damage and slowness duration
• Riftstep Cooldown: Configurable cooldown (0 = no cooldown)
• Custom model data for all items
• Death counter (infinite or X deaths)
• Cooldown bar appearance
• All messages and prefixes
• Trust system settings
• New Features: Riftstep passive cooldown, Infernal fire ticks, Crimson restoration duration

Files

• config.yml - Core abilities, cooldowns, death counter, messages, trust settings, new features
• crafts.yml - Offering and crystal recipes (shapeless)
• data.yml - Persistent player data (auto-managed)

📋 Permissions

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

📦 Default Offering Crafts

Pure Crystal (for crafting offerings)

pure_crystal:
  row1: diamond, amethyst_crystal, diamond
  row2: amethyst_crystal, enchanted_golden_apple, amethyst_crystal
  row3: diamond, amethyst_crystal, diamond

Corrupt Crystal (for removing cores)

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

---

🔗 Resource Pack

Resource pack included with custom textures for all 14 cores and 8 crystals (Pure, Corrupt, and 6 offerings) using Custom Model Data.

---

🆕 Recent Updates

Version 1.1.0 - New Features Added

• Riftstep Passive Cooldown: Configurable cooldown for double jump ability
• Trust System: Players can trust others to prevent being targeted by abilities
• Infernal Damage Buff: Fixed - now properly increases player damage for 5 seconds
• Infernal Fire Ticks: Configurable fire duration on targets
• Crimson Health Restoration: Automatic health restoration after ability duration
• Enhanced Targeting: All abilities now respect the trust system

Commands Added

• /legendary trust <player> - Add a player to your trust list
• /legendary untrust <player> - Remove a player from your trust list
• /legendary trustlist - Show your trusted players

---

💙 Credits

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