Note

Paragon Anniversary Serverside is now feature-complete and stable! Clientside UI is still in development with some features to complete.

---

⚡ Paragon System

for AzerothCore

Endless progression system - Continue growing beyond max level

---

📊 Status

Component	Status	Notes
Serverside	⚙️ Beta	All core features complete, dual-mode system fully implemented, stabilization in progress
Clientside	🎨 Beta	Core UI functional, features and refinement in progress
Documentation	✅ Complete	Full code docs, architecture guides, and hook specifications

---

⚠️ Platform Availability

Important

The Paragon System is currently available exclusively for AzerothCore (3.3.5a).

We are focusing on ensuring all functionality is stable and bug-free on AzerothCore before expanding to other platforms. This allows us to provide a reliable and well-tested experience.

Future Plans:

• 📅 After stabilization on AzerothCore, a port to ElunaTrinityWotlk is planned
• 🔄 Additional emulator support may follow based on community demand

If you're using a different emulator and interested in compatibility, please open an issue on the project repository.

---

🌟 What's This?

The Paragon System introduces an endgame progression mechanic for AzerothCore servers. After reaching max level, players continue to earn paragon experience and unlock stat bonuses through a point-based talent system.

✨ Key Features

• 📊 Paragon Levels: Unlimited progression beyond max level
• ⚡ Stat Bonuses: Invest points in Combat Ratings, Stats, and Special Auras
• 🎯 Three Categories:
  • Combat: Hit, Crit, Haste, Expertise, Armor Penetration
  • Stats: Strength, Agility, Stamina, Resistances, HP/Mana
  • Auras: Loot, Reputation, and Experience bonuses
• 🎮 Multi-Source Experience: Gain paragon XP from creatures, achievements, quests, and skills
• 💰 Point System: Earn points to distribute among available statistics
• 🔄 Client Integration: In-game interface via custom addon
• 💾 Persistent: All progress saved to database

---

🎬 Preview

Click to watch the Paragon Anniversary demo on YouTube 🎥

---

🏗️ Architecture

📦 Core Components paragon_constant.lua - Constants & SQL queries paragon_repository.lua - Database access layer (Singleton) paragon_config.lua - Configuration service (Singleton) paragon_class.lua - Paragon business logic & state paragon_hook.lua - Event handlers & client communication 🧩 Module System modules/paragon_anniversary.lua - Experience & level-up mechanics Extensible via Mediator pattern for custom features

🗄️ Database Configuration Tables: paragon_config_category - Stat categories paragon_config_statistic - Available stats paragon_config - General settings (key-value pairs) paragon_config_experience_* - Experience rewards by source Character Data (Character-Linked Mode): character_paragon - Player levels & XP per character character_paragon_stats - Invested points per character Account Data (Account-Linked Mode): account_paragon - Account-wide levels & XP character_paragon_stats - Stats always per character

🔄 Dual-Mode System

Configure LEVEL_LINKED_TO_ACCOUNT in paragon_config:

• 0 (Default): Character-linked - Each character has independent progression
• 1: Account-linked - All characters on account share level/XP but have separate stat investments

---

🚀 Quick Installation

Quick Start (3 Steps)

1. 📁 Copy the paragon folder to your ALE scripts directory
2. 🔄 Restart your AzerothCore server (tables auto-create)
3. ⚙️ Configure paragon_config table with your desired settings

📝 Note: Requires ALE engine installed on AzerothCore

📖 Detailed Installation Guide

For complete installation instructions including:

• ✅ Prerequisites and dependencies
• ✅ Step-by-step server setup
• ✅ Database configuration
• ✅ Client-side addon installation
• ✅ Testing and troubleshooting

👉 Read the Full Installation Guide

---

⚙️ Configuration

Configure the system via database entries in paragon_config:

System Control

Field	Description	Default
ENABLE_PARAGON_SYSTEM	Enable/disable the entire system	1
LEVEL_LINKED_TO_ACCOUNT	Character-linked (0) vs Account-linked (1) mode	0
PARAGON_LEVEL_CAP	Maximum paragon level (0 = unlimited)	999
MINIMUM_LEVEL_FOR_PARAGON_XP	Minimum character level to earn paragon XP	0

Progression Settings

Field	Description	Default
BASE_MAX_EXPERIENCE	Base XP per level (multiplied by level)	1000
POINTS_PER_LEVEL	Points awarded per paragon level	1
PARAGON_STARTING_LEVEL	Starting paragon level for new characters	1
PARAGON_STARTING_EXPERIENCE	Starting experience value	0

Experience Rewards

Field	Description	Default
UNIVERSAL_CREATURE_EXPERIENCE	Default XP for creature kills	50
UNIVERSAL_ACHIEVEVEMENT_EXPERIENCE	Default XP for achievements	100
UNIVERSAL_SKILL_EXPERIENCE	Default XP for skill increases	25
UNIVERSAL_QUEST_EXPERIENCE	Default XP for quest completion	75

Experience Multipliers

Field	Description	Default
EXPERIENCE_MULTIPLIER_LOW_LEVEL	Bonus multiplier for low-level paragons	1.5
EXPERIENCE_MULTIPLIER_HIGH_LEVEL	Penalty multiplier for high-level paragons	0.8
LOW_LEVEL_THRESHOLD	Paragon level below which bonus applies	5
HIGH_LEVEL_THRESHOLD	Paragon level above which penalty applies	100

Other Settings

Field	Description	Default
DEFAULT_STAT_LIMIT	Maximum points per individual stat (1-255)	255

Adding Custom Stats

1. Add categories to paragon_config_category
2. Define statistics in paragon_config_statistic
3. Configure type, factor, and limit for each stat

Stat Configuration Fields:

• type: AURA, COMBAT_RATING, or UNIT_MODS
• type_value: The specific stat ID from Constants
• factor: Multiplier for each point invested
• limit: Maximum points that can be invested (max 255)
• application: How the stat bonus is applied

Example Data Available: A complete example configuration with 3 categories and 25+ statistics is provided in sql/11-13-2026_Example_Data.sql. Use this as a reference or load it directly to get started quickly.

---

🎮 Stat Types

⚔️ Combat Rating Weapon Skill Defense / Dodge / Parry / Block Hit (Melee/Ranged/Spell) Crit (Melee/Ranged/Spell) Haste (Melee/Ranged/Spell) Expertise Armor Penetration

💪 Unit Modifiers Primary Stats (Str/Agi/Sta/Int/Spi) Resources (HP/Mana/Rage/Energy/etc) Armor & Resistances Attack Power Damage (Mainhand/Offhand/Ranged)

✨ Aura Bonuses Loot Bonus (1900000) Reputation Gain (1900001) Experience Gain (1900002) Custom aura IDs: 1900000+

---

🔧 Technical Overview

Architecture

• Singleton Pattern: Config and Repository services
• Repository Pattern: Database abstraction layer
• Mediator Pattern: Event-driven extensibility
• Object-Oriented: Using classic.lua library

Key Features

• Async Database: Non-blocking queries
• Manual Migrations: SQL files in sql/ directory
• Client Communication: Custom addon protocol (ParagonAnniversary)
• Extensible: Module system via Mediator events

📖 Detailed Technical Documentation:

• HOOKS.md - Complete Mediator event system
• MODULES.md - Creating custom modules
• LIBRARIES.md - Library documentation

---

📚 Documentation

Complete documentation is available in the doc/ directory:

Document	Description
INSTALL.md	Complete installation guide with SQL setup
HOOKS.md	Mediator event system reference
MODULES.md	Creating custom modules
LIBRARIES.md	Classic, CSMH, and Mediator libraries

All code includes LuaDoc comments for inline documentation.

---

📊 Compatibility

Emulator Support

Emulator	Version	Status	Notes
🎮 AzerothCore	3.3.5a	✅ Supported	Primary development platform
🌙 ElunaTrinityWotlk	3.3.5a	📅 Planned	Port scheduled after AzerothCore stabilization

Required Dependencies

Component	Version	Status
🔧 ALE	Latest	✅ Required
📚 Classic	Any	✅ Required
🔌 CSMH	Any	✅ Required

---

📁 Project Structure

paragon/
├── lib/
│   ├── classic/
│   │   └── classic.ext             # OOP library
│   ├── Mediator/
│   │   └── mediator.lua            # Event system
│   └── CSMH/
│       └── SMH.ext
├── modules/
│   ├── paragon_anniversary.lua     # Experience & level-up mechanics
│   └── README.md                   # Module documentation
├── paragon_constant.lua            # Constants, SQL queries, stat enums
├── paragon_repository.lua          # Database access layer (Singleton)
├── paragon_config.lua              # Configuration service (Singleton)
├── paragon_class.lua               # Paragon entity & business logic
├── paragon_hook.lua                # Event handlers & entry point
└── README.md                       # This file

doc/
├── INSTALL.md                      # Installation guide
├── HOOKS.md                        # Complete hook documentation
├── MODULES.md                      # Module development guide
└── LIBRARIES.md                    # Libraries documentation (Classic, CSMH, Mediator)

sql/
├── 01_create_database.sql          # Database creation
├── 02_create_config_tables.sql     # Configuration tables
├── 03_create_experience_tables.sql # Experience reward tables
├── 04_create_paragon_tables.sql    # Paragon progression tables
├── 05_create_triggers.sql          # Validation triggers
├── 06_insert_default_config.sql    # Default configuration
├── 11-13-2026_Example_Data.sql     # Example categories & statistics
└── README.md                       # SQL installation guide

---

🔄 Data Flow

Player Login
    ↓
Hook.OnPlayerLogin (paragon_hook.lua)
    ↓
Create Paragon Instance (paragon_class.lua)
    ↓
Load Level & Statistics from DB (paragon_repository.lua)
    ↓
Callback: Hook.OnPlayerStatLoad
    ↓
Apply Statistics to Player & Send Data to Client (ParagonAnniversary addon)

---

🎯 Recent Improvements

Latest Features (Latest Release)

• ✅ Dual-Mode System: Character-linked and account-linked paragon progression
• ✅ Mediator Pattern Integration: Extensible event system for custom modules
• ✅ Module System: Modular business logic via paragon_anniversary.lua
• ✅ Robust Error Handling: Fallback defaults for all configuration values
• ✅ Complete Documentation: HOOKS.md with all Mediator events documented
• ✅ Advanced Routing: Runtime table selection based on LEVEL_LINKED_TO_ACCOUNT

Architecture Highlights

• Singleton Pattern: Config and Repository are single instances
• Repository Pattern: Clean database abstraction layer
• Mediator Pattern: Decoupled event-driven architecture
• Object-Oriented Design: Using classic.lua for OOP

---

🏆 Credits

• 🔧 Development: Custom system for AzerothCore
• 🎨 Concept: Inspired by Diablo 3 Paragon systems
• 🙏 Thanks: AzerothCore & ALE communities

---

⚡ Ready to add endless progression?

Stable serverside system ready for production use on AzerothCore with ALE