Color Skins

The setSkin action swaps the player’s skin through SkinsRestorer. This example shows three preset skins plus a reset button. The closeMenu call right before setSkin is mandatory - changing the skin respawns the player, and the open inventory would crash the client.

What it teaches

• The setSkin action with texture + signature parameters
• The resetSkin: true shortcut to restore default skin
• Why closeMenu must run before setSkin (respawn + open inventory crashes the client)
• Using PLAYER_HEAD with a texture: field to render a skin preview as the menu item

intermediate

Features: setSkinresetSkincloseMenu-before-setSkinPLAYER_HEAD-texture

Requires: SkinsRestorer

Open: /ame_skins Copy

menu.conf

# Color Skins - skin chooser using setSkin action
# Docs: https://abstractmenus.github.io/docs/en/examples/cosmetics/color-skins
# Open: /ame_skins
# Requires: SkinsRestorer

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Skin Chooser"
size: 3

activators {
  command: "ame_skins"
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }

  {
    slot: 4
    material: PLAYER_HEAD
    name: "&6&lChoose a Skin"
    lore: ["&7Pick a color to apply to your character."]
  }

  # The 4 color variants. Replace texture and signature with values from
  # https://mineskin.org for real skins. The placeholders below will be
  # accepted by HOCON but rejected by SkinsRestorer at runtime.

  {
    slot: 10
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_GOLD"
    name: "&6Gold"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_GOLD"
          signature: "REPLACE_WITH_SIGNATURE_GOLD"
        }
        sound: ${successSound}
        message: "&aGold skin applied. Reconnect to see changes."
      }
    }
  }

  {
    slot: 12
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_PURPLE"
    name: "&dPurple"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_PURPLE"
          signature: "REPLACE_WITH_SIGNATURE_PURPLE"
        }
        sound: ${successSound}
        message: "&dPurple skin applied. Reconnect to see changes."
      }
    }
  }

  {
    slot: 14
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_BLUE"
    name: "&9Blue"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_BLUE"
          signature: "REPLACE_WITH_SIGNATURE_BLUE"
        }
        sound: ${successSound}
        message: "&9Blue skin applied. Reconnect to see changes."
      }
    }
  }

  {
    slot: 16
    material: BARRIER
    name: "&7Reset to default"
    lore: ["&7Restore your original skin."]
    click {
      actions {
        closeMenu: 1
        resetSkin: true
        sound: ${clickSound}
        message: "&7Default skin restored. Reconnect to see changes."
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

Important: order of actions

Inside the actions { ... } block, keys are executed in the order they appear in the file. The plugin docs explicitly require closeMenu before setSkin:

:::caution
Before this action, you need to set the closeMenu action, because when the
skin is changed, player respawning. If the menu is opened, it may cause a
critical error for the client.
:::

In each item’s click block above, closeMenu: 1 comes first, then setSkin. Don’t reorder.

Getting real texture and signature

The placeholders in this example (REPLACE_WITH_TEXTURE_BASE64_GOLD etc.) won’t work as-is. To get real values:

1. Go to MineSkin.org.
2. Upload an image or pick a preset.
3. Copy the Texture Data field into the texture: parameter.
4. Copy the Texture Signature field into the signature: parameter.

The two fields are long base64 strings. The texture on the displayed PLAYER_HEAD (the preview) is the shorter texture-hash form (just the hash from the http://textures.minecraft.net/texture/<hash> URL).

Customizing

To add more skin choices, copy any item block, change the slot:, name:, the preview texture:, and the setSkin payload. The shared template’s ${successSound} keeps the audio feedback consistent across choices.

To skip the preview (use a non-head item like a banner), drop the texture: field and change material: to RED_BANNER or whatever fits the visual theme.

Try it

After installing the example pack:

1. Install SkinsRestorer.
2. Replace the REPLACE_WITH_* placeholders with real texture/signature values.
3. Drop the bundle into plugins/AbstractMenus/menus/example/.
4. /am reload.
5. Type /ame_skins in-game.
6. Click a skin. Reconnect to see the change.