Erweiterte Einstellungen vom TS3MusicBot

Aus Nitradopedia
Wechseln zu: Navigation, Suche
Ts3musicbot ad.png


Die erweiterten Einstellungen vom TS3MusicBot sind im Webinterface im Reiter "Advanced" zu finden. Dieser Menüpunkt steht erst beim aktivierten Query Mode zur Verfügung. Eine Beschreibung zum Aktivieren ist hier zu finden.

Allgemein

Option Beschreibung
Slow Mode Activate the slow mode of the bot, 0 If slow mode is activated, the bot connects slower to the server and disables some bot features to reduce the amount of needed commands. This feature may allow you to use the bot without whitelist the bot IP address. Slow mode disables the bad channel name check, welcome message, client database cache and do not allow the bot check interval to be lower than 3 seconds.
Check interval Check every X seconds, default is 1. Values between 1 and 30 are allowed. If slow mode is activated, 3 is the lowest possible value.
Message encoding A different encoding of the messages config files. Default is UTF-8 which should be good for all EU and US languages. Change this only if you know what you are doing! For english or german language you can also use the encoding ISO-8859-1 A list of all valid ones: http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html
Client DB list Cache This enables the client database list cache. This cache is needed for commands like !lastseen. 1 = Enable, 0 = Disable
Date pattern Change the date pattern, which will be used to format a date in chat functions and welcome message. To get help how to make such a pattern, look here: http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html
Connect forever Should the bot try to connect forever if the Teamspeak server or the bot is offline? 0 = disable, 1 = enable
Last seen Allow !lastseen command for all clients? 1 = Yes, 0 = No

Record

Option Beschreibung
Check enable Choose record check mode, 0 = disable, 1 = kick, 2 = move. This feature will move or kick a recording client (of course only the record function of the Teamspeak client is detected).
Record message Set a record message. On both modes the client should see the message.

If using mode 2, you can use %RECORD_CHANNEL_NAME% in the message, which will be replaced with the channel name (of the record_move_channel_id). Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Move channel ID If mode 2 selected, set channel id to move recording clients into it.
Channel list A comma seperated list (without spaces) of channel ids. Depends on the given mode, this channels can be ignored or only this channels will be checked!
Channel list mode Select one of the two modes for the channel list. ignore = The selected channels will be ignored. only = Only the selected channels will be checked.
Group list A comma seperated list (without spaces) of server group ids. Depends on the given mode, this server groups can be ignored or only this server groups will be checked!
Group list mode Select one of the two modes for the server group list. ignore = The selected server groups will be ignored. only = Only the selected server groups will be checked.
Add complain Add complain entry to the user, 0 = No, 1 = Yes
Message mode Select the message mode, how the client should get the message (useless if kick is enabled). Poke, chat or none are valid values!

Idle

Option Beschreibung
Check enable Enable idle check, 0 = disable, 1 = kick, 2 = move. This feature will move or kick an idle client.
Idle message Idle message, the client get this message as kick reason (mode 1) or chat message (mode 2). You can use the following keywords, which will be replaced: %IDLE_MAX_TIME% - Replaced with max idle time %IDLE_CHANNEL_NAME% - If mode 2 selected, this will be replaced with the channel name of the idle_move_channel_id. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.
Idle second message Idle message, the client get this message as kick reason (mode 1) or chat message (mode 2). You can use the following keywords, which will be replaced: %IDLE_MAX_TIME% - Replaced with max idle time

%IDLE_CHANNEL_NAME% - If mode 2 selected, this will be replaced with the channel name of the idle_move_channel_id. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Idle warn message Idle message, the client get this message as kick reason (mode 1) or chat message (mode 2). You can use the following keywords, which will be replaced: %IDLE_MAX_TIME% - Replaced with max idle time

%IDLE_CHANNEL_NAME% - If mode 2 selected, this will be replaced with the channel name of the idle_move_channel_id. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Move channel ID If mode 2 selected, set channel id to move idle clients into it.
Channel list A comma seperated list (without spaces) of channel ids. Depends on the given mode, this channels can be ignored or only this channels will be checked!
Channel list mode Select one of the two modes for the channel list.
ignore = The selected channels will be ignored.
only = Only the selected channels will be checked.
Group list A comma seperated list (without spaces) of server group ids. Depends on the given mode, this server groups can be ignored or only this server groups will be checked!
Group list mode Select one of the two modes for the server group list. ignore = The selected server groups will be ignored. only = Only the selected server groups will be checked.
Max time Set the max idle time in minutes. If mode 1 selected, the client will be kicked after being idle for this time. If mode 2 selected, the client will be moved to idle_move_channel_id after being idle for this time!
Seconds max time If mode 2 selected, set the max idle time in minutes to kick someone.

Has to be greater than idle_max_time or -1 to disable this feature!

Warn time Set the idle warn time in minutes or set -1 to disable this feature.

The idle warn time has to be smaller than the max idle time.

Min Clients A minimum client count to activate idle check (telnet and TS3 clients counted together). If less clients online, idle check does nothing.
Message mode Select the message mode, how the client should get the message (useless if kick is enabled). poke, chat or none are valid values!
Warn message mode Select the message mode, how the client should get the message.

poke or chat are valid values!

Away

Option Beschreibung
Check enable Enable away mover, 0 = disable, 1 = enable, 2 = enable with move back.

This feature will move the client as soon as away status is set for longer than X seconds, specified below.

Move channel ID Channel id to move away clients into it.
Move delay Idle time in seconds after the client with away status will be moved to the channel. Has between 0 and 1000 seconds!
Channel list A comma seperated list (without spaces) of channel ids. Depends on the given mode, this channels can be ignored or only this channels will be checked!
Channel list mode Select one of the two modes for the channel list.
ignore = The selected channels will be ignored.
only = Only the selected channels will be checked.
Group list A comma seperated list (without spaces) of server group ids. Depends on the given mode, this server groups can be ignored or only this server groups will be checked!
Group list mode Select one of the two modes for the server group list.
ignore = The selected server groups will be ignored.
only = Only the selected server groups will be checked.
Message mode Select the message mode, how the client should get the message.

poke, chat or none are valid values!

Away message Away Mover message, the client get this message as chat message. You can use the following keywords, which will be replaced: %AWAY_CHANNEL_NAME% - This will be replaced with the channel name of the away_move_channel_id. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Advertising

Option Beschreibung
Enable Enable advertising, 0 = disable, 1 = send to virtual server, 2 = send to channel.
Channel ID If mode 2 selected, set channel id to write advertising message into it.
Repeat time Advertise every X minutes.
Advertising messages A semicolon (;) seperated list of advertising messages. The bot write this messages in the order from left to right and start from left again. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Welcome message

Option Beschreibung
Default message enable Enable default welcome message, 0 = disable, 1 = enable. This welcome message, if enabled, will be used for all other groups than specified for welcomemessage_groups. If welcomemessage_enable is disabled, then this will be used for all clients in all groups.
Default message mode Select the message mode, how the client should get the message.

poke or chat are valid values!

Default message Set default welcome message. You can use \n for a new line and typical BBCode like in Teamspeak 3 Client.

You can use the following keywords, which will be replaced: %CLIENT_NICKNAME% - Nickname of the client %CLIENT_VERSION% - Client version %CLIENT_PLATFORM% - Client platform (Windows, Linux, ...) %CLIENT_IP% - Client IP address, bot needs permission b_client_remoteaddress_view for this! %CLIENT_CREATED% - Date and time of the first connection of the client %CLIENT_TOTALCONNECTIONS% - Total connection count of the client %CLIENT_MONTH_BYTES_UPLOADED% - Uploaded data in current month (filetransfer and avatar) %CLIENT_MONTH_BYTES_DOWNLOADED% - Downloaded data in current month (filetransfer and avatar) %CLIENT_TOTAL_BYTES_UPLOADED% - Uploaded data all times (filetransfer and avatar) %CLIENT_TOTAL_BYTES_DOWNLOADED% - Downloaded data all times (filetransfer and avatar) %SERVER_NAME% - Server name %SERVER_PLATFORM% - Server platform (Windows, Linux, ...) %SERVER_VERSION% - Server version %SERVER_CREATED_DATE% - Server created date %SERVER_UPTIME% - Server uptime in days, hours, ... %SERVER_UPTIME_DATE% - Server uptime as date %SERVER_UPLOAD_QUOTA% - Server upload quota %SERVER_DOWNLOAD_QUOTA% - Server download quota %SERVER_MONTH_BYTES_UPLOADED% - Uploaded data in current month (filetransfer and avatar) %SERVER_MONTH_BYTES_DOWNLOADED% - Downloaded data in current month (filetransfer and avatar) %SERVER_TOTAL_BYTES_UPLOADED% - Uploaded data all times (filetransfer and avatar) %SERVER_TOTAL_BYTES_DOWNLOADED% - Downloaded data all times (filetransfer and avatar) %SERVER_MAX_CLIENTS% - Server max clients (slots) %SERVER_RESERVED_SLOTS% - Server reserved slots %SERVER_CHANNEL_COUNT% - Current channel count %SERVER_CLIENT_COUNT% - Current client count %SERVER_CLIENT_CONNECTIONS_COUNT% - Server client connections count Most server informations are not updated instantly, they will be updated every 10 minutes. This welcome message, if enabled, will be used for all other groups than specified for welcomemessage_groups. If welcomemessage_enable is disabled, then this will be used for all clients in all groups.

Group message enable You can set another welcome message for specified server groups, 0 = disable, 1 = enable.
Groups A comma seperated list (without spaces) of server group ids, which should get this welcome message.
Group message mode Select the message mode, how the client should get the message.

poke or chat are valid values!

Groups message Set welcome message. Same keywords like at the default welcome message. You can also use \n for a new line and typical BBCode like in Teamspeak 3 Client. This welcome message will be used for specified server groups you defined at welcomemessage_groups.

Bad nickname

Option Beschreibung
Check enable Enable bad nickname check, 0 = disable, 1 = enable.

This feature will kick every client which match one of the bad nickname rules.

Add complain Add complain entry to the user, 0 = No, 1 = Yes.
Group list A comma seperated list (without spaces) of server group ids.

Depends on the given mode, this server groups can be ignored or only this server groups will be checked!

Group list mod Select one of the two modes for the server group list.

ignore = The selected server groups will be ignored. only = Only the selected server groups will be checked.

Kick message Set kick message for using a bad nickname. You can use \n for a new line and typical BBCode like in Teamspeak 3 Client.
Rules Set bad nickname rules here. Semicolon (;) seperated. Use regular expressions for the rules.

This rules will be used case-insensitive. The following link give you some informations about regular expressions in java: http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html Important: If you are not sure, test your regular expressions on the following page: http://www.rubular.com or http://regexp-evaluator.de/evaluator/ Or the bot may kick all people, if you do something wrong!

Bad channelname

Option Beschreibung
Check enable Enable bad channel name check, 0 = disable, 1 = enable.

This feature will force delete every channel which match one of the bad channel name rules.

Channel list A comma seperated list (without spaces) of channel ids.

This channels will be ignored!

Rules Set bad channel name rules here. Semicolon (;) seperated. Use regular expressions for the rules.

This rules will be used case-insensitive. The following link give you some informations about regular expressions in java: http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html Important: If you are not sure, test your regular expressions on the following page: http://www.rubular.com or http://regexp-evaluator.de/evaluator/ Or the bot may delete all channels, if you do something wrong!

Servergroup protection

Option Beschreibung
Enable Enable server group protection, 0 = disable, 1 = enable.

If enabled, this function will check all server groups from clients on the server, which are currently online. If a client use a protected server group and is not on the list of the bot, it will be removed from the server group.

Groups A comma seperated list (without spaces) of server group ids, which should be protected.
Kick Enable this to kick every client which using a protected server group and are not on the list of the bot, 0 = disable, 1 = enable.
Add complain Add complain entry to the user, 0 = No, 1 = Yes.

This would only add a complaint, if the bot has to remove a server group.

Add missing groups If a client is listed in the servergroupprotection_file and miss a server group, they get added to the server group.

0 = disable, 1 = enable.

Message mode Select the message mode, how the client should get the message (useless if kick is enabled).

poke, chat or none are valid values!

Message Kick or chat message for the server group protection.

You can use the following keywords, which will be replaced: %SERVER_GROUP_ID% - Replaced with the server group id. %SERVER_GROUP_NAME% - Replaced with the server group name. Typical BBCode like in Teamspeak 3 Client possible.

Allowed clients This is the list of allowed clients in the protected server groups.

Semicolon seperated per client starting with the server group id, followed by a comma, and ends with the unique id of the client. If a client is member of two protected groups, make two lines with the same unique id, but different server group id. An example (please remove this example after you understand it):

Mute

Option Beschreibung
Check enable Enable mute mover, 0 = disable, 1 = enable, 2 = enable with move back.

This feature will move the client as soon as the specified mute status is set for longer than X seconds, specified below.

Move headphone Enable move if headphone is muted, 0 = disable, 1 = enable.
Move microphone Enable move if microphone is muted, 0 = disable, 1 = enable.
Move headphone hardware Enable move if headphone hardware is disabled, 0 = disable, 1 = enable.
Move microphone hardware Enable move if microphone hardware is disabled, 0 = disable, 1 = enable.

This also happen if someone is speaking in another TS3 client server tab.

Move channel ID Channel id to move muted clients into it.
Move delay Idle time in seconds after the client with a specified mute status will be moved to the channel.

Has between 0 and 1000 seconds!

Channel list A comma seperated list (without spaces) of channel ids.

Depends on the given mode, this channels can be ignored or only this channels will be checked!

Channel list mode Select one of the two modes for the channel list.

ignore = The selected channels will be ignored. only = Only the selected channels will be checked.

Group list A comma seperated list (without spaces) of server group ids.

Depends on the given mode, this server groups can be ignored or only this server groups will be checked!

Group list mode Select one of the two modes for the server group list.

ignore = The selected server groups will be ignored. only = Only the selected server groups will be checked.

Message mode Select the message mode, how the client should get the message.

poke, chat or none are valid values!

Message Mute Mover message, the client get this message as chat message.

You can use the following keywords, which will be replaced: %MUTE_CHANNEL_NAME% - This will be replaced with the channel name of the mute_move_channel_id. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Servergroupnotify

Option Beschreibung
Enable Enable server group notify, 0 = disable, 1 = enable.

If enabled, this function will notify specified server groups about joining clients in a specified server group.

Message mode Select the message mode, how the clients should get the message.

poke or chat are valid values!

Groups A comma seperated list (without spaces) of server group ids, which should be watched on joining.
Group targets A comma seperated list (without spaces) of server group ids, which should be notified about joining clients.
Channel list A comma seperated list (without spaces) of channel ids.

Depends on the given mode, target clients in this channels can be ignored or only clients in this channels receive the notify message!

Channel list mode Select one of the two modes for the channel list.

ignore = Clients in the selected channels will be ignored. only = Only clients in the selected channels receive the notify message.

Message Server Group Notify message, specified clients get this message as chat or poke message.

You can use the following keywords, which will be replaced: %SERVER_GROUP_ID% - Server Group ID. %SERVER_GROUP_NAME% - Server Group Name. %CLIENT_NAME% - Client Name. %CLIENT_DBID% - Client Database ID. %CLIENT_UNIQUEID% - Client Unique ID. Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Automove

Option Beschreibung
Enable Enable auto move, 0 = disable, 1 = enable.

If enabled, this function will move connecting clients of a specified server group to a specified channel. This function ignores clients with an own default channel set.

Message mode Select the message mode, how the clients should get the message.

poke, chat or none are valid values!

Message Chat message for the auto move function.

Typical BBCode like in Teamspeak 3 Client possible. You can use \n for a new line.

Server groups This is the list of server groups. Semicolon (;) seperated, which will be moved to a specified channel.

Starting with the server group id, followed by a comma, and ends with the channel id. An example: 1,340;2,120