New Features & System Overhaul

Centralized Leveling System

• LevelUtils Implementation: Consolidated XP logic into a central utility, ensuring identical progression curves across Players, Guilds, Professions, Spells, and Pets.
• Dynamic XP Formulas: XP progression is now fully configurable in config.yml using base values and exponents.
• System Integration: Migrated all major modules (XPManager, SpellSystem, ProfessionSystem, etc.) to the new centralized calculation engine.

Guild Progression 2.0

• XP Sharing: Guild members now automatically contribute a portion of their earned XP to the guild (standard 10%).
• Leveling Rewards: Implemented level-up triggers for guilds, including server-wide notifications and sound effects for members.
• Guild Scaling: Guild XP requirements now follow the same configurable curve as other systems.

Admin & Technical Improvements

• Admin GUI Polish: Resolved localization issues where technical strings (MemorySections) were displayed instead of proper titles.
• Full Admin Localization: Completed the translation of the Player Manager, Economy Manager, and Guild Manager for both English and German.
• Code Maintenance: Refactored multiple manager classes to eliminate redundant XP calculation logic and improve maintainability.
• Bug Fixes: Fixed "Message not found" errors in the Admin Dashboard across all modules.

New Features & HUD Redesign

Visual Overhaul

• Integrated Mana Bar: A permanent, graphical Mana bar has been added to the Action-Bar (above the hotbar). This replaces the old BossBar system for a cleaner screen.
• Scoreboard Experience: Experience points (current and required) are now prominently displayed in the Sidebar Scoreboard for better visibility.
• Simplified HUD: BossBars for Health, Mana, and XP have been removed, centralizing all status information in the Action-Bar.

Performance Boost

• Language Caching: Implemented a high-performance caching system for translated messages, significantly reducing CPU load during HUD updates.
• Data Caching: Quest progress and XP calculations are now cached in memory to minimize database and computational overhead.
• HUD Optimization: Action-Bar update intervals increased to 5 ticks (250ms) for better server performance without loss of visual fluidity.

Stability Improvements

• Dungeon World Manager: Enhanced world availability detection with a direct Bukkit-fallback and extended timeout (15s) to ensure reliable player teleportation.
• Quest Listener: Optimized movement event processing to reduce unnecessary calculations during exploration quests.

Fixes & Technical Polish

• Skill System Logic: Fixed a critical issue where ability selection and info display failed due to localized name mismatches.
• Localization Cleanup: Added missing language keys for the Skill Info GUI and HUD in both English and German.
• Dungeon Localization: Added missing language keys for all /dungeon subcommands.
• GUI Consistency: Removed remaining hardcoded color codes and strings from various selection menus (AutoPickup, Race, etc.).

New Features

Integrated Economy System

• Implemented a fully autonomous financial system.
• Custom currency (₲) with configurable symbol and position.
• Vault integration for seamless connection with other economy plugins.
• New commands: /money, /pay, and /eco for admins.
• Integrated with Quests, Achievements, and Shops.

Attribute System

• Added 4 core player attributes: Strength, Dexterity, Intelligence, and Vitality.
• Attributes influence combat damage, speed, mana, and health.
• Spend attribute points gained from leveling up.
• Visual display in the enhanced MMO Stats GUI.

Guilds 2.0

• Introduced Guild XP and Leveling system.
• Guilds now progress and grow over time.
• Passive boosts for guild members based on guild level.
• Updated Guild GUI with level and XP bars.

Enhanced Dungeon System

• Added new room types: Treasure Chambers and Mini-Boss rooms.
• Treasure Chambers feature loot pedestals with rare items.
• Advanced Trap System: TNT plates, Lava pits, and Arrow dispensers.
• Improved corridor generation with walls and better height clearance.
• Loot scaling based on dungeon level.

Quest System Upgrade

• New quest types: BOSS_KILL, TIMED_KILL, EXPLORE, and INTERACT.
• Refactored progress logic to support complex data (e.g., MATERIAL:AMOUNT).
• Improved automatic quest completion detection.

Full Localization

• Complete English and German translations for all messages and GUIs.
• Language choice configurable in config.yml.
• Replaced all hardcoded strings with dynamic translation keys.

Fixes & Improvements

• Room Generator: Fixed critical bug where rooms were filled with stone.
• Command Structure: Centralized all systems via the SystemManager singleton.
• Stability: Resolved race conditions during dungeon world creation.
• Performance: Optimized database queries for player data loading.

New Features

Mana System

• Implemented comprehensive mana system for active skills
• Mana regeneration over time (configurable rate)
• Maximum mana scales with player level
• Mana display in BossBar HUD (blue bar)
• Database persistence for player mana data
• Configurable base mana, level multiplier, and regeneration rate

Skill Effect System

• New JSON-based skill effect model for flexible effect definitions
• Support for multiple effect types:
  • Damage boost
  • Defense boost
  • Speed boost
  • Health boost
  • Mana boost
  • Regeneration
  • Strength boost (PotionEffect)
  • Resistance boost (PotionEffect)
• Level-based effect scaling with multipliers
• Permanent and temporary effect support

Skill Types

• PASSIVE Skills: Automatically active, permanent bonuses
• ACTIVE Skills: Manual activation with cooldowns and mana costs
• TRIGGER Skills: Automatic activation based on combat events
• AURA Skills: Radius-based effects for team support

Active Skill Management

• New ActiveSkillManager for skill activation
• Cooldown system for active skills (30-300 seconds)
• Mana cost system (20-100 mana per skill)
• Database persistence for cooldowns and active effects
• New command: /skill activate <skill_name>
• Tab completion for skill names

Trigger Skills

• New SkillListener for event-based skill activation
• Trigger types:
  • on_damage_taken - When player takes damage
  • on_damage_dealt - When player deals damage
  • on_kill - When player kills an enemy
  • low_health - When health drops below 25%
  • on_death - When player dies
• Automatic effect application based on combat events

Aura Skills

• Radius-based skill effects (10-15 blocks)
• Affects all players within range (including caster if configured)
• Continuous effect application
• Automatic updates every second

Skill Respeccing

• New command: /skill reset
• Reset all skills and refund skill points
• Configurable cost system (default: 1000 gold)
• Automatic removal of all active skill effects
• Database cleanup on reset

Skill Combinations (Combos)

• New SkillComboSystem for combo detection
• 5-second combo window for skill activation
• Sequence-based combo recognition
• Special combo effects when skills are activated in sequence
• Visual feedback (particles and sounds) on combo activation
• Database storage for combo definitions

Expanded Skill Trees

• Increased from 3 to 12+ skills per class
• Total of 120+ skills across all 10 classes
• 5-tier skill structure (Tier 1-5)
• Complex prerequisite chains
• Class-specific skill trees:
  • Warrior: 12 skills (Combat, Defense, Berserker abilities)
  • Mage: 12 skills (Spell power, Mana efficiency, Magic abilities)
  • Archer: 12 skills (Precision, Agility, Ranged combat)
  • Rogue: 12 skills (Stealth, Critical strikes, Evasion)
  • Paladin: 12 skills (Defense, Healing, Divine protection)
  • Necromancer: 12 skills (Dark power, Soul manipulation, Death magic)
  • Plus 4 additional classes with 12 skills each

Technical Improvements

New Classes

• ManaManager - Mana system management
• SkillEffect - JSON-based effect model
• SkillEffectHandler - Effect application system
• ActiveSkillManager - Active skill management
• SkillComboSystem - Combo detection and activation
• DungeonWorldManager - Dungeon instance world management
• DungeonGenerator - Procedural dungeon generation
• RoomGenerator - Room generation system
• FeaturePlacer - Feature placement (bosses, loot, etc.)
• PortalSystem - Block-based portal system
• PortalBlockListener - Portal interaction handling
• DungeonAdminGUI - Admin interface for dungeon management
• SkillListener - Event-based trigger skills

Database Changes

• New table: player_mana - Stores player mana data
• New table: player_active_skills - Stores cooldowns and active effects
• New table: skill_combos - Stores skill combination definitions
• New table: dungeon_worlds - Stores dungeon instance world mappings
• New table: dungeon_portals - Stores portal locations and data

Configuration

• New mana section in config.yml:
  • base-mana - Starting mana (default: 100.0)
  • level-multiplier - Mana per level (default: 10.0)
  • base-regeneration - Mana per second (default: 1.0)
  • regeneration-interval - Ticks between regeneration (default: 20)
• New skill section in config.yml:
  • respec-cost - Cost to reset skills (default: 1000)
  • respec-cost-type - Type of cost: "money" or "points" (default: "money")
• New dungeon section in config.yml:
  • max-instances - Maximum concurrent instances (default: 10)
  • instance-timeout - Instance timeout in seconds (default: 3600)
  • world-prefix - Prefix for dungeon world names (default: "dungeon_")
  • generator.grid-size - Generation grid size (default: 20)
  • generator.room-size-min/max - Room size range (default: 5-15)
  • generator.corridor-width - Corridor width (default: 3)
  • generator.features.* - Enable/disable features (boss-rooms, loot-chests, puzzles, traps, mob-spawners)
  • portal.block-type - Portal block type (default: "END_PORTAL_FRAME")
  • portal.activation-radius - Portal activation radius (default: 2)
  • portal.cooldown-seconds - Portal cooldown (default: 5)

Dependencies

• Added Gson dependency for JSON parsing
• Relocated Gson to com.advancemmo.libs.gson to avoid conflicts
• Multiverse-Core integration for dungeon world management (required for dungeons)

Integration

• Mana system integrated into player lifecycle (join/quit/level-up)
• Passive skills automatically applied on login and level-up
• HUD updated to display mana bar
• Scoreboard updated to show mana
• Skill effects cleared on player quit

Commands

New Commands

• /skill activate <skill_name> - Activate an active skill
• /skill reset - Reset skill tree and refund points (costs money)
• /dungeon list - List all available dungeons
• /dungeon enter <name> - Enter a dungeon (creates instance)
• /dungeon exit - Exit current dungeon
• /dungeon info <name> - Show dungeon information
• /dungeon createportal <name> - Create portal at location (Admin)
• /dungeon admin - Open admin GUI for dungeon management (Admin)

Updated Commands

• /skill - Enhanced GUI with skill types, cooldowns, and mana costs
• /skill gui - Same as /skill

Gameplay Changes

• Players now need mana to use active skills
• Active skills have cooldowns to prevent spam
• Passive skills are always active once unlocked
• Trigger skills activate automatically in combat
• Aura skills provide team support in group activities
• Skill combinations reward strategic skill usage
• More skill points required for complete skill tree (12+ skills per class)

Bug Fixes

• Fixed skill effect persistence issues
• Improved skill upgrade validation
• Fixed mana regeneration not working on server restart
• Fixed passive skills not applying on first login
• Improved cooldown tracking accuracy

Documentation

• Completely rewritten Skills Guide with all new features
• Updated Configuration Guide with mana, skill, and dungeon settings
• Added new Dungeons Guide with complete dungeon system documentation
• Updated Database Guide with new dungeon tables
• Updated API Methods with dungeon system API
• Updated Permissions Guide with dungeon permissions
• Expanded API Documentation with new managers and methods
• Added Skill and Mana Events to API documentation
• Updated Getting Started Guide with skill system basics

Breaking Changes

• Existing skill data may need migration (automatic on first load)
• Old skill definitions replaced with new JSON-based system
• Skill point costs may have changed for existing skills
• Mana system is now required for active skills (was optional before)

Future Plans

• Additional skill effects and combinations
• Skill presets and templates
• Skill sharing between players
• Advanced combo system with more complex sequences
• Skill mastery system
• Skill quests and challenges

Version 1.0.0 - Initial Release

Initial release of AdvanceMMO with basic MMO features:

• Class and Race system
• Basic skill tree (3 skills per class)
• Quest system
• Profession system
• Achievement system
• Daily rewards
• Trading system
• Crafting system
• HUD system
• Guild system