Slot Types (type)
The type parameter is the heart of every icon in the menu. It tells the plugin how this slot should behave: whether it will be just a decoration, or if it should automatically display an item worn by the player.
Proper use of types allows you to create truly dynamic and smart profiles.
All Available Types
Below is a quick reference table for all available slot types.
Type (type) | Description | Example Usage |
|---|---|---|
DEFAULT | Default type. A regular, static item. It is displayed exactly as you configured it. | Decorative borders, buttons for executing commands. |
HELMET | Automatically displays the vanilla helmet (real armor) worn by the profile owner. | A slot showing the actual diamond/netherite helmet. |
CHEST_PLATE | Automatically displays the chestplate worn by the profile owner. | Slot for the chestplate. |
LEGGINGS | Automatically displays the leggings worn by the profile owner. | Slot for leggings. |
BOOTS | Automatically displays the boots worn by the profile owner. | Slot for boots. |
MAIN_HAND | Automatically displays the item the profile owner is holding in their main hand. | Slot for main weapon or tool. |
OFF_HAND | Automatically displays the item the profile owner is holding in their off-hand (real inventory). | Slot for the item in the off-hand (shield, totem). |
HAT | Automatically displays the cosmetic hat equipped by the owner. Distinct from HELMET. | Slot for the visual cosmetic hat. |
BACKPACK | Automatically displays the cosmetic backpack equipped by the owner. | Slot for the backpack cosmetic. |
WALKING_STICK | Automatically displays the cosmetic walking stick/cane. Distinct from OFF_HAND. | Slot for the walking stick cosmetic. |
BALLOON | Automatically displays the cosmetic balloon equipped by the owner. | Slot for the balloon cosmetic. |
SPRAY | Automatically displays the cosmetic spray equipped by the owner. | Slot for the spray cosmetic. |
STATUS | Displays the player's custom status. Can show different items for Online/Offline states. | The main status icon showing the custom text. |
DRAG_AND_DROP | A temporary slot for placing items. Will not save. | Try-on slot. |
SAVED_ITEM | A slot where the owner can drag & drop an item to save/display it in their profile persistently. | "Showcase" slots for displaying rare items. |
Information
Equipment slots are read-only. Players cannot take or replace an item from such a slot by clicking on it. They only display what is already worn by the player.
Cosmetic Equipment
These types allow you to display visual cosmetics separately from real armor. The plugin supports ECosmetics, HMCCosmetics, and CosmeticsCore. You can choose your provider in config.yml (cosmetics-provider).
Type (type) | Description | Note |
|---|---|---|
HAT | Displays the visual Hat. | |
BACKPACK | Displays the equipped Backpack. | |
WALKING_STICK | Displays the equipped Cane/Walking Stick. | |
BALLOON | Displays the equipped Balloon. | |
SPRAY | Displays the selected Spray. | Primarily supported by ECosmetics. |
Difference between HELMET and HAT
HELMET: Shows the real item in the player's armor slot (e.g., Diamond Helmet with Protection IV).HAT: Shows the cosmetic item (visual only) equipped via the cosmetics plugin.
You can use both in one menu to show what armor the player has AND what they look like!
Functional Slots
These types have unique logic and make profiles interactive.
Type (type) | Description |
|---|---|
STATUS | Displays an item symbolizing the player's status. It is recommended to use this with states and different items for online/offline status (onlineItem/offlineItem) so that the icon changes. |
DRAG_AND_DROP | A slot where the profile owner can temporarily place any of their items. The item will not be saved after closing the inventory. Useful for trying on items or temporary storage. |
SAVED_ITEM | Persistent slot. An item that the profile owner places here will be saved in the database and will be visible to everyone who views their profile. Ideal for displaying trophies, favorite weapons, or tools. |
Saved Items (SAVED_ITEM)
Use this type with caution. If you remove a SAVED_ITEM slot from the configuration, players will lose access to the items saved in it! The data will remain in the database, but it can only be recovered by editing the database directly.
Slots for the Status Menu
These types are intended exclusively for use in the status change menu (status.yml). Do not use them in regular profiles.
Type (type) | Description |
|---|---|
CHANGE_STATUS_ACCEPT | The confirmation button. When clicked, it saves the text from the anvil as the new status. |
CHANGE_STATUS_CANCEL | The cancel button. When clicked, it closes the status change menu without saving. |