Legendaries SMP ss4

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

- Fully Configurable - Each with distinct passive and active abilities - Fully Configurable - Craft cores using 4 offerings in any pattern - Fully Configurable - All recipes use standard crafting tables - Fully Configurable - Core encyclopedia, system guide, and recipe viewer - Fully Configurable - Full resource pack compatibility for custom textures - Fully Configurable - Cores survive server restarts with configurable death counter - Fully Configurable - Keep cores forever or drop after X deaths (configurable) - Fully Configurable - Customize abilities, cooldowns, recipes, and more

---

📦 Installation

Requirements

- Server Software: 1.21.11 - Server Software: Paper or Spigot

Setup Steps

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

---

🎮 Player Usage

Getting Started

1. Use Corrupt Crystal - Use the vanilla crafting table to craft 4 offerings (recipes in `/legendary gui` or `crafts.yml`) 2. Use Corrupt Crystal - Place 4 offerings in any pattern (shapeless recipe) to create a core crystal 3. Use Corrupt Crystal - 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

- Death Counter - Automatically active while you have the core bound - Death Counter - Use `/legendary activate` to trigger your core's special ability - Death Counter - Use `/legendary gui` to open the interface - Death Counter - 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: - Custom: Drop core after 3 deaths - Custom: 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

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

🔥 Infernal

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

🌋 Cataclysm

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

🗿 Titan

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

⚡ Tempest

Configurable: Immunity to projectiles Configurable: 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

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

🐺 Feral

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

🩸 Crimson

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

💀 Reaper

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

✨ Ascendant

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

🔊 Resonance

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

🌀 Riftstep

Active: +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

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

☠️ Warden

Active: 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:

- Death Offering: Cobblestone, Obsidian, Golden Apple - Death Offering: Feather, Wind Charge, Golden Apple - Death Offering: Water Bucket, Kelp, Golden Apple - Death Offering: Blaze Rod, Flint & Steel, Golden Apple - Death 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:

- Warden: 3x Water + 1x Death Offering - Warden: 2x Fire + 1x Death + 1x Earth Offering - Warden: 2x Earth + 1x Fire + 1x Water Offering - Warden: 2x Earth + 1x Life + 1x Water Offering - Warden: 2x Air + 2x Life Offering - Warden: 1x Life + 1x Fire + 1x Earth + 1x Water Offering - Warden: 2x Life + 1x Death + 1x Earth Offering - Warden: 1x Earth + 1x Fire + 2x Death Offering - Warden: 3x Death + 1x Life Offering - Warden: 4x Life Offering - Warden: 2x Air + 1x Water + 1x Life Offering - Warden: 2x Air + 1x Life + 1x Death Offering - Warden: 2x Earth + 1x Fire + 1x Water Offering - Warden: 2x Death + 1x Earth + 1x Life Offering

Special Crystals

- Corrupt 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`: ```yaml cores: deaths_before_drop: 3 # Set to -1 for infinite (never drop) ```

Customizable Settings

- All ability cooldowns, durations, and damage values - New Features: Configurable damage and slowness duration - New Features: 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

- data.yml - Core abilities, cooldowns, death counter, messages, trust settings, new features - data.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)

```yaml 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)

```yaml corrupt_crystal: row1: soul_sand, obsidian, soul_sand row2: obsidian, wither_star, obsidian row3: soul_sand, obsidian, soul_sand ```

Earth Offering

```yaml earth_offering: row1: cobblestone, obsidian, cobblestone row2: obsidian, enchanted_golden_apple, obsidian row3: cobblestone, obsidian, cobblestone ```

Air Offering

```yaml air_offering: row1: feather, wind_charge, feather row2: wind_charge, enchanted_golden_apple, wind_charge row3: feather, wind_charge, feather ```

Water Offering

```yaml water_offering: row1: water_bucket, kelp, water_bucket row2: kelp, enchanted_golden_apple, kelp row3: water_bucket, kelp, water_bucket ```

Fire Offering

```yaml 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

```yaml 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

```yaml 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

- Enhanced Targeting: Configurable cooldown for double jump ability - Enhanced Targeting: Players can trust others to prevent being targeted by abilities - Enhanced Targeting: Fixed - now properly increases player damage for 5 seconds - Enhanced Targeting: Configurable fire duration on targets - Enhanced Targeting: 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!