================================================================================ BLESSINGS SMP PLUGIN - COMPLETE GUIDE ================================================================================ OVERVIEW -------- BlessedSMP is a comprehensive SMP plugin featuring 5 unique blessings with abilities, passives, a token system, mythic items, and full customization. ================================================================================ BLESSINGS SYSTEM ================================================================================ AVAILABLE BLESSINGS ------------------- 1. STRENGTH - Melee combat specialist 2. ENDURANCE - Tank and survivalist 3. SPEED - Fast movement and agility 4. LIFE - Healing and sustain 5. THUNDER - Lightning and storms BLESSING ASSIGNMENT ------------------- - Players receive a blessing when the SMP starts via /smpstart - New players joining after the start automatically receive a random blessing - Players can reroll their blessing using a Reroller item (Nether Star) - Tokens are preserved when rerolling ================================================================================ ABILITIES SYSTEM ================================================================================ CONTROLS -------- Ability 1: Press F (offhand key) Ability 2: Press Shift + F (sneaking + offhand key) TOKEN REQUIREMENTS ------------------ - Ability 1: Requires +3 tokens - Ability 2: Requires +4 tokens - Enhanced Mode: At +5 tokens, all abilities become stronger BLESSING OF STRENGTH -------------------- Passive: Warrior's Rage - Permanent Strength I - Gain Strength II for 3s after hitting a player Ability 1: Prideful Slam (F) - Launch 20 blocks up and slam down - Shockwave applies Slowness II (20s) to nearby enemies - Deals knockback and impact damage - No fall damage - Cooldown: 60s Ability 2: Kratos's Intervention (Shift + F) - Gain Strength III and slight speed boost (25s) - Cooldown: 120s BLESSING OF ENDURANCE --------------------- Passive: Titan Skin - Permanent Resistance I - 20% damage reduction from all sources Ability 1: Unwavering Endurance (F) - Gain +20 hearts for 35s - Cooldown: 60s Ability 2: Atlas's Dominion (Shift + F) - Create a domain for 25s - Resistance V + anti-knockback - Cooldown: 120s BLESSING OF SPEED ----------------- Passive: Swift Reflexes - Permanent Speed II - Chance to dodge attacks (15% chance to negate damage) Ability 1: Sonic Boom (F) - Charge up to 20s, press F again to release - Shockwave deals 6 hearts true damage in cone - Cooldown: 60s Ability 2: Hermes Adrenaline (Shift + F) - Speed IV + Haste III for 35s - Cooldown: 120s BLESSING OF LIFE ---------------- Passive: Eternal Growth - Permanent Regeneration II - Increased natural healing speed (1.5x multiplier) Ability 1: Life Drain (F) - Drain 2-6 hearts from target player - Heal yourself by the amount drained - Cooldown: 60s Ability 2: Gaia's Produce (Shift + F) - Food gives enchanted golden apple effects (25s) - Extra absorption bonus - Cooldown: 120s BLESSING OF THUNDER ------------------- Passive: Static Charge - Permanent Speed I - Attacks have 20% chance to strike lightning Ability 1: Zeus's Wrath (F) - Lightning storm for 20s - Increased strike rate + AoE damage - Cooldown: 60s Ability 2: Thunder's Assertion (Shift + F) - 2x damage multiplier for 20s - Hits chain small lightning to nearby enemies - Cooldown: 90s ================================================================================ TOKEN SYSTEM ================================================================================ TOKEN MECHANICS --------------- Starting Tokens: 2 Minimum: -3 Maximum: 5 TOKEN GAIN/LOSS --------------- - Kill a player: +1 token - Death: -1 token - Use token item: +1 token SPECIAL RULES ------------- - At +5 tokens (max), killing a player drops a token item instead - Players at +5 tokens cannot use token items - Tokens DO NOT reset when rerolling blessings - Tokens can be withdrawn as items using /withdraw token ABILITY UNLOCKS --------------- +3 tokens: Ability 1 unlocked +4 tokens: Ability 2 unlocked +5 tokens: Enhanced mode (stronger abilities, reduced cooldowns) ================================================================================ MYTHIC ITEMS ================================================================================ ZEUS'S THUNDERBOLT ------------------ Type: Netherite Sword (Sharpness V) Effect: Every 3 hits summons lightning on the target Damage: 5.0 true damage (configurable) ANCIENT AXE ----------- Type: Netherite Axe Effect: Every 10 hits → 50% chance to freeze nearby enemies for 5s Freeze: Prevents movement, jumping, and knockback ANCIENT ARMOR SET ----------------- Helmet: Water Breathing + Resistance Chestplate: +10 Hearts (correctly added/removed on equip/unequip) Leggings: Speed II Boots: No Fall Damage + Dolphin's Grace All Ancient Armor pieces are unbreakable REROLLER -------- Type: Nether Star Effect: Right-click to receive a new random blessing Note: Cannot receive the same blessing twice in a row TOKEN ITEM ---------- Type: Nether Star Effect: Right-click to consume and gain +1 token Obtain: Drops from players when killed by someone at +5 tokens ================================================================================ TRUST SYSTEM ================================================================================ USAGE ----- - /trust add - Add a player to your trust list - /trust remove - Remove a player from your trust list EFFECT ------ - Trusted players are immune to your abilities and mythic effects - Prevents friendly fire in team scenarios ================================================================================ COMMANDS ================================================================================ PLAYER COMMANDS --------------- /blessing - View your current blessing and token count /info - Display blessing information and controls /tokens - Check your token balance /trust add - Add a player to trust list /trust remove - Remove a player from trust list /withdraw token - Convert tokens to items ADMIN COMMANDS -------------- /blessinggive - Give a specific blessing to a player /givereroll - Give reroller items /givetoken - Give tokens to a player /givemythic - Give a mythic item Items: thunderbolt, axe, helmet, chestplate, leggings, boots /smpstart - Start the SMP and distribute blessings /cooldownreset - Reset all cooldowns for a player /blessingsreload - Reload the plugin configuration ================================================================================ CONFIGURATION ================================================================================ config.yml STRUCTURE -------------------- - debug: Enable console logging for key actions - smp.started: Whether the SMP has started - tokens: Token limits and requirements - abilities: All ability values (cooldowns, damage, durations) - mythic-items: Mythic item stats and chances - enhancement-multipliers: Multipliers for enhanced mode at +5 tokens - messages: All player-facing messages FULLY CONFIGURABLE ------------------ - All damage values - All cooldowns - All durations - Token limits and requirements - Mythic item chances and effects - Passive strengths - Enhancement multipliers - All messages and text RELOAD ------ Use /blessingsreload to apply config changes without restarting the server ================================================================================ TECHNICAL FEATURES ================================================================================ TRUE DAMAGE SYSTEM ------------------ - All ability damage and mythic item damage deals true damage - True damage ignores armor and resistance effects - Ensures consistent damage across all scenarios MULTIPLAYER-SAFE ---------------- - All features work correctly in multiplayer - No duplication glitches - Proper synchronization of effects LIGHTNING DAMAGE FIX -------------------- - Lightning damage occurs on a separate tick from melee hits - Prevents double-hit bugs and stacking damage - Smooth, delayed lightning impacts ANCIENT CHESTPLATE FIX ---------------------- - Correctly adds +10 hearts when equipped - Correctly removes hearts when unequipped - No health overflow or duplication bugs FREEZE EFFECT ------------- - True freeze: prevents movement, jumping, and knockback - Applied via extreme slowness + negative jump boost + walk speed 0 - Automatically resets after duration DEBUG MODE ---------- - Enable in config.yml: debug: true - Logs ability usage, damage dealt, token changes, and rerolls to console - Useful for troubleshooting and monitoring ================================================================================ REROLL SYSTEM ================================================================================ HOW TO USE ---------- 1. Obtain a Reroller item (Nether Star named "Reroller") 2. Right-click with the Reroller in hand 3. Receive a new random blessing (cannot be the same as current) 4. Your tokens are preserved VISUAL FEEDBACK --------------- - Title appears on screen: "✦ A BLESSING HAS CHOSEN YOU ✦" - Subtitle shows the new blessing name - Sound effect plays - Particles appear around the player ================================================================================ SMP START SYSTEM ================================================================================ BEFORE SMP STARTS ----------------- - Players cannot receive blessings - Abilities are disabled - Message shown: "The SMP has not started yet!" STARTING THE SMP ---------------- 1. Admin runs /smpstart 2. Broadcast message sent to all players 3. All online players receive a random blessing 4. All online players receive starting tokens (default: 2) 5. New players joining after start automatically receive a blessing ================================================================================ PERMISSIONS ================================================================================ blessings.admin --------------- - Access to all admin commands - Default: op ================================================================================ SUPPORT & INFO ================================================================================ Plugin Name: BlessedSMP Version: 1.0.0 API Version: 1.20+ CROSS-VERSION COMPATIBILITY --------------------------- - Uses XSeries for full cross-version support (1.8 - 1.21+) - Works on Spigot, Paper, and forks PERFORMANCE ----------- - Optimized for multiplayer servers - Efficient particle and sound systems - Minimal server impact ================================================================================ END OF GUIDE ================================================================================