EventTimerInfo

The EventTimerInfo configuration controls what event information is displayed in the client's Event Timer window. It defines event names and rich tooltip descriptions that help players understand upcoming events, their rewards, and how to participate.

File Location#

Data/Plugins/Events/EventTimerInfo.xml

Overview#

This system provides a modern event timer interface by:

• Displaying event names in the timer window
• Showing rich tooltip descriptions with formatted sections
• Supporting up to 42 different event types (0-41)
• Automatically updating based on server event schedules
• Providing visual states (disabled, waiting, starting soon, active)

The client requests event data from the server on demand, and the server responds with the enabled event list.

Event Index Reference#

Events are organized into three categories:

Core Events (0-13)#

Invasions and Special Events (14-27)#

Slots 14-17 and 21-27 are bound at GameServer startup by each invasion XML's <General EventTimerSlot="N"/> attribute (see Invasions). The mapping below is the shipped default; you can rebind any invasion to any free slot by editing its XML.

Invasions whose XML sets EventTimerSlot="-1" (e.g. 004 - New Year.xml, 005 - Rabbits.xml, 006 - Summer.xml) opt out of the client timer entirely.

Arenas (28-41)#

Default names mirror the shipped short-class labels. Rename freely to match how your server advertises promotions.

Configuration Format#

Tabs#

The window has up to 3 tabs. <Tabs> sets their names and colours, in order. Leave it out to get the default Events / Invasions / Arenas.

<Tabs>
    <Tab Name="Events"    Color="gold"/>
    <Tab Name="Invasions" Color="255,90,60"/>
    <Tab Name="Arenas"    Color="green"/>
</Tabs>

Event Entry#

Tooltip#

<Tooltip> holds <Header> and <Line> elements, drawn top to bottom in file order.

<Tooltip>
    <Header>Blood Castle Info</Header>
    <Line Color="blue">You need Blood Bone and Scroll of Archangel</Line>
    <Line/>
    <Line Color="yellow" Bold="1">Reward:</Line>
    <Line Color="violet">Archangel weapons!</Line>
</Tooltip>

A plain <Line>[Rewards]</Line> (no Color) is drawn as a header too, without the brackets, so older files still look right.

Colours#

Every Color / NameColor attribute takes any of these:

Extra names (no index): gold, cyan, pink.

The indices follow the item tooltip colour order, so numbered colour files from other emulators port over directly. A bad colour is logged in the GameServer console and ignored.

Formatting rules:

• Trailing blank lines are dropped
• Maximum 2047 bytes per tooltip after encoding (each coloured line costs ~10 extra bytes, bold 3). Longer tooltips are cut off and logged at load

Event States#

The server automatically determines event states based on remaining time:

Important Behavior#

Examples#

<Event Index="0" Enabled="true" Name="Blood Castle" NameColor="red">
    <Tooltip>
        <Header Color="orange">Blood Castle Info</Header>
        <Line/>
        <Line Color="blue">Mix Blood Bone + Scroll of Archangel</Line>
        <Line Color="blue">into a Cloak of Invisibility</Line>
        <Line/>
        <Line Color="green">Break the gate, kill the statue and bring</Line>
        <Line Color="green">the Archangel weapon back to win</Line>
        <Line/>
        <Header Color="yellow">Rewards</Header>
        <Line Color="violet" Bold="1">Chance for Archangel weapons!</Line>
    </Tooltip>
</Event>

<!-- Hide Imperial Guardian if your server doesn't run it -->
<Event Index="19" Enabled="false" Name="Imperial Guardian">
    <Tooltip>
        <Line>This event is not available.</Line>
    </Tooltip>
</Event>

<!-- Simple arena description -->
<Event Index="28" Enabled="true" Name="Survivor Arena">
    <Tooltip>
        <Line>[Description]</Line>
        <Line></Line>
        <Line>Free-for-all PvP arena.</Line>
        <Line>Last survivor wins!</Line>
        <Line></Line>
        <Line>[Rules]</Line>
        <Line>- No potions or buffs</Line>
        <Line>- Pure skill combat</Line>
    </Tooltip>
</Event>

<!-- Custom invasion event -->
<Event Index="21" Enabled="true" Name="Ice Queen">
    <Tooltip>
        <Line>[Description]</Line>
        <Line></Line>
        <Line>The Ice Queen invades the server!</Line>
        <Line>Defeat her for amazing rewards.</Line>
        <Line></Line>
        <Line>[Location]</Line>
        <Line>Random spawns in Lorencia</Line>
        <Line></Line>
        <Line>[Rewards]</Line>
        <Line>- Jewel of Guardian</Line>
        <Line>- Frozen equipment</Line>
        <Line>- Massive experience</Line>
    </Tooltip>
</Event>

Tooltip Design Guidelines#

Structure Your Tooltips#

Use a consistent pattern across all events:

1. Description - What is this event?
2. Requirements/Location - How to access it
3. Rewards - What players can earn
4. Rules/Strategy - Special mechanics

Use Clear Headers#

<Header>Description</Header>   <!-- Main event explanation -->
<Header>How to Enter</Header>  <!-- Access requirements -->
<Header>Rewards</Header>       <!-- Loot information -->
<Header>Rules</Header>         <!-- Special mechanics -->
<Header>Location</Header>      <!-- Where it happens -->

Pick one colour per kind of line and keep it across all events (e.g. blue = how to enter, green = how it plays, yellow = rewards). Players learn the pattern.

Keep It Concise#

• Each line should be 40-50 characters max for readability
• Use bullet points (- or •) for lists
• Break long paragraphs into multiple lines
• Use empty lines sparingly for section breaks

Good Tooltip Example#

<Tooltip>
    <Header Color="orange">Illusion Temple Info</Header>
    <Line/>
    <Line Color="green">Team-based capture event. Carry the</Line>
    <Line Color="green">Sacred Ball to the enemy pedestal.</Line>
    <Line/>
    <Header Color="yellow">Rewards</Header>
    <Line>- Illusion Shard Points</Line>
    <Line>- Special armor sets</Line>
</Tooltip>

Common Issues#

Related Configuration#

Behavior#

Event Time Sources#

Different events pull their countdown from different places:

• Most scheduled events read their next-start time from the GameServer's event scheduler
• State-driven events (Kanturu, Crywolf, Castle Siege, Raklion, Imperial Guardian) read their current state directly from the event system
• Invasion slots (14-27) and Custom Arena slots (28-41) each have their own timers

Loading#

At startup the plugin reads Data/Plugins/Events/EventTimerInfo.xml, validates each <Event> Index (0-41), and stores the enable flag, name, and tooltip lines. A malformed or missing file falls back to hardcoded defaults so the event timer UI never shows blank data.