Vixen
02b45cc4
csharp
public record class PlacementWeights

What "together" means to a game, as numbers. Doc 27 § Placement.

Read the guide page for this →

Remarks

⚠ A .vxplacement asset a game authors, not constants the engine ships. The defaults below are Guild Wars 2's shape and are a starting point rather than an answer: a battleground wants fill to dominate, a social hub wants locale to, and neither is something an engine can know. What the engine owns is that the terms exist and that the scoring is total and deterministic whatever they are set to.

Why the party term is four times everything else put together. It is not a preference, it is the mechanism: "join your friend's instance" is doc 27's own list of Guild Wars 2 properties, and it falls out of placement rather than being a feature beside it. A party pull that could lose to a full guild would be a separate join mechanism waiting to be written.

Fields and properties (15)

  • public const string Extension

    The file extension a game authors these in.

  • public static PlacementWeights Default

    Doc 27's defaults, which are Guild Wars 2's shape.

  • public double Party

    A party or squad member is present. Effectively a hard pull.

  • public double GuildMember

    Per guild member present, up to GuildCap.

  • public int GuildCap

    How many guild members count. Capped so that a guild event cannot outrank a party.

  • public double Friend

    Per friend present, up to FriendCap.

  • public int FriendCap

    How many friends count.

  • public double Locale

    The shard is speaking the requester's language.

  • public double HealthyFill

    The shard's fill is in the healthy band.

  • public double HealthyFrom

    Where the healthy band starts, as a percentage of the soft cap.

  • public double HealthyTo

    Where it ends.

  • public double Overfull

    Penalty per percentage point above HealthyTo.

  • public double Aged

    Penalty for a shard past MaxAge.

  • public TimeSpan MaxAge

    How old a shard has to be to be biased against.

  • public double AntiFlap

    Penalty for the shard the requester was just moved off.

Methods (2)

  • public static PlacementWeights Parse(string yaml)

    Reads a .vxplacement.

  • public string ToYaml()

    Writes them back, which is what an editor's inspector saves.

Used by (6)

  • MapCoordinatorVixen.Live.Orchestrator
  • MapOptionsVixen.Live.Orchestrator
  • PlacementDirectorVixen.Live.Orchestrator
  • PlacementDirectorTestsVixen.Live.Orchestrator.Tests
  • PlacementWeightsTestsVixen.Live.Orchestrator.Tests
  • TypeRegistrationVixen.Live.Orchestrator