Pterohost docs

ChestShop: магазины в сундуках на сервере Minecraft

Как установить ChestShop на сервер Minecraft, настроить Vault-экономику и создать магазины в сундуках - подробный гайд 2026.

Кратко: ChestShop - плагин для создания магазинов через таблички и сундуки. Установите Vault + плагин экономики + ChestShop, поставьте сундук, напишите табличку над ним - и магазин готов. Админ-шопы работают без сундука.

ChestShop: магазины в сундуках на сервере Minecraft

ChestShop - один из самых популярных торговых плагинов для Minecraft-серверов с выживанием и экономикой. Принцип прост: ставишь сундук, вешаешь над ним табличку с ценой - и любой игрок может купить или продать предмет. Плагин работает на Bukkit/Spigot/Paper начиная с версии 1.16, активно поддерживается в 2026 году и совместим со всей экосистемой Vault-экономики. В этом гайде разберём установку с нуля, форматы табличек, настройку конфига, создание админ-шопов и типичные проблемы, с которыми сталкиваются администраторы.

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

Требования и зависимости

ChestShop не работает самостоятельно - ему нужны два дополнительных плагина.

Обязательные зависимости:

ПлагинНазначениеГде скачать
VaultAPI-прослойка между экономикой и плагинамиSpigotMC / Modrinth
Плагин экономикиХранит балансы игроковEssentialsX, CMI, или другой
ChestShopСам плагин магазиновSpigotMC

Рекомендуемая связка в 2026 году: Paper 1.21.x + EssentialsX (включает EssentialsX Economy) + Vault + ChestShop 3.14+.

Совместимые плагины экономики:

  • EssentialsX Economy - бесплатный, самый распространённый
  • CMI - платный, но богатый функционал
  • Economy API (iConomy-совместимые) - устаревшие, но работают через Vault

Vault работает как “переводчик” - ChestShop не знает, какой плагин экономики установлен, он просто обращается к Vault. Это позволяет менять экономику без переписывания ChestShop.

Установка ChestShop

Шаг 1: загрузить плагины

Скачайте последние стабильные JAR-файлы:

Vault-1.7.3.jar          -> в /plugins/
EssentialsX-2.21.0.jar   -> в /plugins/
EssentialsXChat (опц.)   -> в /plugins/
ChestShop-3.14.jar       -> в /plugins/

Файлы кладутся в папку plugins/ вашего сервера.

Шаг 2: перезапустить сервер

После копирования файлов перезапустите сервер командой stop в консоли и запустите снова. При первом старте каждый плагин создаст свою папку с конфигурацией.

Шаг 3: проверить загрузку

В консоли должны появиться строки:

[Vault] Enabling Vault v1.7.3
[EssentialsX] Enabling EssentialsX v2.21.0
[ChestShop] Enabling ChestShop v3.14
[ChestShop] Vault found, economy: EssentialsX Economy

Если ChestShop пишет No economy plugin found - проверьте, что Vault установлен и плагин экономики запустился без ошибок.

Шаг 4: проверить плагины в игре

Войдите на сервер и выполните:

/plugins

В списке должны быть зелёными: Vault, EssentialsX, ChestShop.

Формат таблички магазина

Табличка ChestShop состоит из ровно четырёх строк. Каждая строка выполняет свою роль:

Строка 1: [имя владельца]   <- пустая = ваш ник
Строка 2: [количество]       <- целое число (1-64, для стаков)
Строка 3: [цена]             <- B <цена> : S <цена>
Строка 4: [предмет]          <- название или ID

Примеры рабочих табличек:

Продажа алмазов за 100 монет, выкуп за 50:

(пусто)
1
B 100 : S 50
DIAMOND

Только покупка (игроки покупают у вас):

(пусто)
64
B 500
COBBLESTONE

Только продажа (игроки продают вам):

(пусто)
1
S 80
IRON_INGOT

Магазин другого игрока (если у вас есть права):

Steve
16
B 200 : S 100
WHEAT

Названия предметов берутся из стандартных ID Minecraft (в верхнем регистре через подчёркивание). ChestShop также поддерживает псевдонимы: DIAMOND, IRON_INGOT, OAK_LOG и т.д. Для точного ID используйте команду /iteminfo или держите нужный предмет в руке при создании таблички (в этом случае строку 4 можно оставить пустой).

Создание магазина шаг за шагом

  1. Поставьте сундук в доступном для игроков месте.
  2. Заполните сундук товаром (для магазина продажи).
  3. Нажмите ПКМ по знаку (таблице) и напишите четыре строки.
  4. Нажмите готово - ChestShop подсветит табличку и выведет подтверждение в чат.

Важно: табличка должна быть непосредственно над сундуком - на блок выше или на стенке сундука. ChestShop определяет привязку по направлению.

Взаимодействие покупателя:

  • ПКМ по табличке - покупка предмета
  • Shift + ПКМ по табличке - продажа предмета
  • Просто посмотреть на табличку - информация о ценах

Конфигурация ChestShop

Основной конфиг находится по пути plugins/ChestShop/config.yml. Разберём важные параметры:

# Разрешать ли игрокам создавать магазины
allow_create: true

# Минимальная цена (0 = без ограничений)
minimum_price: 0.01

# Максимальная цена (0 = без ограничений)
maximum_price: 0

# Сколько магазинов может создать один игрок
shops_per_player: 0   # 0 = без лимита

# Уведомлять ли владельца о транзакции
notify_on_buy: true
notify_on_sell: true

# Защита: только владелец может забрать товар
protection:
  enabled: true

# Логировать ли транзакции
log_to_file: true
log_file: logs/transactions.log

Параметр shops_per_player стоит ограничить на новых серверах - например, до 10-20 магазинов, чтобы игроки не спамили табличками.

Параметр protect_chest (если есть в вашей версии) включает встроенную защиту сундука от кражи. Однако лучше использовать отдельный плагин защиты - LWC или аналог.

После изменения конфига перезагрузите плагин:

/cs reload

или перезапустите сервер целиком.

Права (permissions) ChestShop

ChestShop использует систему прав через LuckPerms или любой другой Permissions-плагин, совместимый с Vault.

Основные права:

ПравоОписание
chestshop.shop.buyПокупать в магазинах
chestshop.shop.sellПродавать в магазинах
chestshop.shop.createСоздавать свои магазины
chestshop.shop.create.adminСоздавать админ-шопы
chestshop.shop.removeУдалять свои магазины
chestshop.modУдалять чужие магазины (для модераторов)
chestshop.adminПолные права администратора
chestshop.notaxОсвобождение от налога на транзакции

Базовая настройка через LuckPerms для группы default:

/lp group default permission set chestshop.shop.buy true
/lp group default permission set chestshop.shop.sell true
/lp group default permission set chestshop.shop.create true

Для VIP-группы - дополнительно:

/lp group vip permission set chestshop.notax true

Админ-магазины с бесконечным товаром

Обычный магазин ограничен содержимым сундука. Как только товар заканчивается - покупка невозможна. Админ-шоп решает эту проблему: он генерирует товар из воздуха.

Создание админ-шопа:

Напишите в первой строке таблички [Admin] (с заглавной A, регистр важен в старых версиях, в новых - нет):

[Admin]
1
B 500
DIAMOND

Или используйте имя игрока с правом chestshop.shop.create.admin. Для такого магазина сундук не нужен вообще - табличку можно повесить на любую стену.

Когда использовать админ-шопы:

  • Стартовые ресурсы (булыжник, дерево) по фиксированной цене
  • Продажа ключей, токенов, специальных предметов
  • Глобальный выкупщик (игроки сдают лут серверу)

Налог на транзакции можно настроить в конфиге - процент от каждой покупки уходит “в воздух” или на определённый аккаунт. Это помогает бороться с инфляцией:

tax_on_buy: 5     # 5% налог при покупке
tax_on_sell: 0    # без налога на продажу
tax_account: Economy  # аккаунт-получатель (или "" для удаления монет)

Защита сундуков магазинов

Сундук с магазином нужно защищать от взлома - иначе игрок может просто выломать сундук и забрать товар.

Вариант 1: LWC

Самый популярный плагин защиты сундуков. После установки игрок пишет /cprivate и кликает по сундуку. Покупатели всё равно смогут взаимодействовать с табличкой.

/cprivate   <- защитить сундук
/cinfo      <- информация о защите
/cremove    <- снять защиту

Вариант 2: WorldGuard регионы

Для больших рыночных зон создайте регион и запретите взаимодействие чужим игрокам:

/rg define market
/rg flag market chest-access deny
/rg addmember market <владелец>

Вариант 3: встроенная защита ChestShop

В config.yml включите:

protection:
  enabled: true
  allow_hopper_out: false  # запретить хоперам тянуть из магазина

Это не замена полноценному плагину защиты, но предотвращает кражу через хоперы.

Важный нюанс: если вы используете LWC или AxProtect, убедитесь, что ChestShop добавлен в список доверенных плагинов. Иначе транзакции через табличку будут заблокированы. В LWC это настраивается автоматически при совместной установке.

Команды ChestShop

Все команды начинаются с /chestshop или сокращённо /cs:

/cs list                  -> список ваших магазинов
/cs list <игрок>          -> магазины другого игрока (для модераторов)
/cs remove <#>            -> удалить свой магазин по номеру
/cs reload                -> перезагрузить конфиг
/cs version               -> версия плагина

Для администраторов:

/cs removeAll <игрок>     -> удалить все магазины игрока
/cs report                -> статистика транзакций

Типичные ошибки и их решение

Ошибка: “You don’t have permission to create a shop”

Причина - игроку не выдано право chestshop.shop.create. Решение:

/lp user <ник> permission set chestshop.shop.create true

или добавьте право для всей группы default (см. раздел про права).

Ошибка: “No economy plugin found”

Vault не видит плагин экономики. Проверьте:

  1. Установлен ли EssentialsX (не просто Essentials, а именно EssentialsX).
  2. Нет ли ошибок в консоли при загрузке EssentialsX.
  3. Версия Vault совместима с вашей версией сервера.

Ошибка: табличка создаётся, но товар не продаётся

Скорее всего, сундук пустой или привязка сундука не работает. Убедитесь, что:

  • Сундук стоит прямо под табличкой (или на блок ниже).
  • Сундук не является двойным, смотрящим не в ту сторону.
  • В сундуке есть нужный товар.

Ошибка: формат таблички не распознаётся

ChestShop очень строг к формату. Проверьте:

  • Строка 3 должна быть в формате B <цена>, S <цена> или B <цена> : S <цена>.
  • После B и S обязателен пробел.
  • Двоеточие разделяет цену покупки и продажи через пробелы: B 100 : S 50.
  • Предмет в строке 4 должен быть точным ID (регистр не важен в современных версиях).

Хоперы тянут товар из магазина

Отключите в конфиге:

protection:
  allow_hopper_out: false
  allow_hopper_in: false

Магазин дублирует транзакции

Редкий баг, возникает при лаге сервера. Включите log_to_file и отслеживайте двойные записи. Обычно решается обновлением ChestShop до последней версии.

Расширения и совместимые плагины

ChestShop хорошо интегрируется с экосистемой экономических плагинов:

ChestShop-StorageManager - расширение для хранения логов в MySQL/SQLite вместо файла. Полезно для серверов с активной торговлей.

ShopGUI+ - альтернатива для администраторских магазинов с GUI-интерфейсом. Может работать параллельно с ChestShop.

QuickShop Hikari - полноценная альтернатива ChestShop с более современным интерфейсом. Если вы только выбираете плагин - рассмотрите оба варианта.

Dynmap-ChestShop - отображает магазины игроков на Dynmap-карте мира.

DiscordSRV - при настройке интеграции можно слать уведомления о крупных сделках в Discord.

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

Для полноценной работы магазинов важна стабильная основа сервера. Прочитайте настройку server.properties - там описаны ключевые параметры производительности, влияющие на задержки при транзакциях. Если магазины начинают лагать при нагрузке - изучите руководство по устранению лагов. Для тонкой настройки прав и групп игроков (кто может создавать магазины, у кого нет налога) необходим LuckPerms.

Заключение

ChestShop - зрелый и надёжный плагин, который работает на серверах годами без существенных проблем. Установка занимает 10-15 минут: скачайте Vault, плагин экономики и ChestShop, перезапустите сервер, выдайте права - и игроки могут открывать магазины. Ключевой момент - правильный формат таблички и защита сундуков от кражи. Админ-шопы с тегом [Admin] решают проблему пустых складов для базовых ресурсов. Настройте налог на транзакции, чтобы контролировать инфляцию - это важно для долгосрочного здоровья экономики на выживании.

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