How to Configure Seasonal Events (Halloween, Christmas) on MU Server

Seasonal events like Halloween and Christmas are powerful tools to boost player engagement on your MU Online server. This guide shows how to configure these events in Season 6 (the most common version for private servers), with references for other Seasons where applicable.

Prerequisites

Before you begin, make sure you have:

• Access to SQL Server Management Studio (SSMS) with the MuOnline database reachable
• Access to the server folder, typically C:\MuServer\ or D:\GameServer\
• GameServer stopped during critical file edits
• A recent database backup (see the backup tutorial before proceeding)

Part 1: Configuring the Halloween Event

Step 1 — Locate the event configuration file

In Season 6, the primary event control file is located at:

GameServer\Data\EventChipInfo.ini

Open the file in a text editor (Notepad++ recommended). Find the [HalloweenEvent] section:

[HalloweenEvent]
EventEnable       = 0       ; 0 = disabled, 1 = enabled
EventStartMonth   = 10      ; October
EventStartDay     = 25
EventEndMonth     = 11
EventEndDay       = 2
RewardItemCode    = 7167    ; Reward item code (Halloween Pumpkin)
RewardItemLevel   = 0
RewardItemDur     = 255
RewardAmount      = 1

Change EventEnable = 0 to EventEnable = 1.

Step 2 — Configure Halloween monsters via SQL

Special Halloween monsters (Pumpkin of Luck, Jack o'Lantern) need to be enabled in the database. Execute in SSMS:

USE MuOnline;
GO

-- Check if seasonal monsters exist
SELECT MonsterID, Name, Level
FROM dbo.MonsterInfo
WHERE Name LIKE '%Pumpkin%' OR Name LIKE '%Halloween%';

-- Enable Halloween monster spawns in existing maps
UPDATE dbo.MonsterSetBase
SET Enable = 1
WHERE MonsterID IN (
    SELECT MonsterID FROM dbo.MonsterInfo
    WHERE Name LIKE '%Pumpkin%' OR Name LIKE '%Halloween%'
);

Step 3 — Insert Halloween monsters manually (if needed)

If the monsters do not exist, insert them. Example for Pumpkin of Luck (MonsterID 277) in Lorencia (MapNumber 0):

USE MuOnline;
GO

-- Insert Halloween monster in Lorencia
INSERT INTO dbo.MonsterSetBase
    (MapNumber, MonsterID, X, Y, Dir, PathType, SpawnType, Enable)
VALUES
    (0, 277, 136, 110, 0, 0, 0, 1),  -- Pumpkin of Luck point 1
    (0, 277, 142, 115, 2, 0, 0, 1),  -- Pumpkin of Luck point 2
    (0, 278, 138, 120, 0, 0, 0, 1);  -- Jack o'Lantern point 1

GO

Adjust the X and Y values to match your map layout.

Step 4 — Configure seasonal item drops

To make Halloween monsters drop specific items, edit the file:

GameServer\Data\MonsterItemDrop.ini

Add at the end of the block corresponding to MonsterID 277:

[Monster277]
; Pumpkin of Luck - Halloween drops
ItemDrop0 = 7167,0,255,100   ; ItemCode, Level, Dur, Chance(%)
ItemDrop1 = 7168,0,255,50    ; Halloween Candy
ItemDrop2 = 7169,0,255,25    ; Halloween Spirit

Part 2: Configuring the Christmas Event

Step 5 — Enable the Christmas event in the .ini file

In the same GameServer\Data\EventChipInfo.ini file, locate the [ChristmasEvent] section:

[ChristmasEvent]
EventEnable       = 0       ; 0 = disabled, 1 = enabled
EventStartMonth   = 12
EventStartDay     = 15
EventEndMonth     = 1
EventEndDay       = 5
RewardItemCode    = 7170    ; Christmas Firecracker
RewardItemLevel   = 0
RewardItemDur     = 255
RewardAmount      = 1

Change EventEnable = 0 to EventEnable = 1.

Step 6 — Enable Christmas map decoration

Some Season 6 MuServer builds have a separate file for visual decoration:

GameServer\Data\Maps\ChristmasDecoration.ini

If it exists, configure it:

[MapDecoration]
LorenciaSnow   = 1    ; 1 = snow in Lorencia
NoriaSnow      = 1
DeviasSnow     = 0

If the file does not exist in your version, decoration is handled by the client and requires no server-side configuration.

Step 7 — Configure Christmas seasonal NPCs via SQL

The Santa Claus NPC (GiftShop) needs to be enabled:

USE MuOnline;
GO

-- Check Christmas NPC
SELECT NPID, NpcName, MapNumber, X, Y, Enable
FROM dbo.NpcInfo
WHERE NpcName LIKE '%Santa%' OR NpcName LIKE '%Christmas%';

-- Enable Christmas NPC (replace with the correct NPID)
UPDATE dbo.NpcInfo
SET Enable = 1
WHERE NpcName LIKE '%Santa%';

If the NPC does not exist, insert it in Lorencia (safe position near the center):

INSERT INTO dbo.NpcInfo
    (NpcName, MapNumber, X, Y, Dir, Enable)
VALUES
    ('SantaClaus', 0, 130, 135, 1, 1);

Step 8 — Configure the Santa Claus shop

The seasonal NPC shop is configured in:

GameServer\Data\NpcItem\SantaShop.ini

Basic configuration example:

[SantaShop]
; ItemCode, Level, Dur, Skill, Luck, Option, BuyPrice (Zen or EventCurrency)
Item0  = 7170,0,255,0,0,0,5000000   ; Christmas Firecracker - 5M Zen
Item1  = 7171,0,255,0,0,0,10000000  ; Christmas Gift Box - 10M Zen
Item2  = 7172,0,255,0,0,0,50000000  ; Santa's Special Gift - 50M Zen

Part 3: Automation and Scheduling via SQL Agent

Step 9 — Create a SQL Agent Job to activate/deactivate events automatically

To avoid manually editing files every season, configure a SQL Server Agent Job:

USE msdb;
GO

-- Job to activate Halloween (runs on October 25th)
EXEC sp_add_job
    @job_name = N'Activate_Halloween_Event';

EXEC sp_add_jobstep
    @job_name = N'Activate_Halloween_Event',
    @step_name = N'Enable Halloween monsters',
    @command = N'
        USE MuOnline;
        UPDATE dbo.MonsterSetBase
        SET Enable = 1
        WHERE MonsterID IN (277, 278, 279);
    ';

-- Schedule for 10/25 at 00:01
EXEC sp_add_schedule
    @schedule_name = N'HalloweenSchedule',
    @freq_type     = 8,        -- Weekly
    @freq_interval = 1,
    @active_start_time = 000100;

EXEC sp_attach_schedule
    @job_name      = N'Activate_Halloween_Event',
    @schedule_name = N'HalloweenSchedule';

EXEC sp_add_jobserver
    @job_name = N'Activate_Halloween_Event';
GO

Part 4: Restart and Verification

Step 10 — Apply the changes

1. Save all edited .ini files
2. Stop the GameServer (close the process or use your restart script)
3. Start the GameServer and wait for complete loading
4. Check GameServer\Logs\Server.log — look for lines like:

[Event] HalloweenEvent: Loaded - Active
[Event] ChristmasEvent: Loaded - Inactive

Step 11 — Test the event in-game

Using a GM account, run the following tests:

• /move lorencia → verify Halloween monsters appear on the map
• Kill a Pumpkin of Luck and confirm the seasonal drop falls
• Talk to the Santa Claus NPC and confirm the shop opens with the configured items

Common Troubleshooting

Halloween monsters not appearing on the map:

• Confirm Enable = 1 in the dbo.MonsterSetBase table for the correct MonsterIDs
• Verify EventEnable = 1 in the EventChipInfo.ini file
• Restart the GameServer after any database changes

Christmas NPC not appearing:

• Make sure X, Y coordinates are within the map boundaries (Lorencia: 0-255 on both axes)
• Check that Enable = 1 in the dbo.NpcInfo table

Seasonal drops not falling:

• Confirm ItemCodes in MonsterItemDrop.ini exist in the dbo.ItemInfo table
• Check that Chance values are in the correct scale for your version

Snow decoration not appearing on the client:

• Christmas snow is rendered by the MU client, not the server. Verify the client has the files Data\Effect\Christmas*.bmd present.

Perguntas frequentes