• If you need help or want to discuss things, you now can also join us on our Discord Server!
  • A first preview of the unlimited version of SinusBot can be found in the Upcoming Changes thread. A version for Windows will follow, but we don't have a release date, yet.
Required SinusBot Version
Compatible Backends
  1. TeamSpeak 3
This Script will allow you to Lock Clients into a Channel with one Command!
You can choose between Permanently or Temporary Locking them into a Channel!

If the Client tries to leave the Channel or Reconnect then he will be automatically moved back into the Jail Channel.

Auto Jail Recording Clients
Command Permissions via Server Group
Permanent / Temporary Jailing
Disable Jailing of certain Server Groups
Assigning ServerGroup on jailed Clients


!jail add <clienturl|uid> <EMPTY FOR Permanent|<time> <Seconds|Minutes|Hours|Days>>
Jails a Client

!jail release <clienturl/uid>
Unjails a Client Instantly

!jail list
Lists all Clients currently Jailed

Usage Examples:
!jail add [URL=client://0/abcdefghi/jklmnopq123456789a=~Some%20Client]Some Client[/URL]
!jail add abcdefghi/jklmnopq123456789a=
!jail add [URL=client://0/abcdefghi/jklmnopq123456789a=~Some%20Client]Some Client[/URL] 100 Seconds 
!jail add abcdefghi/jklmnopq123456789a= 2 Hours
!jail release abcdefghi/jklmnopq123456789a=
!jail release [URL=client://0/abcdefghi/jklmnopq123456789a=~Some%20Client]Some Client[/URL]

Needed Permissions:

i_channel_subscribe_power (high enough)
i_client_max_channel_subscriptions (best would be -1)
i_client_kick_from_channel_power (high enough)

You can easily Drag and Drop the Client into the Chat to get his Client URL
For the Best Experience set to the Jail Channel or the Servergroup Permission b_client_is_sticky!
For the Time Identification you can Currently use
Second(s) - Minute(s) - Hour(s) - Day(s)
First release
Last update
4.26 star(s) 19 ratings

More resources from Multivitamin

Latest updates

  1. Bugfix

    Bugfix in how time gets calculated from user input
  2. bugfix

    small bugfix release, use command.js version 1.4.4 with this plugin!
  3. Integration for Sinusbot 1.0.0 using command library

    Note: this is a complete rewrite of the already existing script + added the ability to unjail a...

Latest reviews

Works like charm. I love the option that the user can get jailed / unjailed by group. What i would love to see is customizable text for the Jail release kick. Thx much.
Works perfectly ! Thanks !!

Debian GNU/Linux 9.9 (stretch)
Kernel: Linux 4.9.0-9-amd64
ts3client_linux_amd64 (Version 3.3.0)
Sinusbot Version: 1.0.0-beta.5-b262b6a
Use !jhelp for ALL commands:

Jail Bot Usage:

Getting a List of all Jailed Clients:

Jailing a Client PERMANENTLY:
!jail Some Client
!jail abcdefghi/jklmnopq123456789a=
!jail Some

Jailing a Client TEMPORARY
You can jail a client temporary by writing a duration in front of his name

!jail 100 hours abcdefghi/jklmnopq123456789a=

Valid times are: Second(s), Minutes(s), Hours(s), Day(s)!

For unjailing a Client:
!unjail <clienturl|uid|namepart>
I love this script sadly it is not adding the group when they get jailed I have tried what you said before.
what exactly did you try?
does the bot have enough permissions to add the group?
how does your config look like?
Works perfeclty
One of greatest scripts!
Bot in new version there is no way to add groups which are allowed to jail clients. Typing servergroup number, servergroup box shows, I click them and... nothing happens :-)
yes the group box is a bit bad, you need to click at the very beginning of the box add your number and press enter
Great Plugin, Sadly it is missing daylight saving time.
Funtioniert gut, bis auf die move Funktion.
Funktioniert bestimmt super, doch bei mir sagt der Bot immer, dass ich "Not enough Permissions to use this command!" habe, doch als Owner des Servers hab ich aufjedenfall alle...pls. help!
Du musst das Script auch einstellen, das Script an sich weis ja nicht wer der "Owner" des Servers ist
when I add a random server group the script jail the client and in console there is an error 2017/12/22 14:08:49 de0c13e1 68eec1d1 WARN Error in script (event serverGroupAdded): &{value:{name:TypeError message:can't convert from "boolean" to "*map[string]interface {}" trace:[] offset:-1}}