Skip to content

Accessory Sets

Accessory sets live under plugins/EmakiAccessory/sets/. The file name is not used for identification; the set id comes from the id field inside the file.

Accessory sets and EmakiItem equipment sets are independent mechanisms that do not affect each other: this one only counts pieces worn in accessory slots, while EmakiItem only counts the equipment slots. One item may belong to a set on both sides, and each side counts independently.

Only the enabled page contributes pieces: accessories on other pages never count, even when a full set sits there. When a player loses the enabled page's permission, that page contributes zero and the set deactivates.

Full Example

yaml
id: "example_set"
display_name: "<gold>Trialist's Accessories</gold>"

pieces:
  necklace:
    item: "example_necklace"
    slot: "necklace"
    display: "<gray>Trialist's Necklace</gray>"

  ring:
    item: "example_ring"
    slot: "ring"
    display: "<gray>Trialist's Ring</gray>"

  charm:
    item: "example_charm"
    slot: "charm"
    display: "<gray>Trialist's Charm</gray>"

thresholds:
  2:
    effects:
      - ea_attributes:
          max_health: 4.0
          defense: 2.0

  3:
    effects:
      - ea_attributes:
          max_health: 6.0
          crit_chance: 0.05
        es_skills:
          - "example_dash"

pieces — Set Members

The key names are only identifiers within the file; what actually matters is item and slot.

FieldDescription
itemEmakiItem's item definition id.
slotWhere this accessory must be worn to count.
displayText used when presenting this member in the window.

The whole set is inactive when EmakiItem is absent: without a definition id there is no way to decide "this is that accessory".

The Three Forms of slot

FormMeaning
A part id, such as ringAny cell of that part counts.
An instance id, such as ring_1Only that one cell counts.
EmptyAny accessory slot counts.

thresholds — Piece Thresholds

The key is "how many pieces are worn" and must be an integer between 1 and the total member count.

Thresholds are cumulative, not exclusive: wearing 3 pieces activates both the 2-piece and 3-piece tiers. In the example above a player wearing 3 pieces receives max_health: 10.0 (4.0 + 6.0), defense: 2.0, crit_chance: 0.05 and the skill example_dash.

effects

KeyDescription
ea_attributesA map from attribute name to value, feeding EmakiAttribute.
es_skillsA list of skill ids, feeding EmakiSkills.

Attribute names and value semantics match EmakiAttribute, and skill ids match EmakiSkills. How these reach the respective modules is described in Attributes and Skills.

Piece Count Notifications

When a set's equipped piece count changes, AccessorySetBonusChangeEvent fires. It is an edge-triggered, non-cancellable notification; see Event API.

Accessories in orphaned slots never count toward the total, so removing a part from parts.yml lowers the count reported here.