Events

Look up how each game event works and what it gives. 65 events are included: 12 alliance, 36 solo, 12 rookie, and 5 holiday.

Every event has an id, a name, an img, a category, and a description. All other fields are optional, because events differ a lot in shape.

Type

GameEvent

GameEventReward

GameEventTier

GameEventRanking

GameEventScoringAction

Each entry of a GameEventDay scoring list is a scoring action.

EventSchedule

EventRepeat has a kind of 'none', 'every', or 'weekly'. An 'every' repeat has every (a number) and unit ('hours', 'days', 'weeks', or 'months'). A 'weekly' repeat has weekdays.

EventRun has length and unit ('minutes', 'hours', or 'days'), plus an optional label, startWeekday, and startTimeUtc (HH:MM). Times are in UTC.

GameEventExpertTier

GameEventResultShape

resultShape has five values. Each one is derived from the data of the event, in this order.

GameEventRankingTableView

eventRankingTables() returns this shape.

Factory

import { events } from 'whiteout-survival-data'

events() // all 65 events
events(source) // wrap a pre-filtered array

Filters

import { events } from 'whiteout-survival-data'

events().byCategory('alliance').count() // 12
events().byCategory('holiday').get() // Dreamscape Memory, Frosty Fortune, Romance Season, Vision of Dawn, Vault of Enigma

Terminal methods

Helper functions

The order of the tables is the personalRankings tables (personal-1 and on, with basedOn), the allianceRankings table (alliance), the allianceRankingUpdates lists (alliance-update-1 and on, with the name of the update), and the tiers that hold rankings (tier-1 and on, with the name of the tier). A tier table has a scope only when its name says personal or alliance. The star rating tiers of Alliance Showdown and the winner tier of SvS have none. The array is empty for an event with no ranking.

Schedule

frequency and duration are free text. schedule holds the same information as a rule, and it is set on 50 of the 65 events.

import { events } from 'whiteout-survival-data'

const bear = events().find('bear-hunt')
bear?.duration // '30 minutes'
bear?.schedule
// { repeat: { kind: 'every', every: 47.5, unit: 'hours' }, runs: [{ length: 30, unit: 'minutes' }] }

An event with two runs in a cycle has two entries in runs. Hall of Chief has Season 1 for 6 days and Season 2 for 7 days. Crazy Joe has a run on Tuesday and one on Thursday. Frostfire Mine has a run of 30 minutes for each of its seven time slots.

The schedule has no dates, because the game does not publish them. A repeat rule is set when the text gives an interval, such as "Weekly", "Every two weeks", "Once a month", or "Yearly" (12 months). A run is set when the text gives a length. Some events have a repeat rule and no run, or the other way around, when the text has only one of the two.

The SvS week follows the package owner: Preparation for 5 days from Monday, and a Battle of 12 hours from Saturday 10:00 UTC, repeating every four weeks. Canyon Clash follows the owner as well: voting on Monday and Tuesday, registration on Wednesday and Thursday, matchmaking on Friday, and the battle on Saturday.

Item links in scoring actions

A scoring action has an itemId when its text names one item that is in items(). Some actions name a kind of item and not one item. They are linked as follows.

The general speedups are not in the speedup lists, because the wording names the type. An action has an itemId or itemIds, never both.

Expert extra tiers

Three expert skills add reward tiers to an event: Baldur's Blazing Sunrise to Alliance Mobilization, Baldur's Dawn Hymn to Alliance Showdown, and Valeria's Well Prepared to the preparation phase of State of Power. Each skill adds up to three extra tiers, at skill levels 1, 6, and 10. The expertTiers list of these events has one entry for each extra tier. The extra tiers come after the normal milestone tiers.

Examples

import { eventRankingTables, events } from 'whiteout-survival-data'

// Alliance events
events().byCategory('alliance').count() // 12

// Read a nested list: the 20 waves of Crazy Joe
events().findByName('Crazy Joe')?.waves?.length // 20

// Events with a related event buff row
events()
  .get()
  .filter((e) => e.eventBuffId !== undefined)
  .map((e) => e.id)

// Every ranking table of an event in one shape
const tables = eventRankingTables(events().find('king-of-icefield')!)
tables.map((t) => `${t.id} ${t.scope}`)
// ['personal-1 personal', 'personal-2 personal', 'personal-3 personal', 'personal-4 personal']

Known gaps

Next steps

• See Event buffs for which buff sources count in each game mode
• Browse Items to resolve the itemId values used in rewards and scoring actions
• Read Experts for the skills behind the expert extra tiers
• Read the query builder guide for more filter patterns