HMCCosmetics is an important project of ours, and we enjoy working on it (it's actually used by our server, HibiscusMC!). Going forward, it will mostly get version updates and bug fixes. If you want a more active project that is getting new features, please check out MCCosmetics. It's a free and open-source cosmetics plugin being maintained by MythicCraft:



HMCCosmetics is an intuitive, easy-to-use cosmetics plugin, designed for servers using resource packs.

It has two key features - Backpacks, and cosmetic armor.

Backpacks work by spawning an invisible armor stand which follows the player around. The backpack is spawned using packets to improve performance, and nothing will be left over if the server crashes.

Cosmetic armor work by placing fake items in players' armor slots, meaning they can still use a normal piece of armor (like a diamond helmet) for protection. The cosmetic armor also works using packets.

Offhand items allow you to create cosmetics that go in the player's offhand slot. When they switch to a different item (from the survival inventory or with the F key), it is automatically unapplied temporarily. When they click F again, the cosmetic comes back! Just like the others, the off hand cosmetics use packets.

This can also be specified in the config for each of the items. You can choose whether or not you want the cosmetic item to override the armor item, or vice versa.

The GUI's are also highly customizable, with (technically) infinite possible GUI's able to be created. You can create your own dye menus to change the color of items, and items that execute actions when they are clicked.

Example config.yml:
Code (YAML):
cosmetic-settings:
require-empty-helmet: false
require-empty-off-hand: true
require-empty-chest-plate: true
require-empty-pants: true
require-empty-boots: true

# The pitch the player must look down for the backpack to be removed
# Set to -1 for no removal
look-down-backpack-remove: 70

# view distance in blocks that other players will see the backpack cosmetic
# setting this to lower than the server player view distance should fix the
# bug where players see random backpacks
view-distance: 32
wardrobe:
# if true, the wardrobe will be removed when the player is damaged
disable-on-damage: true
# removed if player leaves this radius, set to -1 for infinite radius
display-radius: -1
# if the player can use the wardrobe in other locations
portable: false
# if the wardrobe should always be displayed in the location below
always-display: false
# spawn static wardrobe if in this radius of wardrobe-location
static-radius: 10
# how much yaw should change per tick, set to 0 for none
rotation-speed: 3
# location of static wardrobe, remove for none
wardrobe-location:
world: "World"
x: 0
y: 0
z: 0
yaw: 0
pitch: 0
viewer-location:
world: "World"
x: 5
y: 0
z: 5
yaw: 0
pitch: 0
Example GUI config:
Code (YAML):
title: "<white>" # GUI Title
rows: 5 # Rows in the GUI
items:
1: # GUI Slot number
material: LEATHER_HORSE_ARMOR # Also supports Oraxen items! Format: "oraxen:item_name"
name: "<rainbow>Colorful Hat</rainbow>"
lore: # Lore displayed when the player owns the item
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore: # Lore displayed when the player does not have the correct permission.
- "<red>You do not own this item!"
amount: 1
model-data: 2 # CustomModelData Number
type: HAT
dyeable: true # Enables dyeable item feature
color: # Sets default color for item. Uses RGB format.
red: 5
green: 230
blue: 100
action: # See how the action system works on the wiki
any:
open-menu: dye-menu
permission: "cosmetics.colorful_hat" # Can be anything you want.
id: colorful_hat # Internal identifier. Can be anything you want.
2:
material: PAPER
name: "<blue>Backpack"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
model-data: 4
type: BACKPACK
permission: ""
id: backpack
3:
material: PAPER
name: "<blue>Lantern Cosmetic"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
model-data: 5
type: OFF_HAND
permission: ""
id: lantern_cosmetic
4:
material: PAPER
name: "<blue>Baseball Hat"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
model-data: 6
type: HAT
permission: ""
id: baseball_hat
5:
material: DIAMOND_CHESTPLATE
name: "<blue>Cosmetic Chestplate"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
type: CHEST_PLATE
permission: ""
id: chestplate
6:
material: DIAMOND_LEGGINGS
name: "<blue>Cosmetic Leggings"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
type: PANTS
permission: ""
id: pants
7:
material: DIAMOND_BOOTS
name: "<blue>Cosmetic Boots"
lore:
- ""
- "<gray>Enabled: <#6D9DC5>%enabled%"
- "<gray>Allowed: <#6D9DC5>%allowed%"
locked-lore:
- "<red>You do not own this item!"
amount: 1
type: BOOTS
permission: ""
id: boots
37:
material: PAPER
name: "<#40B7D6>Previous Page"
amount: 1
model-data: 1
action:
any:
open-menu: menu-2
40:
material: PAPER
name: "<rainbow>Customization Menu</rainbow>"
amount: 1
model-data: 3
action:
any:
open-menu: dye-menu
43:
material: PAPER
name: "<#40B7D6>Next Page"
amount: 1
model-data: 2
action:
any:
open-menu: menu-2

• /cosmetics (hmccosmetics.cmd.default) - Opens Cosmetics GUI
• /cosmetics add <username> <cosmetic_id> - Adds cosmetic to a player
• /cosmetics remove <username> <backpack/hat>
• /cosmetics reload (hmccosmetics.cmd.reload) - Reloads plugin configuration files
• /cosmetics help (hmccosmetics.cmd.help) - Sends help message.
• / cosmetics dye <cosmetic type> <hex> (
hmccosmetics.cmd.dye) - dyes a cosmetic item
• / cosmetics wardrobe <player> (hmccosmetics.cmd.wardrobe) - opens the wardrobe

Because of how our plugin works, there are some limitations. Please read this before purchasing our plugin.
Report Bugs: https://github.com/HibiscusMC/HMCCosmetics/issues
Wiki: https://github.com/HibiscusMC/HMCCosmetics/wiki
Discord: https://discord.gg/pcm8kWrdNt






• Suggest more included items in our Discord!