Chest commands

v1.5

It’s highly recommanded to regenerate the plugin’s folder. Make a backup of your menu.yml. This is because the configuration changed.

• Added multiple menus: you will find them in /plugins/ChestCommands/menu folder. You will also find a tutorial.
• Added command type -> ‘ open:filename.yml ‘ to open another menu
• Added extra check for items out of the chest: it will now cut the items that are out of the chest.
• New permission system: to open the menu with commands chestcommands.open.filename.yml (eg chestcommands.open.menu.yml)
  and to open the menu with the item: chestcommands.item.filename.yml. This will not give you the permission to open the menu from another one, nor the permission to use the command.
• Per-menu settings: inside each .yml file you can set the name, the amount of rows, the item (optional) and the command (optional).
• If the plugin tells you that it can’t find a menu, check the console for errors. Remember that ‘name’ and ‘rows’ are required in each menu.

v1.6

• Improved commands handling. Now they are executed as the player really typed them.
• Removed COMMAND: ‘alias:…’ because you don’t need it anymore.
• Improved permission handling and feedback:
  • If you don’t have a permission, it will tell you what are you missing.
  • Changed permissions: all the permissions for commands are chestcommands.command.<command>, for example chestcommands.command.help, or chestcommands.command.open.
  • Having the permission chestcommands.item.<filename> grants automatically the permission to open the menu (chestcommands.open.<filename>)
  • Changed permission for /chc open: chestcommands.commmand.open & chestcommands.command.open.others (this will grant access to every menu)
  • Now chestcommands.command.open requires the permission to open the specified menu. E.g. /chc open menu.yml requires two permissions: chestcommands.command.open and chestcommands.open.menu.yml
• Still compatible with 1.6.x, 1.5.x, 1.4.x…

Version 4 released! 🎉

Note: the new version will try to automatically update configuration files on the first startup (a backup in the folder «old_files» will be created).

Required Spigot version: 1.8 or higher

Upgrading from Minecraft 1.12 (or earlier) to 1.13+?

Changes in 4.0.3

• + Added support for custom colors in hexadecimal format (Example: &#FF87D1), which only work in Spigot 1.16 and higher.
• * Improved error message.

Changes in 4.0.0

• + New developer API: you can now create, manage and open new non-persistent menus through the API, rather than just opening the ones in the menus folder. You can also register new placeholders.
• + Improved error logging: more accurate error details and better visualization.
• + A new command «/cc errors» has been added to view the last loading errors.
• + Icon material can now be «air» (the icon’s slot will be clickable but no item will be displayed).
• * Icon attributes, menu settings and actions will now only accept the exact format described on the documentation (many were changed in v3.3.0). For example, «ID» is now «MATERIAL» and cannot include the durability or the amount anymore («DURABILITY» and «AMOUNT» have to be specified separately). On the first startup, menus will be automatically updated with the correct format.
• * The plugin now requires Bukkit/Spigot 1.8 or greater and Java 8 or greater.
• * Renamed «placeholders.yml» to «custom-placeholders.yml» and changed the format to valid YAML (rather than a text file with a .yml extension). The old file will be updated automatically.
• — The following options were removed from config.yml:
  • «use-console-colors»: console colors are now always enabled.
  • «use-only-commands-without-args»: commands will always open a menu even when used with arguments (for example both «/menu» and «/menu 123» will open the example menu).
  • «multiple-commands-separator»: using the attributes «ACTIONS», «ENCHANTMENTS», «REQUIRED-ITEMS» or the menu settings «open-actions» and «commands» with multiple values on a single line is no longer possible (a list is required, even for one element).
• — The following messages were removed from lang.yml, as they are only displayed to administrators:
  • «open-menu»
  • «open-menu-others»

Changes in 3.3.0

• + Added support for placeholders (notably {player}) in SKULL-OWNER
• + Added support for multiple items in REQUIRED-ITEMS
• * Some options were renamed. Some options with multiple values now use lists instead of semicolon-separated values on a single line. You should update your files, but previous names and formats will still work (for now). Check out the Wiki to see the updated options.
• * The following actions were renamed:
  • ID was renamed to MATERIAL
  • COMMAND was renamed to ACTIONS
  • DATA-VALUE was renamed to DURABILITY
  • ENCHANTMENT was renamed to ENCHANTMENTS
  • REQUIRED-ITEM was renamed to REQUIRED-ITEMS
  • In «menu-settings», «command» was renamed to «commands»
  • In «menu-settings», «open-action» was renamed to «open-actions»
  • In «menu-settings.open-with-item», «id» was renamed to «material»
• * The following options are now lists:
  • «commands» in «menu-settings»
  • «open-actions» in «menu-settings»
  • ACTIONS
  • ENCHANTMENTS
  • REQUIRED-ITEMS

Changes in 3.2.0

• + Added native support for Spigot 1.13+
• + Added «NBT-DATA» node on icons for setting custom NBT tags (e.g. banner patterns)
• + Added «DURABILITY» node as alias of «DATA-VALUE»
• * Updated example menu for 1.13+ and added an example with NBT-DATA
• — Removed PlayerPoints support
• — Removed MCStats for metrics

Атрибуты Chest Commands

• MATERIAL

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

  MATERIAL: diamond sword

• POSITION-X и POSITION-Y

  Эти атрибуты используются в качестве координат для установки положения значка внутри меню. POSITION-X — это столбец (слева направо, значения от 1 до 9), а POSITION-Y — строка (сверху вниз, значения между 1 и количеством строк в меню). Вы можете легко найти координаты с помощью этой таблицы:

  POSITION-X: 5

  POSITION-Y: 1

• ACTIONS

  Список действий, выполняемых после того, как игрок щелкнет значок. По умолчанию действие заставляет игрока выполнить команду, как если бы он набирал текст в чате. Есть много типов действий, таких как отправка сообщения в чате или воспроизведение звука.

  ACTIONS:

  — ‘spawn’

• NAME

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

  NAME: ‘&6Сапоги командира!’

• LORE

  Дополнительные строки, которые появляются под именем во всплывающей подсказке. Вы можете использовать цвета, символы и плейсхолдеры.

  LORE:

  — ‘Описание предмета’

  — ‘еще описание…’

• DURABILITY

  Устанавливает прочность инструмента, оружия или брони.

  До 1.12.2 (Это не прочность, получится желтая шерсть)

  MATERIAL: wool

  DURABILITY: 4

  Начиная с 1.13.2

  MATERIAL: diamond helmet

  DURABILITY: 150

• AMOUNT

  Устанавливает количество, отображаемое на значке.

  AMOUNT: 12

• NBT-DATA

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

  NBT-DATA: ‘{…}’

• ENCHANTMENTS

  Добавляет чары к значку, используется только для эффекта свечения.

  ENCHANTMENTS:

  — sharpness, 5

• COLOR

  Используется для окраски кожаных доспехов. Формат: <красный>, <зеленый>, <синий>, где каждый цвет — это число от 0 до 255 (палитра цветов RGB).

  COLOR: ‘255, 0, 0’

• SKULL-OWNER

  Устанавливает череп владельца значка (это должна быть голова игрока). Вы можете использовать заполнитель {player} в качестве значения для отображения головы игрока, просматривающего меню. Если вы хотите отобразить собственную текстуру, вам следует использовать NBT-DATA.

  SKULL-OWNER: ‘{player}’

• -COLOR

  Устанавливает основной цвет баннера. Значение должно быть цветом красителя.

  -COLOR: ‘light_blue’

• -PATTERNS

  Выбирает шаблоны баннера в том порядке, в котором они перечислены.

  -PATTERNS:

  — ‘cross:yellow’

  — ‘border:red’

• PRICE

  Деньги, необходимые для выполнения действий с иконкой. Деньги будут сняты перед выполнением каких-либо действий. Нужно установить плагин Vault

  PRICE: 100.0

• LEVELS

  Стоимость в уровнях опыта для выполнения действий значка. Уровни будут удалены перед выполнением каких-либо действий.

  LEVELS: 5

• REQUIRED-ITEMS

  Устанавливает список необходимых элементов (в качестве стоимости) для выполнения действий значка. Элементы будут удалены перед выполнением каких-либо действий.

  До версии 1.12.2

  REQUIRED-ITEMS:

  — ‘wool:4, 30’

  Начиная с 1.13.2

  REQUIRED-ITEMS:

  — ‘yellow wool, 30’

• KEEP-OPEN

  Устанавливает, должно ли закрываться меню после щелчка по значку. Значение по умолчанию — false (меню закрывается после нажатия).

  KEEP-OPEN: true

• PERMISSION

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

  PERMISSION: ‘my.custom.permission’ В этом случае только игроки С этим правом смогу использовать элемент меню

  PERMISSION: ‘-my.custom.permission’ В этом случае только игроки БЕЗ этого права смогу использовать элемент меню

• VIEW-PERMISSION

  Устанавливает пользовательское разрешение, необходимое для того, чтобы игроки могли видеть значок. Может быть отменено как РАЗРЕШЕНИЕ.

  VIEW-PERMISSION: ‘my.custom.permission’

• PERMISSION-MESSAGE

  Этот атрибут настраивает сообщение об ошибке, отправляемое игроку, у которого нет РАЗРЕШЕНИЯ, при нажатии на значок. Если не задан, будет использоваться сообщение по умолчанию из config.yml.

  PERMISSION-MESSAGE: ‘&cВы должы быть VIP чтобы использовать это.’

jar

ChestCommands-v3.3.1.jar

Дата изменения: 23-08-2020

Размер: 172.72 KB

Скачиваний: 5555

Версия: 1.16 1.15.2 1.14.4 1.13.2 1.12.2 1.11.2 1.10.2 1.8.9 1.7.10

v1.7

• Added menu signs. They work like Essentials signs, put in the first line, and the file name in the second (you can omitt «.yml»). If the operation was successful, the first line will be blue. If not, it will be red and an error message will appear.
• Added economy support. You need Vault and an economy plugin (iConomy, Essentials, Boseconomy, etc)
  • Use ‘PRICE: number’ in your menus to charge users for using that item. (Example: ‘PRICE: 5.8’ will require 5.8 money to execute the command)
  • Configurable command when the user don’t have money (placeholder: <price>). NOTE: if the user had enough money, no message will be displayed.
  • Permission for bypass: chestcommands.economy.bypass
• Added stack size support. You can use AMOUNT: 10 for example to have 10 of that item.
• Added KEEP-OPEN (default is false) if set to true, the menu will not close after clicking (good for shops).
  TIP: open the file example.yml in the zip file to see the new config nodes.

v1.5

It’s highly recommanded to regenerate the plugin’s folder. Make a backup of your menu.yml. This is because the configuration changed.

• Added multiple menus: you will find them in /plugins/ChestCommands/menu folder. You will also find a tutorial.
• Added command type -> ‘ open:filename.yml ‘ to open another menu
• Added extra check for items out of the chest: it will now cut the items that are out of the chest.
• New permission system: to open the menu with commands chestcommands.open.filename.yml (eg chestcommands.open.menu.yml)
  and to open the menu with the item: chestcommands.item.filename.yml. This will not give you the permission to open the menu from another one, nor the permission to use the command.
• Per-menu settings: inside each .yml file you can set the name, the amount of rows, the item (optional) and the command (optional).
• If the plugin tells you that it can’t find a menu, check the console for errors. Remember that ‘name’ and ‘rows’ are required in each menu.

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

chestcommands.open.* — Разрешает открывать все меню на вашем сервере.

chestcommands.open..yml — Разрешает открывать определенное меню.

chestcommands.command.help — доступ к команде /cc help

chestcommands.command.open — доступ к команде /cc open <file>

chestcommands.command.open.others — доступ к команде /cc open <file> Примечание : это разрешение также предоставляет доступ для открытия всех меню.

chestcommands.command.list — доступ к команде /cc list

chestcommands.command.reload — доступ к команде /cc reload

chestcommands.sign — требуется для создания знаков меню.

chestcommands.economy.bypass — обход экономии затрат. (что бы всё было бесплатно)

chestcommands.update — получать уведомления об обновлениях при присоединении.

Описание опций

v1.6

• Improved commands handling. Now they are executed as the player really typed them.
• Removed COMMAND: ‘alias:…’ because you don’t need it anymore.
• Improved permission handling and feedback:
  • If you don’t have a permission, it will tell you what are you missing.
  • Changed permissions: all the permissions for commands are chestcommands.command.<command>, for example chestcommands.command.help, or chestcommands.command.open.
  • Having the permission chestcommands.item.<filename> grants automatically the permission to open the menu (chestcommands.open.<filename>)
  • Changed permission for /chc open: chestcommands.commmand.open & chestcommands.command.open.others (this will grant access to every menu)
  • Now chestcommands.command.open requires the permission to open the specified menu. E.g. /chc open menu.yml requires two permissions: chestcommands.command.open and chestcommands.open.menu.yml
• Still compatible with 1.6.x, 1.5.x, 1.4.x…