Systems

Chat Announcement Filter

Server-wide announcements (boss kills, encounter starts, achievements, rare rewards) can be filtered by each player in the bell menu of the profile window. Which settings row an announcement belongs to is data: packs define rows in config/chatnotify*.json.

Each row lets the player choose All, Nearby only or Off. Participants of the announced event (for example the players of the encounter) always receive it. An announcement that no row matches goes to everyone.


Configuration

Any pack can add config/chatnotify.json (any file name starting with chatnotify):

{
  "nearbyRadius": 150,
  "categories": [
    {
      "code": "ossuary-awaken",
      "order": 20,
      "name": "albase:chatnotify-cat-ossuaryawaken",
      "default": "nearby",
      "priority": 10,
      "matches": [
        { "events": ["encounter-awaken"], "encounterIds": ["albase:encounter:ossuary"] }
      ]
    }
  ]
}

File fields

FieldDefaultDescription
nearbyRadius150Radius in blocks for "Nearby only" (horizontal). The last loaded file that sets it wins
categories[]Settings rows

Category fields

FieldDefaultDescription
coderequiredUnique row id. A duplicate replaces the earlier row (warning in the log)
namenoneLang key of the row label
defaultallall, nearby or off - used until the player picks something
nearbytruefalse hides the "Nearby only" choice (for announcements with no place in the world, such as achievements)
order0Row position in the window, lower first
priority0When several rows match one announcement, the highest priority wins
matchesrequiredThe row covers an announcement when any rule here fits. A row without a rule that has events is skipped

Match rule fields

An announcement must have its event in events, and every other filter that is set must also pass.

FieldDescription
eventsRequired. Event codes (below)
entityTagsThe source entity has any of these tags (for example ossuary, hollowtrials, duat)
targetIdsThe source entity's quest target id matches any of these (* wildcard)
encounterIdsThe encounter id matches any of these (* wildcard)

Event codes

CodeAnnouncement
bosskillA boss was killed
playerkilledbybossA player died to a boss
encounter-preparationAn encounter is being prepared
encounter-awakenAn encounter boss awakens
encounter-completionAn encounter was completed
encounter-failAn encounter failed
encounter-rotationA rotating world boss changed
encounter-modifierAn encounter modifier was announced
achievementAn achievement was unlocked
questA quest was completed
caserewardA case (lootbox) reward
rerollA reroll result

Tagging New Content

For a new boss, either give the entity a tag and match it with entityTags, or match its encounter with encounterIds / its quest target with targetIds. No code change is needed.

The framework's generic rows live in resources/assets/alegacyvsquest/config/chatnotify.json. Area rows: quests/albase/assets/albase/config/chatnotify.json and quests/alzenith/assets/alzenith/config/chatnotify.json.

A player's choices are stored per account and move with account transfer when the target has none.

Press ESC to close