Pterohost docs

Кейсы и кристаллы на сервере: ExcellentCrates

Как настроить плагин кейсов ExcellentCrates на сервере Minecraft: создание ящиков, ключи, анимации, шансы наград и донат-интеграция.

Кратко: ExcellentCrates - один из лучших плагинов кейсов для Paper/Spigot в 2026 году. Создай файл кейса в /plugins/ExcellentCrates/crates/, пропиши награды с весами, задай анимацию и выдавай ключи командой /crate key give. Готово за 20 минут.

Кейсы и кристаллы на сервере: ExcellentCrates

Кейсы - это проверенный инструмент монетизации и удержания игроков на Minecraft-серверах. Игроки получают ключи за донат, активность или выполнение квестов, открывают кейсы и получают редкие предметы, привилегии или внутриигровую валюту. Плагин ExcellentCrates (разработчик - Nightexpress, актуальная версия в 2026 году - 4.x для Paper 1.20+) предлагает гибкую настройку: YAML-конфиги наград с весами, несколько режимов анимаций, интеграцию с Vault и PlaceholderAPI, голограммы над ящиками и полный набор административных команд. В этой статье разберём установку, создание первого кейса, настройку наград и связку с донат-магазином.

Pterohost - игровой хостинг с NVMe-дисками, защитой от DDoS и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Установка ExcellentCrates

ExcellentCrates распространяется через Modrinth и Hangar (официальные репозитории плагинов). Для работы нужен Paper или Fork (Purpur, Pufferfish) версии 1.20 и выше. Spigot официально не поддерживается начиная с версии 4.x.

Зависимости:

  • Обязательно: нет (плагин работает автономно)
  • Опционально: Vault (для денежных наград), PlaceholderAPI (для голограмм и статистики), HolographicDisplays или DecentHolograms (для голограмм над кейсами)

Шаги установки:

  1. Скачай .jar с Modrinth или Hangar (поиск ExcellentCrates).
  2. Положи файл в /plugins/.
  3. Перезапусти сервер или выполни /reload confirm (не рекомендуется для продакшена).
  4. Плагин создаст папку /plugins/ExcellentCrates/ с подпапками crates/, keys/, lang/, menus/.

После первого запуска проверь консоль - не должно быть ошибок, только строки вида [ExcellentCrates] Loaded X crates.

Структура файлов плагина

/plugins/ExcellentCrates/
  config.yml          - глобальные настройки
  crates/             - один .yml файл = один кейс
    daily.yml
    vip.yml
    elite.yml
  keys/               - конфиги предметов-ключей (опционально)
  menus/              - конфиги меню (превью наград и т.д.)
  lang/
    en.yml            - язык интерфейса

Каждый файл в папке crates/ автоматически загружается как отдельный кейс. ID кейса = имя файла без .yml. Например, vip.yml -> ID кейса vip.

Создание первого кейса

Создай файл /plugins/ExcellentCrates/crates/vip.yml:

# Название кейса (отображается игрокам)
name: "&6&lVIP Кейс"

# Подсказка под названием
description:
  - "&7Откройте и получите VIP-привилегии,"
  - "&7редкие предметы и монеты!"

# Блок или предмет, который будет отображаться как иконка кейса
block:
  material: CHEST

# Анимация открытия
opening_config:
  type: WHEEL
  # Количество одновременно показываемых призов в колесе
  roll_amount: 3
  # Длительность анимации в тиках (20 тиков = 1 секунда)
  roll_time: 60

# Настройки ключа
key:
  # Игровой предмет, который является ключом
  item:
    material: TRIPWIRE_HOOK
    name: "&6Ключ от VIP-кейса"
    lore:
      - "&7Используй, чтобы открыть &6VIP Кейс"
    # Уникальный тег для идентификации ключа
    custom_model_data: 1001

# Список наград
rewards:
  # Каждая награда - именованный блок
  reward_money_small:
    name: "&a500 монет"
    weight: 200          # высокий вес = чаще выпадает
    preview:
      material: SUNFLOWER
    commands:
      - "eco give %player_name% 500"

  reward_money_big:
    name: "&6&l2000 монет"
    weight: 50
    preview:
      material: GOLD_INGOT
    commands:
      - "eco give %player_name% 2000"

  reward_vip_month:
    name: "&bVIP на 30 дней"
    weight: 20
    preview:
      material: DIAMOND
    commands:
      - "lp user %player_name% parent settemp vip 30d"

  reward_diamond_sword:
    name: "&fАлмазный меч [Unbreaking III]"
    weight: 15
    preview:
      material: DIAMOND_SWORD
    items:
      - material: DIAMOND_SWORD
        enchantments:
          UNBREAKING: 3

  reward_key_bonus:
    name: "&eBONUS: ещё 1 ключ"
    weight: 10
    preview:
      material: TRIPWIRE_HOOK
    commands:
      - "crate key give %player_name% vip 1"

  reward_elytra:
    name: "&5&lЭлитра"
    weight: 5            # редкий приз
    preview:
      material: ELYTRA
    broadcast: true      # объявить всему серверу о выпадении
    items:
      - material: ELYTRA

После создания файла выполни /crate reload в консоли или в чате с правами оператора.

Веса и шансы наград

ExcellentCrates использует систему весов (weight), а не прямых процентов. Это удобнее: можно добавлять новые награды без пересчёта всех шансов.

Формула:

Шанс(%) = weight_награды / sum(все weight) * 100

Пример для кейса выше:

НаградаWeightШанс
500 монет20066.7%
2000 монет5016.7%
VIP на 30 дней206.7%
Алмазный меч155.0%
Бонусный ключ103.3%
Элитра51.7%
Итого300100%

Советы по балансу:

  • Главные призы (VIP, редкие предметы) держи в диапазоне weight 1-30.
  • Частые мелкие призы (монеты, опыт) - 100-500.
  • Для “джекпота” раз в 500 открытий ставь weight 1 при сумме всех весов 500.
  • Параметр broadcast: true у редких наград мотивирует других игроков открывать кейсы.

Анимации открытия

ExcellentCrates поддерживает несколько встроенных типов анимаций. Задаются через opening_config.type:

ТипОписание
WHEELКрутящееся колесо, классический слот-стиль
CSGOГоризонтальная прокрутка как в CS:GO
SINGLEПростой одиночный выбор (быстро, без лишнего шума)
EACH_ITEMПоказывает каждый возможный приз поочерёдно

Пример расширенной конфигурации анимации:

opening_config:
  type: CSGO
  roll_amount: 5        # количество слотов в прокрутке
  roll_time: 80         # длительность в тиках
  # Звук при открытии
  open_sound:
    sound: UI_BUTTON_CLICK
    volume: 1.0
    pitch: 1.0
  # Звук при завершении
  win_sound:
    sound: ENTITY_PLAYER_LEVELUP
    volume: 1.0
    pitch: 1.0

Анимация открывается в GUI-меню прямо в игре. Игрок кликает по блоку кейса с ключом в руке или инвентаре - автоматически открывается окно анимации.

Привязка кейса к блоку в мире

Чтобы игроки могли взаимодействовать с кейсом физически (кликать по сундуку, блоку, декорации):

/crate set vip

После этой команды нужно правой кнопкой кликнуть по любому блоку в мире. Блок становится точкой открытия кейса vip. При клике с ключом в руке или инвентаре откроется анимация.

Убрать привязку:

/crate remove <кликнуть по блоку>

Список всех привязанных блоков:

/crate hologram <id> - управление голограммой над блоком

Несколько блоков - один кейс можно привязать к нескольким блокам в разных частях мира командой /crate set vip несколько раз.

Команды администратора

Основные команды ExcellentCrates (требуют право excellentcrates.admin или оператор):

КомандаОписание
/crate listСписок всех загруженных кейсов
/crate reloadПерезагрузить все кейсы из файлов
/crate key give <игрок> <id> <кол>Выдать ключ игроку
/crate key take <игрок> <id> <кол>Забрать ключ у игрока
/crate key check <игрок>Проверить ключи игрока
/crate open <id> <игрок>Открыть кейс для игрока (без ключа)
/crate set <id>Привязать кейс к блоку
/crate preview <id>Открыть превью наград кейса
/crate editorGUI-редактор кейсов (экспериментальный)

Команды для игроков (требуют право excellentcrates.use):

КомандаОписание
/crate preview <id>Просмотр возможных наград
/crate keysСписок своих ключей

Голограммы над кейсами

ExcellentCrates поддерживает голограммы через интеграцию с DecentHolograms или HolographicDisplays. Голограмма автоматически появляется над привязанным блоком.

Конфигурация голограммы в файле кейса:

hologram:
  enabled: true
  y_offset: 1.5          # высота над блоком в блоках
  lines:
    - "&6&lVIP КЕЙС"
    - "&7Нажми, чтобы открыть"
    - "&eНужен: &6Ключ VIP"
    - ""
    - "&fОткрыто сегодня: &a%excellentcrates_crate_openings_vip%"

Плейсхолдер %excellentcrates_crate_openings_vip% требует установленного PlaceholderAPI и даёт статистику открытий конкретного кейса.

Для установки DecentHolograms:

  • Скачай с Hangar или Modrinth
  • Положи в /plugins/
  • Перезапусти сервер - ExcellentCrates автоматически обнаружит его и создаст голограммы

Интеграция с донат-системой

Ключи от кейсов - отличный донат-товар. Схема интеграции зависит от используемой системы.

Магазин через консольные команды (универсальный способ)

Большинство донат-платформ (GaveSite, DonationStore, Tebex) поддерживают выполнение команд после оплаты. Настрой выполнение:

crate key give {player} vip 3

Замени {player} на плейсхолдер своей платформы (в Tebex это {username}).

Интеграция с плагином донат-системы на сервере

Если используешь плагины типа DonateCase или собственный магазин на сервере:

# В конфиге своего донат-плагина
purchase_vip_keys:
  command: "crate key give %player% vip 5"
  price: 199

Автоматическое начисление за активность

Выдача ключей за рейтинг активности, голосование, выполнение квестов:

# Пример для плагина Votifier / NuVotifier
vote_rewards:
  commands:
    - "crate key give %player% daily 1"
    - "crate key give %player% vip 1"

Или в конфиге EssentialsX Jobs / JobsReborn:

Jobs:
  Miner:
    levelup-commands:
      10:
        - "crate key give %player% daily 2"
      25:
        - "crate key give %player% vip 1"

Несколько типов кейсов: рекомендуемая структура

На продакшен-сервере рекомендуется иметь 3-4 кейса с разным балансом:

КейсIDИсточник ключейПримерный топ-приз
ЕжедневныйdailyГолосование, ежедневный бонусРедкий ресурс
VIPvipДонат от 99 руб.VIP на месяц
ЭлитныйeliteДонат от 299 руб.Элитра, кейп
ИвентовыйeventТолько на ивентахЭксклюзивные предметы

Создай отдельный .yml файл для каждого кейса в папке crates/. Они не конфликтуют между собой.

Настройка прав доступа через LuckPerms

Игроки по умолчанию не могут открывать кейсы без права excellentcrates.use. Настрой через LuckPerms:

# Выдать право всем игрокам
/lp group default permission set excellentcrates.use true

# Запретить конкретный кейс (если нужно ограничение по рангу)
/lp group default permission set excellentcrates.crate.elite false
/lp group vip permission set excellentcrates.crate.elite true

Права на конкретный кейс имеют формат excellentcrates.crate.<id_кейса>. По умолчанию все права открыты для игроков с excellentcrates.use.

Связанные материалы

Для полноценной экономики сервера с кейсами рекомендуем изучить настройку Vault и экономических плагинов - без этого денежные награды из кейсов не будут работать. Список других полезных плагинов для сервера собран в статье лучшие плагины для Minecraft-сервера. Если настраиваешь донат-привилегии через кейсы, понадобится LuckPerms - управление правами и рангами.

Заключение

ExcellentCrates - зрелый и активно поддерживаемый плагин кейсов для Minecraft Paper 1.20+. Система весов делает настройку шансов интуитивной, анимации удерживают интерес игроков, а консольные команды для выдачи ключей позволяют легко интегрировать кейсы с любой донат-платформой. Начни с одного-двух кейсов (например, ежедневного и VIP), настрой голограммы для визуальной привлекательности и отслеживай статистику открытий через PlaceholderAPI. Постепенно расширяй ассортимент кейсов по мере роста сервера.

Pterohost - хостинг Minecraft-серверов с NVMe SSD, защитой от DDoS-атак и технической поддержкой круглосуточно. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг