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

Download: Get the latest JAR file from the releases page
Install: Place the JAR file in your server's plugins folder
Start: Restart your server to generate configuration files
Configure: Edit config.yml and reroll.yml to customize gameplay
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.

Foundations SMP