Кланы
Модуль clans (по мотивам плагина ZClans): кланы с рангами и правами, приглашения и заявки, общая казна, настройки видимости и войны N на N на отдельной арене.
Всё начинается с команды /clan: она открывает меню. Что в нём будет, зависит от того, состоите ли вы в клане.
Если вы не в клане#

- Список кланов — баннеры всех кланов (при наведении — лидер и число участников). Нажмите на баннер,
чтобы открыть карточку клана. В чате (
/clan list,/clan info) название клана показывает баннер при наведении. - Приглашения — кланы, которые вас позвали (принять ✔ или отклонить ✘).
- Создать свой клан.
- Если вы подали заявку, здесь же её можно отозвать.

Карточка клана#
Тег и название, баннер, лидер, число участников, дата основания, казна и счёт войн (победы, поражения, ничьи). Часть этих данных клан может скрыть от посторонних (см. Видимость). Отсюда же можно подать заявку.

Вступить: приглашение или заявка#
Приглашение — клан зовёт вас сам. Придёт сообщение, а в меню появится строка с кнопками ✔ / ✘.

- Приглашение действует 24 часа.
- Если вы 3 раза отклонили приглашения одного клана, этот клан не сможет приглашать вас ещё сутки. Истёкшее приглашение отказом не считается.
- Команды:
/clan accept <клан>,/clan decline <клан>.
Заявка — вы просите принять вас в клан.
- Активной может быть только одна заявка: заявка в другой клан заменяет старую. Повторно в тот же клан подать нельзя — заявка уже ждёт ответа.
- Если клан 3 раза отклонил ваши заявки, подавать туда заявки нельзя ещё сутки.
- Отозвать:
/clan unapplyили кнопка в меню. - Создадите свой клан — ваши заявки в другие кланы сбросятся.
- Команда:
/clan apply <клан>.
Состоять можно только в одном клане.
Создать клан#
/clan create <ТЕГ> <название> или «Создать свой клан» в меню.

- Тег — 2–5 букв или цифр, например
R27. Он показывается перед вашим ником в чате и табе:[R27] Ник. - Название — 3–24 символа: буквы, цифры, пробел,
_ - ' . - И тег, и название должны быть свободны.
- Создатель становится лидером.

Меню клана#

В панели: участники, заявки, казна, войны, права рангов, видимость клана, ваша видимость, «Выйти из клана» и (у лидера) «Баннер из руки» и «Распустить клан». Кнопки, на которые у вашего ранга нет прав, не работают.
Соклановцы видят сообщения о клане в чате: «Ник присоединился», «Ник вышел», «Ник получил приглашение в клан», «Новый лидер клана», «Клан распущен».
Ранги и права#
Ранги снизу вверх: Участник → Старейшина → Заместитель → Лидер. Лидер в клане один, заместителей может быть несколько.
Что разрешено рангам, лидер настраивает сам («Права рангов» в меню — по одному рангу, ранг переключается
кнопками; или /clan perm). Кнопки действий, на которые у вашего ранга нет права, видны серыми: при наведении —
какое право нужно. По умолчанию:
| Право | Участник | Старейшина | Заместитель | Лидер |
|---|---|---|---|---|
| Приглашения | — | ✔ | ✔ | ✔ |
| Заявки (принимать и отклонять) | — | ✔ | ✔ | ✔ |
| Война (вызов, ответ, время, отмена) | — | — | ✔ | ✔ |
| Состав на войну | — | — | ✔ | ✔ |
| Вывод из казны | — | — | ✔ | ✔ |
| Повышение и понижение | — | — | ✔ | ✔ |

Только у лидера, без настройки: исключить участника, передать лидерство, распустить клан, права рангов и видимость клана.
Участники#

Список с рангами и значком «в сети». Нажмите на участника, чтобы открыть действия:

- Повысить / Понизить (право «Повышение»). Менять ранг можно только тем, кто ниже вас, и поднимать не выше ранга сразу под вашим: заместитель может сделать старейшину, лидер — заместителя.
- Передать лидерство (лидер). Бывший лидер становится заместителем.
- Исключить (лидер). Перед исключением меню попросит подтверждение.

Заявки в клан#

Кто подал заявку и когда; ✔ — принять, ✘ — отклонить. При принятии проверяется, что игрок не вступил в другой клан. Когда приходит новая заявка, все, у кого есть право «Заявки» и кто в сети, получают сообщение. Посторонние списков участников и заявок не видят.
Выйти и распустить#
- Выйти:
/clan leaveили кнопка в меню. Лидер выйти не может: сначала передайте лидерство или распустите клан. Игрок из состава на ближайшую войну тоже выйти не может. - Распустить:
/clan disband(лидер, с подтверждением). Нельзя, если в казне есть АР или у клана есть принятая или идущая война. При роспуске пропадают приглашения и заявки, у всех закрываются меню клана.
Казна#
Общий счёт клана в АР. Это не сундук: казна хранится в банке, украсть её в мире нельзя.

- Внести может любой участник — с личного счёта в банке (не из инвентаря).
- Вывести на свой счёт — только ранги с правом «Вывод из казны». Об этом получают сообщение остальные, у кого есть это право.
- Одновременно казной пользуется один человек. Пока казна открыта у кого-то, остальным пишет «Казной сейчас пользуется ник». Если 5 минут ничего не делать, казна освобождается сама.

Команды: /clan treasury — меню, /clan treasury deposit <сумма>, /clan treasury withdraw <сумма>.
Баннер#
/clan banner или кнопка «Баннер из руки» в панели (лидер): возьмите в руку баннер и выполните команду. Клан сохранит копию, а сам баннер останется у
вас. Баннер показывается в карточке и меню клана.
Видимость#
Что видно посторонним (лидер): состав, казна, войны, лидер, дата основания. Отмеченное скрыто от тех, кто не в клане.

Моя видимость (каждый для себя): можно скрыть от соклановцев свой ранг и дату вступления. Скрытое видят только вы и лидер.

Команды: /clan privacy <поле> hide|show — поля members, treasury, wars, leader, created;
/clan hide rank on|off, /clan hide joined on|off.
Войны#
Клан вызывает другой клан на бой N на N на отдельной арене со ставкой из казны. Победитель забирает обе ставки.

Как проходит война#
-
Вызов. Клан выбирает соперника, формат (3×3, 5×5 или 6×6) и ставку в АР. В казне должно хватать на ставку. Сопернику приходит сообщение.

Вызов на войну -
Ответ. У вызванного клана 24 часа, чтобы принять или отклонить. Не ответили — вызов истекает. При принятии ставка списывается из казны обоих кланов и замораживается до конца войны. Если в казне не хватает, принять нельзя. У клана может быть только одна принятая война; остальные вызовы между этими кланами отменяются.
-
Время. Его выбирает вызвавший клан:
/clan war time <id> ЧЧ:ММ [ДД.ММ]или кнопка в меню войны.- начало — с 08:00 до 00:00 по Москве;
- не раньше чем через час и не дальше чем на 7 дней вперёд;
- без даты — ближайший такой час;
- одна арена — одна война: занятое время назначить нельзя.
-
Состав. Каждый клан отмечает до N бойцов («Состав» в меню войны или
/clan war roster <id> add|remove <ник>). Менять состав можно до момента за 1 час до начала, потом он фиксируется.
Война 
Состав -
Начало. В назначенное время бойцы из состава, которые в сети, переносятся на арену. Сервер запоминает, где стоял каждый. Неполный состав допустим. Если от клана не пришёл никто, он проигрывает. Если не пришёл никто с обеих сторон, война отменяется и ставки возвращаются.
-
Бой — 10 минут.
- На арене режим «Приключение»: ломать и ставить блоки нельзя.
- В табе вместо ников — «Боец 1», «Боец 2»… (номера перемешаны).
- Погибший теряет вещи как обычно, выбывает и возвращается на своё место. Вышедший из игры тоже выбывает.
- Ушедший за границу арены возвращается на свою точку.
- Выпавшие вещи можно подбирать: подобранное остаётся у того, кто взял.
- Сверху виден таймер и число живых с каждой стороны.
-
Итог.
- Если у одной стороны погибли все — бой заканчивается сразу.
- Иначе по истечении времени побеждает клан, у которого больше живых.
- Живых поровну — решает броня: у каждого живого бойца складывается оставшаяся прочность брони в процентах (пустой слот — 0), у кого сумма больше, тот победил.
- Равны и живые, и броня — ничья, ставки возвращаются.
- Победитель получает обе ставки в казну. Выжившие возвращаются на свои места. Всё, что осталось на арене, удаляется.
О ключевых событиях (вызов, принятие, назначение, фиксация состава, начало, итог) сообщается в чате.
Отмена#
- По согласию. Один клан предлагает отменить (
/clan war cancel <id>или кнопка), второй подтверждает той же командой в течение 30 минут. Ставки возвращаются. - Если один из кланов распущен или исчез, его войны отменяются.
- Если бой прервала остановка сервера, война отменяется со ставками назад, а бойцы возвращаются на свои места.
- Администрация может отменить войну без согласия.
Команды войн#
| Команда | Что делает |
|---|---|
/clan war challenge <N> <ставка> <клан> |
вызвать |
/clan war accept <id>, /clan war decline <id> |
принять или отклонить вызов |
/clan war time <id> ЧЧ:ММ [ДД.ММ] |
назначить время (вызвавший клан) |
/clan war roster <id> add|remove <ник> |
состав |
/clan war cancel <id> |
предложить отмену или согласиться на неё |
/clan war list |
войны вашего клана |
/clan war info <id> |
подробности: составы и итог |
Статусы войны: ждёт ответа → принята, время не выбрано → назначена → идёт бой → завершена (или отклонена, истекла, отменена).
Все команды кланов#
| Команда | Кто | Что делает |
|---|---|---|
/clan |
все | меню |
/clan create <ТЕГ> <название> |
не в клане | создать |
/clan info [клан] |
все | карточка клана (своего — без аргумента) |
/clan list |
все | список кланов |
/clan invites |
все | ваши приглашения в чат |
/clan members |
участник | состав клана в чат |
/clan applications |
право «Заявки» | заявки в чат |
/clan invite <ник> |
право «Приглашения» | пригласить |
/clan accept|decline <клан> |
приглашённый | ответить на приглашение |
/clan apply <клан>, /clan unapply |
не в клане | подать или отозвать заявку |
/clan approve|reject <ник> |
право «Заявки» | решить по заявке |
/clan leave |
участник | выйти |
/clan kick <ник> |
лидер | исключить |
/clan promote|demote <ник> |
право «Повышение» | изменить ранг |
/clan transfer <ник> |
лидер | передать лидерство |
/clan disband |
лидер | распустить |
/clan banner |
лидер | баннер из руки |
/clan perm |
участник | права рангов в чат |
/clan perm <ранг> <право> on|off |
лидер | права рангов: ранги member, elder, deputy; права invite, applications, war, war_roster, treasury_withdraw, promote |
/clan privacy |
участник | что скрыто от посторонних и ваша видимость, в чат |
/clan privacy <поле> hide|show |
лидер | видимость клана |
/clan hide rank|joined on|off |
участник | своя видимость |
/clan treasury [deposit|withdraw <сумма>] |
участник | казна (без аргументов — окно) |
/clan treasury balance |
участник | казна и ваш счёт в чат |
Для администрации#
/clan admin — окно: на арену, точки сторон A и B, идущие войны (▶ — начать сейчас, ✘ — отменить) и роспуск
любого клана.

| Команда | Что делает |
|---|---|
/clan admin |
окно администрации кланов |
/clan admin war cancel <id> |
отменить войну без согласия (ставки возвращаются) |
/clan admin war start <id> |
начать войну сейчас (правила состава те же) |
/clan admin disband <клан> |
распустить клан |
/clan admin arena tp |
телепорт на арену |
/clan admin arena seta|setb |
точка появления стороны A (вызвавший) или B (вызванный) там, где стоите |
Право: clans.admin. Арена — отдельное плоское измерение rozb_clans:arena без ночных мобов; создаётся само.
Построить её можно WorldEdit или Axiom, затем отметить точки сторон.
Настройки (config/rozb_clans/config.json):
| Ключ | По умолчанию | Что это |
|---|---|---|
nameMin, nameMax |
3, 24 | длина названия |
tagMin, tagMax |
2, 5 | длина тега |
showTag |
true |
тег перед ником в чате и табе |
inviteTtlMinutes |
1440 | срок приглашения |
inviteStrikes, inviteCooldownHours |
3, 24 | после скольких отказов и на сколько часов блокируются приглашения клана игроку (и заявки игрока в клан) |
treasuryLockSeconds |
300 | сессия казны |
warFormats |
3, 5, 6 | допустимые N |
warMinStake |
0 | минимальная ставка |
warResponseHours |
24 | время на ответ |
timeZone |
Europe/Moscow |
часовой пояс окна войн |
warWindowFromHour, warWindowToHour |
8, 24 | окно начала боя |
rosterLockMinutes |
60 | фиксация состава до начала |
warMaxDaysAhead |
7 | насколько вперёд можно назначить |
warDurationMinutes |
10 | длительность боя |
cancelRequestMinutes |
30 | время на согласие с отменой |
anonymizeTab |
true |
«Боец N» вместо ников |
arenaWorld |
rozb_clans:arena |
измерение арены |
arenaSpawnA, arenaSpawnB |
−20.5 −59 0.5 и 20.5 −59 0.5 | точки сторон |
arenaRadius |
60 | радиус арены от середины между точками |