Цветные скины

Действие setSkin меняет скин игрока через SkinsRestorer. В этом примере три готовых скина и кнопка сброса. Вызов closeMenu непосредственно перед setSkin обязателен: смена скина вызывает респаун игрока, и открытый инвентарь приведёт к крашу клиента.

Что показывает пример

• Действие setSkin с параметрами texture + signature
• Сокращение resetSkin: true для возврата стандартного скина
• Почему closeMenu должен идти перед setSkin (респаун + открытый инвентарь = краш клиента)
• Использование PLAYER_HEAD с полем texture: для отображения превью скина в качестве предмета меню

средний

Фичи: setSkinresetSkincloseMenu-before-setSkinPLAYER_HEAD-texture

Требует: SkinsRestorer

Открыть: /ame_skins Скопировать

menu.conf

# Цветные скины - выбор скина через действие setSkin
# Docs: https://abstractmenus.github.io/docs/ru/examples/cosmetics/color-skins
# Open: /ame_skins
# Requires: SkinsRestorer

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

title: "&6Выбор скина"
size: 3

activators {
  command: "ame_skins"
}

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

  {
    slot: 4
    material: PLAYER_HEAD
    name: "&6&lВыбери скин"
    lore: ["&7Выбери цвет для своего персонажа."]
  }

  # Четыре цветных варианта. Замени texture и signature на значения с
  # https://mineskin.org для реальных скинов. Заглушки ниже HOCON примет,
  # но SkinsRestorer отклонит их во время выполнения.

  {
    slot: 10
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_GOLD"
    name: "&6Золотой"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_GOLD"
          signature: "REPLACE_WITH_SIGNATURE_GOLD"
        }
        sound: ${successSound}
        message: "&aЗолотой скин применён. Перезайди, чтобы увидеть изменения."
      }
    }
  }

  {
    slot: 12
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_PURPLE"
    name: "&dФиолетовый"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_PURPLE"
          signature: "REPLACE_WITH_SIGNATURE_PURPLE"
        }
        sound: ${successSound}
        message: "&dФиолетовый скин применён. Перезайди, чтобы увидеть изменения."
      }
    }
  }

  {
    slot: 14
    material: PLAYER_HEAD
    texture: "REPLACE_WITH_PREVIEW_TEXTURE_HASH_BLUE"
    name: "&9Синий"
    click {
      actions {
        closeMenu: 1
        setSkin {
          texture: "REPLACE_WITH_TEXTURE_BASE64_BLUE"
          signature: "REPLACE_WITH_SIGNATURE_BLUE"
        }
        sound: ${successSound}
        message: "&9Синий скин применён. Перезайди, чтобы увидеть изменения."
      }
    }
  }

  {
    slot: 16
    material: BARRIER
    name: "&7Сбросить на стандартный"
    lore: ["&7Вернуть исходный скин."]
    click {
      actions {
        closeMenu: 1
        resetSkin: true
        sound: ${clickSound}
        message: "&7Стандартный скин восстановлен. Перезайди, чтобы увидеть изменения."
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/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: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# 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: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  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&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf ↓ Бандл (.zip)

Бандл включает _shared/templates.conf и INSTALL.txt.

Важно: порядок действий

Внутри блока actions { ... } ключи выполняются в том порядке, в котором они идут в файле. Документация плагина прямо требует ставить closeMenu перед 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.
:::

В каждом блоке click выше closeMenu: 1 стоит первым, затем идёт setSkin. Не меняй порядок.

Где взять реальные texture и signature

Заглушки в этом примере (REPLACE_WITH_TEXTURE_BASE64_GOLD и т.д.) сами по себе не сработают. Чтобы получить реальные значения:

1. Зайди на MineSkin.org.
2. Загрузи изображение или выбери готовый скин.
3. Скопируй поле Texture Data в параметр texture:.
4. Скопируй поле Texture Signature в параметр signature:.

Оба поля - длинные base64-строки. Поле texture у отображаемого PLAYER_HEAD (превью) - это короткий хеш текстуры (та часть, что идёт после http://textures.minecraft.net/texture/<hash>).

Кастомизация

Чтобы добавить новый скин, скопируй любой блок с предметом, поменяй slot:, name:, превью texture: и содержимое setSkin. Общий шаблон со звуком ${successSound} сохраняет одинаковую звуковую обратную связь для всех вариантов.

Если превью не нужно (скажем, хочешь использовать баннер вместо головы), убери поле texture: и поменяй material: на RED_BANNER или что подходит к стилю.

Попробовать

После установки набора примеров:

1. Поставь SkinsRestorer.
2. Замени заглушки REPLACE_WITH_* на реальные texture/signature.
3. Положи бандл в plugins/AbstractMenus/menus/example/.
4. Выполни /am reload.
5. Введи /ame_skins в игре.
6. Кликни на скин. Перезайди, чтобы увидеть изменения.