- Поддерживаемые версии
-
- 1.8
- 1.9
- 1.10
- 1.11
- 1.12
- 1.13
- 1.14
- 1.15
- 1.16
- 1.17
- 1.18
- 1.19
Функционал плагина позволяет настроить работу около 90% всех возможных процессов! Даже аниматоры предоставляют обширный набор настроек, которые вы можете изменить так, как пожелаете.
Плагин может работать на всех версиях в промежутке от 1.9 до 1.15. Версия 1.8 не указана в этом промежутке из-за проблем с совместимостью. Плагин может работать на этой версии, но стабильной работы ожидать не стоит. Для работы плагина необходим плагин HolographicDisplays.
Плагин создавался и тестировался на Java 8.
Добавлен исходный код, чтобы вы могли самостоятельно переписать плагин.
https://bircode.ru/docs:treasurecocasereloaded
База знаний плагина
Концепция
В этом разделе прописана основная информация о плагине и тонкостях его работы. Данная информация обязательна к прочтению для новичков. Если в сообщениях сообщества ВКонтакте вы зададите вопрос, реализация которого уже прописана в документации, вы будете проигнорированы.
Забудьте про слово "кейс". В данном плагине вы встретите это слово только в документации. Коробка. Вот так тут называются эти "кейсы". В переводе на тыцецерусный, "кейс" означает "коробка". Запомните это в дальнейшем.
Не-ет... Зачем вы выдаёте себе ключи и надеетесь, что сможете открыть их как коробки? Если понятие "ключ" пришло к вам оттуда же, откуда и "кейс", то забудьте про это. Здесь ключи используются как вспомогательная единица при открытии коробки (если настройки коробки требуют этого). Да. Тут вы открываете коробки. Не ключи.
Нет, вы не можете "поставить кейс". Вы можете поставить "точку открытия". Точнее даже не поставить, а создать её из уже поставленного блока. И функционировать эта "точка открытия" будет так же, как и ваш "кейс, который можно поставить".
Да, вы можете сделать "донат-кейсы" в этом плагине. И "кейсы с титулами" тоже. Вы можете сделать всё, что захотите, только если это вписывается в функционал плагина. Чтобы точно узнать можно ли сделать то, что вы хотите, напишите в сообщения сообщества ВКонтакте.
Да, в этом плагине вы можете сделать так, чтобы привилегия выдавалась только тогда, когда она дороже по ценности, чем та, что сейчас есть у игрока. Дойдёте до раздела с исполнителями и сами всё разузнаете. И команду от имени консоли тоже можно выполнять.
Почему указываются буквенные названия предметов и блоков? Отвечаю: это сделано для того, чтобы было проще вводить совместимость между версиями в указанном ранее промежутке версий. Будете требовать цифру вместо буквы - включу небесную кару.
Нет, плагин пока не может отказаться от HolographicDisplays. У разработчика недостаточно скилла, чтобы написать встроенную поддержку голограмм.
Да, вы можете создавать несколько коробок. Количество коробок неограничено. И количество ключей тоже неограничено.
Названием коробки или ключа является название его файла настроек без .yml. Пример: файл настроек коробки называется ciexanex.yml, значит название этой коробки будет ciexanex. Та же процедура происходит и с ключами.
Системы коробок и ключей имеют "общую природу". Они объединены в одну систему под названием "юниты". Коробки и ключи - это юниты. А теперь самое интересное, что выходит из этого объединения. Вы не можете создать ключ с названием "romashka", если уже существует коробка с таким названием. И наоборот: невозможно создать коробку с названием "pomidor", если уже существует ключ с таким названием. Этот бесящий механизм был создан для того, чтобы упростить ввод команд /tccr give/take/set, а так же для того, чтобы упростить работу некоторых функций. И даже не смейте мне говорить о том, что юнитами называются войска, а не какие-то коробки или ключи. Я без вас это знаю. Я не смог придумать более приближённого названия для этой объединённой системы коробок и ключей.
Теперь вы более-менее готовы к квантовому прыжку во вселенную TCCR. Полную подготовку вы осуществите после прочтения всей оставшейся документации.
Активация
Первый запуск
При запуске на новом сервере плагин будет требовать активировать себя через консольную команду tccrauth [ЛОГИН] [ПАРОЛЬ]. Повторяю: команда консольная, а значит ввести её можно только в консоли сервера. После ввода данной команды плагин совершит некую магию, и решит - активировать себя или нет. В случае успешной активации вы получите запущенный плагин и уведомление от бота (если вы активировали его в сообществе ВКонтакте).Изменение адреса сервера
При авторизации плагин получает токен, который играет роль идентификатора сервера в системе. Этот токен хранится в файле storage.ejs. Если запустить плагин на другом IP адресе не удаляя этот файл, то вам в ВК придёт уведомление о том, что была произведена попытка включения с неизвестного IP адреса, и будет предложено обновить IP адрес сохранённого в системе сервера на новый. Если же вы хотите добавить ещё один сервер, не изменяя адрес существующего, то необходимо ввести консольную команду авторизации о которой говорилось ранее. Стоит отметить, что на один аккаунт можно добавить не более пяти серверов. Чтобы расширить этот лимит напишите в сообщения сообщества ВКонтакте.Команды
Консольные команды
Команда | Аргументы | Права | Описание |
---|---|---|---|
tccrauth | [ЛОГИН] [ПАРОЛЬ] | - | активация плагина |
tccrretry | - | - | повторная попытка включения плагина. Команда сработает только если присутствует авторизационный токен |
tccrreset | - | - | сброс активации плагина |
Базовые команды
Команда | Аргументы | Права | Описание |
---|---|---|---|
/tccr | - | - | выводит информацию о плагине |
/tccr open | - | tccr.commands.open | открыть меню выбора |
/tccr open | [КОРОБКА] | tccr.commands.open | открыть указанную коробку |
/tccr open | [КОРОБКА] [КЛЮЧ] | tccr.commands.open | открыть указанную коробку используя указанный ключ |
/tccr give | [ЮНИТ] [ИГРОК] [КОЛИЧЕСТВО] | tccr.commands.give | выдаёт игроку указанное количество коробок или ключей |
/tccr set | [ЮНИТ] [ИГРОК] [КОЛИЧЕСТВО] | tccr.commands.set | устанавливает игроку указанное количество коробок или ключей |
/tccr take | [ЮНИТ] [ИГРОК] [КОЛИЧЕСТВО] | tccr.commands.take | забирает у игрока указанное количество коробок или ключей |
/tccr remove | [ИГРОК] | tccr.commands.remove | уничтожает все данные указанного игрока |
/tccr points | - | tccr.commands.points | отображает команды взаимодействия с точками открытия |
/tccr simulate | [ИГРОК] [КОРОБКА] [КОЛИЧЕСТВО] | tccr.commands.simulate | проводит симуляцию открытия указанной коробки у игрока указанное количество раз |
/tccr generateResources | [КОМПОНЕНТ] | tccr.commands.generateresources | генерирует файлы указанного компонента |
/tccr service | - | tccr.service | отображает команды обслуживания |
Команды взаимодействия с точками открытия
Команда | Аргументы | Права | Описание |
---|---|---|---|
/tccr points | - | tccr.commands.points.points | отображает команды взаимодействия с точками открытия |
/tccr points create | - | tccr.commands.points.points | создаёт точку открытия |
/tccr points remove | - | tccr.commands.points.points | удаляет точку открытия |
/tccr points setSelector | [СЕЛЕКТОР] | tccr.commands.points.setselector | устанавливает селектор точке открытия. Виды селекторов: INVENTORY, BOOK, HOLOGRAPHIC |
/tccr points setHologram | [ГОЛОГРАММА] | tccr.commands.points.sethologram | устанавливает тип голограммы для точки открытия. Типы голограмм: NORMAL, INDIVIDUAL, EXTERNAL |
/tccr points setLine | [СТРОКА] [ТИП] [СОДЕРЖИМОЕ] | tccr.commands.points.setline | изменяет содержимое указанной строки голограммы точки открытия. Типы строк: text и item |
/tccr points removeLine | [СТРОКА] | tccr.commands.points.removeline | удаляет указанную строку из голограммы точки открытия |
/tccr points setHeight | [ВЫСОТА] | tccr.commands.points.setheight | изменяет высоту голограммы точки открытия над её блоком |
/tccr points setOpenByDefault | [КОРОБКА] | tccr.commands.points.setopenbydefault | задаёт точке открытия коробку, которая будет открываться при нажатии на её блок. Чтобы сбросить значение, введите команду без аргумента |
/tccr points setAvailable | [КОРОБКА, КОРОБКА, ...] | tccr.commands.points.setavailable | задаёт точке открытия список коробок, которые можно будет через неё открыть. Чтобы сбросить значение, введите команду без аргумента |
/tccr points showOnlyAvailable | [true или false] | tccr.commands.points.showonlyavailable | если true, через данную точку открытия будут отображаться только те коробки, которые указаны через команду setAvailable |
/tccr points setEffector | [АЛИАС КОМПОНЕНТА-ЭФФЕКТОРА, ...] | tccr.commands.points.seteffector | задаёт точке открытия список эффекторов. Чтобы сбросить значение, введите команду без аргумента |
/tccr points setParameter | [ПАРАМЕТР] [ЗНАЧЕНИЕ] | tccr.commands.points.setparameter | задаёт точке открытия уникальный параметр. Чтобы сбросить значение параметра, оставьте аргумент значения пустым |
/tccr points copy | - | tccr.commands.points.copy | копирует все данные точки открытия |
/tccr points paste | - | tccr.commands.points.paste | присваивает скопированные данные данной точке открытия |
Команды обслуживания
Команда | Аргументы | Права | Описание |
---|---|---|---|
/tccr service | - | tccr.service | отображает сервисные команды |
/tccr service toggledebug | - | tccr.service | переключает режим отладки |
/tccr service set | [ПАРАМЕТР] [ЗНАЧЕНИЕ] | tccr.service | присваивает параметр для настроек режима отладки. Чтобы сбросить значение параметра, оставьте аргумент значения пустым |
/tccr service display | [ПОДСИСТЕМА] | tccr.service | отображает данные подсистемы плагина. Подсистемы: components, units, points, storage, sessions |
/tccr service reload | [ПОДСИСТЕМА] | tccr.service | перезагружает указанную подсистему плагина. Перезагружаемые подсистемы: components, units, points, storage, sessions, gui, messages |
/tccr service executeaction | [ИСПОЛНИТЕЛЬ И ЕГО ПАРАМЕТРЫ] | tccr.service | команда для тестирования исполнителей |
/tccr service viewblock | - | tccr.service | отображает параметры блока на прицеле |
/tccr service placeblock | [БЛОК И ЕГО ПАРАМЕТРЫ] | tccr.service | заменяет блок на прицеле на указанный вами. Список параметров можно найти тут. |
Конфигурация плагина
language: RUSSIAN ## Локализация
debug:
enabled: false ## Если true, режим отладки будет включён вместе с плагином
datastorage: default ## Метод хранения данных: default, sql, bungee
sql: ## Настройки подключения к базе данных
host: localhost ## Адрес базы данных
username: admin ## Пользователь базы данных
password: admin ## Пароль пользователя
database: database ## Название базы данных, в которой будут созданы таблицы
groups: ## Иерархия групп в плагине на права; необходимо для работы некоторых исполнителей
- admin
- moderator
- vip
- player