mod-eluna is a powerful, AzerothCore-specific implementation of a Lua scripting engine that enables server administrators and developers to create custom gameplay features, events, and mechanics without modifying the core server code.

• Native AzerothCore Integration: Built specifically for AzerothCore's architecture
• Enhanced API: Extended functionality for AzerothCore, beyond the original Eluna specification.
• Community-Driven Development: Actively maintained with community contributions

mod-eluna is NOT compatible with the original Eluna project. This fork has evolved independently with AzerothCore-specific enhancements and API changes that make scripts non-interchangeable.

If you need to use standard Eluna scripts or maintain compatibility with the original Eluna project, please use the dedicated AzerothCore port available at:

🔗 ElunaAzerothCore

This repository maintains compatibility with the original Eluna API and supports standard Eluna scripts.

• Installation
• Documentation
• API Reference
• Support
• Contributing
• Acknowledgements

• AzerothCore server installation
• Git version control system
• CMake build system

# Navigate to your AzerothCore modules directory
cd <azerothcore-path>/modules

# Clone the mod-eluna repository
git clone https://github.com/azerothcore/mod-eluna.git

# Configure build with your preferred Lua version
cd <azerothcore-build-directory>
cmake ../ -DLUA_VERSION=luajit  # Options: luajit, lua52, lua53, lua54

# Default: If no version is specified, Lua 5.2 will be used

# Rebuild your AzerothCore server
make -j$(nproc)

• LuaJIT (Recommended for performance)
• Lua 5.2 (Default)
• Lua 5.3
• Lua 5.4

• Installation Guide
• Implementation Details

• mod-eluna API Documentation - Complete API reference for mod-eluna
• Hooks Documentation - Available event hooks
• Lua 5.2 Reference - Official Lua language documentation

• GitHub Issues: Report bugs or request features
• Discord Community: Join our Discord server
• AzerothCore Discord: Official AzerothCore support

• Lua Programming Guide
• AzerothCore Documentation

We welcome contributions from the community! Here's how you can help:

graph LR
    A[Fork Repository] --> B[Create Branch]
    B --> C[Make Changes]
    C --> D[Submit PR]
    D --> E[Review Process]

1. Fork the repository
2. Create a feature branch from master
3. Implement your changes with proper testing
4. Follow the existing code style and conventions
5. Submit a pull request with a clear description

mod-eluna is built upon the foundation of the original Eluna project. We acknowledge and thank the original Eluna team for their pioneering work in Lua scripting for World of Warcraft server emulators.

• Original Eluna Repository - The original Eluna project
• Eluna Discord Community - Original Eluna community support
• ElunaAzerothCore - AzerothCore with original Eluna compatibility

• AzerothCore - Primary target (this project)
• TrinityCore - Original Eluna support
• MaNGOS
• cMaNGOS

This project is licensed under the GNU General Public License v3.0. See LICENSE for details.