AzerothCore-RealmMaster/import

Import Directory

This directory allows you to easily import custom database files and configuration overrides into your AzerothCore server.

📁 Directory Structure

import/
├── db/          # Database SQL files to import
├── conf/        # Configuration file overrides
└── pdumps/      # Character dump files to import

🗄️ Database Import (import/db/)

Place your custom SQL files here to import them into the database on server startup or deployment.

Supported Files

• auth.sql - Authentication database updates
• characters.sql - Character database updates
• world.sql - World database updates
• *.sql - Any other SQL files will be imported automatically

Usage

1. Place your SQL files in import/db/:

   cp my_custom_npcs.sql import/db/world.sql
   cp my_accounts.sql import/db/auth.sql
   

2. Deploy or restart your server:

   ./scripts/bash/import-database-files.sh
   

Example Files

See import/db/examples/ for sample SQL files.

⚙️ Configuration Import (import/conf/)

Place module configuration files here to override default settings.

Supported Files

Any .conf file placed here will be copied to the server's config directory, overriding the default settings.

Common Configuration Files

• worldserver.conf - Core world server settings
• authserver.conf - Authentication server settings
• playerbots.conf - Playerbot module settings
• AutoBalance.conf - AutoBalance module settings
• Any other module .conf file

Usage

1. Create or copy a configuration file:

   cp storage/config/playerbots.conf.dist import/conf/playerbots.conf
   

2. Edit the file with your custom settings:

   AiPlayerbot.MinRandomBots = 100
   AiPlayerbot.MaxRandomBots = 200
   

3. Apply the configuration:

   ./scripts/bash/configure-server.sh
   

   Or use the Python config tool for advanced merging:

   python3 scripts/python/apply-config.py
   

Configuration Presets

Instead of manual configuration, you can use presets from config/server-overrides.conf:

[worldserver.conf]
Rate.XP.Kill = 2.0
Rate.XP.Quest = 2.0

[playerbots.conf]
AiPlayerbot.MinRandomBots = 100
AiPlayerbot.MaxRandomBots = 200

See config/CONFIG_MANAGEMENT.md for detailed preset documentation.

🎮 Character Import (import/pdumps/)

Import character dump files from other AzerothCore servers.

Supported Formats

• .pdump - Character dump files from .pdump write command
• .sql - SQL character dump files

Quick Start

1. Place character dump files in import/pdumps/
2. Run the import script:

   ./scripts/bash/import-pdumps.sh --password your_mysql_password --account target_account
   

Advanced Configuration

Create import/pdumps/configs/filename.conf for per-character settings:

account=target_account
name=NewCharacterName  # Optional: rename
guid=5000             # Optional: force GUID

📖 For complete character import documentation, see import/pdumps/README.md

🔄 Automated Import

Both database and configuration imports are automatically handled during:

• Initial Setup: ./setup.sh
• Deployment: ./deploy.sh
• Module Staging: ./scripts/bash/stage-modules.sh

📝 Notes

• Files in import/ are preserved across deployments
• SQL files are only imported once (tracked by filename hash)
• Configuration files override defaults but don't replace them
• Use .gitignore to keep sensitive files out of version control

🚨 Best Practices

1. Backup First: Always backup your database before importing SQL
2. Test Locally: Test imports on a dev server first
3. Document Changes: Add comments to your SQL files explaining what they do
4. Use Transactions: Wrap large imports in transactions for safety
5. Version Control: Keep track of what you've imported

📚 Related Documentation

• Character Import Guide - Complete pdump import documentation
• Database Management
• Configuration Management
• Module Management