LostCases

3.1 Декоративные предметы (Декор)

Обычные предметы с фиксированным материалом, названием и описанием. Они служат для оформления меню, заполнения пустого пространства и не вызывают никаких игровых событий при клике.

Параметры элемента декора:

• material: Материал предмета в игре (например, GRAY_STAINED_GLASS_PANE).
• name: Название предмета (поддерживает цветовые коды, для пустого имени укажите " ").
• slots или slot: Список слотов или один слот, где будет размещен предмет.
• lore: *(Опционально)* Список строк описания предмета.

- material: GRAY_STAINED_GLASS_PANE
  name: " "
  slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 35, 36, 44]

3.2 Отображение ключей игрока (тип: case)

Тип case динамически выводит в меню предметы кейсов, от которых у игрока есть ключи в данный момент. Каждый ключ отображается как **отдельный предмет**.

Как это работает:

• Плагин сканирует все доступные кейсы и количество ключей игрока для каждого.
• Для каждого ключа генерируется индивидуальный предмет. Если у игрока 3 золотых ключа и 2 обычных, плагин создаст 5 предметов по очереди, расположив их в указанных слотах.
• Открытие по ЛКМ: При клике левой кнопкой мыши по такому предмету меню закрывается, списывается 1 ключ и запускается анимация открытия этого кейса.

Параметры элемента "case":

• type: Обязательно значение case.
• slots: Список слотов под кейсы. Кейсы заполняются по очереди.
• material: *(Опционально)* Переопределяет материал предмета. Если не указан, берется материал самого кейса из начала его конфига.
• name / lore: *(Опционально)* Кастомное имя и описание предмета в меню с поддержкой плейсхолдеров.

- type: case
  slots: [10, 11, 12, 13, 14, 15, 16]
  name: "&bКейс: %case_display_name%"
  lore:
    - "&7Ключей: &e%keys% шт."
    - "&aНажмите ЛКМ, чтобы открыть!"

Плейсхолдеры для "case":

• %case_display_name% — Имя кейса, которому принадлежит предмет.
• %keys% — Количество ключей игрока для этого кейса.
• %all_keys% — Общее количество ключей игрока от всех кейсов.
• %username% — Никнейм игрока.

3.3 Кнопка мгновенного запуска (action: start)

Предмет-кнопка, при нажатии на который запускается открытие того кейса, блок которого был нажат в мире. Ключ списывается со счета игрока.

Параметры кнопки старта:

• material: Предмет кнопки в инвентаре (например, TRIPWIRE_HOOK).
• action: Обязательно значение start.
• slots: Слот, в котором находится кнопка (обычно центр меню).
• name / lore: Отображаемое имя и описание кнопки.

- material: TRIPWIRE_HOOK
  name: "&aНачать открытие"
  lore:
    - "&7Требуется 1 ключ"
  slots: [22]
  action: start

3.4 Элементы истории выигрышей (type: history-N)

Выводят последние выигранные призы в данном кейсе на сервере. Поддерживается до 9 слотов истории.

Как это работает:

• type: history-1 отображает самую последнюю награду, history-2 — предшествующую ей и так далее.
• Если истории выигрышей еще нет, предмет автоматически заменяется на серый краситель с текстом Нет истории (сообщение настраивается в языковом файле).
• При наведении на предмет истории показывается ник победителя и выигранная им награда.

- type: history-1
  slots: [45]
- type: history-2
  slots: [46]

3.1 Static Decorative Items (Decor)

Standard items with static materials, display names, and lore descriptions. They are used for menu styling and filling empty space, triggering no events on click.

Decor Item Parameters:

• material: The Minecraft material name (e.g. GRAY_STAINED_GLASS_PANE).
• name: The item's display name (supports color codes; use " " for empty name).
• slots or slot: Coordinates where the item will be rendered.
• lore: *(Optional)* List of item lore strings.

- material: GRAY_STAINED_GLASS_PANE
  name: " "
  slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 35, 36, 44]

3.2 Player Key Slots (type: case)

The case type dynamically displays case items representing key slots that the player currently owns. Each key is rendered as a **separate stack**.

How it works:

• The plugin checks all loaded cases and the player's keys for each.
• For every single key, a separate item stack is generated. If a player owns 3 golden keys and 2 common keys, the menu will show 5 items sequentially in the designated slots.
• Left-Click Opening: Left-clicking any case item closes the GUI, takes 1 key, and immediately triggers the opening animation at the block.

"case" Item Parameters:

• type: Must be set to case.
• slots: List of slot coordinates to populate with cases.
• material: *(Optional)* Overrides the item material. If not set, it defaults to the case block's material.
• name / lore: *(Optional)* Custom name and lore supporting placeholders.

- type: case
  slots: [10, 11, 12, 13, 14, 15, 16]
  name: "&bCase: %case_display_name%"
  lore:
    - "&7Keys: &e%keys% pcs."
    - "&aLeft-Click to open!"

Placeholders for "case":

• %case_display_name% — The display name of the case.
• %keys% — Number of keys the player owns for this specific case.
• %all_keys% — Total keys the player owns across all cases on the server.
• %username% — The nickname of the player.

3.3 Instant Start Button (action: start)

A button that, when clicked, consumes 1 key and starts the opening animation for the clicked case block in the world.

Start Button Parameters:

• material: Button item material (e.g. TRIPWIRE_HOOK).
• action: Must be set to start.
• slots: The slot coordinate for the button (usually the center).
• name / lore: Custom display name and lore.

- material: TRIPWIRE_HOOK
  name: "&aStart Opening"
  lore:
    - "&7Requires 1 key"
  slots: [22]
  action: start

3.4 Winner History Items (type: history-N)

Displays the history of recently won prizes from this case on the server. Supports up to 9 history slots.

How it works:

• type: history-1 shows the most recent win, history-2 shows the one before that, etc.
• If there is no history recorded yet, the slot displays gray dye with the text No history.
• Hovering over the item reveals the winner's name and their prize.

- type: history-1
  slots: [45]
- type: history-2
  slots: [46]