Plugin for creation rooms (chats) with different parametres. Has possibility to create personal rooms by users. "The prison" system allows to lock some users in rooms.
To enter room use command !rooms_enter <roomname> in chat or !enter im PM. Also automatically there will be an input user in room if to write it the personal message if such possibility is available. To leave room by command !rooms_quit <roomname> in chat or !quit in PM. Get users in the room by command !rooms_info <roomname> in chat or !info in PM. Get room's description be command !rooms_description <roomname> in chat or !description in PM. To look the list of rooms and the inquiry on commands it is possible by command !rooms in chat.
To create new room possible by command !rooms_add <roomname> <visibility> <access> <class> <description> in chat. Parametre "visibility" can be 1 (visible in the list of users) or 0 (not visible in the list of users). Parametre "access" defines, whether it is possible write to room and can be 1 (possible write) or 0 (read only). The Hub administration can write to rooms with access flag 0. Room level defines class of users which can enter into room. If the class of the user below the specified level of room, at it is not present the rights to enter. To change parametres of an existing room it is possible by command !rooms_parameters <roomname> <visibility> <access> <class> <description> in chat or !parameters <visibility> <access> <class> <description> in PM. Parametres it is possible to specify not everything, since the first. Not specified parametres remain old.
To delete room possible by command !rooms_delete <roomname> in chat.
To lock room that it was impossible to enter into it to new users, it is possible by command !rooms_lock <roomname> in chat or !lock in PM. To unlock room it is possible by command !rooms_unlock <roomname> in chat or !unlock in PM.
To expel all users from room it is possible by command !rooms_drive <roomname> in chat or !drive in PM. To expel the concrete user from room it is possible by command !rooms_drive <roomname> <nick> in chat or !drive <nick> in PM.
To look the entire account about available rooms and their structure it is possible by command !rooms_details in chat.
To bring the user in the black list, having forbidden it to enter into rooms, it is possible by command !rooms_prohibit <nick> in chat. To allow to enter again to the user into rooms it is possible by command !rooms_allow <nick> in chat. To look the black list it is possible by command !rooms_skip.
To plant the user in the specified room (prison function), having forbidden it to write to the general chat and to leave room in which it have planted, it is possible by command !rooms_jail <roomname> <nick> in chat. To release the user from the prison, having allowed to write again to it to chat and to leave room it is possible by command !rooms_letout <nick>. To look the list of the concluded rooms it is possible by command !rooms_prison in chat. Do not forget to release users from the prison, differently will forget about them and they, poor creatures, cannot even write to chat and to leave room.
To invite the user in room it is possible by command !rooms_invite <roomname> <nick> in chat or !invite <nick> in PM.
On a room for access it is possible to set the password. It becomes by command !rooms_password <roomname> <password> <reminder> in chat or !password <password> <reminder> in PM. If the password is not set (an empty line) the room is considered without the password. The help (if it is specified) helps to recollect or learn the password for access and is deduced together with inquiry of the password.
By command !rooms_addexception <roomname> it is possible to add an exception of names (the name which cannot be used as the room name) in chat. To remove an exception of the forbidden names it is possible by command !rooms_deleteexception <roomname> in chat. To look the list of exceptions of names of rooms it is possible by command !rooms_exceptions in chat.
For rooms it is possible to set classes it is forbidden to them to enter into room, separately. The command is for this purpose used !rooms_forbidclass <roomname> <class> in chat. To resolve again forbidden class for a room it is possible by command !rooms_allowclass <roomname> <class> in chat.
The plugin allows users to create also personal rooms (so-called nominal rooms). Thus a moderator in room is its founder. The Hub administration is not moderators in such rooms, can remove personal room only. It is possible to create only one personal room from one nick or IP-addresses. At an exit from the Hub of the user who has created personal room, its room leaves automatically.
To create personal room possible by command !personalrooms_add <roomname> <description> in chat. To delete personal room possible by command !personalrooms_delete in chat. Also it is possible to set the password on access to the room by command !personalrooms_password <password> <reminder> in chat or !password <password> <reminder> in PM. The password should be without blanks. It is possible to use command without parametres to remove the password. To expel the user from the personal room it is possible by command !personalrooms_drive <nick> in chat or !drive <nick> in PM. To invite in the nominal room of the user it is possible by command !personalrooms_invite <nick> in chat or !invite <nick> in PM.
To look the entire account about nominal rooms and their structure it is possible by command !personalrooms_details in chat. To make cleaning of nominal rooms, to remove possible "phantom" personal rooms without the owner it is possible by command !personalrooms_clean in chat.
By command !rooms_autoquit <class> The parametre class of users since which users remain in rooms at an exit from the Hub is set, that is there is no autoexit.
By command !rooms_io the mode of sending of messages in rooms about an input/exit of users is set.
Also it is possible to appropriate moderators from users for the general rooms. Thus users who are in the list of moderators of room, have in it the same rights, as well as operators. To add moderator in the list of moderators of current room it is possible by command !moderator+ <nick> in PM. To remove the user from the list of moderators of current room it is possible by command !moderator- <nick> in PM. The list of moderators of current room is accessible by command !moderators in PM.
The base of ignored users is stored in file RoomsBlackList. The base of the concluded rooms is stored in file RoomsPrisoners. The base of rooms is stored in file Rooms.dat. The base of personal rooms is stored in file ImenRooms.dat. The base of exceptions of names is stored in file RoomsExeptNames. The name of bot and point of the main menu is set in language localisation file Text_lang.lua. The text of the hrlp for users and operators is stored in files RoomsUserHelp_lang.txt and RoomsOPHelp_lang.txt in plugin's folder.