strength vanilla

# **THE STRENGTH SMP VANILLA MOD** ### IMPORTANT IN-GAME COMMANDS : **/strength** **/upgrade ** **/leaderboard** ### MOD OVERVIEW: TheStrength Vanilla is a high-performance combat and progression overhaul built for Fabric 1.21.11 using Official Minecraft Mappings. It features a permanent attribute-based leveling system, sequential weapon skill cycles, dynamic center- screen feedback, and a custom "Partial Keep Inventory" death penalty system. ### 1. CORE DEPENDENCIES • Minecraft: 1.21.11 • Fabric Loader: >= 0.19.3 • Fabric API: Latest compatible (Required for Networking, Events, and Attributes) • Java Version: Java 21 ### 2. PERMANENT STRENGTH ATTRIBUTE SYSTEM Players progress through 5 permanent levels of Strength. These levels modify attack damage attributes globally (melee and projectile). **• Damage Matrix (Base Attribute Modifiers):** - Level 1: +0.0 HP (Base damage) - Level 2: +1.5 HP (+0.75 Hearts) - Level 3: +3.0 HP (+1.5 Hearts) - Level 4: +4.5 HP (+2.25 Hearts) - Level 5: +6.0 HP (+3.0 Hearts) [MAX CAP] **• Strength Lifesteal (Stealing):** - Condition: Stealing only occurs if the killer uses a Sword of Level 2+. - Gain: The killer steals 1 Strength Level from the victim (up to Level 5). - Loss: The victim loses 1 Strength Level on death (unless at Level 1). - Safety Logic: If the killer is already Level 5, the victim loses NO strength to preserve the server's strength economy. **• Fallback Rewards:** - If no strength is stolen (Killer at Lvl 5, Victim at Lvl 1, or wrong weapon): - +1 Point (Spendable). - +1 Weapon Point (for the weapon used in the kill). ### 3. STRENGTH POTION MECHANICS (ADAPTIVE BOOST) Strength potions are dynamically balanced to work with your permanent levels, ensuring damage stays within the mod's competitive limits (+6.0 HP cap). **• Strength I (Normal/Long):** - Provides an adaptive boost that scales with your level. - Target Damage Cap: 3.0 + (Level-1) * 0.75 HP. - The mod adds the exact difference between this cap and your base damage. **• Strength II (Strong):** - Automatically provides the exact boost needed to hit the absolute mod cap of +6.0 HP (3 full hearts), regardless of your current base level. ### 4. WEAPON ABILITY CYCLES & COMBOS All weapons track combat streaks. Streaks reset if the player takes damage from another player or the weapon's timeout window (3-5s) expires. **• Sword ("Unstoppable Combo"):** - Activation: Land 3 consecutive Critical hits (falling) or Knockback hits (sprinting). - Active Phase: Grants a 1.5x damage multiplier for 3 seconds. - Feedback: Every strike triggers Critical particles and sounds. - Chain: Landing hits while active resets the timer to maintain the chain. **• Axe ("Shield & Armor Shatter"):** - Cycle: 4-Hit Sequence. - Hits 1 & 2: Land 2 consecutive fully-charged Critical hits to activate. - Hit 3: Destroys 10% of Target's Shield (if blocking) or ALL Armor pieces. - Hit 4: Destroys 10% of Target's Shield or ALL Armor pieces. - Penalty: Attacker's Axe also loses 10% durability on every ability hit. - Transition: If Hit 4 is a critical hit, it instantly starts Hit 1 of the next cycle. **• Bow ("Precision Draw"):** - Requirement: Every shot MUST be fully charged (Critical Arrow). - Hit 1: Triggers Activation message. - Hit 2+: Each consecutive fully-charged hit adds +0.5x damage multiplier. - Reset: Missing a shot, hitting a block, or weak shots reset streak to 0. **• Mace ("Concussive Impact"):** - Activation: Land 2 consecutive "Smash" attacks (falling > 1.5 blocks). - Active Phase: Every subsequent hit applies Slowness IV to the target for 5s. **• Crossbow ("Phantom Bolt"):** - Passive: Arrows have a permanent ability to penetrate up to 3 blocks. ### 5. THE CONDUIT BOOSTER **• Auto-Consumption:** If a player with Strength Level < 3 has a vanilla Conduit in their inventory, it is automatically consumed to grant +1 Permanent Strength Level. **• Custom Crafting Recipe:** - Corner Slots: Strength II Potions - Side Slots: Gold (Top/Mid), Emerald (Sides), Iron (Bot/Sides) - Center Slot: Diamond Sword [Recipe includes Diamond, Gold, Iron, Emeralds, and Nether Star materials] ### 6. DEATH MECHANICS (PARTIAL KEEP INVENTORY) The mod enforces a custom retention system that ignores vanilla gamerules: **• RETAINED (Saved on all deaths):** - All equipped Armor pieces. - Full Hotbar (Slots 0-8). - Offhand item. **• DROPPED (Lost on all deaths):** - All items in the Main Inventory / Backpack (Slots 9-35). **• PENALTIES:** - Durability: Every Armor piece loses 25% of its total max durability on death. - Sound: A global Wither Spawn sound plays at the location of every death. ### 7. VISUAL FEEDBACK (UNIFORM COLOR SCHEME) **• Splash Screens (Center Screen):** - Killer/Conduit: "Strength +X" (RED title, AQUA "+", WHITE number). - Victim (Post-Respawn): "Strength -1" (RED title, AQUA "-", WHITE number). - Row 2: "strength level: X/5 | [Weapon] Pt +1 [Total]" (GREEN labels, WHITE numbers, PINK weapon, YELLOW points, GRAY separators). **• Action Bar (Above Hotbar):** - Status/Expirations: Always RED. - Sword: "Crit Hits X" (PINK "Crit", WHITE "Hits", AQUA count). - Axe: "-10% Target Durability" (YELLOW percentage, RED text). - Mace: "Slowness IV Applied X" (PINK "Slowness", RED "IV", AQUA count). - Bow: "Damage Multiplier X.x" (RED "Damage", PINK "Multiplier", WHITE count). - Expiry: "[Ability Expired]" (RED) appears after a 300ms gap when cycle ends. **• Boss Bar HUD (Top Screen):** - Name: [Potion Level] (YELLOW). - Bonus: [+X.x Damage] (RED). - Timer: Time Left [M:SS] (SKYBLUE/WHITE). **• Tooltips (Inventory):** - Header: Gold Bold "SMP". - Shows Total Kills (RED), Level (YELLOW), and Points (GOLD). - Ability Status: Green Tick (✔) if Level 3+, Gold [x] if Locked. ### 8. COMMANDS **• /strength:** Opens the visual board showing Kills, Points, and Weapon levels. Features interactive [UPGRADE] buttons to level up gear. **• /leaderboard:** View the top players on the server ranked by Total Player Kills. **• /upgrade :** Spend points to upgrade specific weapon levels. ================================================================================