=====================================

WEATHERPOWERS PLUGIN - COMPLETE INFO

Author: XITER Version: 1.0.0 Platform: Minecraft (Bukkit/Spigot/Paper)

OVERVIEW

WeatherPowers is a Minecraft plugin that grants players elemental weather affinities, allowing them to harness the power of Sun, Rain, Storm, and Snow. Each affinity provides 3 unique abilities with special effects and targeting capabilities.

WEATHER AFFINITIES

Players are automatically assigned one of four weather affinities:

☀️ SUN AFFINITY

• Theme: Fire, Heat, Light
• Color: Gold/Yellow
• Strengths: Damage over time, area denial, blindness

🌧️ RAIN AFFINITY

• Theme: Water, Healing, Force
• Color: Aqua/Blue
• Strengths: Healing, knockback, temporary weapons

⚡ STORM AFFINITY

• Theme: Lightning, Wind, Chaos
• Color: Purple/Dark Blue
• Strengths: Direct damage, multiple strikes, launching

❄️ SNOW AFFINITY

• Theme: Ice, Cold, Control
• Color: White/Light Blue
• Strengths: Crowd control, freezing, area effects

ABILITIES BREAKDOWN

☀️ SUN POWERS:

1. SOLAR FLARE (20s cooldown)

   • Blinds all enemies within 7 blocks for 5 seconds
   • Creates explosion particle effect and thunder sound
   • Message: "Solar Flare activated! Blinded X enemies."

2. HEATWAVE (20s cooldown)

   • Evaporates water blocks in 5-block radius
   • Sets nearby entities on fire for 2 seconds
   • Creates flame particles and fire extinguish sound
   • Message: "Heatwave activated! Affected X entities."

3. LAVA SUMMON (20s cooldown)

   • Summons lava at targeted block location for 3 seconds
   • Creates lava particles and lava pop sound
   • Message: "Lava Summoned at target location!"

🌧️ RAIN POWERS:

1. RAIN BLESSING (20s cooldown)

   • Heals all players within 8 blocks by 2 hearts
   • Creates water drop particles and rain sound
   • Message: "Rain Blessing activated! Healed X players."

2. TIDAL WAVE (20s cooldown)

   • Pushes all entities away within 6 blocks
   • Creates water bubble particles and bucket empty sound
   • Message: "Tidal Wave activated! Pushed X entities."

3. RAIN SWORD (20s cooldown)

   • Grants "Rain Blade" iron sword with Sharpness 5 & Unbreaking 10
   • Sword lasts 10 seconds then disappears automatically
   • Creates water drop particles and trident riptide sound
   • Message: "Rain Blade manifested! (10 seconds)"

⚡ STORM POWERS:

1. THUNDER CALL (20s cooldown)

   • Strikes lightning at targeted block (up to 50 blocks away)
   • Direct lightning strike with full damage
   • Message: "Thunder called from the heavens!"

2. TORNADO (20s cooldown)

   • Launches all entities within 6 blocks straight up (2.5 blocks high)
   • Creates cloud particles and dragon flap sound
   • Message: "Tornado summoned! Launched X entities skyward."

3. THUNDER BARRAGE (20s cooldown)

   • Unleashes 10 lightning strikes over 1 second on target area
   • Each strike has slight random offset for coverage
   • Message: "Thunder Barrage unleashed!"

❄️ SNOW POWERS:

1. ICE PRISON (20s cooldown)

   • Freezes water blocks to ice in 4-block radius
   • Applies Slowness II to nearby entities for 5 seconds
   • Creates snow particles and glass break sound
   • Message: "Ice Prison activated! Trapped X entities."

2. BLIZZARD (20s cooldown)

   • Blinds all entities within 6 blocks for 3 seconds
   • Creates heavy snow particles and rain sound
   • Message: "Blizzard unleashed! Blinded X entities."

3. ICE ENTOMB (20s cooldown)

   • Places ice block at target location for 5 seconds
   • Applies Slowness V and prevents jumping to nearby entities
   • Creates snow particles and glass place sound
   • Message: "Ice Entomb activated! Target frozen in ice!"

TARGETING ABILITIES (Right-Click on Enemies)

All affinities have special targeting abilities with 20-second shared cooldown:

☀️ SUN TARGETING - Lava Summon

• Right-click enemy to summon lava under them for 3 seconds
• Deals 2 hearts damage and sets on fire for 3 seconds
• Creates lava particles and lava pop sound

🌧️ RAIN TARGETING - Water Blast

• Right-click enemy for massive knockback with upward force
• Knockback strength: 5.0, Upward force: 1.5
• Creates water splash particles and splash sound

⚡ STORM TARGETING - Lightning Strike

• Right-click enemy to strike them with lightning
• Direct lightning hit with full damage
• Instant strike effect

❄️ SNOW TARGETING - Ice Bind

• Right-click enemy to freeze them for 5 seconds
• Applies Slowness V, Slow Digging, and prevents jumping
• Creates snow particles and glass break sound

COMMANDS

PLAYER COMMANDS: /myaffinity

• Shows your current weather affinity and abilities
• Displays all 3 abilities with names and cooldowns
• Usage: /myaffinity

/ability <1|2|3>

• Switches to specified ability number
• Confirms switch with ability name
• Usage: /ability 2

/switchability

• Cycles to next ability (1→2→3→1)
• Shows confirmation message with new ability
• Usage: /switchability

ADMIN COMMANDS: /setaffinity <sun|rain|storm|snow>

• Sets a player's weather affinity
• Requires weatherpowers.admin permission
• Usage: /setaffinity PlayerName sun

/weatherpowers reload

• Reloads plugin configuration
• Requires weatherpowers.admin permission
• Usage: /weatherpowers reload

CONTROLS

ABILITY ACTIVATION:

• Left-Click: Use selected ability
• Ctrl + Right-Click: Cycle through abilities (1→2→3→1)

TARGETING:

• Right-Click on Enemy: Use targeting ability (requires line of sight)
• Works on all living entities including players (if enabled in config)

ACTION BAR DISPLAY:

• Shows all 3 abilities with status: [1. Solar ✓] | [2. Heat (15s)] | [3. Lava ✓]
• Green checkmark (✓) = Ready to use
• Red timer (Xs) = On cooldown
• Selected ability has arrow indicator (▶)

CRAFTING RECIPES

All power crystals use a 3x3 grid pattern filling the entire crafting table:

☀️ SUN POWER CRYSTAL Materials: 8 Gold Blocks + 1 Diamond Block Pattern: [GOLD] [GOLD] [GOLD] [GOLD] [DIAM] [GOLD]
[GOLD] [GOLD] [GOLD]

🌧️ RAIN POWER CRYSTAL Materials: 8 Emerald Blocks + 1 Diamond Block Pattern: [EMER] [EMER] [EMER] [EMER] [DIAM] [EMER] [EMER] [EMER] [EMER]

⚡ STORM POWER CRYSTAL Materials: 8 Netherite Blocks + 1 Diamond Block Pattern: [NETH] [NETH] [NETH] [NETH] [DIAM] [NETH] [NETH] [NETH] [NETH]

❄️ SNOW POWER CRYSTAL Materials: 8 Quartz Blocks + 1 Diamond Block Pattern: [QRTZ] [QRTZ] [QRTZ] [QRTZ] [DIAM] [QRTZ] [QRTZ] [QRTZ] [QRTZ]

RECIPE SUMMARY:

• Each crystal requires 9 total items
• 8 block materials + 1 diamond block center
• Very expensive materials for game balance
• Recipes automatically registered on plugin enable

PERMISSIONS

PLAYER PERMISSIONS: weatherpowers.use - Use basic plugin features (default: true) weatherpowers.ability - Use weather abilities (default: true) weatherpowers.craft - Craft power crystals (default: true)

ADMIN PERMISSIONS: weatherpowers.admin - All admin commands (default: op) weatherpowers.setaffinity - Set player affinities (default: op) weatherpowers.reload - Reload plugin config (default: op)

CONFIGURATION

Key config.yml settings:

GENERAL:

• auto_assign_affinity: true (assign random affinity to new players)
• auto_give_power_items: true (give power crystal automatically)
• debug_mode: false (console debug messages)

COOLDOWNS:

• All abilities: 20 seconds (uniform for balance)
• Targeting abilities: 20 seconds (shared cooldown)

EFFECTS:

• Ability ranges, damage values, and durations
• Targeting ability configurations
• Particle and sound effect settings

UI SETTINGS:

• Action bar display duration and update frequency
• Symbol customization for ready/cooldown states

GAMEPLAY FEATURES

BALANCED MECHANICS:

• Uniform 20-second cooldowns for all abilities
• Expensive crafting recipes requiring rare blocks
• Line-of-sight requirements for targeted abilities
• Shared cooldown for targeting abilities

VISUAL FEEDBACK:

• Action bar shows all 3 abilities with real-time cooldown timers
• Particle effects for all abilities with unique themes
• Sound effects matching each affinity's element
• Color-coded messages for each affinity

PLAYER PROGRESSION:

• Automatic affinity assignment for new players
• Access to power crystal crafting recipes
• Three distinct abilities per affinity for variety
• Optional PvP targeting if enabled by admins

INSTALLATION

1. Download WeatherPowers.jar from builds
2. Place in server's plugins folder
3. Start/restart server
4. Plugin will generate config.yml automatically
5. Grant players weatherpowers.use permission
6. Players will receive random affinities on first join

TROUBLESHOOTING

COMMON ISSUES:

• Abilities not working: Check permissions and cooldowns
• Recipes not showing: Verify crafting.enable_recipes: true in config
• Action bar not displaying: Check UI settings in config
• Targeting not working: Ensure allow_player_targeting setting

SUPPORT:

• Check console for error messages
• Use /weatherpowers reload after config changes
• Verify all dependencies are installed
• Contact XITER for additional support

VERSION HISTORY

v1.0.0 - Initial Release

• Four weather affinities with 3 abilities each
• Targeting system with right-click enemies
• Block-based expensive crafting recipes
• Uniform 20-second cooldowns
• Complete action bar UI system
• Comprehensive command system