UltimateStrengthSMP

 UltimateStrengthSMP - Complete Plugin Overview

---

 📋 Quick Summary

| Property | Details |
|----------|---------|
| **Plugin Name** | UltimateStrengthSMP |
| **Version** | 1.0.0 |
| **Platform** | PaperMC 1.21.1 - 1.21.11 |
| **Java Version** | Java 21+ |
| **Plugin Type**  | PvP / Competitive |
| **Dependencies** | None (Optional: PlaceholderAPI, Vault) |

---

 🎮 What Is UltimateStrengthSMP?

**UltimateStrengthSMP** is a **Hardcore Competitive SMP plugin** that revolutionizes PvP gameplay. Unlike traditional Lifesteal servers where players steal hearts, this plugin makes players steal **Attack Damage Attributes**.

 The Core Concept

```
┌─────────────────────────────────────────────────────────────┐
│                    THE STRENGTH CYCLE                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   🗡️ KILL A PLAYER                                          │
│      └── You gain +1 Attack Damage                          │
│      └── They lose -1 Attack Damage                         │
│                                                              │
│   💀 DIE TO A PLAYER                                         │
│      └── You lose -1 Attack Damage                          │
│      └── Killer gains +1 Attack Damage                      │
│                                                              │
│   📉 DROP BELOW THRESHOLD (-10 default)                      │
│      └── You are ELIMINATED                                 │
│      └── Banned or put in Spectator Mode                    │
│                                                              │
│   ✨ GET REVIVED                                             │
│      └── Another player uses Revive Beacon                  │
│      └── You return with starting strength                  │
│                                                              │
└─────────────────────────────────────────────────────────────┘
```

---

 ✨ Complete Feature List

 🔴 Core Systems

| Feature | Description | Configurable |
|---------|-------------|--------------|
| **Strength Stealing** | Gain/lose attack damage on kills/deaths | ✅ Amount, cap, threshold |
| **Elimination System** | Remove players who drop too low | ✅ BAN or SPECTATOR mode |
| **Withdraw System** | Convert strength to tradeable items | ✅ Cooldown, limits |
| **Revive System** | Bring back eliminated players | ✅ Item requirement, immunity |
| **Attribute Modifiers** | Real Minecraft damage attributes | ✅ Base damage values |
| **PDC Storage** | Data persists across restarts | ✅ Auto-save |

 🟡 Weapon Class System

| Feature | Description | Configurable |
|---------|-------------|--------------|
| **6 Unique Classes** | Sword, Axe, Bow, Trident, Crossbow, Shield | ✅ Enable/disable each |
| **Passive Abilities** | Automatic bonuses based on playstyle | ✅ Requirements, effects |
| **Ultimate Abilities** | Powerful activated skills | ✅ Cooldowns, damage |
| **Class Assignment** | Random or player-choice on first join | ✅ Mode selection |
| **Class Selector GUI** | Visual interface to pick class | ✅ Icons, descriptions |
| **Class Change** | Set class for a player (ADMIN COMMAND ONLY) | ✅ Toggle enable or disable  |

 🟢 Combat System

| Feature | Description | Configurable |
|---------|-------------|--------------|
| **Combo Detection** | Track consecutive valid hits | ✅ Timeout, requirements |
| **Critical Hit Validation** | Verify true critical hits | ✅ All conditions |
| **Damage Multipliers** | Bonus damage for abilities | ✅ Multiplier values |
| **Stun Effects** | Freeze or slow enemies | ✅ Duration, type |
| **Combat Logging Prevention** | Track PvP engagement | ✅ Tag duration |

 🔵 Item System

| Feature | Description | Configurable |
|---------|-------------|--------------|
| **Strength Dust** | Physical strength item for trading | ✅ Appearance, lore |
| **Revive Beacon** | Required item to revive players | ✅ Recipe, consumption |
| **Tiered Weapons** | 3 tiers with increasing power | ✅ Damage, recipes |
| **Legendary Weapons** | Unique items with active abilities | ✅ Cooldowns, effects |
| **Custom Recipes** | Craftable special items | ✅ Shapes, ingredients |

 🟣 Visual & Audio

| Feature | Description | Configurable |
|---------|-------------|--------------|
| **Particle Effects** | Visual feedback for all actions | ✅ Types, enable/disable |
| **Sound Effects** | Audio cues for events | ✅ Sounds, volume |
| **Action Bar Display** | Live strength/class info | ✅ Format, interval |
| **Scoreboard** | Persistent stats display | ✅ All lines, title |
| **Broadcasts** | Server-wide announcements | ✅ Messages, toggle |

---

 ⚔️ Weapon Classes Detailed

 Class Comparison Table

| Class | Playstyle | Passive | Ultimate | Difficulty |
|-------|-----------|---------|----------|------------|
| ⚔️ **Sword** | Aggressive Melee | Forced Crits | Attack Speed Boost | ⭐⭐ Medium |
| 🪓 **Axe** | Burst Damage | Stun on Crits | 300% Damage Strike | ⭐⭐⭐ Hard |
| 🏹 **Bow** | Ranged DPS | 2x Every 3rd | 3x Every 10th | ⭐ Easy |
| 🔱 **Trident** | Elemental | Lightning Strikes | Wave Push | ⭐⭐ Medium |
| 🎯 **Crossbow** | Control | Pull Enemies | 4x Every 10th | ⭐⭐ Medium |
| 🛡️ **Shield** | Tank/Defense | Damage Resist | Invincibility | ⭐ Easy |

 Detailed Class Breakdowns

 ⚔️ Sword Master

```
THEME: Rapid combo attacks and sustained damage

PASSIVE - Combo Crits
├── Requirement: Land 3 valid combo hits
├── Effect: All attacks become critical hits
├── Duration: Until miss or take damage
└── Combo Rules:
    ├── Must be sprinting
    ├── Attack cooldown > 90%
    └── Target is living entity

ULTIMATE - Dual Wield
├── Activation: 5-hit combo + Right-click
├── Effect: 50% reduced attack cooldown
├── Duration: 15 seconds
└── Cooldown: 2 minutes
```

 🪓 Axe Berserker

```
THEME: Devastating critical strikes

PASSIVE - Crushing Blows
├── Requirement: Land 5 verified critical hits
├── Effect: Stun target for 1 second
├── Stun Type: Freeze ticks or Slowness 255
└── Critical Rules:
    ├── Must be falling (fallDistance > 0)
    ├── Not on ground/climbing/swimming
    ├── No water/lava/elytra
    ├── No Blindness or Slow Falling
    └── Attack cooldown > 90%

ULTIMATE - Charged Strike
├── Activation: Right-click with axe
├── Phase 1: Deal 0 damage for 5 seconds
├── Phase 2: Next hit deals 400% damage
└── Cooldown: 2 minutes
```

 🏹 Bow Ranger

```
THEME: Ranged precision with scaling damage

PASSIVE - Focused Shot
├── Trigger: Every 3rd arrow hit
├── Effect: 2x damage multiplier
└── Notes: Counter persists, resets on death

ULTIMATE - Power Shot
├── Trigger: Every 10th arrow hit
├── Effect: 3x damage multiplier
└── Notes: Replaces passive on 10th (not additive)
```

 🔱 Trident Stormbringer

```
THEME: Lightning and wave control

PASSIVE - Storm Strike
├── Trigger: Each melee hit with trident
├── Effect: Lightning strike on target
├── Bonus Damage: 4.0
├── Can set fire: Yes
└── Cooldown: 2 seconds between strikes

ULTIMATE - Riding the Wave
├── Activation: Right-click with trident
├── Effect 1: Push enemies away (8 block radius)
├── Effect 2: Launch player forward
└── Cooldown: 90 seconds
```

 🎯 Crossbow Specialist

```
THEME: Precise shots with crowd control

PASSIVE - Grappling Shot
├── Trigger: On arrow hit
├── Chance: 33%
├── Effect: Pull target towards shooter
└── Pull Strength: 1.5 blocks

ULTIMATE - Piercing Shot
├── Trigger: Every 10th successful hit
├── Effect: 4x damage multiplier
└── Notes: Counter tracks hits only
```

 🛡️ Shield Guardian

```
THEME: Defense and invulnerability

PASSIVE - Fortified
├── Trigger: Shield disabled by axe
├── Effect: 25% damage resistance
└── Duration: 5 seconds

ULTIMATE - Invincibility
├── Activation: Right-click with shield
├── Effect: Complete damage immunity
├── Duration: 15 seconds
└── Cooldown: 5 minutes
```

---

 🗡️ Weapon Tier System

 Tier Comparison

| Tier | Name | Base Damage | Total Damage Formula | Obtainment |
|------|------|-------------|---------------------|------------|
| T1 | Reinforced Steel | 7 | 7 + Player Strength | Craftable |
| T2 | Mithril | 10 | 10 + Player Strength | Craftable |
| T3 | Netherite Alpha | 14 | 14 + Player Strength | Boss/Admin |
| ⭐ | Legendary | Special | Varies + Abilities | Admin Only |

 Damage Examples

```
Player with 5 Strength using:
├── Vanilla Sword:    ~7 damage
├── T1 Steel Sword:   7 + 5 = 12 damage
├── T2 Mithril Sword: 10 + 5 = 15 damage
└── T3 Alpha Sword:   14 + 5 = 19 damage

Player with 15 Strength using:
├── T1 Steel Sword:   7 + 15 = 22 damage
├── T2 Mithril Sword: 10 + 15 = 25 damage
└── T3 Alpha Sword:   14 + 15 = 29 damage
```

 Legendary Weapons

| Weapon | Type | Ability | Cooldown |
|--------|------|---------|----------|
| ✦ **Strength Siphon** | Hoe | Steal 0.1 strength without killing | 30s |
| ⚔️ **Titan Claymore** | Heavy Sword | Launch nearby enemies upward | 45s |
| ☠️ **Assassin Dagger** | Dagger | Teleport behind target | 20s |

---

 💻 Command Reference

 Player Commands

```
/withdraw <amount>
├── Permission: ussmp.withdraw
├── Description: Convert strength into Strength Dust item
├── Example: /withdraw 2
└── Notes: Has cooldown, minimum remaining check

/revive <player>
├── Permission: ussmp.revive
├── Description: Revive an eliminated player
├── Requirement: Holding Revive Beacon (configurable)
└── Example: /revive Steve

/class [info|change|abilities]
├── Permission: ussmp.class
├── Subcommands:
│   ├── info - View your current class details
│   └── abilities - List your passive and ultimate
└── Example: /class info

/recipes [category]
├── Permission: ussmp.recipes
├── Description: Open custom recipe viewer GUI
├── Categories: tier1, tier2, tier3, legendary, special
└── Example: /recipes tier2

/ussmp [help|info]
├── Permission: ussmp.use
├── Description: Main plugin help command
└── Example: /ussmp help
```

 Admin Commands

```
/eliminate <player>
├── Permission: ussmp.admin.eliminate
├── Description: Manually eliminate a player
└── Example: /eliminate Steve

/strength <subcommand> [player] [amount]
├── Permission: ussmp.admin.strength
├── Subcommands:
│   ├── set <player> <amount> - Set exact strength
│   ├── add <player> <amount> - Add strength
│   ├── remove <player> <amount> - Remove strength
│   ├── check [player] - View strength
│   ├── reset <player> - Reset to default
│   └── top [page] - View leaderboard
└── Examples:
    ├── /strength set Steve 10
    ├── /strength add Steve 5
    └── /strength check Steve

/ussmp reload
├── Permission: ussmp.admin.reload
├── Description: Reload all configuration files
└── Example: /ussmp reload

/ussmp debug
├── Permission: ussmp.admin.debug
├── Description: Toggle debug mode
└── Example: /ussmp debug
```

---

 🔐 Permission Structure

 Permission Tree

```
ussmp.*                            All permissions
├── ussmp.use                      Basic plugin use
├── ussmp.withdraw                 Use /withdraw
│   └── ussmp.withdraw.unlimited   Bypass limits
├── ussmp.revive                   Use /revive
│   └── ussmp.revive.noitem        No beacon needed
├── ussmp.class                    View class info
│   └── ussmp.class.change         Change class
├── ussmp.recipes                  View recipes
│
├── ussmp.admin.*                  All admin permissions
│   ├── ussmp.admin.eliminate      Eliminate players
│   ├── ussmp.admin.strength       Modify strength
│   ├── ussmp.admin.reload         Reload config
│   ├── ussmp.admin.debug          Debug mode
│   ├── ussmp.admin.bypass         Bypass restrictions
│   └── ussmp.admin.give           Give custom items
│
├── ussmp.ability.passive          Use passive abilities
├── ussmp.ability.ultimate         Use ultimate abilities
├── ussmp.ability.legendary        Use legendary abilities
│
├── ussmp.immune.strengthloss      Can't lose strength
├── ussmp.immune.elimination       Can't be eliminated
└── ussmp.immune.strengthsteal     Strength can't be stolen
```

---

 📊 Use Cases & Server Types

 Best For:

| Server Type | Why It Works |
|-------------|--------------|
| **Hardcore SMP** | High-stakes PvP with permanent consequences |
| **Competitive PvP** | Skill-based progression through combat |
| **Content Creators** | Dramatic moments, eliminations, comebacks |
| **Event Servers** | Limited-time competitive seasons |
| **Small Communities** | Creates natural alliances and rivalries |

 Example Server Configurations

 🔴 Ultra Hardcore Mode
```yaml
strength:
  per-kill-gain: 2.0         Faster scaling
  per-death-loss: 2.0        Harsh penalties
  max-cap: 30.0              Higher ceiling
  elimination-threshold: -5.0   Quick eliminations

elimination:
  mode: "BAN"                Permanent until revived

revive:
  require-item: true
  consume-item: true
```

 🟡 Casual Competitive Mode
```yaml
strength:
  per-kill-gain: 0.5         Slower scaling
  per-death-loss: 0.5        Forgiving
  max-cap: 15.0              Lower ceiling
  elimination-threshold: -15.0   Hard to eliminate

elimination:
  mode: "SPECTATOR"          Just spectate

revive:
  require-item: false        Easy revives
```

 🟢 Content Creator Mode
```yaml
strength:
  per-kill-gain: 1.0
  per-death-loss: 1.0
  max-cap: 20.0
  elimination-threshold: -10.0

elimination:
  mode: "BAN"
  broadcast-elimination: true   Drama!
  lightning-effect: true
  
weapon-class:
  assignment-mode: "SELECTOR"   Player choice = content

effects:
  particles:
    enabled: true              Visual content
  sounds:
    enabled: true
```

---

 🔄 Gameplay Flow

 New Player Journey

```
┌─────────────────────────────────────────────────────────────┐
│                     PLAYER JOINS SERVER                      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
              ┌───────────────────────────────┐
              │   First Time? Select Class    │
              │   (GUI opens automatically)   │
              └───────────────────────────────┘
                              │
                              ▼
              ┌───────────────────────────────┐
              │   Starting Strength: 0        │
              │   Base Attack Damage: Normal  │
              └───────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      GAMEPLAY LOOP                           │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    │
│   │   GATHER    │───▶│   CRAFT     │───▶│    HUNT     │    │
│   │  Resources  │    │   Weapons   │    │   Players   │    │
│   └─────────────┘    └─────────────┘    └─────────────┘    │
│          │                                     │            │
│          │         ┌─────────────┐             │            │
│          └────────▶│   SURVIVE   │◀────────────┘            │
│                    └─────────────┘                          │
│                          │                                  │
│            ┌─────────────┴─────────────┐                   │
│            ▼                           ▼                    │
│   ┌─────────────┐             ┌─────────────┐              │
│   │   WIN PVP   │             │  LOSE PVP   │              │
│   │ +1 Strength │             │ -1 Strength │              │
│   └─────────────┘             └─────────────┘              │
│            │                           │                    │
│            ▼                           ▼                    │
│   ┌─────────────┐             ┌─────────────┐              │
│   │   GROW      │             │  Below -10? │              │
│   │  STRONGER   │             │ ELIMINATED! │              │
│   └─────────────┘             └─────────────┘              │
│                                        │                    │
│                                        ▼                    │
│                               ┌─────────────┐              │
│                               │   REVIVED   │              │
│                               │  by friend  │              │
│                               └─────────────┘              │
│                                        │                    │
│                                        ▼                    │
│                                  (Back to Loop)             │
└─────────────────────────────────────────────────────────────┘
```

 Economy Flow (Strength Trading)

```
┌──────────────────┐         ┌──────────────────┐
│   Player A       │         │    Player B      │
│   Strength: 10   │         │    Strength: 2   │
└────────┬─────────┘         └────────┬─────────┘
         │                            │
         │ /withdraw 3                │
         ▼                            │
┌──────────────────┐                  │
│   Player A       │                  │
│   Strength: 7    │                  │
│   +3 Dust Items  │                  │
└────────┬─────────┘                  │
         │                            │
         │    Trade dust for items    │
         │◀──────────────────────────▶│
         │                            │
         ▼                            ▼
┌──────────────────┐         ┌──────────────────┐
│   Player A       │         │    Player B      │
│   Strength: 7    │         │    Strength: 2   │
│   Has diamonds   │         │   +3 Dust Items  │
└──────────────────┘         └────────┬─────────┘
                                      │
                                      │ Right-click dust
                                      ▼
                             ┌──────────────────┐
                             │    Player B      │
                             │    Strength: 5   │
                             │   (stronger!)    │
                             └──────────────────┘
```

---

 📈 Statistics & Tracking

 Tracked Per Player

| Statistic | Storage | Use |
|-----------|---------|-----|
| Current Strength | PDC | Core gameplay |
| Weapon Class | PDC | Ability system |
| Total Kills | PDC | Leaderboard |
| Total Deaths | PDC | Leaderboard |
| Kill Streak | Memory | Broadcasts |
| Combo Counter | Memory | Sword class |
| Crit Counter | Memory | Axe class |
| Arrow Counter | Memory | Bow/Crossbow |
| Cooldowns | Memory | Abilities |

 PlaceholderAPI Placeholders

```
%ussmp_strength%           → Current strength value
%ussmp_class%              → Weapon class name
%ussmp_class_icon%         → Class icon (⚔, 🪓, etc.)
%ussmp_kills%              → Total kills
%ussmp_deaths%             → Total deaths
%ussmp_kdr%                → Kill/Death ratio
%ussmp_rank%               → Leaderboard position
%ussmp_ultimate_cooldown%  → Seconds until ready
%ussmp_is_eliminated%      → true/false
```

---

 🛡️ Anti-Abuse Features

| Feature | Description | Config Option |
|---------|-------------|---------------|
| **Self-Kill Prevention** | Can't gain strength from own deaths | `anti-abuse.prevent-self-kill` |
| **Transfer Cooldown** | Cooldown between transfers from same player | `anti-abuse.transfer-cooldown` |
| **IP Check** | Detect alt accounts on same IP | `anti-abuse.ip-check` |
| **Combat Logging** | Counts as death if logout in combat | Separate system |
| **Indirect Kill Window** | Time limit for counting indirect kills | `strength.indirect-kill-window` |

---

 🎯 Target Audience

| Audience | Appeal |
|----------|--------|
| **Server Owners** | Unique SMP experience, high player engagement |
| **Content Creators** | Dramatic moments, eliminations, rivalries |
| **Competitive Players** | Skill-based progression, class mastery |
| **PvP Enthusiasts** | Deep combat system, meaningful fights |
| **SMP Communities** | Natural alliances, trading, politics |

---

 ⚡ Quick Start Checklist

```
□ Download UltimateStrengthSMP-1.0.0.jar
□ Place in plugins/ folder
□ Start server (generates configs)
□ Edit config.yml for your server style
□ Edit messages.yml for branding
□ Set up permissions (LuckPerms recommended)
□ Restart server
□ Test with /ussmp debug
□ Announce to players!
```

---

**Ready to transform your SMP into a high-stakes competitive battleground!** ⚔️

 

Need a server to run UltimateStrengthSMP?
Get 24/7 high-performance hosting from reliable hosting for your community!
Click here to get started with KCB Hosting