Режимы: BLOCKS и RARITY

Шахта работает в одном из двух режимов — плоский список блоков или переключающиеся редкости.

BLOCKS — фиксированный список блоков

Один список блоков с шансами, который заново заполняет шахту при каждом сбросе. Состав не меняется — меняется только то, где именно какой блок оказался.

mode: BLOCKS
blocks:
  - id: stone
    chance: 100.0

Это режим по умолчанию для новой шахты — самый простой и предсказуемый.

RARITY — переключающиеся редкости

Внутри шахты — несколько «редкостей», у каждой свой набор блоков. При сбросе плагин выбирает одну редкость по её собственному шансу, и вся шахта заполняется блоками именно этой редкости.

mode: RARITY
rarity:
  - id: default
    chance: 75.0
    name: '&fОбычная'
    blocks:
      - id: stone
        chance: 80.0
      - id: iron_ore
        chance: 19.0
      - id: diamond_ore
        chance: 1.0
  - id: epic
    chance: 25.0
    name: '&5Эпическая'
    icon: diamond_block
    blocks:
      - id: stone
        chance: 50.0
      - id: diamond_ore
        chance: 3.5

Плейсхолдеры редкости %rarity_current% и %rarity_next% показывают текущую и следующую (уже выбранную, но ещё не активированную) редкость — удобно предупредить игроков заранее через голограмму или действие.

icon у редкости — необязательное поле: своя иконка в GUI-списке редкостей вместо одной иконки на все. Подробнее про сам список — в GUI меню → Редкости.

Переключение режима

Кнопка «Режим» в главном GUI шахты переключает BLOCKS ↔ RARITY на лету:

BLOCKS → RARITY: текущие блоки становятся редкостью default.
RARITY → BLOCKS: остаются блоки только первой редкости, остальные теряются — плагин честно предупреждает об этом в подсказке кнопки.