FoundationsAbilities

FoundationsAbilities is a comprehensive elemental magic system plugin for Minecraft servers that provides players with powerful foundation-based abilities, rune progression, and dynamic combat mechanics.

🌟 Core Features

🎲 Foundation Assignment System

• Random Foundation Assignment: New players are automatically assigned one of six elemental foundations (Water, Air, Earth, Fire, Ice, Lightning)
• Foundation Rerolling: Players can craft and use Reroll Tokens to change their foundation
• Foundation Selection GUI: Interactive menu for viewing and managing foundations
• Foundation Animation: Dramatic visual and sound effects when foundations are assigned or rerolled

🔮 Six Unique Elemental Foundations

Each foundation provides distinct passive and active abilities:

💧 Water Foundation

• Passive: Extended underwater breathing, Conduit Power, Dolphin Grace
• Active 1 - Ocean's Embrace: Water aura granting damage reduction, knockback resistance, and regeneration to allies
• Active 2 - Maelstrom: Whirlpool that pulls enemies toward center with damage over time
• Active 3 - Tendrils: Water tendrils that lift enemies into the air and slam them into the ground

🌬️ Air Foundation

• Passive: Enhanced mobility and agility
• Active 1 - Dash: High-speed dash with damage and knockback
• Active 2 - Wind Blade/Ball: Ranged wind projectiles and vortex effects
• Active 3 - Shattered Sky: Area-of-effect damage and knockback from above

🏔️ Earth Foundation

• Passive: Damage reduction based on foundation level
• Active 1 - Leap: High jump with ground slam damage and slowness effects
• Active 2 - Dome: Protective earth dome that blocks projectiles
• Active 3 - Crack/Spike: Ground-based attacks creating stone spikes and fissures

🔥 Fire Foundation

• Passive: Enhanced fire damage and resistance
• Active 1 - Fire Brand/Lava Wall: Fire damage over time and protective lava barriers
• Active 2 - Fireball: Explosive fire projectiles
• Active 3 - Fire Storm: Area-of-effect fire damage with lightning strikes

❄️ Ice Foundation

• Passive: Frost-based defensive abilities
• Active 1 - Shotgun: Multi-shot ice projectiles with freezing effects
• Active 2 - Freezing Strike: Area-of-effect freezing and slowness
• Active 3 - Blizzard: Area-of-effect ice damage and freezing

⚡ Lightning Foundation

• Passive: Electrical resistance and enhanced speed
• Active 1 - Stormburst: Chain lightning damage over time
• Active 2 - Storm Cloud: Lightning storm with multiple strikes
• Active 3: Ultimate lightning-based area damage

🏅 Rune Progression System

Rune Mechanics

• Rune Collection: Players start with 3 runes and can collect up to 11
• Rune Withdrawal: Players can withdraw rune items for trading or storage
• Rune Crafting: Craft additional runes using gold and redstone (limited by current rune count)
• Rune Loss: Players lose runes on death (configurable amount)

Progression Gates

• Passive Unlocked: 1 rune required
• Active 1 Unlocked: 5 runes required
• Active 2 Unlocked: 7 runes required
• Active 3 Unlocked: 9 runes required

🎮 Advanced Features

Trust System

• Player Trust: Players can trust other players to avoid friendly fire from their abilities
• One-Way Trust: Trust relationships are one-way (you trust them, but they don't automatically trust you)
• Trust Management: Add/remove trusted players through commands

Cooldown Management

• Individual Cooldowns: Each ability has its own cooldown timer
• Action Bar Display: Real-time cooldown progress shown in action bar
• Scoreboard Integration: Foundation information and cooldown status on scoreboard
• Visual Feedback: Particle effects and sound cues for ability usage

GUI Interface

• Main Menu: Interactive foundation management interface
• Ability Information: Comprehensive guide to all foundations and abilities
• Crafting Recipes: Visual display of rune and reroll token recipes
• Foundation Status: Real-time display of current foundation and progression

Performance Optimization

• Performance Mode: Configurable particle reduction for lower-end systems
• Particle Scaling: Automatic adjustment of particle effects based on server performance
• Efficient Scheduling: Optimized task scheduling for smooth gameplay

⚙️ Configuration Options

Ability Customization

• Cooldown Durations: Configurable cooldown times for all abilities
• Damage Values: Adjustable damage output for all active abilities
• Effect Durations: Customizable duration for all status effects
• Range and Radius: Configurable ranges for area-of-effect abilities

Gameplay Balance

• Rune Requirements: Adjustable rune thresholds for each progression stage
• Reroll Mechanics: Configurable reroll requirements and costs
• Crafting Limits: Maximum rune count for crafting eligibility
• Death Penalties: Configurable rune loss on player death

Visual and Audio

• Particle Effects: Customizable particle counts and types
• Sound Effects: Configurable sound volumes and types
• GUI Customization: Customizable menu titles and item names
• Animation Settings: Foundation assignment animation timing and effects

🛠️ Commands

Player Commands

• /menu - Open foundation management GUI
• /active1, /active2, /active3 - Use foundation abilities
• /withdraw - Withdraw rune item
• /trust <player> - Add player to trust list
• /togglescoreboard - Toggle scoreboard display
• /togglebar - Toggle cooldown action bar
• /reroll - Reroll foundation (if eligible)

Admin Commands

• /foundation <set|get> <player> [foundation] - Manage player foundations
• /runes <give|take|set> <player> <amount> - Manage player runes
• /foundationsreset <player> - Reset player foundation data
• /reloadconfig - Reload plugin configuration

🔧 Installation & Setup

1. Download: Get the latest JAR file from the releases page
2. Install: Place the JAR file in your server's plugins folder
3. Start: Restart your server to generate configuration files
4. Configure: Edit config.yml and reroll.yml to customize gameplay
5. Custom Models: Optional - Add custom model data for rune and reroll items

📋 Requirements

• Minecraft Version: 1.21+ (tested on 1.21)
• Server Type: Spigot, Paper, or compatible forks
• Dependencies: None (standalone plugin)

🎨 Customization

The plugin supports extensive customization through configuration files:

• config.yml: Main configuration for abilities, runes, and gameplay mechanics
• reroll.yml: Configuration for reroll token crafting and appearance
• Custom Model Data: Support for custom item models and textures

🚀 Future Development

Planned features include:

• Additional elemental foundations
• Advanced ability combinations
• Foundation-specific achievements
• Enhanced visual effects
• Cross-server foundation persistence

---

FoundationsAbilities transforms your Minecraft server into an immersive elemental magic experience with deep progression systems, strategic combat mechanics, and extensive customization options. Perfect for roleplay servers, survival games, or any server looking to add magical elements to gameplay.