equip_armor_stand_processor

equip_armor_stand_processor

Equips armor stands as a structure is placed, rolling one armor set per stand from a weighted list. Use it when you want varied guards or dressed stands across placements without saving a separate NBT for each loadout.

Built on MSL's entity processor framework, which is ported and adapted from YUNG's API.

Fabric only at the moment. On NeoForge this processor silently does nothing and armor stands generate unequipped. The datapack side is fine, so a structure authored for it will work once that is fixed. See entity processor framework for detail.

Minimal example

A set with only two slots filled, and a trim on the chestplate:

{
  "processor_type": "moogs_structures:equip_armor_stand_processor",
  "armor_sets": [
    {
      "weight": 5,
      "armor": {
        "chest": {
          "id": "minecraft:iron_chestplate",
          "components": {
            "minecraft:trim": { "material": "minecraft:copper", "pattern": "minecraft:rib" }
          }
        },
        "feet": { "id": "minecraft:iron_boots" }
      }
    }
  ]
}

Fields

Field	Type	Required	Notes
armor_sets	array	yes	The pool of sets. An empty array is a no-op.
armor_sets[].weight	int	yes	1 or higher. Relative to the sum, not a percentage.
armor_sets[].armor	object	yes	The set itself. weight sits beside it, not inside it.

armor

Field	Type	Required	Notes
head / chest / legs / feet	item	no	Any subset. Omitted slots are left empty.

Each slot is vanilla item NBT: id, optional count, and optional components for enchantments, trims, custom names and so on. Every armor stand in every piece using the processor list gets processed, and each rolls independently.

Enchantments can be written either way. The pre-1.21.5 wrapped form ("minecraft:enchantments": {"levels": {...}}) and the 1.21.5+ flat form are both accepted, so one datapack works across the version boundary.

Gotchas

• Equipment is replaced, not merged. If you saved a helmet onto the stand in the build world and your set only sets chest, the helmet is gone. Put everything you want on the stand into the set.
• An empty armor object strips the stand. "armor": {} writes empty equipment rather than leaving the stand alone. Use it deliberately or not at all.
• Typos in the item fail silently on newer versions. On MC 26.1 and later the item is not validated when the datapack loads, so a misspelled item id or component shows up in game as a bare stand with nothing in the log. On 1.21.5 and earlier the same mistake fails loudly at load. Check stands in game after editing.
• Misspelled slot names are ignored the same way. Only head, chest, legs and feet exist, and there is no offhand or mainhand slot.

See also

• Structure Processors overview.
• spawner_randomizing_processor, whose nbt field can pre-equip spawned mobs.