Skip to main content
Custom items in Hubbly allow you to create interactive items with custom names, lore, materials, and actions. Items are defined in the items.yml file and can be given to players or used in menus.

​
Basic Item Configuration

All custom items are defined in the items.yml file under the items section. Each item has a unique identifier and properties.
1

Create the item definition

Add your item to items.yml with a unique identifier:
items.yml
items:
  compass:
    name: "&cCompass"
    material: COMPASS
    lore:
      - "&7Right click me to open"
      - "&7the server selector!"
    actions:
      - "[MENU] selector"
2

Configure item properties

Available properties for items:
  • name - Display name with color codes
  • material - Bukkit material type
  • lore - List of lore lines
  • actions - List of actions to execute
  • glow - Add enchantment glow effect
  • amount - Stack size (default: 1)
  • model_data - Custom model data ID
3

Give the item to players

Use the command to give items:
/hubbly give <item>
For example:
/hubbly give compass

​
Item Examples

​
Glowing Item with Menu Action

items.yml
items:
  compass:
    name: "&cCompass"
    material: COMPASS
    glow: true
    lore:
      - "&7Right click me to open"
      - "&7the server selector!"
    actions:
      - "[MENU] selector"

​
Custom Player Head with URL

Use custom textures from minecraft.net:
items.yml
items:
  socials:
    name: "Socials"
    material: PLAYER_HEAD
    url: http://textures.minecraft.net/texture/355e2dc46399b7b9275221fcdc87c66e58d0d3044dcf62af0465122c1cd7e0bc
    actions:
      - "[MENU] socials"

​
Shop Item with Command Action

items.yml
items:
  shop:
    name: "&aShop"
    material: EMERALD_BLOCK
    lore:
      - "&7Opens the shop"
    actions:
      - "[PLAYER] buy"

​
Movement Menu Item

items.yml
items:
  movement:
    name: "&aMovement"
    material: FEATHER
    lore:
      - "&7Click me to open the movement menu"
    actions:
      - "[PLAYER] hubbly menu movement"

​
Player Head Types

Hubbly supports three types of player heads:
items:
  player_head:
    material: PLAYER_HEAD
    texture: Notch

​
Item Properties Reference

​
Basic Properties

PropertyTypeDescriptionExample
nameStringItem display name"&cCompass"
materialStringBukkit materialCOMPASS
loreListItem lore linesSee examples
actionsListActions on interactionSee Action System

​
Advanced Properties

PropertyTypeDescriptionExample
glowBooleanEnchantment glowtrue
amountIntegerStack size3
model_dataIntegerCustom model data10001
urlStringPlayer head texture URLSee examples
textureStringPlayer head textureNotch
hdbIntegerHeadDatabase ID12345
colorStringLeather armor color (hex)8ad592

​
Leather Armor Colors

You can customize leather armor colors using hex codes (without the #):
items.yml
items:
  colored_armor:
    name: "&aCustom Armor"
    material: LEATHER_CHESTPLATE
    color: 8ad592

​
Color Codes and Formatting

Hubbly supports both traditional and hex colors:

​
Traditional Color Codes

name: "&c&lRed Bold Text"
lore:
  - "&7Gray text"
  - "&a&oGreen italic"

​
Hex Colors

Use the <#RRGGBB> format for hex colors: 
name: "<#CCFFDD>Custom Color"
lore:
  - "<#FF5733>Orange text"
  - "<#3498DB>Blue text"

​
Using Items in Menus

Items can also be used directly in menu configurations. See the Creating Menus guide for more information.
All item properties work the same whether defined in items.yml or directly in menu files.

​
Common Use Cases

​
Hub Selector Item

items.yml
items:
  hub_selector:
    name: "&6&lHub Selector"
    material: NETHER_STAR
    glow: true
    lore:
      - ""
      - "&7Right-click to open"
      - "&7the server selector"
      - ""
    actions:
      - "[SOUND] ENTITY_PLAYER_LEVELUP"
      - "[MENU] selector"

​
Cosmetics Menu

items.yml
items:
  cosmetics:
    name: "&d&lCosmetics"
    material: ENDER_CHEST
    lore:
      - "&7Browse cosmetics"
    actions:
      - "[PLAYER] cosmetics"

​
Teleporter Item

items.yml
items:
  spawn_teleport:
    name: "&a&lReturn to Spawn"
    material: ENDER_PEARL
    lore:
      - "&7Click to teleport to spawn"
    actions:
      - "[PLAYER] spawn"
      - "[TITLE] &aWelcome!;&7to spawn;10;40;10"
      - "[SOUND] ENTITY_ENDERMAN_TELEPORT"

​
Best Practices

Make sure to use valid Bukkit material names. Invalid materials will cause errors.
  1. Unique Identifiers - Use descriptive, unique IDs for each item
  2. Color Consistency - Maintain consistent color schemes across items
  3. Clear Descriptions - Write helpful lore that explains item functionality
  4. Test Actions - Always test item actions before deploying
  5. Performance - Avoid excessive actions on frequently-used items

​
Next Steps

Creating Menus

Learn how to use items in interactive menus

Action System

Explore all available actions for items

Build docs developers (and LLMs) love

Get started for freeTalk to us