> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/event/illusiontemple.md).

# IllusionTemple.dat

Illusion Temple event: 6-tier PvP team dungeon. Entry timing, scheduled start times, per-tier experience for winning/losing team, and per-tier coin rewards.

## File Location

```
Data/Event/IllusionTemple.dat
```

Loaded once at GameServer startup. Gated by [Event.dat](/docs/gameserver/event-dat.md#illusion-temple) `IllusionTempleEvent`. Changes require a restart.

## Sections

### Section 0 - Timing

```
0
//WarningTime   NotifyTime   EventTime   CloseTime
5               1            15          4
end
```

Minutes.

* `WarningTime` - minutes before start to announce and allow entry.
* `NotifyTime` - pre-match preparation window once slots are open.
* `EventTime` - active match duration.
* `CloseTime` - post-match cleanup window before the instance recycles.

### Section 1 - Schedule

```
1
//Year   Month   Day   DoW   Hour   Minute   Second
*        *       *     *     1      30       0
...
end
```

Wildcards (`*`) mean "any". Each row is one scheduled start time. Shipped: six runs per day (01:30, 05:30, 09:30, 13:30, 17:30, 21:30).

### Section 2 - XP Rewards

```
2
//Level   ExperienceTable1   ExperienceTable2
0         300000             50000
1         340000             60000
...
end
```

| Column             | Effect                                         |
| ------------------ | ---------------------------------------------- |
| `Level`            | IT tier (0-5 = Illusion Temple 1-6)            |
| `ExperienceTable1` | XP granted to every member of the winning team |
| `ExperienceTable2` | XP granted to every member of the losing team  |

Granted XP is further multiplied by the per-account-level `AddEventExperienceRate` before being applied. Six rows are required (one per tier).

### Section 3 - Coin Rewards

```
3
//Level   WC   WP   GP
0         10   0    0
1         10   0    0
...
end
```

Per-tier coin payout granted on match completion to participants with a non-zero reward row. Four columns per row; six rows (one per tier). Shipped default: 10 WC per tier, nothing on WP/GP.

| Column  | Effect                   |
| ------- | ------------------------ |
| `Level` | IT tier (0-5)            |
| `WC`    | WCoin amount             |
| `WP`    | WCoin Premium (P) amount |
| `GP`    | GoblinPoint amount       |

## Entry Rules

Entry is validated server-side on the enter request and enforces:

* Event enabled in Event.dat.
* Inventory slot of the ticket is valid.
* Character carries either a tier-matched Ticket of Illusion (item 13,51 with level == tier+1) or a Scroll of Blood (item 13,61, any tier).
* Character meets the tier bracket bounds. Bounds are [configurable per tier](/docs/gameserver/event-dat.md#bracket-entry-gates) on level, reset, grand reset, and master reset; vanilla hardcoded brackets are used when every `IllusionTempleTier<N>...` key is `-1`. When any tier is configured, the bracket table is synced to the client and rendered in the entry dialog and in the Ticket of Illusion / Scroll of Blood item tooltips (the same style as the Armor of Guardsman tier table). `IllusionTempleMasterAnyTier = 1` lets masters bypass per-tier bounds, and `IllusionTemplePerIpCharCap` limits same-IP characters across all tiers.
* Not in a party, no active duel, not in a personal shop, not in a guild war.
* PK level below 4 unless `PKLimitFree` is set in Event.dat.
* Character is not mid class-change.
* Target map server is online.
* The tier accepts entries (WarningTime window is active).

On success, the character is moved to the tier map (gate 142 for tier 1 through gate 147 for tier 6) and the ticket durability is decreased by 1; Scroll of Blood is fully consumed.

## Team Layout

* Two teams per instance: Yellow (team 0) and Blue (team 1).
* Up to 10 players total per instance, 5 per team (slot-allocated server-side on entry).
* A match starts only when each team has at least `IllusionTempleMinUser / 2` players; otherwise the instance returns to the empty state.

## Cross-File Dependencies

| Value                      | Related in                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------ |
| Enable flag                | [Event.dat](/docs/gameserver/event-dat.md) `IllusionTempleEvent`                           |
| Min participants           | [Event.dat](/docs/gameserver/event-dat.md) `IllusionTempleMinUser`                         |
| Fenrir drop chance         | [Event.dat](/docs/gameserver/event-dat.md) `IllusionTempleRewardFenrirRate` (out of 10000) |
| Entry tickets              | [ChaosMix plugin](/docs/data/plugins/chaosmix/recipes.md) (Illusion Temple entry recipes)  |
| Damage scaling             | [Character.dat](/docs/gameserver/character-dat.md) `IllusionTempleDamageRate`              |
| Maps 45-50                 | [MapManager.xml](/docs/data/mapmanager.md)                                                 |
| Monsters used inside tiers | [Monster.txt](/docs/data/monster/monster.md)                                               |
| Reward bags 56-61          | [EventItemBag](/docs/data/eventitembag.md)                                                 |

## Common Issues

* **Team balance issues** - `IllusionTempleMinUser` too low; raise to force more participants. Per-team requirement is `IllusionTempleMinUser / 2`.
* **Fenrir never drops on victory** - `IllusionTempleRewardFenrirRate` is out of 10000, not 100. Shipped `5` = 0.05%; raise to `500` for 5%.
* **Losing team gets no XP** - section 2 `ExperienceTable2` is zero for that tier.
* **No coin reward** - section 3 row is all zeroes for that tier; set any of WC/WP/GP above zero to trigger the payout.
* **Players cannot enter** - tier requires the tier-matched Ticket of Illusion (level field must equal tier+1) or a generic Scroll of Blood; a party member, duelist, or PK4+ character is rejected.