EventMatching: Events

Part of EventMatching. Events are the core matchable activities in the activity finder — dungeons, battlefields, and field content.

---

DSL section

Section: eventMatchingEvents Operations: create, update, delete, upsert

---

Event properties

Property	Type	Since	Description
eventId	int	v92	Unique event identifier
group	string	v92	Event group: priority or secondary
type	string	v92	Event category (e.g., Dungeon, BattleField)
questId	int	v92	Associated quest ID
categoryId	int	v92	UI category ID
active	bool	v92	Whether the event is active
repeat	bool	v92	Allow repeated completion
requiredItemLevel	int	v92	Minimum item level to participate
image	string	v92	Event image asset path
recommend	bool	v92	Show in recommended list
recommendMaxItemLevel	int	v92	Maximum item level for recommendation
fieldEvent	bool	v92	Mark as field event
additionalSortPriority	int	v92	Sort priority override
requiredFestivalId	int	v92	Required active festival ID
requiredVisitedGuardId	string	v92	Required visited guard ID
action	nested	v92	Action block
targets	list	v92	Target location list
mailSender	string	v92	Reward mail sender string
mailTitle	string	v92	Reward mail title string
mailBody	string	v92	Reward mail body string
rewards	list	v92	Reward compensation list

---

Action

Defines the event’s action behavior.

Property	Type	Since	Description
type	string	v92	Action type (e.g., matching, teleport)
requiredLevel	int	v92	Minimum player level
uiName	string	v92	UI display name reference

---

Target

Location entries for the event. Multiple targets create selectable destinations.

Property	Type	Since	Description
id	string	v92	Target identifier (typically continent ID)
teleportContinentId	string	v92	Teleport destination continent
teleportPos	decimal[]	v92	Teleport coordinates [x, y, z]
zoneNameId	string	v92	Zone name string ID

---

Compensation (reward)

Individual reward entries within the compensation list.

Property	Type	Since	Description
type	string	v92	Reward type (e.g., exp, money, item)
templateId	int	v92	Reward item template ID
amount	int	v92	Reward quantity
npcGuildId	int	v92	NPC guild ID for reputation rewards

---

Event groups

Events are organized into two groups via the group property:

Group	XML Attribute	Description
priority	isSpecialCompensation="false"	Standard event pool
secondary	isSpecialCompensation="true"	Special compensation events

The group field is required for create, update, delete, and upsert operations.

---

Examples

Create with full structure

eventMatchingEvents:
  create:
    - eventId: 800100
      group: priority
      type: Dungeon
      questId: 800100
      categoryId: 800100
      active: true
      repeat: true
      requiredItemLevel: 446
      image: "img://EventMatching_Dungeon_800100"
      recommend: true
      recommendMaxItemLevel: 456
      action:
        type: matching
      targets:
        - id: "9088"
          teleportContinentId: "7002"
          teleportPos: [-5175, 71910, 4610]
          zoneNameId: "@zoneName:9088"
      rewards:
        - type: exp
          templateId: 20000001
          amount: 551744
        - type: money
          templateId: 20000000
          amount: 250000
        - type: item
          templateId: 367
          amount: 2

Update

eventMatchingEvents:
  update:
    - eventId: 800002
      group: priority
      changes:
        active: false
        requiredItemLevel: 450

Delete

eventMatchingEvents:
  delete:
    - eventId: 800030
      group: priority

Upsert

eventMatchingEvents:
  upsert:
    - eventId: 800300
      group: priority
      type: Dungeon
      questId: 800300
      categoryId: 800300
      active: true
      requiredItemLevel: 446
      action:
        type: matching
      targets:
        - id: "9088"
      rewards:
        - type: exp
          templateId: 20000001
          amount: 551744