Плагин - hEnderChest | Продвинутая система эндер-сундуков: размер по правам, покупка слотов

Поддерживаемые версии

1.21

Ядра и Прокси

Bukkit
Spigot
Paper

Минимальная версия Java: 21

hEnderChest
Продвинутая система эндер-сундуков для Minecraft-серверов

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

hEnderChest — это гибкий плагин для кастомных эндер-сундуков на сервере.

Плагин позволяет создавать виртуальные эндер-сундуки с настраиваемым размером, правами на количество слотов, покупкой дополнительных слотов, меню подтверждения покупки, SQLite/MySQL-хранилищем, поддержкой PlaceholderAPI и гибкой системой действий.

hEnderChest подойдёт для survival-серверов, экономических серверов, донатных хранилищ, систем прокачки, RPG-прогрессии, кастомных меню и любых проектов, где обычного эндер-сундука недостаточно.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Основные возможности

Кастомные виртуальные эндер-сундуки

hEnderChest заменяет обычную механику эндер-сундука на управляемую систему виртуального хранилища.

Игроки могут открывать свой эндер-сундук через команду или через взаимодействие с блоком эндер-сундука, если у них есть нужные права.

Данные хранятся в базе данных, поэтому вы можете отдельно контролировать доступ, размер, купленные слоты и админское управление хранилищем.

────────────────────────────────────────

Два режима работы

Плагин поддерживает два режима.

Код:

settings:
  mode: 1

Режим 1 — простой режим без покупки слотов. Игрок получает столько слотов, сколько ему доступно по правам.

Код:

settings:
  mode: 2

Режим 2 — режим с покупкой слотов. Инвентарь может отображать до 54 слотов, а заблокированные слоты показываются как настраиваемые предметы до покупки.

Это позволяет выбрать либо простую систему размера хранилища, либо полноценную систему прокачки эндер-сундука.

────────────────────────────────────────

Размер эндер-сундука через права

Размер хранилища можно контролировать через permissions.

Доступные права на размер:

Код:

henderchest.size.9
henderchest.size.18
henderchest.size.27
henderchest.size.36
henderchest.size.45
henderchest.size.54

Так можно выдавать больше места донат-группам, рангам, персоналу или отдельным игрокам.

────────────────────────────────────────

Система покупки слотов

Во втором режиме игроки могут открывать новые слоты прямо в меню эндер-сундука.

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

Пример заблокированного слота:

Код:

buy:
  1:
    confirm: true
    slots: [0,1,2,3,4,5,6,7,8]
    material: "ORANGE_STAINED_GLASS_PANE"
    name: "&fЗаблокированный слот"
    lore:
      - "&fНажмите, чтобы купить слот"

Эта система хорошо подходит для экономики, донатных улучшений, наград, кейсов, квестов и долгосрочной прокачки на survival-серверах.

────────────────────────────────────────

Меню подтверждения покупки

Для покупки слотов можно включить подтверждение.

Меню подтверждения полностью настраивается:

Название меню
Размер меню
Кнопка подтверждения
Кнопка отмены
Декоративные предметы
Действия при клике по предметам

Пример:

Код:

confirm:
  title: "&0Подтверждение покупки"
  size: 45
  "yes":
    slots: [20]
    material: "LIME_STAINED_GLASS_PANE"
  "no":
    slots: [24]
    material: "RED_STAINED_GLASS_PANE"

Это защищает игроков от случайных покупок и делает систему улучшений более удобной.

────────────────────────────────────────

Гибкие условия покупки

Покупки могут использовать выражения на основе PlaceholderAPI.

Пример:

Код:

leftClick:
  expressions:
    - "1:%playerpoints_points% >= 250"
    - "2:%vault_eco_balance% >= 5000"
  actionsOnBuy:
    - "[Message] {prefix} Слот {slots} успешно куплен!"
    - "[Console] p take {player} 250 -s"
    - "[Vault] action:remove && count:5000.0"
  actionsOnCancel_1:
    - "[Message] {prefix} У вас недостаточно поинтов."
  actionsOnCancel_2:
    - "[Message] {prefix} У вас недостаточно монет."

Можно создавать разные требования для разных слотов, валют, рангов или типов клика.

────────────────────────────────────────

Настройки для разных типов клика

Во втором режиме можно отдельно настроить разные клики.

Доступные секции:

Код:

leftClick
rightClick
middleClick
shiftRightClick
shiftLeftClick
allClick

Это позволяет делать разные сценарии покупки в зависимости от того, как игрок нажимает на заблокированный слот.

────────────────────────────────────────

Хранение данных

hEnderChest сохраняет содержимое эндер-сундуков в базе данных.

Поддерживаемые типы базы данных:

SQLite
MySQL

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

Код:

enderchest_mode1.db
enderchest_mode2.db

MySQL можно включить в конфиге:

Код:

settings:
  database:
    type: "mysql"
    mysql:
      host: "localhost"
      port: 3306
      database: "minecraft"
      user: "root"
      password: ""

Это полезно для серверов с большим онлайном, постоянным хранением данных и централизованной базой.

────────────────────────────────────────

Открытие по команде или клику

Игрок может открыть свой эндер-сундук командой:

Код:

/enderchest
/ec

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

Вы сами решаете, каким способом игроки будут получать доступ к хранилищу.

────────────────────────────────────────

Открытие чужих эндер-сундуков

Персонал сервера может открывать эндер-сундуки других игроков:

Код:

/enderchest <ник>

Это удобно для проверок, модерации и управления хранилищами.

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

────────────────────────────────────────

Защита от изменения чужого хранилища

Если администратор или модератор открывает чужой эндер-сундук, это не значит, что он автоматически может его изменять.

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

Код:

henderchest.modify

Без этого права взаимодействие с чужим эндер-сундуком будет заблокировано.

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

────────────────────────────────────────

Админское управление слотами

Во втором режиме администраторы могут вручную управлять купленными слотами игроков.

Команды:

Код:

/henderchest addslots <ник> <кол-во>
/henderchest removeslots <ник> <кол-во>
/henderchest setslots <ник> <кол-во>

Количество также может быть указано диапазоном.

Пример:

Код:

/henderchest addslots Steve 1-9

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

────────────────────────────────────────

Гибкая система действий

hEnderChest имеет систему действий, которую можно настраивать через конфиги.

Основные секции действий:

Код:

actions.interactOpen
actions.commandOpen
actions.someoneOpen
actions.noPerms

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

Код:

buyPrevious.actions
buy.<id>.<click>.actionsOnBuy
buy.<id>.<click>.actionsOnCancel_<номер>
confirm.myItems.<id>.actions

Это позволяет управлять сообщениями, звуками, командами, эффектами и результатом покупки без изменения кода.

────────────────────────────────────────

Поддерживаемые типы действий

Плагин поддерживает разные типы действий:

Код:

[MESSAGE]
[BROADCAST]
[CONSOLE]
[PLAYER]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[FIREWORK]
[EFFECT]
[VAULT]
[CLOSE]
[ACHIVEMENT]

Пример:

Код:

actions:
  commandOpen:
    - "[Message] {prefix} Вы открыли эндер-сундук."
    - "[Sound] sound:BLOCK_ENDER_CHEST_OPEN && volume:1.0 && pitch:1.0"

  noPerms:
    - "[Message] {prefix} У вас нет права {permission}"

────────────────────────────────────────

Hex-цвета и плейсхолдеры

Плагин поддерживает обычные цветовые коды и hex-цвета.

Пример:

Код:

#FDBE00
&f
&7

В сообщениях, названиях предметов, описаниях и условиях можно использовать PlaceholderAPI.

Это позволяет делать красивые меню, информативные сообщения и гибкие условия покупки.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Команды

Код:

/enderchest
/ec
/enderchest <ник>
/henderchest
/henderchest help
/henderchest reload
/henderchest addslots <ник> <кол-во|диапазон>
/henderchest removeslots <ник> <кол-во|диапазон>
/henderchest setslots <ник> <кол-во|диапазон>

Описание команд:

Код:

/enderchest                                   - открыть свой эндер-сундук
/ec                                           - алиас команды /enderchest
/enderchest <ник>                             - открыть эндер-сундук другого игрока
/henderchest                                  - показать админскую помощь
/henderchest help                             - показать админскую помощь
/henderchest reload                           - перезагрузить конфиг
/henderchest addslots <ник> <кол-во>          - добавить купленные слоты во втором режиме
/henderchest removeslots <ник> <кол-во>       - удалить купленные слоты во втором режиме
/henderchest setslots <ник> <кол-во>          - установить купленные слоты во втором режиме

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

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Права

Код:

henderchest.size.9          - доступ к 1 строке
henderchest.size.18         - доступ к 2 строкам
henderchest.size.27         - доступ к 3 строкам
henderchest.size.36         - доступ к 4 строкам
henderchest.size.45         - доступ к 5 строкам
henderchest.size.54         - доступ к 6 строкам
henderchest.open.interact   - открытие через клик по эндер-сундуку
henderchest.open.command    - открытие через команду
henderchest.others          - открытие эндер-сундуков других игроков
henderchest.offline         - право, объявленное для доступа к оффлайн-игрокам
henderchest.modify          - изменение эндер-сундуков других игроков
henderchest.admin           - доступ к админским командам /henderchest

По умолчанию все права в plugin.yml выданы OP.

Для обычных игроков обычно нужно выдать минимум:

Код:

henderchest.open.command
henderchest.open.interact
henderchest.size.9

Дальше размер можно увеличивать через права на слоты или через систему покупки.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PlaceholderAPI

hEnderChest регистрирует плейсхолдеры с идентификатором:

Код:

henderchest

Доступные плейсхолдеры:

Код:

%henderchest_size%
%henderchest_purchased%
%henderchest_available%

Описание:

Код:

%henderchest_size%       - текущий размер эндер-сундука игрока
%henderchest_purchased%  - купленные слоты во втором режиме
%henderchest_available%  - доступные слоты игрока

Эти плейсхолдеры можно использовать в scoreboard, TAB, меню, holograms и других плагинах с поддержкой PlaceholderAPI.

────────────────────────────────────────

Внутренние плейсхолдеры

Эти плейсхолдеры можно использовать в сообщениях и действиях плагина:

Код:

{prefix}
{player}
{uuid}
{slots}
{slot}
{size}
{target}
{targetName}
{permission}
{slotsText}

Они полезны для сообщений, названий GUI, уведомлений о покупке и ответов админских команд.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Зависимости

Обязательные:

Java 21 или новее
Paper API 1.21 или новее
PlaceholderAPI

Опциональные:

Vault-экономика
MySQL-база данных

Vault нужен только если вы планируете использовать Vault-действия или условия покупки, связанные с экономикой.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Установка

Установите PlaceholderAPI.
Поместите hEnderChest.jar в папку plugins.
Перезапустите сервер.
Откройте папку плагина.
Выберите режим работы в config.yml.
Настройте базу данных, если хотите использовать MySQL.
Выдайте игрокам нужные права.
После изменения конфигов выполните reload или перезапустите сервер.

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

Код:

plugins/hEnderChest/config.yml
plugins/hEnderChest/mode2.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Файлы конфигурации

config.yml

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

mode2.yml

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

Такое разделение делает конфиги чище и удобнее для настройки системы улучшения эндер-сундука.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Для чего можно использовать hEnderChest

Кастомный эндер-сундук
Донатные улучшения хранилища
Размер эндер-сундука по рангам
Постепенная разблокировка слотов
Покупка слотов за валюту
Награды из кейсов или квестов
Проверка хранилища персоналом
Личное хранилище игроков
Прогрессия на survival-сервере

hEnderChest даёт полный контроль над тем, как игроки получают доступ к своему эндер-сундуку и расширяют его.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Почему hEnderChest

hEnderChest — это не просто команда /ec.

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

Всё настраивается через YAML, поэтому систему можно адаптировать под экономику, ранги и стиль прогрессии вашего сервера.

Зависимости: Vault, PlaceholderAPI (Опционально)

Команды и права

Команда	Право	Описание
Отсутствует	henderchest.size.<9/18/27/36/45/54>	Увеличение размера эндерсундука для определённого mode в конфиге
Отсутствует	henderchest.open.interact	Доступ к открытию эндерсундука по нажатию на него
/ec или /enderchest	henderchest.open.command	Доступ к открытию эндерсундука командой
/ec или /enderchest <Ник игрока в сети>	henderchest.others	Доступ к открытию чужого эндерсундука в сети
/ec или /enderchest <Ник игрока в оффлайне>	henderchest.offline	Доступ к открытию чужого эндерсундука в оффлайне
/ec или /enderchest	henderchest.modify	Доступ к перемещению вещей внутри чужого онлайн/оффлайн эндерсундука

Реакции: Радик, qweyns, canduman987 и 4 других

Плагин hEnderChest | Продвинутая система эндер-сундуков: размер по правам, покупка слотов v2.3

Другие ресурсы пользователя He3HaukaX

Поделиться ресурсом

Последние обновления

Обновление!

Обновление!

Фикс

Последние рецензии

Мы ценим вашу конфиденциальность