⚔ UltimateStrengthSMP

A hardcore Strength-stealing SMP plugin where every kill counts.

Kill players to steal their strength, grow more powerful, and survive — or fall below the threshold and face elimination.

---

📖 Overview

UltimateStrengthSMP is a hardcore SMP plugin built around a single brutal concept: kill to grow stronger. Every player carries a Strength value that scales their attack damage directly. Kill a player and steal their strength; die and lose your own. Fall below the elimination threshold and you're out — banned, spectated, or temp-banned depending on your server's configuration.

The plugin layers a full 9-class weapon system on top of the strength economy, giving every player unique passives and ultimates based on what they're holding. Three weapon tiers, four legendary weapons, a revival system, and deep anti-abuse controls make it a complete competitive SMP framework.

Fully compatible with Paper, Purpur, and Folia (1.21–26.x), with optional DiscordSRV, PlaceholderAPI, Vault, and LuckPerms support.

---

✨ Why Choose UltimateStrengthSMP?

⚡ Kill-based Strength Economy – Steal strength on kills; lose it on death. Every fight has real consequences.
🎨 9 Weapon Classes – Each class has a unique passive and ultimate. The class follows the weapon you're holding.
🔧 Four Elimination Modes – BAN, SPECTATOR, GAMEMODE, or TEMP_BAN — configure how eliminated players are handled.
🚀 Folia Compatible – Full Folia support via a custom scheduler abstraction (FoliaScheduler).
🛠️ Deeply Configurable – Every strength value, cooldown, ability threshold, weapon stat, death message, and notification channel is editable without touching any code.

---

✨ Features

🔴 Core Features

⚔️ Strength-stealing kill/death system with configurable per-kill gain and per-death loss
💀 Four elimination modes: permanent ban, spectator, gamemode exclusion, or timed ban
🔄 Revive system with craftable Revive Beacon item and configurable revival strength
📦 /withdraw — convert strength into physical Strength Dust items
🌐 World blacklist and whitelist support

🟡 Advanced Systems

🎯 9 weapon classes each with a passive ability and an ultimate
🗡️ Tiered weapon system: Reinforced Steel → Mithril → Netherite Alpha
🏆 4 legendary weapons with unique active abilities
⚙️ Configurable strength requirements to unlock passives and ultimates per class
📊 Stats tracking: kills, deaths, KDR, killstreaks, leaderboard

🟢 Customization & Integration

🎨 Fully configurable config.yml, messages.yml, recipes.yml
🌐 PlaceholderAPI, Vault, LuckPerms, DiscordSRV soft-dependencies
📺 Action bar, boss bar, and scoreboard HUD displays
🔔 Per-player notification toggle system (/notifications)
🎵 Configurable particle and sound effects for every event

---

📚 Documentation

⚡ Strength System

Every player has a Strength value that directly scales their attack damage. The formula is:

Final Damage = base-damage + (strength × damage-per-strength-point)

By default damage-per-strength-point: 1.0 and base-damage: 1.0, making the damage grow linearly with strength.

🟢 Kill Reward – Gain per-kill-gain strength (default: 1.0) on each player kill.
🔴 Death Penalty – Lose per-death-loss strength (default: 1.0) on death by a player.
🟡 Natural Death – Configurable non-PvP loss (default: 0.5) with optional dust drop.
🔵 Crafting Cap – Strength gained from consuming Strength Dust is capped separately (default: 3.0).

Setting	Default	Description
per-kill-gain	1.0	Strength gained per kill
per-death-loss	1.0	Strength lost per PvP death
max-cap	20.0	Maximum strength cap
starting-strength	1.0	Starting strength for new players
pvp-only	true	Only transfer strength on PvP deaths
steal-at-cap	true	Victim still loses even if killer is at cap
drop-dust-at-max-strength	true	Drop dust when killer is at max cap

💀 Elimination System

When a player's strength drops below elimination.threshold (default: -10.0), they are eliminated according to the configured mode:

Mode	Behavior
BAN	Player is permanently banned. Can only rejoin via /revive with a Revive Beacon.
SPECTATOR	Player is set to spectator mode. Cannot interact until revived.
GAMEMODE	Player stays online but is excluded from the strength system entirely.
TEMP_BAN	Player is banned for temp-ban-duration seconds, then auto-revived.

Eliminations can be broadcast server-wide with custom messages, lightning effects, particles, and sounds.

🗡️ Weapon Classes

Players are assigned a class based on the weapon in their main hand. Classes can be assigned randomly or via a GUI selector. Each class has a passive (activates automatically) and an ultimate (activated by right-click, the F key, or /ultimate depending on config).

---

⚔ Sword Master — Masters of quick, precise strikes with devastating combo potential.

Ability	Type	Description
Combo Master	Passive	After 3 consecutive sprinting hits, all attacks become forced critical hits
Dual Wield	Ultimate	After a 5-hit combo, gain 50% attack speed for 15 seconds (configurable)

Cooldown: 60s. Forced crits apply a ×1.5 multiplier (configurable).

---

🪓 Axe Berserker — Brutal warriors who strike with overwhelming force and stunning power.

Ability	Type	Description
Stunning Crits	Passive	After 5 verified critical hits, stun the target for 3 seconds (configurable)
Charged Strike	Ultimate	Charge up for 3 seconds (configurable) then release a 4× damage hit

Cooldown: 120s. Requires crits to unlock (configurable via axe-ultimate-require-crits).

---

🏹 Bow Sniper — Precise archers who deal increasing damage with successive hits.

Ability	Type	Description
Precision Shots	Passive	Every 3rd arrow hit deals 2× damage
Piercing Arrow	Ultimate	Every 10th arrow hit deals 3× damage

Cooldown: 90s. Minimum strength required to trigger the ultimate (configurable via bow-ultimate-min-strength).

---

🔱 Trident Stormbringer — Wielders of the storm who turn critical hits into lightning.

Ability	Type	Description
Swordform	Passive	Trident attacks at sword speed and disables shields on hit
Storm Crits	Ultimate	After 3 crits, every crit calls lightning and deals +1 heart bonus for 10 seconds

Cooldown: 45s.

---

🎯 Crossbow Executioner — Marksmen whose bolts ignore shields and can ignite targets.

Ability	Type	Description
Shieldpiercer	Passive	Crossbow shots pass through shields; 15% chance to ignite the target
Overcharged Crossbow	Ultimate	After 5 hits, gain Power V + Quick Charge V for the configured duration

Cooldown: 90s.

---

🛡 Shield Guardian — Defensive warriors who turn enemy attacks into their advantage.

Ability	Type	Description
Defensive Stance	Passive	If your shield is disabled by an axe hit, gain Resistance I for 5 seconds
Invincibility	Ultimate	Become completely invulnerable for 15 seconds (configurable)

Cooldown: 180s.

---

⚒ Mace Berserker — Smash-focused fighters with a reduced ultimate cooldown.

Ability	Type	Description
Heavy Swing	Passive	Mace ultimate cooldown is reduced by the configured multiplier (default: ×0.5)
Windburst Frenzy	Ultimate	After 3 Mace smash hits, gain Wind Burst II for the configured duration

Base cooldown: 180s (reduced to 90s by default via passive multiplier).

---

⚔ Spear Lancer — Fast jabs and explosive forward lunges. (Custom item class)

Ability	Type	Description
Quick Poke	Passive	Attack at sword speed; each poke deals +0.5 bonus damage
Lunge III	Ultimate	After 10 pokes, launch yourself forward at high speed

Cooldown: 30s.

---

🛡 Armor Guardian — Defensive class that converts diamond armor to netherite.

Ability	Type	Description
Iron Form	Passive	Diamond armor pieces in your inventory are silently upgraded to netherite
Last Stand	Ultimate	Auto-activates below a configurable health threshold: gain Absorption IV for 20 seconds

Cooldown: 120s. This class is excluded from the vanilla netherite armor block.

---

🏷️ Weapon Tiers

Three craftable weapon tiers provide stronger base attack damage:

Tier	Name	Damage	Glow	Recipe Base Materials
1	Reinforced Steel	7.0	No	Coal Block + Iron Block + Stick
2	Mithril	10.0	Yes	Prismarine Crystals + Diamond Block + Blaze Rod
3	Netherite Alpha	14.0	Yes	Netherite Block + Nether Star + Blaze Rod

Both Sword and Axe variants exist for each tier.

🔮 Legendary Weapons

Four unique legendary weapons with craftable recipes and active abilities:

Weapon	Material	Ability	Cooldown	Description
Strength Siphon	Netherite Hoe	Essence Drain	30s	Right-click to activate; next hit steals 0.1 strength from the target without killing them
Titan Claymore	Netherite Sword	Earthquake	45s	Right-click to slam the ground, launching all nearby enemies into the air (5-block radius, 6 damage)
Assassin Dagger	Iron Sword	Shadow Step	20s	Right-click while looking at a player to teleport behind them (10-block range, 2× backstab multiplier)
The Strength Sword	Netherite Sword	Multiple	—	Legendary sword with 15 base damage, Soul Crusher passive (debuffs on 26 hits), Max Strength ability (right-click), Warden's Wrath (Shift+right-click), and Double Strength ultimate

The Strength Sword detailed abilities:

Ability	Trigger	Description	Cooldown
Soul Crusher	Passive	After 26 hits, inflict Weakness II + Slowness II + freeze on target	—
Max Strength	Right-click	Deal bonus damage and amplify your strength for 10 seconds	60s
Warden's Wrath	Shift+Right-click	Fire a 15-block warden-style beam dealing 4 damage every 5 ticks for 3 seconds	120s
Double Strength	Auto (5-hit combo)	Double your attack damage for 10 seconds	90s

🛸 Custom Items

Item	Material	Description	Recipe
Strength Dust	Blaze Powder	Absorb 1 strength on right-click (subject to crafting cap)	4× Gold Block + 4× Diamond Block + 1× Netherite Ingot
Revive Beacon	Nether Star	Required for /revive (consumed on use)	4× Diamond Block + 4× Nether Star + 1× Beacon
Class Catalyst	Echo Shard	Opens class selector GUI or assigns random class	4× Amethyst Shard + 4× Echo Shard + 1× Nether Star

---

⚙️ Configuration

Configuration files: config.yml · messages.yml · recipes.yml

# Key settings

strength:
  damage-per-strength-point: 1.0   # Damage scaling per strength point
  per-kill-gain: 1.0                # Strength gained on kill
  per-death-loss: 1.0               # Strength lost on PvP death
  max-cap: 20.0
  starting-strength: 1.0

elimination:
  enabled: true
  threshold: -10.0
  mode: "BAN"           # BAN | SPECTATOR | GAMEMODE | TEMP_BAN
  temp-ban-duration: 3600

weapon-class:
  mode: "SELECTOR"      # RANDOM or SELECTOR
  allow-change: false
  change-cost: 5.0

ultimate-activation:
  mode: "CLICK"         # CLICK | KEYBIND | COMMAND

database:
  type: "PDC"           # PDC or MYSQL

revive:
  require-item: true
  consume-item: true
  revive-strength: 0.0
  immunity-duration: 30

vanilla:
  netherite-armor-enabled: false    # Block regular netherite armor on non-Armor class

📋 Notable Configuration Options

Option	Description	Default
strength.pvp-only	Only transfer strength on PvP deaths	true
strength.indirect-kills	Credit kills from fall/lava/etc. after a hit	true
strength.drop-dust-at-max-strength	Drop dust when killer is capped	true
strength.crafting-cap	Max strength gainable from Strength Dust	3.0
combat.attack-cooldown-threshold	Minimum charge % for a hit to count toward combo	0.9
combat.combos.require-sprinting	Require sprinting for combo hits	true
abilities.sword-combo-count	Hits needed to start a combo	3
abilities.axe-crit-count	Crits needed to stun	5
abilities.bow-passive-count	Arrow hits before bonus damage	3
abilities.shield-invincibility-duration	Shield ultimate duration (ticks)	300
anti-abuse.same-killer-cooldown	Cooldown between gains from same killer (s)	60
cooldowns.sword-ultimate	Dual Wield cooldown (s)	60
cooldowns.shield-ultimate	Invincibility cooldown (s)	180

💡 Note: Reload all config files with /ussmp reload without restarting. MySQL storage is available as an alternative to PDC.

---

💻 Commands

👤 Player Commands

Command	Description	Permission
/ussmp	Show help menu and plugin info	ussmp.use
/strength [player]	View your strength or another player's	ussmp.strength
/class [info|abilities|change|list]	View or manage your weapon class	ussmp.class
/ultimate	Activate your class ultimate ability	ussmp.ultimate
/withdraw <amount>	Convert strength into Strength Dust	ussmp.withdraw
/revive <player>	Revive an eliminated player (requires Revive Beacon)	ussmp.revive
/recipes	Open custom recipe viewer GUI	ussmp.recipes
/stats [player]	View player kill/death/KDR statistics	ussmp.stats
/notifications [chat|actionbar|bossbar|all|status]	Toggle personal notification channels	ussmp.notifications

Aliases: /str, /dmg, /power → /strength · /wc, /classinfo → /class · /ult, /ability → /ultimate · /wd, /takeout → /withdraw · /res, /resurrect → /revive · /cr, /crafting → /recipes · /kdr, /profile → /stats

🔧 Admin Commands

Command	Description	Permission
/ussmp reload	Reload all configuration files	ussmp.admin.reload
/ussmp debug	Toggle debug mode	ussmp.admin.debug
/strength set <player> <value>	Set a player's strength	ussmp.admin.strength.set
/strength add <player> <value>	Add strength to a player	ussmp.admin.strength.add
/strength remove <player> <value>	Remove strength from a player	ussmp.admin.strength.remove
/strength reset <player>	Reset a player's strength	ussmp.admin.strength.reset
/strength top	View strength leaderboard	ussmp.admin.strength
/class set <player> <class>	Set a player's weapon class	ussmp.admin.class.set
/eliminate <player>	Manually eliminate a player	ussmp.admin.eliminate
/revive <player>	Revive without requiring a Beacon	ussmp.revive.noitem
/admin netharmor <grant|revoke|list> [player]	Manage netherite armor exceptions	ussmp.admin

---

🔐 Permissions

ussmp.*
├── ussmp.use
├── ussmp.withdraw
├── ussmp.withdraw.unlimited       (bypass cooldown & limits)
├── ussmp.revive
├── ussmp.revive.noitem            (revive without Beacon)
├── ussmp.class
├── ussmp.class.change
├── ussmp.class.bypass-cost
├── ussmp.recipes
├── ussmp.stats
├── ussmp.strength
├── ussmp.ultimate
├── ussmp.notifications
├── ussmp.admin.*
│   ├── ussmp.admin.eliminate
│   ├── ussmp.admin.strength.*
│   ├── ussmp.admin.class.set / .remove
│   ├── ussmp.admin.reload
│   ├── ussmp.admin.debug
│   ├── ussmp.admin.bypass.*
│   └── ussmp.admin.give
├── ussmp.ability.*
│   ├── ussmp.ability.passive
│   ├── ussmp.ability.ultimate
│   └── ussmp.ability.legendary
├── ussmp.immune.*
│   ├── ussmp.immune.strengthloss
│   ├── ussmp.immune.elimination
│   ├── ussmp.immune.strengthsteal
│   └── ussmp.immune.damage
└── ussmp.notify.*
    ├── ussmp.notify.elimination
    ├── ussmp.notify.revive
    └── ussmp.notify.killstreak

Permission	Description	Default
ussmp.use	Access basic plugin commands	true
ussmp.admin.*	All admin permissions	op
ussmp.immune.elimination	Cannot be eliminated	op
ussmp.immune.strengthloss	Immune to losing strength	op
ussmp.admin.bypass.cooldown	Bypass all cooldowns	op
ussmp.leaderboard.hidden	Hidden from leaderboard	op

---

🔤 PlaceholderAPI

UltimateStrengthSMP supports PlaceholderAPI!

Placeholder	Description
%ultimatestrength_strength%	Player's current strength value
%ultimatestrength_class%	Player's weapon class name
%ultimatestrength_kills%	Total player kills
%ultimatestrength_deaths%	Total deaths
%ultimatestrength_kdr%	Kill/death ratio
%ultimatestrength_killstreak%	Current killstreak
%ultimatestrength_rank%	Strength leaderboard rank

Requirements: PlaceholderAPI must be installed and placeholders.enabled: true in config.yml.

---

📥 Installation

Getting started is easy!

📋 Requirements

Requirement	Version
Minecraft	1.21.x – 26.x
Server Software	Paper, Purpur, Folia
Java	21+
Dependencies	None (all optional)

Optional integrations:

• PlaceholderAPI
• Vault
• LuckPerms
• DiscordSRV (kill/elimination/revive channel broadcasting)

🚀 Installation Steps

1. 📦 Download the latest version of UltimateStrengthSMP.
2. 📂 Place the .jar file inside your server's plugins/ folder.
3. 🔄 Restart your server.
4. ⚙️ Configure the plugin in plugins/UltimateStrengthSMP/config.yml.
5. 🎉 Use /ussmp reload to apply changes without restarting.

---

🎨 Resource Pack

Download Here

---

🆘 Support & Bug Reports

Need help, found a bug, or have a suggestion?

Join the GetUrPlugins Discord community!

🐛 Bug Reports – Report bugs and unexpected behavior.
💬 Support – Get help with installation and configuration.
💡 Suggestions – Share ideas for future improvements.
📢 Announcements – Stay informed about updates and releases.

⚠️ Please include your Minecraft version, server software, and relevant error logs when reporting an issue.

---

📜 Credits & License

Developed by: GetUrPlugins

License: All Rights Reserved (ARR).

© GetUrPlugins. All rights reserved.

❌ Unauthorized redistribution or resale is prohibited.
❌ Modification, decompilation, or republishing is prohibited without explicit permission.
✅ Usage is permitted under the conditions set by the author.

See https://gcl.onl/licenses/arr for the full license terms.

---