Плагин для создания комнат (чатов) с разными параметрами. Имеется возможность создавать персональные комнаты пользователями. Система "тюрьмы" позволяет запирать некоторых пользователей в комнатах.
Чтобы войти в комнату, нужно написать !rooms_enter <название_комнаты> в чат или !enter в приват комнаты. Также автоматически произойдёт вход пользователя в комнату, если написать ей личное сообщение, если такая возможность имеется. Чтобы выйти из комнаты введите команду !rooms_quit <название_комнаты> в чат или команду !quit в приват комнаты. Посмотреть состав комнаты можно командой !rooms_info <название_комнаты> в общий чат или командой !info в приват комнаты. Посмотреть описание комнаты можно командой !rooms_description <название_комнаты> в общий чат или командой !description в приват комнаты. Посмотреть список комнат и справку по командам можно по команде !rooms в чат.
Создать комнату можно командой !rooms_add <название> <видимость> <доступ> <уровень> <описание> в чат. Параметр «видимость» может быть 1 (видна в списке пользователей на хабе) или 0 (не видна в списке пользователей). Параметр «доступ» определяет, можно ли писать в комнату и может быть 1 (писать можно) или 0 (писать нельзя, только чтение). Администрация Хаба может писать в комнаты с флагом доступа 0. Уровень комнаты определяет класс пользователей, которые могу входить в комнату. Если класс пользователя ниже указанного уровня комнаты, у него нет прав на вход. Поменять параметры существующей комнаты можно командой !rooms_parameters <название> <видимость> <доступ> <уровень> <описание> в чат или командой !parameters <видимость> <доступ> <уровень> <описание> в приват комнаты. Параметры можно указывать не все, начиная с первого. Неуказанные параметры останутся старыми.
Удалить комнату можно командой !rooms_delete <название_комнаты> в общий чат.
Запереть комнату, чтобы нельзя было в неё входить новым пользователям, можно командой !rooms_lock <название> в общий чат или командой !lock в приват комнаты. Отпереть комнату можно командой !rooms_unlock <название> в чат или командой !unlock в приват.
Выгнать всех пользователей из комнаты можно командой !rooms_drive <название> в чат или командой !drive в приват. Выгнать конкретного пользователя из комнаты можно командой !rooms_drive <название> <ник> в чат или командой !drive <ник> в приват комнаты.
Посмотреть подробный отчёт об имеющихся комнатах и их составе можно командой !rooms_details в чат.
Занести пользователя в чёрный список, запретив ему входить в комнаты, можно командой !rooms_prohibit <ник> в чат. Разрешить пользователю снова входить в комнаты можно командой !rooms_allow <ник> в чат. Посмотреть чёрный список можно командой !rooms_skip.
Посадить пользователя в указанную комнату (функция тюрьмы), запретив ему писать в общий чат и выходить из комнаты, в которую его посадили, можно командой !rooms_jail <название> <ник> в общий чат. Выпустить пользователя из тюрьмы, разрешив ему снова писать в чат и выйти из комнаты можно командой !rooms_letout <ник>. Посмотреть список заключённых комнат можно по команде !rooms_prison в чат. Не забывайте выпускать пользователей из тюрьмы, иначе забудете про них и они, бедняги, не смогут даже написать в чат и выйти из комнаты.
Пригласить пользователя в комнату можно командой !rooms_invite <название> <ник> в чат или командой !invite <ник> в приват комнаты.
На комнату для доступа можно задать пароль. Это делается командой !rooms_password <название> <пароль> <подсказка> в общий чат или командой !password <пароль> <подсказка> в приват комнаты. Если пароль не задан (пустая строка), то комната считается без пароля. Подсказка (если указана) помогает вспомнить или узнать пароль для доступа и выводится вместе с запросом пароля.
Командой !rooms_addexception <название> можно добавить исключение названий (название, которое не может быть использовано в качестве названия комнаты) в общий чат. Удалить исключение из запрещённых названий можно командой !rooms_deleteexception <название> в чат. Посмотреть список исключений названий комнат можно командой !rooms_exceptions в общий чат.
Для комнат можно задавать классы, которым запрещено входить в комнату, отдельно. Для этого используется команда !rooms_forbidclass <название> <класс> в общий чат. Разрешить вновь запрещённый класс для комнаты можно командой !rooms_allowclass <название> <класс> в общий чат.
Плагин позволяет пользователям также создавать персональные комнаты (так называемые именные комнаты). При этом модератором в комнате является её создатель. Администрация Хаба не является в таких комнатах модераторами, может лишь удалить именную комнату. Создавать можно только одну именную комнату с одного ника или IP-адреса. При выходе с Хаба пользователя, создавшего именную комнату, его комната удаляется автоматически.
Создать свою именную комнату можно командой !personalrooms_add <название> <описание> в общий чат. Удалить именную комнату можно командой !personalrooms_delete в общий чат. Также можно задать пароль на доступ к своей комнате командой !personalrooms_password <пароль> <подсказка> в общий чат или командой !password <пароль> <подсказка> в приват. Пароль должен быть без пробелов. Можно использовать команду без параметров, чтобы удалить пароль. Выгнать пользователя из своей именной комнаты можно командой !personalrooms_drive <ник> в чат или командой !drive <ник> в приват. Пригласить в свою именную комнату пользователя можно командой !personalrooms_invite <ник> в чат или !invite <ник> в приват.
Посмотреть подробный отчёт об именных комнатах и их составе можно командой !personalrooms_details в общий чат. Произвести чистку именных комнат, чтобы удалить возможные «зависшие» именные комнаты без хозяина можно командой !personalrooms_clean в общий чат.
Командой !rooms_autoquit <класс> задаётся параметр класс пользователей, начиная с которого пользователи остаются в комнатах при выходе с Хаба, то есть не происходит автовыход.
Командой !rooms_io задаётся режим отправки сообщений в комнаты о входе/выходе пользователей.
Также можно присваивать модераторов из пользователей для общих комнат. При этом пользователи, которые находятся в списке модераторов комнаты, имеют в ней такие же права, как и операторы. Добавить модера в список модераторов текущей комнаты можно командой !moderator+ <ник> в приват комнаты. Удалить пользователя из списка модераторов текущей комнаты можно командой !moderator- <ник> в приват комнаты. Список модераторов текущей комнаты доступен по команде !moderators в приват комнаты.
База игнорируемых пользователей хранится в файле RoomsBlackList. База заключённых комнат хранится в файле RoomsPrisoners. База комнат хранится в файле Rooms.dat. База именных комнат хранится в файле ImenRooms.dat. База исключений названий хранится в файле RoomsExeptNames. Название бота и пункта главного меню задаётся в файле языковой локализации Text_lang.lua. Текст справки для пользователей и операторов хранится в файлах RoomsUserHelp_lang.txt и RoomsOPHelp_lang.txt в папке плагина.