EntryLimits.xml
Limits how many times an account may enter an event or a dungeon per day and per week. All characters of one account share the count, so alts cannot farm extra entries. Free, built in.
File Location#
Data/Plugins/Events/EntryLimits.xml
Reloads with the other plugins. Needs the SQL migration SQL/Migrations/0005_entry_limit.sql (table EntryLimit).
Schema#
<EntryLimits Enabled="1" ResetHour="0" WeekResetDay="1">
<Limit Event="BloodCastle" MaxPerDay="3" MaxPerWeek="15"/>
</EntryLimits>
| Attribute | Default | Meaning |
|---|---|---|
Enabled | 1 | 0 = no limits anywhere (events and dungeons) |
ResetHour | 0 | Hour (0-23, server local time) when a new day starts |
WeekResetDay | 1 | Day a new week starts: 0 = Sunday, 1 = Monday ... 6 = Saturday (at ResetHour) |
Limit Event | BloodCastle, DevilSquare, ChaosCastle, IllusionTemple, ImperialGuardian, Doppelganger | |
Limit MaxPerDay | 0 | Entries per day. 0 = no daily limit |
Limit MaxPerWeek | 0 | Entries per week. 0 = no weekly limit |
Every limit ships at 0, so nothing changes until you set one.
Dungeons#
Put MaxPerDay / MaxPerWeek on the <Dungeon> of its own file in Data/Plugins/Dungeons/. Days and weeks start as set here.
<Dungeon Name="Forgotten Depths" ... MaxPerDay="5" MaxPerWeek="0">
How it works#
- An entry counts when the player is let in, the moment the ticket or fee is taken.
- A player with no entries left is refused before the ticket is used. They see a centre message and a chat line: which event,
todayorthis week, the count and when it resets. - Imperial Guardian and Doppelganger: the party goes in without a member who has no entries left. That member is told why.
- Dungeons: the dungeon window (L) shows an Entries cell under Requirements: "1/3" for today (or "16/16 wk" once the week is used up), green or red, with today, this week and both reset times in its tooltip. The leader sees "X has no entries left for this dungeon" when a member is out, like the other member checks. Every member who goes in uses one entry, late joiners too.
- Counts load when a character enters the game. Until the DataServer answers, limited entries are refused with "still loading".
- Kalima is not limited.
Event Timer#
Add EntryLimit="<name>" to a row in EventTimerInfo.xml and its tooltip ends with the player's own line, green while entries are left and red when used up:
Entries: 2/3 today, 9/15 this week
<name> is an event name from the table above or a dungeon Name. The shipped file sets it on Blood Castle, Devil Square, Chaos Castle, Illusion Temple and Imperial Guardian. Nothing shows while that limit is 0.