Vixen
dd8b0a81

Gameplay · guide

Dungeons, raids and lockouts

Difficulty tiers, encounters with gates and checkpoints, and lockouts whose resets are absolute boundaries rather than timers from whenever somebody entered.

Edit this page on GitHub

Documents

What it is

An Instance is a map, its difficulties and the fights in it. An InstanceRun is one group's attempt: which difficulty, who is in it, how far they got. A Lockout is what stops them doing it again this week.

What it is for

Doc 27's Instance shard kind with gameplay on top — dungeons, raids, and anything else a group is given its own copy of.

Using it

Compile an InstanceLibrary, call InstanceRun.Enter, then Engage and Defeat the fights.

⚠ A reset is an absolute boundary. "Weekly" is the same instant for everybody; a duration from when somebody entered gives every player their own schedule and makes a raid night unplannable.

⚠ The lockout is issued on the first defeat, not on entry, once, and never extended. Everybody in the party gets it.

⚠ One locked-out member refuses the whole group, because letting the rest in leaves somebody at the door while their party clears without them.

⚠ The difficulty is fixed for the life of the run. A lockout is per (instance, difficulty), so a group that could switch halfway would have one lockout covering two.

⚠ A wipe resets what was being fought and nothing else — a dead boss stays dead. What it costs is the attempt.

⚠ A gate must fall before anything behind it may be engaged.

Examples

A dungeon on two difficulties:

yaml
# Assets/Instances/crypt.vxdef!InstanceDefinitiondisplayName: The Cryptscene: maps/cryptminimumPlayers: 2maximumPlayers: 5difficulties:  - { id: normal, displayName: Normal }  - id: heroic    displayName: Heroic    tag: Instance.Heroic    healthScale: 2    damageScale: 1.5    lockout: { scope: Character, reset: Weekly }    requires: [ { kind: HasTag, subject: Instance.Heroic } ]encounters:  - { id: gatekeeper, displayName: The Gatekeeper, isGate: true }  - { id: lich, displayName: The Lich King }

Going in:

csharp
using Vixen.Gameplay;using Vixen.Gameplay.Instances;static class Door {    public static InstanceRefusal Open(        Instance crypt,        IReadOnlyList<PlayerId> party,        ILockoutStore lockouts,        double now,        IRequirementContext attunement    ) =>        // One locked-out member refuses everybody, which is kinder than the alternative.        InstanceRun.Enter(crypt, "heroic", party, lockouts, now, out _, attunement);}

Fighting:

csharp
using Vixen.Gameplay.Instances;static class Boss {    public static bool Kill(InstanceRun run, int encounter, ILockoutStore lockouts, double now) {        if (run.Engage(encounter) != InstanceRefusal.None) {            return false;        }        // The first defeat is what issues the lockout — walking in and leaving costs nothing.        return run.Defeat(encounter, lockouts, now) == InstanceRefusal.None;    }}

See also

  • PvP — G6's other half, and the same shape of match state.
  • Requirements — what gates a difficulty.
  • Quests — what the run's kills advance.

Next

  • Arenas, battlegrounds and objectives — Four composable objective types with one signed capture meter, so a contested point is frozen rather than slowly losing, and a new battleground is a map plus a .vxdef.
  • Requirements — "Can I do this" answered once, by code the client runs for the tooltip and the realm runs for the truth.
  • Quests, stages and objectives — A quest is stages, a stage is objectives, and an objective is a subscription with a tag query — so it costs nothing when nothing dies.