Files
ScourgeInvasion/README.md
Manmadedrummer a2fbc862d4 Update README.md
2025-06-12 19:03:09 -04:00

89 lines
3.6 KiB
Markdown

# Scourge Invasion
*Event 17 for AzerothCore - Araxia Online*
![Scourge Invasion Banner](banner.jpg)
## Overview
The Scourge Invasion is a custom event implementation for AzerothCore, crafted for Araxia Online. This event brings dynamic gameplay with random mob attacks, challenging bosses, and updated quests, enhancing the World of Warcraft experience.
## Features
- **Dynamic Mob Attacks**: 15% chance for mobs to spawn and attack when changing zones/subzones, scaled to player level.
- **Bosses**: Unique Scourge bosses added permanently to iconic dungeons.
- **Updated Quests**: Replaced Dim `Necrotic Shards (ID 22892)` with `Necrotic Rune (ID 22484)`, removed exploration requirements, and adjusted quest flags.
- **Smart AI**: Enhanced NPC behavior via SmartScripts for mobs like Bone Witch and Spirit of the Damned.
- **Event Integration**: Spawns for bosses and quest givers tied to Event 17, with automatic despawning when the event ends.
- **Lua Scripts**: Includes random attack logic and world announcement scripts.
- **Future Plans**: Potential integration with in-game holiday calendar for enhanced visibility.
## Directory Structure
| Folder | Description |
| --- | --- |
| **BOSSES** | Lua scripts for Scourge Invasion bosses. |
| **LUA** | Scripts for random mob attacks and event world announcements. |
| **SmartScripts** | SQL for Smart AI implementation (Bone Witch, Spirit of the Damned, etc.). *Note: Lumbering Horror disabled due to spawn issues.* |
| **Quest** | Updated quest SQL for Necrotic Rune and flag adjustments. |
| **game_event_Creatures** | SQL for spawning bosses and quest givers tied to Event 17. |
| **Spawns** | SQL for updated NPC quest giver spawn locations. |
## Scourge Invasion Bosses
These bosses are permanently added to dungeons on the Araxia Online server:
| ID | Name | Location |
| --- | --- | --- |
| 28194 | Prince Tenris Mirkblood | Karazhan |
| 14684 | Balzaphon | Stratholme |
| 14695 | Lord Blackwood | Scholomance |
| 14690 | Revanchion | Dire Maul |
| 14693 | Scorn | Scarlet Monastery (Graveyard) |
| 14682 | Sever | Shadowfang Keep |
| 14686 | Lady Falther'ess | Razorfen Downs |
## Random Mobs
These mobs may ambush players during the event:
| ID | Name | Status |
| --- | --- | --- |
| 16423 | Spectral Apparition | Active |
| 16422 | Skeletal Soldier | Active |
| 16379 | Spirit of the Damned | Active |
| 16380 | Bone Witch | Active |
| 14697 | Lumbering Horror | Disabled (spawn issues) |
## Installation
1. Clone or download this repository.
2. Copy the contents of each folder into the corresponding AzerothCore server directories:
- SQL files: Import into your database using a tool like HeidiSQL or phpMyAdmin.
- Lua scripts: Place in the `lua_scripts` folder of your AzerothCore server.
3. Ensure Event 17 is configured in your `game_event` table.
4. Restart your server to apply changes.
## Testing
To test the Scourge Invasion event in-game:
- Start the event: `.event start 17`
- Stop the event: `.event stop 17`
Verify that mobs spawn, bosses are accessible, and quests function as intended.
## Future Enhancements
- Integrate with in-game holiday calendar for automatic event scheduling.
- Fix Lumbering Horror spawn issues.
## Credits
- **Original Scripts**: [Planee](https://github.com/planee/RandomScriptsforAzerothCore)
- **Modifications & Enhancements**: [Manmadedrumemr](https://github.com/araxiaonline)
- **Project Repository**: [Araxia Online](https://github.com/araxiaonline)
## Contributing
We welcome contributions to improve the Scourge Invasion event! Please fork the repository, make your changes, and submit a pull request. Ensure your code follows AzerothCore standards and includes clear documentation.