📚 DARK EVOLUTION SYSTEM

Quick Description

The Dark Evolution System is an automatic event where monsters evolve by combining! When two monsters of the same level meet, they merge into a stronger evolved version. The event spawns monsters across multiple maps, and as they evolve through 7 levels, they drop better rewards. Players must hunt them before they become too powerful!

---

How it works

• Event runs automatically at scheduled times throughout the day
• Monsters spawn across configured maps (Lorencia, Devias, Noria, etc.)
• When 2 monsters of the same level get close, they merge into a stronger evolved form
• Evolution chain: Level 1 → Level 2 → Level 3 → Level 4 → Level 5 → Level 6 → Level 7 (Final Boss)
• Each evolution level drops better rewards
• Announcements warn players before event starts and ends
• Final evolved bosses drop the best rewards

---

Main settings & commands

• Enable/disable: Config.Switch = true/false
• Event schedule: Config.EventDate = {...} (supports multiple daily times)
• Announce time: Config.AnnounceTime = 60 (seconds before start)
• Event duration: Config.EventTime = 360 (seconds)
• Total monsters spawned: Config.SpawnCount = 300
• Evolution levels: 7 levels configured in Config.MonsterConfig

---

Quick config (DarkEvolutionConfig.lua)

Config = {
    Switch = true, -- Enable/disable system
    
    -- Event schedule (supports multiple times per day)
    EventDate = {
        {Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 02, Minute = 40},
        {Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 09, Minute = 55},
        {Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 14, Minute = 15},
        {Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 22, Minute = 55},
    },
    
    AnnounceTime = 60, -- Warning time in seconds before event starts
    EventTime = 360, -- Event duration in seconds (6 minutes)
    
    -- Maps where monsters will spawn
    Maps = {
        {Map = 0, MapXMin = 10, MapYMin = 10, MapXMax = 240, MapYMax = 240}, -- Lorencia
        {Map = 2, MapXMin = 10, MapYMin = 10, MapXMax = 240, MapYMax = 240}, -- Devias
        {Map = 3, MapXMin = 10, MapYMin = 10, MapXMax = 240, MapYMax = 240}, -- Noria
    },
    
    SpawnCount = 300, -- Total monsters spawned
    
    -- Monster evolution chain (7 levels)
    MonsterConfig = {
        [1] = { -- Level 1 - Starting monster
            ID = 650, -- Monster ID
            Reward = {
                RandomItem = {
                    {Section = 14, ID = 13, Durability = 1}, -- Bless
                    {Section = 14, ID = 14, Durability = 1}, -- Soul
                    {Section = 12, ID = 15, Durability = 1}, -- Jewel of Chaos
                }
            }
        },
        [2] = { -- Level 2
            ID = 87,
            Reward = {
                Random = 3, -- Drops 3 random items
                RandomItem = {
                    {Section = 14, ID = 13, Durability = 1},
                    {Section = 14, ID = 14, Durability = 1},
                    {Section = 12, ID = 15, Durability = 1},
                }
            }
        },
        [3] = { -- Level 3
            ID = 88,
            Reward = {
                RandomItem = {
                    {Section = 14, ID = 13, Durability = 5}, -- 5x Bless
                    {Section = 14, ID = 14, Durability = 5}, -- 5x Soul
                }
            }
        },
        [7] = { -- Level 7 - Final Boss (best rewards)
            ID = 161,
            Reward = {
                Item = { -- Guaranteed drops
                    {Section = 14, ID = 33}, -- 2x Jewel of Life
                    {Section = 14, ID = 33},
                    {Section = 14, ID = 446}, -- 8x Premium items
                    {Section = 14, ID = 446},
                    {Section = 14, ID = 446},
                    {Section = 14, ID = 446},
                }
            }
        }
    },
}

---

Event schedule explained

EventDate = {
    {Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 02, Minute = 40},
    -- -1 = Any (Year/Month/Day/DayOfWeek)
    -- DoW: 0=Sunday, 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday
}

Example: Event at 14:15 every day

{Year = -1, Month = -1, Day = -1, DoW = -1, Hour = 14, Minute = 15}

Example: Event at 20:00 only on Saturdays

{Year = -1, Month = -1, Day = -1, DoW = 6, Hour = 20, Minute = 00}

---

Evolution mechanics

Level	Monster ID	Evolution	Rewards
1	650	2x Lvl 1 = 1x Lvl 2	Basic jewels (1x)
2	87	2x Lvl 2 = 1x Lvl 3	3 random jewels
3	88	2x Lvl 3 = 1x Lvl 4	Better jewels (5x)
4	89	2x Lvl 4 = 1x Lvl 5	2 random jewels (5x)
5	66	2x Lvl 5 = 1x Lvl 6	4 random premium items
6	160	2x Lvl 6 = 1x Lvl 7	6 random premium items
7	161	FINAL BOSS	10 guaranteed items!

---

Reward types explained

Random rewards

Reward = {
    Random = 3, -- Drops 3 random items from the list
    RandomItem = {
        {Section = 14, ID = 13, Durability = 1},
        {Section = 14, ID = 14, Durability = 1},
    }
}

Guaranteed rewards

Reward = {
    Item = { -- Drops ALL items in the list
        {Section = 14, ID = 33}, -- Item 1 (guaranteed)
        {Section = 14, ID = 33}, -- Item 2 (guaranteed)
    }
}

---

Announcement system

The system supports multi-language announcements (English, Portuguese, Spanish):

Strings = {
    StartPlace = {
        "[Dark Evolution] Starts in %s!", -- English
        "[Dark Evolution] Começou em %s!", -- Portuguese
        "[Dark Evolution] Inició en %s!", -- Spanish
        0, -- Message type: 0 = Center screen
        2, -- Broadcast: 2 = All users in room
    },
    WillStart = {
        "[Dark Evolution] Will start in %s in %d minutes.",
        "[Dark Evolution] Acontecerá em %s em %d minutos.",
        "[Dark Evolution] Sucederá en %s en %d minutos.",
        0, -- Message type
        2, -- Broadcast type
    },
}

Message Types:

• 0 = Center of screen (big announcement)
• 1 = System message [Blue]
• 3 = System message [Red]
• 100 = System white (accepts HTML tags)

Broadcast Types:

• 1 = Single user
• 2 = All users in the room
• 3 = All users in connected rooms
• 4 = All users in all rooms (global)

---

Tips for configuration

✅ Adjust spawn count based on server population

SpawnCount = 300, -- 300 monsters for medium servers
SpawnCount = 500, -- 500 monsters for high-pop servers

✅ Configure event times for your timezone

{Hour = 14, Minute = 15}, -- 14:15 (2:15 PM)
{Hour = 22, Minute = 30}, -- 22:30 (10:30 PM)

✅ Customize rewards per evolution level

[7] = { -- Final boss
    Reward = {
        Item = {
            {Section = 14, ID = 33}, -- Add your best rewards here!
        }
    }
}

✅ Select strategic maps for the event

Maps = {
    {Map = 0, MapXMin = 10, MapYMin = 10, MapXMax = 240, MapYMax = 240}, -- Lorencia
    {Map = 2, MapXMin = 10, MapYMin = 10, MapXMax = 240, MapYMax = 240}, -- Devias
}

---

See DarkEvolutionConfig.lua for all parameters and detailed examples.