1948b0b3d4
• Enhanced backup-scheduler.sh with detailed performance metrics: - Per-database timing and compression statistics - Overall backup throughput and duration tracking - Performance warnings for slow backups (>30min/>1hr) - Completion markers to prevent incomplete backup copies • Added BACKUP_INTERVAL_MINUTES configuration (default 60): - Replaces fixed hourly scheduling with flexible intervals - Supports any interval from 1 minute to hours - Maintains daily backup scheduling at configured time • New verify-backup-complete.sh script: - Checks backup completion before copying/processing - Supports waiting with timeout for active backups - Backward compatible with manifest validation • Enhanced backup manifests with performance data: - Duration, compression ratio, throughput metrics - Enables historical performance trend analysis - Portable implementation using awk instead of bc Tested with 5-minute intervals over 18+ hours: - 218 successful backups, 0 failures - Consistent 82.1% compression, 52MB/s throughput - Production-ready backup monitoring infrastructure
AzerothCore RealmMaster
A complete containerized deployment of AzerothCore WoW 3.3.5a (Wrath of the Lich King) private server with 93+ enhanced modules and intelligent automation.
Table of Contents
- Quick Start
- What You Get
- Getting Started → docs/GETTING_STARTED.md
- Complete Module Catalog → docs/MODULES.md
- Management & Operations → docs/GETTING_STARTED.md
- Advanced Configuration → docs/ADVANCED.md
- Custom NPCs Guide → docs/NPCS.md
- Script Reference → docs/SCRIPTS.md
- Troubleshooting → docs/TROUBLESHOOTING.md
- Credits & Next Steps
Quick Start
Prerequisites
- Docker with Docker Compose
- 16GB+ RAM and 32GB+ storage
- Linux/macOS/WSL2 (Windows with WSL2 recommended)
Three Simple Steps
# 1. Get the code
git clone https://github.com/uprightbass360/AzerothCore-RealmMaster.git
cd AzerothCore-RealmMaster
# 2. Configure your server
./setup.sh
# 3. Deploy
./deploy.sh # Always required - Supports ssh remote deploy or local
./status.sh # Optional - Shows health and accesibility of all containers and current user data
First deployment takes 30-60 minutes for database setup and client data download. Subsequent starts are much faster.
See Getting Started for detailed walkthrough.
What You Get
✅ Core Server Components
- AzerothCore 3.3.5a - WotLK server application with 93+ enhanced modules
- MySQL 8.0 - Database with intelligent initialization and restoration
- Smart Module System - Automated module management and source builds
- phpMyAdmin - Web-based database administration
- Keira3 - Game content editor and developer tools
✅ Automated Configuration
- Intelligent Database Setup - Smart backup detection, restoration, and conditional schema import
- Backup Management - Automated hourly/daily backups with intelligent restoration
- Module Integration - Automatic source builds when C++ modules are enabled
- Service Orchestration - Profile-based deployment (standard/playerbots/modules)
Getting Started
Quick Overview:
- Clone repository →
./setup.sh→./build.sh(if needed) →./deploy.sh - Create admin account and connect your WoW 3.3.5a client
- Access management tools at http://localhost:8081 (phpMyAdmin) and http://localhost:4201 (Keira3)
For complete local and remote deployment guides, see docs/GETTING_STARTED.md.
Complete Module Catalog
Choose from 93+ enhanced modules spanning automation, quality-of-life improvements, gameplay enhancements, PvP features, and more. All modules are automatically downloaded, configured, and integrated during deployment.
Popular Categories:
- Automation - Playerbots, AI chat, level management
- Quality of Life - Solo LFG, AOE looting, auto-revive
- Gameplay - Autobalance, challenge modes, hardcore mode
- Services - Transmog, profession NPCs, talent templates
Browse the complete catalog with descriptions at docs/MODULES.md.
Custom NPCs Guide
The server includes 14 custom NPCs providing enhanced functionality including profession training, enchantments, arena services, and more. All NPCs are spawnable through GM commands and designed for permanent placement.
Available NPCs:
- Service NPCs - Profession training, reagent banking, instance resets
- Enhancement NPCs - Enchanting, buffing, pet management, transmog
- PvP NPCs - 1v1 arena battlemaster
- Guild House NPCs - Property management and services
For complete spawn commands, coordinates, and functionality details, see docs/NPCS.md.
Management & Operations
For common workflows, management commands, and database operations, see docs/GETTING_STARTED.md.
Advanced Configuration
For architecture details, storage structure, build system, and advanced customization, see docs/ADVANCED.md.
Script Reference
For comprehensive documentation of all deployment scripts, management commands, and automation tools, see docs/SCRIPTS.md.
Troubleshooting
For diagnostic procedures, common issues, and backup system documentation, see docs/TROUBLESHOOTING.md.
Credits & Next Steps
Project Credits
This project builds upon:
- AzerothCore - Core server application
- AzerothCore Module Community - Enhanced gameplay modules
Key Features
- ✅ Fully Automated Setup - Interactive configuration and deployment
- ✅ Intelligent Module System - Automatic source builds and profile selection
- ✅ Automated Backups - Health checks, scheduled backups, and monitoring
- ✅ Docker-Based - Containerized deployment for easy setup and portability
- ✅ Comprehensive Documentation - Clear setup and troubleshooting guides
Next Steps After Installation
Essential First Steps:
- Create admin account:
docker attach ac-worldserver→account create admin password→account set gmlevel admin 3 -1 - Test your setup: Connect with WoW 3.3.5a client using
set realmlist 127.0.0.1 - Access web tools: phpMyAdmin (port 8081) and Keira3 (port 4201)
For detailed server administration, monitoring, backup configuration, and performance tuning, see docs/GETTING_STARTED.md.