Zh ManagedKits Description/ru

From Documentation
Jump to navigation Jump to search

Установка

Плагин устанавливается на Minecraft Pocket Edition стандартным образом - загружается в папку plugins на сервере minecraft.

Скачайте ахив. Распакуйте и загрузите phar файл на сервер

Плагин поддерживает Economy API €¢onom¥$ от onebone


Настройка плагина

Есть два файла для настройки плагина

config.yml

Данный файл вы изменяете для общих настроек плагина

economy_enabled Поддержка Economy API

0 - отключена

1 - включена

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

0 - отключена

1 - включена

default_kit_title Наименование набора по умолчанию
sign_enabled Поддержка использования табличек с наборами

0 - отключена

1 - включена

kits.yml

В данном файле вы определяете свои наборы.

Рассмотрим следующий набор

Simple:
  name: "Simple"
  description: "kit with simple items"
  price: 0
  status: 1
  locked_time: 7200
  hidden: 0
  items:
    "298": 1
    "299": 1
    "300": 1
    "301": 1
    "273": 1
    "274": 1
    "275": 1
    "276": 1
Simple: Наименование набора (KitName), используется в списке наборов и правам доступа

Данный набор имеет наименование Simple

name: Свойство наименование набора, на текущий момент не используется, но зарезервировано. Используйте такое же наименование что и KitName
description: Описание набора
price: Цена набора, укажите ноль если он бесплатный

Если указана цена больше нуля и отключена опция Economy API - такой набор не будет доступен

Если будет указана отрицательная цена и включена опция Economy API - такой набор не будет доступен

status: Начальное состояние набора

0 - доступен

1 - отключен

locked_time: Время в секундах, когда данный набор не доступен для повторного использования игроком
hidden: Виден или скрыт для игрока. Это свойство может быть использовано в дальнейшем для развития функционала. Установка этого свойства указывает на то, что данный набор (если он активный) все равно скрыт для использования игроком, если он не обладает нужными правами. Набор Default (по умолчанию для новых игроков на сервере) имеет данное свойство.

0 - доступен

1 - отключен

items: Основной родительский узел для указания списка элеменов для набора

Если данное свойство не указано, или список элементов не определен, то такой набор не будет доступен

"298": 1 Элемент с ид. = 298, и количество = 1

В данном случае игрок получит 1 элемент с ид. 298

"299": 1 Элемент с ид. = 299, и количество = 1

Остальные - аналогично


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

Команда Привилегии Описание
/kit
  • zhmanagedkits.kit.command
  • Сервер
Список доступных команд
/kit list
  • zhmanagedkits.kit.list.available
  • Сервер
Список активных наборов, вы можете видеть наименования разных цветов в зависимости от статуса набора
  • white - доступный набор
  • purple - доступный набор но существует ограничение (по времени, наличию денег)
  • gold - доступный набор с указанной ценой (платный)
/kit list all
  • zhmanagedkits.kit.list.all
  • Сервер
Список всех наборов, вы можете видеть наименования разных цветов в зависимости от статуса набора
  • gray - скрытый набор
  • white - доступный набор
  • red - отключенный набор
  • gold - доступный набор с указанной ценой (платный)
/kit list disabled
  • zhmanagedkits.kit.list.disabled
  • Сервер
Список всех отключенных наборов
/kit list hidden
  • zhmanagedkits.kit.list.hidden
  • Сервер
Список всех скрытых наборов
/kit details KitName
  • zhmanagedkits.kit.details.available
  • zhmanagedkits.kit.details.all
  • Сервер
Получение описания набора KitName, вы можете видеть информацию о наборе, его статусу и цене (если включена опция Economy API)
/kit enable KitName
  • zhmanagedkits.kit.state.enable
  • Сервер
Разрешает доступ к набору KitName, если набор не может быть активным (из-за конфигурации), он будет отключен
/kit enable all
  • zhmanagedkits.kit.state.enable
  • Сервер
Разрешает доступ ко всем наборам, если набор не может быть активным (из-за конфигурации), он будет отключен
/kit disable KitName
  • zhmanagedkits.kit.state.disable
  • Сервер
Запрещает доступ к набору KitName
/kit disable all
  • zhmanagedkits.kit.state.disable
  • Сервер
Запрещает доступ ко всем наборам
/kit hide KitName
  • zhmanagedkits.kit.state.hide
  • Сервер
Скрывает набор KitName
/kit hide all
  • zhmanagedkits.kit.state.hide
  • Сервер
Скрывает все доступные наборы
/kit show KitName
  • zhmanagedkits.kit.state.show
  • Сервер
Делает видимым набор KitName
/kit show all
  • zhmanagedkits.kit.state.show
  • Сервер
Делает видимыми все доступные наборы
/kit reload
  • zhmanagedkits.kit.config.reload
  • Сервер
Перезагружает все наборы из конфигурационного файла
/kit save
  • zhmanagedkits.kit.config.save
  • Сервер
Записывает текущее состояние всех наборов в конфигурационный файл kits.yml
/kit get KitName
  • zhmanagedkits.kit.get
Дает игроку набор KitName. Если он/она имеют привилегии его использовать (время, деньги ...)

Если опция Economy API включена, цена за набор будет удержана

Описание в примерах

При инициализация плагина, выводится разная важная информация

Kit-1-initialize.png


Команды консоли на сервере

Выполняем команду kit

Kit-2-usage.png


Выполняем команду kit list

Kit-3-list.png


Выполняем команду kit list all

Kit-4-list-all.png


Выполняем команду kit details для получения информации по набору

Kit-5-details.png


Выполняем команду kit disable для отключения набора.

Если вы запретили доступ к набору, все игроки получат сообщение об этом.

Kit-6-disable.png


Выполняем команду kit disable all для отключения всех доступных наборов.

Kit-7-disable-all.png


Выполняем команду kit enable для включения набора.

Если вы разрешили доступ к набору, все игроки получат сообщение об этом.

Kit-8-enable.png


Выполняем команду kit enable all для включения всех доступных наборов. Если какой-либо набор не может быть переведен в активное состояние, вы получите сообщение.

Kit-9-enable-all.png


Выполняем команду kit reload для загрузки начальной конфигурации наборов, все изменения в конфигурационном файле для наборов будут учтены.

Kit-10-reload.png


Выполняем команду kit get для получения набора на сервере. Вы можете видеть сообщение об ошибке.

Kit-11-get-server.png


Команды игрока

Когда новый игрок первый раз заходит в ваш мир, он/она получают набор по умолчанию (если опция включена)

User-1-default-got-kit.png


Выполняем команду /kit list для получения списка активных наборов

User-2-default-available-kits-after-got.png


Выполняем команду /kit get Gold для получения набора с наименованием Gold

User-3-gold-got-kit.png


Выполняем команду /kit list для получения списка доступных наборов. Теперь вы видите набор Gold активный, но он не доступен для использования.

User-4-gold-available-kits-after-got.png


Выполняем команду /kit details Gold чтобы увидеть подробности набора.

User-5-gold-kit-details-after-got.png


Выполняем команду /kit get Diamond для получения набора с наименованием Diamond

User-6-diamond-got-kit.png


Теперь выполним команду /kit get Diamond для получения набора с наименованием Diamond еще раз. Вы видите сообщение об ошибке.

User-7-diamond-tried-to-get-kit-again.png


Теперь увеличим стоимость набора Brilliant с 1000 до 10000. В данный момент игрок не обладает достаточной суммой.

Давайте посмотрим на активные наборы. Вы видите, что набор Brilliant активный, но использовать его нельзя.

Выполняем команду /kit list для получения списка доступных наборов.

User-8-brilliant-kit-list-locked-kit.png


Выполняем команду /kit details Brilliant чтобы увидеть подробности набора. Как видите, он заблокирован из-за недостатка средств (денег)

User-9-brilliant-kit-details-for-locked-kit.png


Теперь попытаемся выполнить команду /kit get Brilliant для получения набора с наименованием Brilliant который заблокирован из-за недостатка денег. Вы видите сообщение об ошибке.

User-10-brilliant-tried-to-get-locked-kit.png


Использование табличек

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

  • Создать табличку
  • На первой строке необходимо написать [zhManagedKits]
  • На второй строке необходимо написать Наименование_Вашего_Набора


Language: English  • русский