Voxel Shop beta is live. Expect occasional bugs. Learn more  
AgaCosmetics icon

AgaCosmetics 1.0

Display-entity cosmetics for Java & Bedrock: no armor stands, built-in shop, outfits & HMC migration

2aqpoq.png
cr69m7.png
e74j9w.png
6iiy0v.png
uym0eb.png
g3ilaq.png
7p0g7c.png
cxv2wa.png
5zuvi9.png
Players step into a wardrobe and watch themselves turn while they pick cosmetics from the menu, and sneak to leave. Set one up by standing where it should be and running /agac wardrobe create : the camera is placed for you. Outside the wardrobe, right-clicking a locked cosmetic in the menu lets players wear it for a few seconds.
oshcyp.png
xha90d.png
  1. Bedrock players see the same display entities through GeyserDisplayEntity
  2. Separate Bedrock offsets, adjustable in-game with /agac adjust (a menu, no config editing)
  3. Native Bedrock form menus instead of chest GUIs
  4. The same jar is a Geyser extension: it prepares converted packs on every Geyser start, also on a separate proxy or host without SSH
cm2kw3.png
  1. price: 500 on any cosmetic: players buy it from the menu, paid with Vault, CoinsEngine or XP levels
  2. /agac give 7d: gifts and timed rentals for crates, votes and store packages
  3. Outfits: players save whole looks and switch with one click
  4. Styles: one cosmetic in many colours or versions, grouped under one menu entry
  5. Showcase stands: figures in your spawn or shop wearing a set look; clicking one tries the whole look on
xap5gb.png
fw6hl7.png
zkmyce.png
47ehqw.png
[SPOILER=For developers]
  1. Add the jar as compileOnly and softdepend: [AgaCosmetics]
  2. AgaCosmeticsAPI: cosmetic(id), equip, unequip, dye, tryOn, give(uuid, cosmetic, Duration), take, buy, price, hide/show, outfits, openMenu, isBedrock
  3. Events: CosmeticEquipEvent, CosmeticUnequipEvent, CosmeticPurchaseEvent (change the price or cancel), CosmeticUnlockEvent, CosmeticHide/ShowEvent, MenuOpenEvent, WardrobeEnter/LeaveEvent, CosmeticUserLoadEvent
  4. registerItemSource("myitems", id -> ...) lets cosmetics and menus use your plugin's items
  5. Full reference with examples on the wiki
[/SPOILER] [SPOILER=Requirements]
  1. Paper or Folia 1.21.8 or newer (tested on 1.21.8 and 1.21.11; Spigot is not supported), Java 21+
  2. Optional: Nexo, ItemsAdder, Oraxen, CraftEngine, MythicMobs, MMOItems, Denizen, eco, ModelEngine, LibsDisguises, Geyser + Floodgate + GeyserDisplayEntity, Vault or CoinsEngine, PlaceholderAPI, WorldGuard
  3. PacketEvents is included; no other plugin is needed
[/SPOILER] [SPOILER=Coming from HMCCosmetics?]
  1. Drop AgaCosmetics in next to HMCCosmetics and start the server
  2. Run /agac migrate hmccosmetics --dry-run and read the report
  3. Run /agac migrate hmccosmetics: cosmetics, menus, wardrobes, settings and every player's saved cosmetics are imported, no restart
  4. Remove HMCCosmetics. Permissions and %HMCCosmetics_...% placeholders keep working
[/SPOILER]