BBya Guilds&Clans: Плагин для гильдий и кланов нашего сервера

[OcelotJungle 192]

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

 

Команды плагина и работа с игроками.

Спойлер

 

Во всех командах из пунктов 2-5 регистр ника игрока не имеет значения, т.к. внутри система обрабатывает все ники в нижнем регистре, но в пунктах 6-7 обязателен правильный регистр ника.

 

---

 

0. Перезагрузка конфига.

Спойлер

 

При редактировании конфигов вручную (кланов, гильдий, игроков, общего) для подгрузки изменений конфигов нужно прописать команду:

/gc reload

 

Результат:

 

 

---

 

1. Внутриигровая справка.

Спойлер

 

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

а) /gc

б) /gc help

 

Результат:

Спойлер

 

 

 

---

 

2. Работа с кланами.

Спойлер

 

Чтобы установить игроку клан, нужно прописать одну из команд:

а) /gc setclan <player> <clan ID>

б) /gc setclan <player> <clan name>

 

Первый вариант устанавливает игроку клан по его порядковому номеру в конфиге clans.yml (рекомендуется соответствовать при настройке номерам кланов в шапке темы Кланы), причём ID клана может быть только в диапазоне 0-255, но команда выполнится только если клан с таким номером существует в конфиге. Второй устанавливает клан по его названию. Также, если перед вводом клана, но после ввода ника, нажать кнопку так, в чате появится список названий всех доступных кланов. Регистр ввода названия значения не имеет.

 

Результат использования команды:

 

Если прописать '/gc setclan <player> 0', то клан игрока сбросится и в чате появится:

 

Чтобы узнать клан игрока, нужно прописать команду:

/gc getclan <player>

 

Результат:

 

 

---

 

3. Работа с гильдиями.

Спойлер

 

Чтобы установить игроку гильдию, нужно прописать одну из двух команд:

а) /gc setguild <player> <guild ID>

б) /gc setguild <player> <guild name>

 

По аналогии с кланами, первый вариант устанавливает игроку гильдию по её порядковому номеру в конфиге guilds.yml (рекомендуется соответствовать при настройке последовательности создания гильдий), причём ID гильдии может быть только в диапазоне 0-255, но команда выполнится только если гильдия с таким номером существует в конфиге . Второй вариант устанавливает гильдию по её названию. Также, если перед вводом гильди, но после ввода ника, нажать кнопку так, в чате появится список названий всех доступных гильдий. Регистр ввода названия значения не имеет.

 

Результат:

 

Для сброса гильдии используется аналогичная клановой команда '/gc setguild <player> 0' с аналогичным результатом (при этом уровень игрока в гильдии не затрагивается):

 

Чтобы узнать гильдию игрока, нужно прописать команду:

/gc getclan <player>

 

Результат:

 

 

---

 

4. Работа с уровнями.

Спойлер

 

Чтобы установить уровень игрока, нужно прописать команду:

/gc setlevel <player> <level>

 

Уровень можно установить только в определённых пределах. Если игрок не имеет гильдии, то уровень можно установить только в пределах от 0 до 255 включительно. Если игрок состоит в какой-либо гильдии, то ему можно установить уровень от 0 до максимального уровня этой гильдии, прописанного в конфиге, включительно. Никто не мешает убрать игроку гильдию, поставить 255 уровень и вернуть гильдию, но какой в этом смысл?

 

Результат:

а) Игрок состоит в гильдии, максимальный уровень 30, установка уровня 20.

б) Игрок состоит в гильдии, максимальный уровень 30, установка уровня выше 30.

в) Игрок не состоит в гильдии, установка уровня 179.

г) Игрок не состоит в гильдии, установка уровня выше 255.

 

Чтобы узнать уровень игрока, нужно прописать команду

/gc getlevel <player>

 

Результат:

 

 

---

 

5. Сброс информации об игроке.

Спойлер

 

Чтобы удалить информацию об игроке из конфига, нужно прописать команду:

/gc resetinfo <player>

 

Первый ввод команды просто установит информацию об игроке на ноль, второй ввод совсем уберёт строку с его ником из файла.

 

Результат:

а) 

б) 

 

 

---

 

6. Полная прокачка игрока в гильдии.

Спойлер

 

Чтобы полностью прокачать игрока в его гильдии, нужно прописать команду:

/gc fulllevelup <player>

 

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

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

 

Результат:

 

 

---

 

7. Вступление игрока в гильдию.

Спойлер

 

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

/gc gotoguild <player> <guild ID/name>

 

При использовании команды проверяется наличие у игрока на счетах сумм, прописанных в конфиге, и если денег и бутылок хватает, то:

а) Игрок перемещается в указанную гильдию.

б) У игрока устанавливается первый уровень гильдии.

в) Со счёта игрока снимается N-ное количество изумрудов и бутылок опыта.

 

Результат:

 

 

---

 

8. Пересборка ника игрока.

Спойлер

 

Каждый раз при входе игрока на сервер либо использовании любой из команд, меняющих какие-либо параметры игрока, или "gc reload", его ник пересобирается по шаблону:

а) Префикс клана, имеет вид "[Название_клана]", а также цвет этого клана.

б) Цвет ССИС-команды, в которой состоит игрок. Если команды у игрока нет, то цвет ника будет цвета его гильдии. В противном случае - белый.

в) Ник игрока.

г) Разделитель " | ".

д) Обозначение гильдии в формате "(символ гильдии)-(уровень гильдии римскими цифрами)" и с цветом гильдии.

 

Примеры:

а) Клан "Light" жёлтого цвета, ССИС-команда с бирюзовым цветом, гильдия "Торговец" 19-го уровня.

б) Клан "THI" чёрного цвета, нет ССИС-команды, гильдия "Гном" 30-го уровня.

в) Нет клана, нет ССИС-команды, гильдия "Торговец" 10-го уровня

г) Клан "Light", ССИС-команда зелёного цвета, нет гильдии.

 

 

 

 

Настройка конфигов.

Спойлер

 

Плагин имеет 4 конфига: clans.yml, players.yml, config.yml, guilds.yml.

В реальных конфигах инструкции написаны на английском языке для совместимости с github.

 

 

---

 

1. Подробнее о clans.yml.

 

Конфиг с самой простой настройкой:

Спойлер

 

 

 

Поле label - отображаемое название клана (только латиница), color - цвет клана из стандартной палитры цветов в minecraft, например, можно взять отсюда (из Official Name, но в нижнем регистре и заменяя пробелы нижним подчёркиванием):

Спойлер

 

 

 

 

---

 

2. Подробнее о players.yml

 

Конфиг, содержащий информацию об игроках. Настройка:

Спойлер

 

 

Думаю, не нужно объяснять, что это шестнадцатеричная система счисления. Маловероятно, что вам придётся редактировать этот конфиг вручную, так как он полностью контролируется командами из игры.

Ники игроков всегда записываются в нижнем регистре.

 

 

 

---

 

3. Подробнее о config.yml

 

Основной конфиг, имеющий 4 параметра. Настройка:

Спойлер

 

Думаю, комментарии излишни. Не рекомендую ставить маленькое значение effectDuration, так как когда эффекту остаётся работать меньше минуты, он перезаписывается.

 

 

---

 

4. Самое сложное, guilds.yml.

 

Самый непростой конфиг - конфиг гильдий. Настройка:

Спойлер

 

Поле postfix принимает участие в пересборке ника игрока. symbol отображается в обозначении гильдии в конце ника, а color отвечает за цвет гильдии.

Поле levelup участвует как во вступлении в гильдию (в этом случае цена вступления - поля money и bottles, без участия step), так и в прокачивании уровней гильдии (тогда цена каждого следующего уровня, в зависимости от соответствующего значения в основном конфиге, равна либо "cost", либо "cost + step*oldLevel"). Если step не нужен, его можно установить равным нулю или вовсе не прописывать, то же самое с любым из двух параметров цены прокачивания.

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

а) Поле morning отвечает за то, выдаётся эффект только утром (в промежуток между 0 и 200 тиками с начала игрового дня) или постоянно.

б) Поле name отвечает за тип эффекта, возможные значения можно посмотреть здесь, либо здесь, либо взять из игровой команды '/effect'. Регистр значения не имеет.

в) Список уровней - levels.

в.1) Значение слева равно значению уровня эффекта, начиная с 1 (не с 0, как в игре).

в.2) Значение справа обозначает, на каких уровнях гильдии будет действовать данный уровень эффекта.

в.2.1) Если написан один ноль или пустые квадратные скобки, то эффект действует с 0 до 255 уровня включительно.

в.2.2) Если написано число, то эффект действует с 0 уровня до этого числа включительно.

в.2.3) Если написано одно число в квадратных скобках, то эффект действует от этого числа до 255 уровня включительно.

в.2.4) Если написано два или более чисел в квадратных скобках, то эффект действует с первого числа до второго включительно.

 

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

 

Пример заполненной гильдии:

Спойлер

 

 

 

 

 

На этом пока всё, если у кого будут вопросы - задавайте в этой теме, я на неё подписан.

[RedTeapot 155]

Только что, OcelotJungle сказал:

С чего ты взял спам Исключениями? Плагин при запуске выдаёт одну строчку, что список игроков пуст.

 

Посмотрел на консоль. Думаешь, я тут ржача ради решил сказки посочинять?

[Admin 455]

22 минуты назад, OcelotJungle сказал:

Плагин при запуске выдаёт одну строчку, что список игроков пуст.

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

и только в конце строчка с причиной

[OcelotJungle 192]

5 часов назад, Admin сказал:

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

 

Ну, хз. Не должно.

 

5 часов назад, RedTeapot сказал:

 

Посмотрел на консоль. Думаешь, я тут ржача ради решил сказки посочинять?

Кто тебя знает?