GlymeraArmorStand

GlymeraArmorStand - Collectible Armor Stands with Endless Variations

Craftable armor stands that spawn unique, randomized player-looking NPCs. Every stand is a one-of-a-kind collectible - equip them with armor and weapons to build your personal gallery.

Most actual version only working for Hytale stable 5 ! Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy

---

What is GlymeraArmorStand?

GlymeraArmorStand adds craftable blocks that, when placed, spawn a unique NPC with a randomized player appearance. Every armor stand looks different - different hair, face, body type, clothing and more. You can equip them with any armor piece or weapon, rotate them freely, and pick them up to place them somewhere else. The appearance is permanently tied to each block, so your collection stays intact no matter how often you move them.

Craft, collect, equip, display.

---

How It Works

1. Craft an Armor Stand block at a Workbench
2. Place the block - a unique NPC appears, facing you
3. Equip it by hitting the stand with armor or weapons
4. Rotate it by hitting with a stick (45-degree steps)
5. Unequip by hitting with an empty hand (strips all equipment)
6. Pick up by hitting a naked stand with an empty hand (returns the block with its identity)
7. Place again anywhere - the exact same NPC appears

---

Commands

Command	Who	Description
/armorstand	Everyone	Show plugin info and usage help
/armorstand list	Everyone	List all your placed armor stands with locations and equipment
/armorstand equip	Everyone	Equip your held item on the nearest armor stand (within 5 blocks)
/armorstand give [player]	OP	Give 8 armor stand blocks to yourself or a player
/armorstand removeall	OP	Remove all armor stands from the world
/armorstand reload	OP	Reload the config file

---

Crafting Recipe

Crafted at a Workbench (Survival category):

• 2x Gold Bar
• 1x Bone Fragment
• 1x Raw Pork

The recipe can be disabled in the config file (requires server restart).

---

Equipment Slots

Armor stands support 6 equipment slots. The slot is automatically detected from the item name:

Slot	Detected Keywords
Head	_head, _helmet, _hat, _mask, _hood, _cap, _crown
Chest	_chest, _torso, _body, _robe, _tunic, _vest
Hands	_hands, _gloves, _gauntlet
Legs	_legs, _pants, _leggings, _boots, _feet, _greaves
Right Hand	weapon_*, tool_*, or any unrecognized item
Left Hand	Via /armorstand equip when right hand is occupied

Swapping: If a slot is already occupied, the old item is returned to your inventory before the new one is applied.

---

Features

• Endless variations - Every armor stand gets a unique, randomized player appearance from Hytale's full cosmetics pool
• True collectibles - Each block carries a unique seed; the same block always produces the same NPC
• Stable appearances - NPC looks are permanently saved and survive server updates that change the cosmetics pool
• Full equipment support - Head, chest, hands, legs, right hand and left hand slots
• Rotation - Hit with a stick to rotate in 45-degree steps; stands snap to face you when first placed
• Ownership protection - Only the owner (or an OP) can interact with a stand
• Per-player limit - Configurable maximum number of stands per player (default: 50)
• Persistent - Stands survive server restarts with all equipment and appearance intact
• Chunk-aware - NPCs only spawn when their chunk is loaded, no wasted resources
• Craftable - Recipe can be enabled or disabled in the config

---

Configuration

The config file is automatically created at first startup in the plugin data directory.

{
  "maxStandsPerPlayer": 50,
  "recipeEnabled": true
}

Setting	Default	Description
maxStandsPerPlayer	50	Maximum number of placed armor stands per player
recipeEnabled	true	Whether the crafting recipe is available (requires restart)

---

Installation

1. Place GlymeraArmorStand-1.0.0.jar in your server's mods/ folder
2. Start (or restart) the server
3. Done!

---

Data Files

The plugin stores its data in the plugin data directory:

File	Purpose
config.json	Plugin settings
stands.json	All placed stands (positions, equipment, owners)
skins.json	Permanent seed-to-appearance registry (ensures stability across updates)

---

Good to Know

• Armor stands are invulnerable - they cannot be killed by damage, only picked up by the owner
• Stands are immobile - they cannot be pushed or moved by any game mechanic
• When you reach your stand limit, you'll see a message: "Maximum armor stands reached! (50/50)"
• Interacting with someone else's stand shows: "This is not your armor stand!"
• OPs can interact with any stand regardless of ownership
• Picking up a stand returns all equipped items to your inventory first, then gives you the block
• The block can be safely stored in chests and containers

---

Performance

• Chunk-aware spawning - NPCs are only spawned when their chunk is loaded by a player
• Periodic cleanup - Stale or duplicate NPCs are automatically removed every second
• Cached skins - Generated models are cached in memory to avoid repeated computation
• Minimal tick cost - One lightweight check per second, no per-tick processing

---

Made with care by Glymera for the Hytale community