Clans даёт игрокам одно меню для всего, что делает клан: создать его, пригласить людей, раздать роли, заключить альянсы, задать нормы фарма и клановые скины, посмотреть, какое место клан занимает в топе. Если у вас стоит ServerPanel, меню открывается в нём отдельной категорией и подстраивается под ваш шаблон: V1, V2 или V4. Без ServerPanel оно открывается на весь экран в стиле Old Style или New Rust.
Clans также берёт на себя встроенную клановую систему Rust. Клановое меню на F1, вкладка клан-чата, названия кланов на карте и Rust+ показывают данные Clans, а внутриигровые события клановых очков идут в рейтинг вашего клана. У игроков один клан, а не два, которые расходятся между собой.
Лидеры кланов сами настраивают ранги. У роли есть название, цвет и двенадцать прав: от приглашения и исключения игроков до смены аватара и переключения дружественного огня для союзников. Большому клану не нужно раздавать всем права лидера. Данные хранятся в JSON, Protobuf или MySQL, а перенести их между хранилищами можно одной консольной командой. При обновлении с 1.x настройки сохраняются: старые модераторы становятся ролями, а настройки страниц переезжают в новое меню.
Возможности Clans
Скриншоты
Полноэкранный шаблон — Old Style
Полноэкранный шаблон — New Rust
ServerPanel V1
ServerPanel V2
ServerPanel V4
Чем отличается
Роли клана — название, цвет и двенадцать прав у каждой роли
Штатное клановое меню Rust показывает тот же клан
События клана и чат в Discord
Команды
Игроки (названия /clan и /clans можно изменить в конфиге):
Администраторы (clans.manage, нужно право clans.admin):
Консоль:
Права доступа
Категориям и страницам меню, колонкам топа, плиткам статистики, клановым скинам и смене аватара можно назначить право с любым именем. Плагин регистрирует его при загрузке.
Веб-редактор конфига
Управляйте настройками Clans в нашем веб-редакторе конфигурации. Каждый раздел конфига получает свою форму, поэтому роли, страницы, колонки топа, платные действия и хранилище настраиваются без ручной правки JSON-файла.
Веб-редактор конфига
P.S. Зайдите в наш Discord https://discord.gg/mevent и запросите группу «Clans», чтобы получить доступ к веб-редактору конфигурации.
Видео
Тестовый сервер
Заходите на наш тестовый сервер, чтобы самим посмотреть и опробовать все наши уникальные возможности!
Скопируйте IP-адрес ниже, чтобы начать играть!
Код:
Часто задаваемые вопросы
В: Что за файлы в архиве и какие из них мне нужны?
О: В архиве три файла плагинов, обязателен только Clans.cs. Это сам плагин: меню, роли, альянсы, нормы фарма, скины, топы и хранилище, и он работает без двух остальных. ClansDiscord.cs необязателен: он отправляет события клана и клан-чат в вебхуки Discord, так что, если Discord вам не нужен, пропустите его. Чтобы им пользоваться, вставьте вебхук вашего сервера в поле "Admin webhook URL". У каждого события свой переключатель и цвет, а командный чат (Team) по умолчанию выключен. Лидеры кланов могут добавить свой вебхук кнопкой DISCORD или командой /clan discord, а вы можете ограничить это правом и списком разрешённых хостов. ClansConverter.cs необязателен и нужен один раз, только когда вы переносите данные кланов из другого плагина: установите его, выполните нужную команду в консоли сервера или через RCON (из игровой консоли F1 они не работают), проверьте, что кланы перенеслись, и удалите файл. Команды перечислены выше, в разделе «Консоль». Если вы начинаете с нуля, он вам не нужен.
В: Как добавить Clans в ServerPanel?
О: В ServerPanel создайте категорию с параметрами Type: Plugin, Plugin Name: Clans, Plugin Hook: API_OpenPlugin. Clans считывает ваш шаблон ServerPanel и выбирает подходящий вариант меню: t1 и t1_1 дают V1, t2 и t3 дают V2, t4 даёт V4. Пока эта категория существует, /clan открывает её. Чтобы принудительно выбрать вариант, установите в конфиге параметр «Шаблон UI» (UI Pattern) в значение V1, V2, V4 или Fullscreen вместо Auto.
В: Какое хранилище выбрать?
О: JSON используется по умолчанию и работает сразу. Protobuf быстрее и занимает меньше места на диске, что удобно для больших серверов. MySQL позволяет нескольким серверам делить данные кланов. Переключиться можно в любой момент командой clans.convertstorage.
В: Я обновляюсь с Clans 1.x. Что будет с моими данными?
О: Кланы и настройки переносятся. Старые настройки модераторов и цвета участников становятся ролями клана, а настройки страниц переезжают в новые категории меню. Настройки интерфейса переехали из конфига в файлы шаблонов в data/Clans/Templates. Если вы пользовались PlayerDatabase, один раз выполните clans.import.playerdatabase из Clans Converter.
В: Работает ли Clans с моими другими плагинами?
О: У Clans тот же API, что и у других популярных плагинов кланов, поэтому плагины с поддержкой кланов работают и с ним.
В: Как показать топ кланов на экране?
О: Установите Clans Top.
В: Какие ещё плагины нужны?
О: ImageLibrary на Oxide: для аватаров и иконок. В Carbon модуль изображений встроен.
В: Где править тексты или добавить свой язык?
О: oxide/lang/en/Clans.json (или carbon/lang/en/). Скопируйте файл в lang/<code>/Clans.json и переведите значения. Английский и русский уже входят в плагин.
В: Где посмотреть пример конфига?
О: Config
Хуки
Код:
Вопросы, идеи и сообщения об ошибках — в наш Discord.
Clans также берёт на себя встроенную клановую систему Rust. Клановое меню на F1, вкладка клан-чата, названия кланов на карте и Rust+ показывают данные Clans, а внутриигровые события клановых очков идут в рейтинг вашего клана. У игроков один клан, а не два, которые расходятся между собой.
Лидеры кланов сами настраивают ранги. У роли есть название, цвет и двенадцать прав: от приглашения и исключения игроков до смены аватара и переключения дружественного огня для союзников. Большому клану не нужно раздавать всем права лидера. Данные хранятся в JSON, Protobuf или MySQL, а перенести их между хранилищами можно одной консольной командой. При обновлении с 1.x настройки сохраняются: старые модераторы становятся ролями, а настройки страниц переезжают в новое меню.
Возможности Clans
- Пять вариантов меню — ServerPanel V1, V2 и V4 (плагин сам выбирает по вашему шаблону ServerPanel), плюс два полноэкранных стиля: Old Style и New Rust. Каждый вариант — файл шаблона в data/Clans/Templates, где можно менять позиции, цвета и размеры
- Роли клана — лидеры создают роли со своим названием и цветом и выбирают права: приглашение, исключение, повышение, понижение, альянсы, аватар, описание, цвет тега, нормы фарма, скины, дружественный огонь и дружественный огонь для союзников
- Клановая система Rust работает на Clans — клановое меню F1, вкладка клан-чата, названия кланов на карте и Rust+, а внутриигровые события клановых очков идут в рейтинг
- Альянсы — отправка, принятие, отмена и разрыв альянсов, с отдельным переключателем дружественного огня для союзников
- Дружественный огонь — настраивается для каждого клана, защиту соклановцев от турелей можно включить отдельно
- Нормы фарма — клан задаёт, сколько каждого ресурса должен принести каждый участник, а меню показывает, сколько кто уже собрал
- Клановые скины — один набор скинов на весь клан, чтобы с первого взгляда отличать своих от врагов
- Оформление клана — аватар, цвет тега и описание, у каждого своё право в роли
- Топы кланов и игроков — постраничные, с полем ввода номера страницы; колонки и плитки статистики на странице «О клане» и в профилях задаются в конфиге, каждую можно отключить или закрыть правом
- Профили игроков и кланов — открываются из списков участников и таблиц топа
- Ваше меню, ваши страницы — категории и страницы меню можно переставлять, переименовывать, скрывать или закрывать правами
- Платные действия — плата за создание клана, вступление, выход, исключение, роспуск, установку скинов или аватара и за приглашения, через любой плагин экономики или предметами
- Правила тега — минимальная и максимальная длина, список запрещённых слов и фильтр допустимых символов. Ошибки показываются прямо в окне «Создание клана»
- Чат клана и альянса с поддержкой BetterChat
- Дополнительный плагин Clans Discord — события клана и клан-чат уходят в Discord через вебхуки, а лидеры кланов могут указать свой вебхук
- Хранилище — JSON, Protobuf или MySQL, а clans.convertstorage переносит все данные в хранилище другого типа
- Очистка — удаление неактивных кланов и сброс кланов, игроков или приглашений на новой карте, каждое на своём переключателе
- Рассчитан на большие серверы — топ пересобирается небольшими шагами, данные записываются только при изменениях, а шаблон меню готовится в фоне при запуске
Скриншоты
Полноэкранный шаблон — Old Style
Полноэкранный шаблон — New Rust
ServerPanel V1
ServerPanel V2
ServerPanel V4
Чем отличается
Роли клана — название, цвет и двенадцать прав у каждой роли
Штатное клановое меню Rust показывает тот же клан
События клана и чат в Discord
Команды
Игроки (названия /clan и /clans можно изменить в конфиге):
- /clan — открыть меню клана
- /clan create <tag> — создать клан
- /clan disband — распустить клан
- /clan leave — покинуть клан
- /clan join — открыть ваши приглашения
- /clan invite <name/steamid>, /clan withdraw <name/steamid> — пригласить игрока, отменить приглашение
- /clan kick <name/steamid> — исключить участника
- /clan promote <name/steamid>, /clan demote <name/steamid> — перевести участника на роль выше или ниже
- /clan allyinvite <tag>, allywithdraw, allyaccept, allycancel, allyrevoke <tag> — управление альянсами
- /clan ff, /clan allyff (также /cff, /aff) — переключить дружественный огонь для клана и для союзников
- /clan description <text>, /clan tagcolor <hex> — задать описание и цвет тега
- /clan discord — указать вебхук Discord для клана (Clans Discord)
- /cinfo <tag> — информация о клане
- /c, /cchat — клан-чат; /a, /achat — чат альянса
Администраторы (clans.manage, нужно право clans.admin):
- list, listex — все кланы; в listex ещё участники и их статус онлайн
- show [name/userId] — один клан и его участники
- msg [clanTag] [message] — отправить сообщение клану
- create [name/userId] [clanTag], rename [oldTag] [newTag], disband [clanTag]
- invite, join, kick, owner, promote, demote [clanTag] [name/userId]
Консоль:
- clans.convertstorage <JSON|Protobuf|MySQL> — перенести все данные игроков и кланов в хранилище другого типа
- clans.refreshtop — пересобрать топ кланов и игроков прямо сейчас
- clans.refreshskins — перезагрузить список скинов, из которых игроки выбирают клановые скины
- clans.reborn.convert (Clans Converter) читает файл данных Clans Reborn (data/Clans.json) и создаёт из него кланы
- clans.umod.convert (Clans Converter) делает то же для плагина uMod Clans (data/clan_data.json)
- clans.convert.olddata (Clans Converter) переносит настройки игроков из данных Clans 1.x, например дружественный огонь и клановые скины
- clans.import.playerdatabase [field] (Clans Converter) переносит данные игроков из плагина PlayerDatabase. Имя поля по умолчанию Clans, и PlayerDatabase должен быть загружен
Права доступа
- clans.admin — команда clans.manage
- clans.cancreate, clans.canjoin, clans.canleave, clans.candisband, clans.cankick, clans.canskins — каждое проверяется, только когда включён его переключатель в разделе «Настройки разрешений» (Permission Settings) конфига
Категориям и страницам меню, колонкам топа, плиткам статистики, клановым скинам и смене аватара можно назначить право с любым именем. Плагин регистрирует его при загрузке.
Веб-редактор конфига
Управляйте настройками Clans в нашем веб-редакторе конфигурации. Каждый раздел конфига получает свою форму, поэтому роли, страницы, колонки топа, платные действия и хранилище настраиваются без ручной правки JSON-файла.
Веб-редактор конфига
P.S. Зайдите в наш Discord https://discord.gg/mevent и запросите группу «Clans», чтобы получить доступ к веб-редактору конфигурации.
Видео
Тестовый сервер
Заходите на наш тестовый сервер, чтобы самим посмотреть и опробовать все наши уникальные возможности!
Скопируйте IP-адрес ниже, чтобы начать играть!
Код:
connect 155.103.86.38:28015Часто задаваемые вопросы
В: Что за файлы в архиве и какие из них мне нужны?
О: В архиве три файла плагинов, обязателен только Clans.cs. Это сам плагин: меню, роли, альянсы, нормы фарма, скины, топы и хранилище, и он работает без двух остальных. ClansDiscord.cs необязателен: он отправляет события клана и клан-чат в вебхуки Discord, так что, если Discord вам не нужен, пропустите его. Чтобы им пользоваться, вставьте вебхук вашего сервера в поле "Admin webhook URL". У каждого события свой переключатель и цвет, а командный чат (Team) по умолчанию выключен. Лидеры кланов могут добавить свой вебхук кнопкой DISCORD или командой /clan discord, а вы можете ограничить это правом и списком разрешённых хостов. ClansConverter.cs необязателен и нужен один раз, только когда вы переносите данные кланов из другого плагина: установите его, выполните нужную команду в консоли сервера или через RCON (из игровой консоли F1 они не работают), проверьте, что кланы перенеслись, и удалите файл. Команды перечислены выше, в разделе «Консоль». Если вы начинаете с нуля, он вам не нужен.
В: Как добавить Clans в ServerPanel?
О: В ServerPanel создайте категорию с параметрами Type: Plugin, Plugin Name: Clans, Plugin Hook: API_OpenPlugin. Clans считывает ваш шаблон ServerPanel и выбирает подходящий вариант меню: t1 и t1_1 дают V1, t2 и t3 дают V2, t4 даёт V4. Пока эта категория существует, /clan открывает её. Чтобы принудительно выбрать вариант, установите в конфиге параметр «Шаблон UI» (UI Pattern) в значение V1, V2, V4 или Fullscreen вместо Auto.
В: Какое хранилище выбрать?
О: JSON используется по умолчанию и работает сразу. Protobuf быстрее и занимает меньше места на диске, что удобно для больших серверов. MySQL позволяет нескольким серверам делить данные кланов. Переключиться можно в любой момент командой clans.convertstorage.
В: Я обновляюсь с Clans 1.x. Что будет с моими данными?
О: Кланы и настройки переносятся. Старые настройки модераторов и цвета участников становятся ролями клана, а настройки страниц переезжают в новые категории меню. Настройки интерфейса переехали из конфига в файлы шаблонов в data/Clans/Templates. Если вы пользовались PlayerDatabase, один раз выполните clans.import.playerdatabase из Clans Converter.
В: Работает ли Clans с моими другими плагинами?
О: У Clans тот же API, что и у других популярных плагинов кланов, поэтому плагины с поддержкой кланов работают и с ним.
В: Как показать топ кланов на экране?
О: Установите Clans Top.
В: Какие ещё плагины нужны?
О: ImageLibrary на Oxide: для аватаров и иконок. В Carbon модуль изображений встроен.
В: Где править тексты или добавить свой язык?
О: oxide/lang/en/Clans.json (или carbon/lang/en/). Скопируйте файл в lang/<code>/Clans.json и переведите значения. Английский и русский уже входят в плагин.
В: Где посмотреть пример конфига?
О: Config
Хуки
Код:
Код:
void OnClanCreate(string tag)
void OnClanCreated(IClan clan, ulong leaderId)
void OnClanUpdate(string tag)
void OnClanDestroy(string tag)
void OnClanDisbanded(string tag, List<ulong> memberUserIDs)
void OnClanRenamed(string oldTag, string newTag)
void OnClanLeaderChanged(ulong newLeader, ulong oldLeader, string tag)
void OnClanMemberJoined(ulong userId, string tag)
void OnClanMemberLeft(ulong userId, string tag)
void OnClanMemberGone(ulong userId, string tag)
void OnClanMemberKicked(ulong userId, ulong actorId, string tag)
void OnClanMemberPromoted(ulong userId, ulong actorId, string tag, string role)
void OnClanMemberDemoted(ulong userId, ulong actorId, string tag, string role)
void OnClanInvite(ulong inviterId, ulong targetId, string tag)
void OnClanInviteRejected(ulong userId, string tag)
void OnClanInviteWithdrawn(ulong inviterId, ulong targetId, string tag)
void OnClanAllianceInvite(string tag, string targetTag, ulong actorId)
void OnClanAllianceAccepted(string tag, string targetTag, ulong actorId)
void OnClanAllianceInviteRejected(string tag, string targetTag, ulong actorId)
void OnClanAllianceInviteWithdrawn(string tag, string targetTag, ulong actorId)
void OnClanAllianceRevoked(string tag, string targetTag, ulong actorId)
void OnClanChat(BasePlayer player, string message, string tag)
void OnClanTopUpdated()Вопросы, идеи и сообщения об ошибках — в наш Discord.
