Плагин [FUN] RandomCase-Reloaded v3.21 Универсальный плагин кейсов [1.10-R1.0]

RandomCase - Впариваем игрокам кейсы с ключами!
Версия: v3.21

Все права, команды, и детальное описание настроек находится во втором посте!

Особенности:

• Возможность создания множества полностью настраиваемых кейсов и ключей.
• Удобное (наверное) API для разработчиков.
• Настройка сообщений.
• Поддержка Vault, MaterialEconomy, Collections, StatTrack.
• И много разных вкусностей!!

Скачать плагин.
Исходный код.
Страница на BukkitDev.
Страница на SpigotMC.

Спойлер: Дальнейшие планы

Добавить конфиг.
Добавить команды и права.
Добавить GUI.
Добавить "выполнение команды" как выпадающий приз из кейса.
Добавить покупку кейсов и ключей.
Добавить шанс выпадения.
Добавить GUI создание кейса.
Добавить поддержку MySQL и/или других БД (откладывается на неопределенный срок...).

Спойлер: Известные баги

1. ???

Лог изменений:
Версия 3.21:

• Небольшой баг-фикс.

Версия 3.2:

• Добавлен новый кейс 'EMPTY' и новый ключ 'EMPTY'.

Спойлер: Старые версии

Версия 3.1:

• Баг-фиксов там много разных (в том числе баг-фикс уровней дропа), ну и вкусняшки там разные.

Версия 3.0:

• Офигенный апдейт с кучей шняжек, полностью переписанным кодом, API для кодеров, и вообще вкуснотища!

Версия 2.82

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

Версия 2.81

• Декоративные предметы теперь могут содержать все те же параметры что и дроп.

Версия 2.8

• Добавлена возможность проигрывания звука при открытии кейса.
• Новые параметры для дропа, DATA и DAMAGE.
• Важный баг-фикс!

Версия 2.7

• Добавлен второй режим открытия кейсов.

Версия 2.6

• Добавлен параметр "LEVEL" для каждого дропа.

Версия 2.5

• Добавлена команда перезагрузки конфига.
• Важный баг-фикс!

Версия 2.4

• Добавлена возможность покупки кейсов и/или ключей! (Необходим Vault & любой плагин экономики).

Версия 2.31

• Добавлены стандартные параметры для большинства секция из конфига.
• Подготовление для нового режима открытия кейса.

Версия 2.3

• Добавлена нормальная настройка дропа.
• Добавлена возможность выполнения команд при выигрыше предмета!

Версия 2.2

• Добавлен ГУИ интерфейс

Версия 2.1

• Добавлены команды и права, небольшие баг-фиксы.

Версия 2.0

• Заново написанный код, конфигурация, мульти-язычность.

Спойлер: Очень старые версии

Версия 1.05

• Если в команде вы используете неверный ник игрока, в консоли не будет ошибок.

Версия 1.04

• Когда вы пишете команду /getKey или /getCase сундук/кейс не заменяет предмет в руке, а просто добавляется в инвентарь.

Версия 1.03

• Баг-фикс, починена работоспособность команды /getKey [player].

Версия 1.02

• Баг-фикс, убран баг из-за которого не отбирался ключ при открытии кейса, если в слоте был всего 1 ключ.

Версия 1.01

• Баг-фикс, теперь ключ(и) в руке при открытие сундука не удаляются а просто уменьшается их кол-во на 1.

Версия 1.0

• Релиз моего крутого плагина

 

Разные настроечки и прочее!

Спойлер: Права и команды

/randomcase - основная команда плагина.
Алиас - /rc

/rc reload - Перезагрузка плагина.
Право на использование команды: random_case.reload

/rc force <manager> [player] - Принудительное открытие кейса.
Права на использование:
Для себя: random_case.force_open.<manager>
Для других: random_case.force_open_other.<manager>

/rc open <manager> - Открытие кейса командой.
Право на использование: random_case.command_open.<manager>

/rc get manager <manager> <amount> [player] - получение/выдача набора кейс + ключ.
Права на использование:
Для себя: random_case.get.manager.<manager>
Для других: random_case.give.manager.<manager>

/rc get case <manager><amount> [player] - получение/выдача кейса.
Права на использование:
Для себя: random_case.get.case.<manager>
Для других: random_case.give.case.<manager>

/rc get key <manager><amount> [player] - получение/выдача ключа.
Права на использование:
Для себя: random_case.get.key.<manager>
Для других: random_case.give.key<manager>

/rc get drop <manager> <drop> - получение/выдача дропа.
Права на использование:
Для себя: random_case.get.drop.<manager>.<drop>
Для других: random_case.give.drop.<manager>.<drop>

/rc buy manager <manager> [player] - покупка набора кейс + ключ.
Права на использование:
Для себя: random_case.buy.manager.<manager>
Для других: random_case.buy_other.manager.<manager>

/rc buy case <manager> [player] - покупка кейса.
Права на использование:
Для себя: random_case.buy.case.<manager>
Для других: random_case.buy_other.case.<manager>

/rc buy key <manager> [player] - покупка ключа.
Права на использование:
Для себя: random_case.buy.key.<manager>
Для других: random_case.buy_other.key.<manager>

/rc buy drop <manager> <drop> - покупка дропа.
Права на использование:
Для себя: random_case.buy.drop.<manager>.<drop>
Для других: random_case.buy_other.drop.<manager>.<drop>

Другие права:
Право на открытие кейса: random_case.open.<manager>
Право на крафт кейса: random_case.craft.case.<manager>
Право на крафт ключа: random_case.craft.key.<manager>

Спойлер: Зависимости

Обязательные:
GWMLibrary (идет в архиве с плагином (см. "Настройка предмета"))

Рекомендуемые:
Vault. (для покупки кейсов или ключей в игре)

MaterialEconomy. (для добавления материальной валюты в кейсы)
Collections. (для добавления коллекций и предметов из коллекций в кейсы)
StatTrack. (для добавления StatTrack-системы к Дропам ITEM и COMPLEX)

Спойлер: Дроп(DROP)

Следующие параметры могут содержать все дропы:
DROP_ITEM - (СЕКЦИЯ) "фальшивый" предмет для GUI менеджеров.
LEVEL - (ЧИСЛО) Шанс выпадения дропа.
Каждый следующий уровень имеет уменьшенный в 2 раза шанс выпадения.
Не рекомендую использовать значения больше 13.
PRICE - (ЧИСЛО) Цена дропа. Если не указана - купить нельзя.

Спойлер: ITEM

Описание:
Обычный предмет, может иметь шанс появления StatTrack-системы.
Параметры:
ITEM - (СЕКЦИЯ) сам предмет (см "Настройка предмета").
STATTRACK_CHANCE - (ЧИСЛО[0-100]) шанс того что предмет будет иметь StatTrack-систему.
Только при "USE_STATRACK: true" в конфигурации.
100 - StatTrack-система добавляется всегда.
0 - StatTrack-система не добавляется никогда.

Спойлер: COMMAND

Описание:
Набор команд.
Параметры:
COMMANDS - (СПИСОК СТРОК) Команды без наклонной в начале
Команда не должны содержать символа "|"!
Для выполнения от имени игрока в конец команды надо добавить "|false".
"%PLAYER%" - заменяется на ник игрока.

Спойлер: COMPLEX

Описание:
Комплексный дроп, содержит предмет и команды.
Параметры:
ITEM - (СЕКЦИЯ) сам предмет (см "Настройка предмета").
COMMANDS - (СПИСОК СТРОК) Команды без наклонной в начале
Команда не должны содержать символа "|"!
Для выполнения от имени игрока в конец команды надо добавить "|false".
"%PLAYER%" - заменяется на ник игрока.
STATTRACK_CHANCE - (ЧИСЛО[0-100]) - шанс того что предмет будет иметь StatTrack-систему.
Только при "USE_STATRACK: true" в конфигурации.
100 - StatTrack-система добавляется всегда. 0 - StatTrack-система не добавляется никогда.

Спойлер: MULTI

Описание:
Дроп содержащий в себе неограниченное количество других дропов.
Параметры:
DROPS - (СЕКЦИЯ) дропы.
Примечание:
В Multi дроп можно добавлять Multi дроп.

Спойлер: MATERIAL-ECONOMY

Описание:
Только при "USE_MATERIAL_ECONOMY: true" в конфигурации.
Дроп материальной валюты из плагина
Параметры:
ECONOMY -(СТРОКА) ID экономики.
SUM - (СТРОКА) Сумма денег в предмете.

Спойлер: COLLECTION

Описание:
Только при "USE_COLLECTIONS: true" в конфигурации.
Дроп целой коллекции из плагина Collections.
Параметры:
COLLECTION - (СТРОКА) ID коллекции из Collections.

Спойлер: COLLECTION-ITEM

Описание:
Только при "USE_COLLECTIONS: true" в конфигурации.
Дроп одного предмета коллекции из плагина Collections.
Параметры:
COLLECTION - (СТРОКА) ID коллекции из Collections.
ITEM - (СТРОКА) ID предмета коллекции из Collections.

Спойлер: Кейсы(CASE)

Следующие параметры могут содержать все кейсы:
PRICE - (ЧИСЛО) Цена кейса.
Если не указана - купить нельзя.

Спойлер: MATERIAL

Описание:
Материальный кейс (предмет).
Для открытия надо нажать правой кнопкой мыши.
Параметры:
CASE_ITEM - (СЕКЦИЯ) Предмет кейса.
Желательно добавить описание чтобы обычные игроки не могли подделать кейс.
RECIPE - (СЕКЦИЯ) крафт кейса.
Если не установлен, скрафтить кейс нельзя.
Должен содержать до 9 предметов каждый в отдельный секции "ITEM[номер(1-9)]".
Примечание:
Нумерация слотов -
1|2|3
4|5|6
7|8|9
Для пустого слота просто не добавлять к нему секцию.

Спойлер: VIRTUAL

Описание:
Виртуальный кейс, количество кейсов для каждого игрока содержится в файле virtual_cases.yml
Параметры:
VIRTUAL_NAME - имя кейса для сохранения в файл.

Спойлер: BLOCK

Описание:
Блок-кейс. Для открытия необходимо кликнуть по блоку.
Параметры:
LOCATIONS - Локации кейса.
Формат: "world|x|y|z".
REMOVE_BLOCK_AFTER_OPEN - (ЛОГИЧЕСКИЙ ТИП) Удалять ли блок после открытия кейса.
По стандарту установлено на false.
REMOVE_LOCATION_AFTER_OPEN - (ЛОГИЧЕСКИЙ ТИП) Удалять ли локацию после открытия кейса.
По стандарту установлено на false.
REMOVE_COFNFIG_LOCATION_AFTER_OPEN - (ЛОГИЧЕСКИЙ ТИП) Удалять ли локацию из конфигурации (навсегда) после открытия кейса.
По стандарту установлено на false.

Спойлер: Ключи(KEY)

Спойлер: MATERIAL

Описание:
Материальный ключ (предмет).
Параметры:
KEY_ITEM - Предмет ключа.
Желательно добавить описание чтобы обычный игроки не могли подделать ключ.
RECIPE - крафт ключа.
Если не установлен, скрафтить ключ нельзя.
Должен содержать 9 предметов каждый в отдельный секции "ITEM[номер(1-9)]".
Примечание:
Нумерация слотов -
1|2|3
4|5|6
7|8|9
Для пустого слота просто не добавлять к нему секцию.

Спойлер: VIRTUAL

Описание:
Виртуальный ключ, количество ключей для каждого игрока содержится в файле virtual_keys.yml
Параметры:
VIRTUAL_NAME - имя ключа для сохранения в файл.

Спойлер: Открытие кейсов (OPEN_MANAGER)

Спойлер: NO-GUI

Описание: Моментальное открытие кейса без GUI интерфейса.
Параметры: Нету их

Спойлер: GUI

Описание: Открытие кейса с GUI-"барабанчиком".
Параметры:
DISPLAY_NAME - (СТРОКА) Имя GUI интерфейса.
DECORATIVE_ITEMS - (СЕКЦИЯ) Декоративные предмета (20 штук).
ITEM_CHANGE_DELAY - (СПИСОК ЧИСЕЛ) Время смены предметов.
DELETE_DECORATIVE_ITEMS - (ЛОГИЧЕСКИЙ ТИП) Удалять ли декоративные предметы после выпадения предмета.
AUTO_INVENTORY_CLOSE_DELAY - (ЧИСЛО) Время автоматического закрытия кейса.
START_SOUND - (СТРОКА) Звук при старте прокрутки.
ACTION_SOUND - (СТРОКА) Звук во время прокрутки.
END_SOUND - (СТРОКА) Звук в конце прокрутки.

Спойлер: Конфигурация предмета

MATERIAL - (СТРОКА) Материал предмета.
AMOUNT - (ЧИСЛО) Количество предмета.
DATA - (ЧИСЛО) Мета-дата предмета (либо прочность для тех предметов у которых нет мета-даты).
DISPLAY_NAME - (СТРОКА) Имя предмета.
LORE - (СПИСОК СТРОК) Описание предмета.
ENCHANTMENTS - (СПИСОК СТРОК) Чары предмета (формат: "Зачарование|Уровень").
FLAGS - (СПИСОК СТРОК) Флаги предмета.

Спойлер: Настройка конфига

USE_VAULT - (ЛОГИЧЕСКИЙ ТИП) использовать ли Vault.
USE_STATTRACK - (ЛОГИЧЕСКИЙ ТИП) использовать ли StatTrack.
USE_COLLECTIONS - (ЛОГИЧЕСКИЙ ТИП) использовать ли Collections.
USE_MATERIAL_ECONOMY - (ЛОГИЧЕСКИЙ ТИП) использовать ли Material-Economy.

Спойлер: Справочка

Значения вот разные, полезные...
Материалы
Чары
Звуки
Флаги
Существа

 

GUI есть?[DOUBLEPOST=1430217539][/DOUBLEPOST]

Добавляй GUI интерфейс, как в ItemCases и цены тебе не будет.

 

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

 

Мне плагин понравился что крафты есть так держать

 

А мне плагин ItemCases понравился, что я его купил)

 

XD нам всё нравиться что купим =)

 

А мне мой нравиться потому-что я его автор и потому-что он бесплатный))

 

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

 

Кек... В itemcases есть gui и возможность более...

 

Ну.... зато он простенький =) а мне нравиться такое ха

 

Но он платный))) А у меня бесплатный А про возможности, это ты про кастомный лут и возможность нескольких сундуков? По мне это не возможности, а особенности плагина.

 

GUI + Кастомность + Удобность + Разные сундуки + Разные возможности.

 

В чем выражена "удобность"?[DOUBLEPOST=1430224049,1430223301][/DOUBLEPOST]У меня "кастомности" и "разных сундуков" не будет точно, так как это не плагин на разные сундуки, это плагин на один сундук, с предметами.

 

А еще я хочу сделать, чтобы можно было выдавать призы в виде пермишенов(не групп PEX) из этой лотерее!

 

Ты тоже пишешь такой плагин?)

 

Нет. Это моя задумка на сервер)

 

Ясно)

 

У меня есть предложение:
Можно сделать в конфиге процентную вероятность выпадения той или иной вещи. То есть типа того:
Item: 7
Probability: 0.01%
Также было бы неплохо, если бы предметы можно было именовать, давать им Lore и т.д., а также было бы хорошо если бы можно было прописывать команды при выигрыше, типо:
Command: pex group TEST user add %nick%

say &6Поздравляем! теперь вы в группе TEST!​

Probability: 1%
Вообщем всё, идеи закончились.

 

Нет его писал именно я. Я не отрицаю что попросил помощи в некоторых местах. 97% кода - лично мой.[DOUBLEPOST=1430232813,1430232307][/DOUBLEPOST]

Честно говоря, такой наглости я еще не слышал...
Готового кода кроме одной строки я вообще не использовал, просто интересовался как использовать методы, или просил совета как лучше реализовать какую-то функцию! Из-за пары строчек кода, вы уже предъявляете мне какие-то притензии?![DOUBLEPOST=1430232933][/DOUBLEPOST]

Ну, к сожелению кастомную настройку я врядли буду делать...
Однако сделать шанс выпадения хороших вещей - меньше, а шанс плохих - больше, на досуге сделаю!