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

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

🎮 Player Usage

Getting Started

Craft Offerings - Use the vanilla crafting table to craft 4 offerings (recipes in /legendary gui or crafts.yml)
Craft Core Crystal - Place 4 offerings in any pattern (shapeless recipe) to create a core crystal
Bind Core - Right-click the core crystal to bind it to yourself
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!

Legendaries SMP ss4