TS3ApiAsync (TeamSpeak 3 Java API 1.3.1 API)

java.lang.Object
- com.github.theholywaffle.teamspeak3.TS3ApiAsync

```
public class TS3ApiAsync
extends Object
```
Asynchronous version of TS3Api to interact with the TS3Query.
This class is used to easily interact with a TS3Query. It constructs commands, sends them to the TeamSpeak3 server, processes the response and returns the result.
All methods in this class are asynchronous (so they won't block) and will return a CommandFuture of the corresponding return type in TS3Api. If a command fails, no exception will be thrown directly. It will however be rethrown in CommandFuture.get() and CommandFuture.get(long, TimeUnit). Usually, the thrown exception is a TS3CommandFailedException, which will get you access to the QueryError from which more information about the error can be obtained.
Also note that while these methods are asynchronous, the commands will still be sent through a synchronous command pipeline. That means if an asynchronous method is called immediately followed by a synchronous method, the synchronous method will first have to wait until the asynchronous method completed until it its command is sent.
You won't be able to execute most commands while you're not logged in due to missing permissions. Make sure to either pass your login credentials to the TS3Config object when creating the TS3Query or to call login(String, String) to log in.
After that, most commands also require you to select a virtual server. To do so, call either selectVirtualServerByPort(int) or selectVirtualServerById(int).

See Also:

The synchronous version of the API

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`CommandFuture<Integer>`	`addBan(String ip, String name, String uid, long timeInSeconds, String reason)` Adds a new ban entry.
`CommandFuture<Integer>`	`addBan(String ip, String name, String uid, String myTSId, long timeInSeconds, String reason)` Adds a new ban entry.
`CommandFuture<Void>`	`addChannelClientPermission(int channelId, int clientDBId, String permName, int permValue)` Adds a specified permission to a client in a specific channel.
`CommandFuture<Integer>`	`addChannelGroup(String name)` Creates a new channel group for clients using a given name and returns its ID.
`CommandFuture<Integer>`	`addChannelGroup(String name, PermissionGroupDatabaseType type)` Creates a new channel group using a given name and returns its ID.
`CommandFuture<Void>`	`addChannelGroupPermission(int groupId, String permName, int permValue)` Adds a specified permission to a channel group.
`CommandFuture<Void>`	`addChannelPermission(int channelId, String permName, int permValue)` Adds a specified permission to a channel.
`CommandFuture<Void>`	`addClientPermission(int clientDBId, BPermissionType permName, boolean value, boolean skipped)` Adds a specified permission to a client.
`CommandFuture<Void>`	`addClientPermission(int clientDBId, IPermissionType permName, int value, boolean skipped)` Adds a specified permission to a client.
`CommandFuture<Void>`	`addClientPermission(int clientDBId, String permName, int value, boolean skipped)` Deprecated. This method is no longer preferred for adding permissions to a client. Use `addClientPermission(int, IPermissionType, int, boolean)` or `addClientPermission(int, BPermissionType, boolean, boolean)` instead.
`CommandFuture<Void>`	`addClientToServerGroup(int groupId, int clientDatabaseId)` Adds a client to the specified server group.
`CommandFuture<Void>`	`addComplaint(int clientDBId, String message)` Submits a complaint about the specified client.
`CommandFuture<Void>`	`addPermissionToAllServerGroups(ServerGroupType type, String permName, int value, boolean negated, boolean skipped)` Adds a specified permission to all server groups of the type specified by `type` on all virtual servers.
`CommandFuture<String>`	`addPrivilegeKey(PrivilegeKeyType type, int groupId, int channelId, String description)` Create a new privilege key that allows one client to join a server or channel group.
`CommandFuture<String>`	`addPrivilegeKeyChannelGroup(int channelGroupId, int channelId, String description)` Creates a new privilege key for a channel group.
`CommandFuture<String>`	`addPrivilegeKeyServerGroup(int serverGroupId, String description)` Creates a new privilege key for a server group.
`CommandFuture<Integer>`	`addServerGroup(String name)` Creates a new server group for clients using a given name and returns its ID.
`CommandFuture<Integer>`	`addServerGroup(String name, PermissionGroupDatabaseType type)` Creates a new server group using a given name and returns its ID.
`CommandFuture<Void>`	`addServerGroupPermission(int groupId, String permName, int value, boolean negated, boolean skipped)` Adds a specified permission to a server group.
`CommandFuture<CreatedQueryLogin>`	`addServerQueryLogin(String loginName, int clientDBId)` Creates a server query login with name `loginName` for the client specified by `clientDBId` on the currently selected virtual server and returns the password of the created login.
`void`	`addTS3Listeners(TS3Listener... listeners)` Adds one or more `TS3Listener`s to the event manager of the query.
`CommandFuture<int[]>`	`banClient(int clientId, long timeInSeconds)` Bans a client with a given client ID for a given time.
`CommandFuture<int[]>`	`banClient(int clientId, long timeInSeconds, String reason)` Bans a client with a given client ID for a given time for the specified reason.
`CommandFuture<int[]>`	`banClient(int clientId, String reason)` Bans a client with a given client ID permanently for the specified reason.
`CommandFuture<int[]>`	`banClients(int[] clientIds, long timeInSeconds, String reason, boolean continueOnError)` Bans multiple clients by their client ID for a given time for the specified reason.
`CommandFuture<Void>`	`broadcast(String message)` Sends a text message to all clients on all virtual servers.
`CommandFuture<Void>`	`copyChannelGroup(int sourceGroupId, int targetGroupId, PermissionGroupDatabaseType type)` Creates a copy of the channel group specified by `sourceGroupId`, overwriting any other channel group specified by `targetGroupId`.
`CommandFuture<Integer>`	`copyChannelGroup(int sourceGroupId, String targetName, PermissionGroupDatabaseType type)` Creates a copy of the channel group specified by `sourceGroupId` with a given name and returns the ID of the newly created channel group.
`CommandFuture<Integer>`	`copyServerGroup(int sourceGroupId, int targetGroupId, PermissionGroupDatabaseType type)` Creates a copy of the server group specified by `sourceGroupId`, overwriting another server group specified by `targetGroupId`.
`CommandFuture<Integer>`	`copyServerGroup(int sourceGroupId, String targetName, PermissionGroupDatabaseType type)` Creates a copy of the server group specified by `sourceGroupId` with a given name and returns the ID of the newly created server group.
`CommandFuture<Integer>`	`createChannel(String name, Map<ChannelProperty,String> options)` Creates a new channel with a given name using the given properties and returns its ID.
`CommandFuture<Void>`	`createFileDirectory(String directoryPath, int channelId)` Creates a new directory on the file repository in the specified channel.
`CommandFuture<Void>`	`createFileDirectory(String directoryPath, int channelId, String channelPassword)` Creates a new directory on the file repository in the specified channel.
`CommandFuture<CreatedVirtualServer>`	`createServer(String name, Map<VirtualServerProperty,String> options)` Creates a new virtual server with the given name and returns an object containing the ID of the newly created virtual server, the default server admin token and the virtual server's voice port.
`CommandFuture<Snapshot>`	`createServerSnapshot()` Creates a `Snapshot` of the selected virtual server containing all settings, groups and known client identities.
`CommandFuture<Void>`	`deleteAllBans()` Deletes all active ban rules from the server.
`CommandFuture<Void>`	`deleteAllComplaints(int clientDBId)` Deletes all complaints about the client with specified database ID from the server.
`CommandFuture<Void>`	`deleteBan(int banId)` Deletes the ban rule with the specified ID from the server.
`CommandFuture<Void>`	`deleteChannel(int channelId)` Deletes an existing channel specified by its ID, kicking all clients out of the channel.
`CommandFuture<Void>`	`deleteChannel(int channelId, boolean force)` Deletes an existing channel with a given ID.
`CommandFuture<Void>`	`deleteChannelClientPermission(int channelId, int clientDBId, String permName)` Removes a specified permission from a client in a specific channel.
`CommandFuture<Void>`	`deleteChannelGroup(int groupId)` Removes the channel group with the given ID.
`CommandFuture<Void>`	`deleteChannelGroup(int groupId, boolean force)` Removes the channel group with the given ID.
`CommandFuture<Void>`	`deleteChannelGroupPermission(int groupId, String permName)` Removes a permission from the channel group with the given ID.
`CommandFuture<Void>`	`deleteChannelPermission(int channelId, String permName)` Removes a permission from the channel with the given ID.
`CommandFuture<Void>`	`deleteClientPermission(int clientDBId, BPermissionType permName)` Removes a permission from a client.
`CommandFuture<Void>`	`deleteClientPermission(int clientDBId, IPermissionType permName)` Removes a permission from a client.
`CommandFuture<Void>`	`deleteClientPermission(int clientDBId, String permName)` Deprecated. This method is no longer preferred for removing permissions from a client. Use `deleteClientPermission(int, IPermissionType)` or `deleteClientPermission(int, BPermissionType)` instead.
`CommandFuture<Void>`	`deleteComplaint(int targetClientDBId, int fromClientDBId)` Deletes the complaint about the client with database ID `targetClientDBId` submitted by the client with database ID `fromClientDBId` from the server.
`CommandFuture<Void>`	`deleteCustomClientProperty(int clientDBId, String key)` Removes the `key` custom client property from a client.
`CommandFuture<Void>`	`deleteDatabaseClientProperties(int clientDBId)` Removes all stored database information about the specified client.
`CommandFuture<Void>`	`deleteFile(String filePath, int channelId)` Deletes a file or directory from the file repository in the specified channel.
`CommandFuture<Void>`	`deleteFile(String filePath, int channelId, String channelPassword)` Deletes a file or directory from the file repository in the specified channel.
`CommandFuture<Void>`	`deleteFiles(String[] filePaths, int channelId)` Deletes multiple files or directories from the file repository in the specified channel.
`CommandFuture<Void>`	`deleteFiles(String[] filePaths, int channelId, String channelPassword)` Deletes multiple files or directories from the file repository in the specified channel.
`CommandFuture<Void>`	`deleteIcon(long iconId)` Deletes an icon from the icon directory in the file repository.
`CommandFuture<Void>`	`deleteIcons(long... iconIds)` Deletes multiple icons from the icon directory in the file repository.
`CommandFuture<Void>`	`deleteOfflineMessage(int messageId)` Deletes the offline message with the specified ID.
`CommandFuture<Void>`	`deletePermissionFromAllServerGroups(ServerGroupType type, String permName)` Removes a specified permission from all server groups of the type specified by `type` on all virtual servers.
`CommandFuture<Void>`	`deletePrivilegeKey(String token)` Deletes the privilege key with the given token.
`CommandFuture<Void>`	`deleteServer(int serverId)` Deletes the virtual server with the specified ID.
`CommandFuture<Void>`	`deleteServerGroup(int groupId)` Deletes the server group with the specified ID, even if the server group still contains clients.
`CommandFuture<Void>`	`deleteServerGroup(int groupId, boolean force)` Deletes a server group with the specified ID.
`CommandFuture<Void>`	`deleteServerGroupPermission(int groupId, String permName)` Removes a permission from the server group with the given ID.
`CommandFuture<Void>`	`deleteServerQueryLogin(int clientDBId)` Deletes the server query login with the specified client database ID.
`CommandFuture<Void>`	`deployServerSnapshot(Snapshot snapshot)` Restores the selected virtual servers configuration using the data from a previously created server snapshot.
`CommandFuture<Void>`	`deployServerSnapshot(String snapshot)` Restores the configuration of the selected virtual server using the data from a previously created server snapshot.
`CommandFuture<Long>`	`downloadFile(OutputStream dataOut, String filePath, int channelId)` Downloads a file from the file repository at a given path and channel and writes the file's bytes to an open `OutputStream`.
`CommandFuture<Long>`	`downloadFile(OutputStream dataOut, String filePath, int channelId, String channelPassword)` Downloads a file from the file repository at a given path and channel and writes the file's bytes to an open `OutputStream`.
`CommandFuture<byte[]>`	`downloadFileDirect(String filePath, int channelId)` Downloads a file from the file repository at a given path and channel and returns the file's bytes as a byte array.
`CommandFuture<byte[]>`	`downloadFileDirect(String filePath, int channelId, String channelPassword)` Downloads a file from the file repository at a given path and channel and returns the file's bytes as a byte array.
`CommandFuture<Long>`	`downloadIcon(OutputStream dataOut, long iconId)` Downloads an icon from the icon directory in the file repository and writes the file's bytes to an open `OutputStream`.
`CommandFuture<byte[]>`	`downloadIconDirect(long iconId)` Downloads an icon from the icon directory in the file repository and returns the file's bytes as a byte array.
`CommandFuture<Void>`	`editChannel(int channelId, ChannelProperty property, String value)` Changes a single property of the given channel.
`CommandFuture<Void>`	`editChannel(int channelId, Map<ChannelProperty,String> options)` Changes a channel's configuration using the given properties.
`CommandFuture<Void>`	`editClient(int clientId, ClientProperty property, String value)` Changes a single property of the given client.
`CommandFuture<Void>`	`editClient(int clientId, Map<ClientProperty,String> options)` Changes a client's configuration using given properties.
`CommandFuture<Void>`	`editDatabaseClient(int clientDBId, Map<ClientProperty,String> options)` Changes a client's database settings using given properties.
`CommandFuture<Void>`	`editInstance(ServerInstanceProperty property, String value)` Changes the server instance configuration using given properties.
`CommandFuture<Void>`	`editServer(Map<VirtualServerProperty,String> options)` Changes the configuration of the selected virtual server using given properties.
`CommandFuture<List<Ban>>`	`getBans()` Gets a list of all bans on the selected virtual server.
`CommandFuture<List<Binding>>`	`getBindings()` Gets a list of IP addresses used by the server instance.
`CommandFuture<Channel>`	`getChannelByNameExact(String name, boolean ignoreCase)` Finds and returns the channel matching the given name exactly.
`CommandFuture<List<Permission>>`	`getChannelClientPermissions(int channelId, int clientDBId)` Displays a list of permissions defined for a client in a specific channel.
`CommandFuture<List<ChannelGroupClient>>`	`getChannelGroupClients(int channelId, int clientDBId, int groupId)` Gets all client / channel ID combinations currently assigned to channel groups.
`CommandFuture<List<ChannelGroupClient>>`	`getChannelGroupClientsByChannelGroupId(int groupId)` Gets all client / channel ID combinations currently assigned to the specified channel group.
`CommandFuture<List<ChannelGroupClient>>`	`getChannelGroupClientsByChannelId(int channelId)` Gets all channel group assignments in the specified channel.
`CommandFuture<List<ChannelGroupClient>>`	`getChannelGroupClientsByClientDBId(int clientDBId)` Gets all channel group assignments for the specified client.
`CommandFuture<List<Permission>>`	`getChannelGroupPermissions(int groupId)` Gets a list of all permissions assigned to the specified channel group.
`CommandFuture<List<ChannelGroup>>`	`getChannelGroups()` Gets a list of all channel groups on the selected virtual server.
`CommandFuture<ChannelInfo>`	`getChannelInfo(int channelId)` Gets detailed configuration information about the channel specified channel.
`CommandFuture<List<Permission>>`	`getChannelPermissions(int channelId)` Gets a list of all permissions assigned to the specified channel.
`CommandFuture<List<Channel>>`	`getChannels()` Gets a list of all channels on the selected virtual server.
`CommandFuture<List<Channel>>`	`getChannelsByName(String name)` Gets a list of channels whose names contain the given search string.
`CommandFuture<Client>`	`getClientByNameExact(String name, boolean ignoreCase)` Finds and returns the client whose nickname matches the given name exactly.
`CommandFuture<ClientInfo>`	`getClientByUId(String clientUId)` Gets information about the client with the specified unique identifier.
`CommandFuture<ClientInfo>`	`getClientInfo(int clientId)` Gets information about the client with the specified client ID.
`CommandFuture<List<Permission>>`	`getClientPermissions(int clientDBId)` Gets a list of all permissions assigned to the specified client.
`CommandFuture<List<Client>>`	`getClients()` Gets a list of all clients on the selected virtual server.
`CommandFuture<List<Client>>`	`getClientsByName(String name)` Gets a list of clients whose nicknames contain the given search string.
`CommandFuture<List<Complaint>>`	`getComplaints()` Gets a list of all complaints on the selected virtual server.
`CommandFuture<List<Complaint>>`	`getComplaints(int clientDBId)` Gets a list of all complaints about the specified client.
`CommandFuture<ConnectionInfo>`	`getConnectionInfo()` Gets detailed connection information about the selected virtual server.
`CommandFuture<Map<String,String>>`	`getCustomClientProperties(int clientDBId)` Gets a map of all custom client properties and their values assigned to the client with database ID `clientDBId`.
`CommandFuture<DatabaseClientInfo>`	`getDatabaseClientByUId(String clientUId)` Gets information about the client with the specified unique identifier in the server database.
`CommandFuture<DatabaseClientInfo>`	`getDatabaseClientInfo(int clientDBId)` Gets information about the client with the specified database ID in the server database.
`CommandFuture<List<DatabaseClient>>`	`getDatabaseClients()` Gets information about all clients in the server database.
`CommandFuture<List<DatabaseClient>>`	`getDatabaseClients(int offset, int count)` Gets information about a set number of clients in the server database, starting at `offset`.
`CommandFuture<List<DatabaseClientInfo>>`	`getDatabaseClientsByName(String name)` Gets all clients in the database whose last nickname matches the specified name exactly.
`CommandFuture<FileInfo>`	`getFileInfo(String filePath, int channelId)` Gets information about a file on the file repository in the specified channel.
`CommandFuture<FileInfo>`	`getFileInfo(String filePath, int channelId, String channelPassword)` Gets information about a file on the file repository in the specified channel.
`CommandFuture<List<FileInfo>>`	`getFileInfos(String[] filePaths, int channelId)` Gets information about multiple files on the file repository in the specified channel.
`CommandFuture<List<FileInfo>>`	`getFileInfos(String[] filePaths, int[] channelIds, String[] channelPasswords)` Gets information about multiple files on the file repository in multiple channels.
`CommandFuture<List<FileInfo>>`	`getFileInfos(String[] filePaths, int channelId, String channelPassword)` Gets information about multiple files on the file repository in the specified channel.
`CommandFuture<List<FileListEntry>>`	`getFileList(String directoryPath, int channelId)` Gets a list of files and directories in the specified parent directory and channel.
`CommandFuture<List<FileListEntry>>`	`getFileList(String directoryPath, int channelId, String channelPassword)` Gets a list of files and directories in the specified parent directory and channel.
`CommandFuture<List<FileTransfer>>`	`getFileTransfers()` Gets a list of active or recently active file transfers.
`CommandFuture<HostInfo>`	`getHostInfo()` Displays detailed configuration information about the server instance including uptime, number of virtual servers online, traffic information, etc.
`CommandFuture<List<IconFile>>`	`getIconList()` Gets a list of all icon files on this virtual server.
`CommandFuture<InstanceInfo>`	`getInstanceInfo()` Displays the server instance configuration including database revision number, the file transfer port, default group IDs, etc.
`CommandFuture<List<String>>`	`getInstanceLogEntries()` Fetches the last 100 log entries from the server log.
`CommandFuture<List<String>>`	`getInstanceLogEntries(int lines)` Fetches the specified amount of log entries from the server log.
`CommandFuture<String>`	`getOfflineMessage(int messageId)` Reads the message body of a message.
`CommandFuture<String>`	`getOfflineMessage(Message message)` Reads the message body of a message.
`CommandFuture<List<Message>>`	`getOfflineMessages()` Gets a list of all offline messages for the server query.
`CommandFuture<List<PermissionAssignment>>`	`getPermissionAssignments(String permName)` Displays detailed information about all assignments of the permission specified with `permName`.
`CommandFuture<Integer>`	`getPermissionIdByName(String permName)` Gets the ID of the permission specified by `permName`.
`CommandFuture<int[]>`	`getPermissionIdsByName(String... permNames)` Gets the IDs of the permissions specified by `permNames`.
`CommandFuture<List<PermissionAssignment>>`	`getPermissionOverview(int channelId, int clientDBId)` Gets a list of all assigned permissions for a client in a specified channel.
`CommandFuture<List<PermissionInfo>>`	`getPermissions()` Displays a list of all permissions, including ID, name and description.
`CommandFuture<Integer>`	`getPermissionValue(String permName)` Displays the current value of the specified permission for this server query instance.
`CommandFuture<int[]>`	`getPermissionValues(String... permNames)` Displays the current values of the specified permissions for this server query instance.
`CommandFuture<List<PrivilegeKey>>`	`getPrivilegeKeys()` Gets a list of all available tokens to join channel or server groups, including their type and group IDs.
`CommandFuture<List<ServerGroupClient>>`	`getServerGroupClients(int serverGroupId)` Gets a list of all clients in the specified server group.
`CommandFuture<List<ServerGroupClient>>`	`getServerGroupClients(ServerGroup serverGroup)` Gets a list of all clients in the specified server group.
`CommandFuture<List<Permission>>`	`getServerGroupPermissions(int serverGroupId)` Gets a list of all permissions assigned to the specified server group.
`CommandFuture<List<Permission>>`	`getServerGroupPermissions(ServerGroup serverGroup)` Gets a list of all permissions assigned to the specified server group.
`CommandFuture<List<ServerGroup>>`	`getServerGroups()` Gets a list of all server groups on the virtual server.
`CommandFuture<List<ServerGroup>>`	`getServerGroupsByClient(Client client)` Gets a list of all server groups set for a client.
`CommandFuture<List<ServerGroup>>`	`getServerGroupsByClientId(int clientDatabaseId)` Gets a list of all server groups set for a client.
`CommandFuture<Integer>`	`getServerIdByPort(int port)` Gets the ID of a virtual server by its port.
`CommandFuture<VirtualServerInfo>`	`getServerInfo()` Gets detailed information about the virtual server the server query is currently in.
`CommandFuture<List<QueryLogin>>`	`getServerQueryLogins()` Gets a list of all server query logins (containing login name, virtual server ID, and client database ID).
`CommandFuture<List<QueryLogin>>`	`getServerQueryLoginsByName(String pattern)` Gets a list of all server query logins (containing login name, virtual server ID, and client database ID) whose login name matches the specified SQL-like pattern.
`CommandFuture<Version>`	`getVersion()` Gets the version, build number and platform of the TeamSpeak3 server.
`CommandFuture<List<String>>`	`getVirtualServerLogEntries()` Fetches the last 100 log entries from the currently selected virtual server.
`CommandFuture<List<String>>`	`getVirtualServerLogEntries(int lines)` Fetches the specified amount of log entries from the currently selected virtual server.
`CommandFuture<List<VirtualServer>>`	`getVirtualServers()` Gets a list of all virtual servers including their ID, status, number of clients online, etc.
`CommandFuture<Boolean>`	`isClientOnline(int clientId)` Checks whether the client with the specified client ID is online.
`CommandFuture<Boolean>`	`isClientOnline(String clientUId)` Checks whether the client with the specified unique identifier is online.
`CommandFuture<Void>`	`kickClientFromChannel(Client... clients)` Kicks one or more clients from their current channels.
`CommandFuture<Void>`	`kickClientFromChannel(int... clientIds)` Kicks one or more clients from their current channels.
`CommandFuture<Void>`	`kickClientFromChannel(String message, Client... clients)` Kicks one or more clients from their current channels for the specified reason.
`CommandFuture<Void>`	`kickClientFromChannel(String message, int... clientIds)` Kicks one or more clients from their current channels for the specified reason.
`CommandFuture<Void>`	`kickClientFromServer(Client... clients)` Kicks one or more clients from the server.
`CommandFuture<Void>`	`kickClientFromServer(int... clientIds)` Kicks one or more clients from the server.
`CommandFuture<Void>`	`kickClientFromServer(String message, Client... clients)` Kicks one or more clients from the server for the specified reason.
`CommandFuture<Void>`	`kickClientFromServer(String message, int... clientIds)` Kicks one or more clients from the server for the specified reason.
`CommandFuture<Void>`	`login(String username, String password)` Logs the server query in using the specified username and password.
`CommandFuture<Void>`	`logout()` Logs the server query out and deselects the current virtual server.
`CommandFuture<Void>`	`moveChannel(int channelId, int channelTargetId)` Moves a channel to a new parent channel specified by its ID.
`CommandFuture<Void>`	`moveChannel(int channelId, int channelTargetId, int order)` Moves a channel to a new parent channel specified by its ID.
`CommandFuture<Void>`	`moveClient(Client client, ChannelBase channel)` Moves a single client into a channel.
`CommandFuture<Void>`	`moveClient(Client client, ChannelBase channel, String channelPassword)` Moves a single client into a channel using the specified password.
`CommandFuture<Void>`	`moveClient(int clientId, int channelId)` Moves a single client into a channel.
`CommandFuture<Void>`	`moveClient(int clientId, int channelId, String channelPassword)` Moves a single client into a channel using the specified password.
`CommandFuture<Void>`	`moveClients(Client[] clients, ChannelBase channel)` Moves multiple clients into a channel.
`CommandFuture<Void>`	`moveClients(Client[] clients, ChannelBase channel, String channelPassword)` Moves multiple clients into a channel using the specified password.
`CommandFuture<Void>`	`moveClients(int[] clientIds, int channelId)` Moves multiple clients into a channel.
`CommandFuture<Void>`	`moveClients(int[] clientIds, int channelId, String channelPassword)` Moves multiple clients into a channel using the specified password.
`CommandFuture<Void>`	`moveFile(String oldPath, String newPath, int channelId)` Moves and renames a file on the file repository within the same channel.
`CommandFuture<Void>`	`moveFile(String oldPath, String newPath, int oldChannelId, int newChannelId)` Renames a file on the file repository and moves it to a new path in a different channel.
`CommandFuture<Void>`	`moveFile(String oldPath, String newPath, int channelId, String channelPassword)` Moves and renames a file on the file repository within the same channel.
`CommandFuture<Void>`	`moveFile(String oldPath, String newPath, int oldChannelId, String oldPassword, int newChannelId, String newPassword)` Renames a file on the file repository and moves it to a new path in a different channel.
`CommandFuture<Void>`	`moveQuery(ChannelBase channel)` Moves the server query into a channel.
`CommandFuture<Void>`	`moveQuery(ChannelBase channel, String channelPassword)` Moves the server query into a channel using the specified password.
`CommandFuture<Void>`	`moveQuery(int channelId)` Moves the server query into a channel.
`CommandFuture<Void>`	`moveQuery(int channelId, String channelPassword)` Moves the server query into a channel using the specified password.
`CommandFuture<Void>`	`pokeClient(int clientId, String message)` Pokes the client with the specified client ID.
`CommandFuture<Void>`	`registerAllEvents()` Registers the server query to receive notifications about all server events.
`CommandFuture<Void>`	`registerEvent(TS3EventType eventType)` Registers the server query to receive notifications about a given event type.
`CommandFuture<Void>`	`registerEvent(TS3EventType eventType, int channelId)` Registers the server query to receive notifications about a given event type.
`CommandFuture<Void>`	`registerEvents(TS3EventType... eventTypes)` Registers the server query to receive notifications about multiple given event types.
`CommandFuture<Void>`	`removeClientFromServerGroup(int serverGroupId, int clientDatabaseId)` Removes the client specified by its database ID from the specified server group.
`CommandFuture<Void>`	`removeClientFromServerGroup(ServerGroup serverGroup, Client client)` Removes the specified client from the specified server group.
`void`	`removeTS3Listeners(TS3Listener... listeners)` Removes one or more `TS3Listener`s to the event manager of the query.
`CommandFuture<Void>`	`renameChannelGroup(ChannelGroup channelGroup, String name)` Renames the specified channel group.
`CommandFuture<Void>`	`renameChannelGroup(int channelGroupId, String name)` Renames the channel group with the specified ID.
`CommandFuture<Void>`	`renameServerGroup(int serverGroupId, String name)` Renames the server group with the specified ID.
`CommandFuture<Void>`	`renameServerGroup(ServerGroup serverGroup, String name)` Renames the specified server group.
`CommandFuture<String>`	`resetPermissions()` Resets all permissions and deletes all server / channel groups.
`CommandFuture<List<CustomPropertyAssignment>>`	`searchCustomClientProperty(String key)` Finds all clients that have any value associated with the `key` custom client property, and returns the client's database ID and the key and value of the matching custom property.
`CommandFuture<List<CustomPropertyAssignment>>`	`searchCustomClientProperty(String key, String valuePattern)` Finds all clients whose value associated with the `key` custom client property matches the SQL-like pattern `valuePattern`, and returns the client's database ID and the key and value of the matching custom property.
`CommandFuture<Void>`	`selectVirtualServer(VirtualServer server)` Moves the server query into the specified virtual server.
`CommandFuture<Void>`	`selectVirtualServer(VirtualServer server, String nickname)` Moves the server query into the specified virtual server and sets the server query's nickname.
`CommandFuture<Void>`	`selectVirtualServerById(int id)` Moves the server query into the virtual server with the specified ID.
`CommandFuture<Void>`	`selectVirtualServerById(int id, String nickname)` Moves the server query into the virtual server with the specified ID and sets the server query's nickname.
`CommandFuture<Void>`	`selectVirtualServerByPort(int port)` Moves the server query into the virtual server with the specified voice port.
`CommandFuture<Void>`	`selectVirtualServerByPort(int port, String nickname)` Moves the server query into the virtual server with the specified voice port and sets the server query's nickname.
`CommandFuture<Void>`	`sendChannelMessage(int channelId, String message)` Sends a text message to the channel with the specified ID.
`CommandFuture<Void>`	`sendChannelMessage(String message)` Sends a text message to the channel the server query is currently in.
`CommandFuture<Void>`	`sendOfflineMessage(String clientUId, String subject, String message)` Sends an offline message to the client with the given unique identifier.
`CommandFuture<Void>`	`sendPrivateMessage(int clientId, String message)` Sends a private message to the client with the specified client ID.
`CommandFuture<Void>`	`sendServerMessage(int serverId, String message)` Sends a text message to the virtual server with the specified ID.
`CommandFuture<Void>`	`sendServerMessage(String message)` Sends a text message to the virtual server the server query is currently in.
`CommandFuture<Void>`	`sendTextMessage(TextMessageTargetMode targetMode, int targetId, String message)` Sends a text message either to the whole virtual server, a channel or specific client.
`CommandFuture<Void>`	`setClientChannelGroup(int groupId, int channelId, int clientDBId)` Sets a channel group for a client in a specific channel.
`CommandFuture<Void>`	`setCustomClientProperties(int clientDBId, Map<String,String> properties)` Sets the value of the multiple custom client properties for a client.
`CommandFuture<Void>`	`setCustomClientProperty(int clientDBId, String key, String value)` Sets the value of the `key` custom client property for a client.
`CommandFuture<Void>`	`setMessageRead(int messageId)` Sets the read flag to `true` for a given message.
`CommandFuture<Void>`	`setMessageRead(Message message)` Sets the read flag to `true` for a given message.
`CommandFuture<Void>`	`setMessageReadFlag(int messageId, boolean read)` Sets the read flag for a given message.
`CommandFuture<Void>`	`setMessageReadFlag(Message message, boolean read)` Sets the read flag for a given message.
`CommandFuture<Void>`	`setNickname(String nickname)` Sets the nickname of the server query client.
`CommandFuture<Void>`	`startServer(int serverId)` Starts the virtual server with the specified ID.
`CommandFuture<Void>`	`startServer(VirtualServer virtualServer)` Starts the specified virtual server.
`CommandFuture<Void>`	`stopServer(int serverId)` Stops the virtual server with the specified ID.
`CommandFuture<Void>`	`stopServer(int serverId, String reason)` Stops the virtual server with the specified ID.
`CommandFuture<Void>`	`stopServer(VirtualServer virtualServer)` Stops the specified virtual server.
`CommandFuture<Void>`	`stopServer(VirtualServer virtualServer, String reason)` Stops the specified virtual server.
`CommandFuture<Void>`	`stopServerProcess()` Stops the entire TeamSpeak 3 Server instance by shutting down the process.
`CommandFuture<Void>`	`stopServerProcess(String reason)` Stops the entire TeamSpeak 3 Server instance by shutting down the process.
`CommandFuture<Void>`	`unregisterAllEvents()` Unregisters the server query from receiving any event notifications.
`CommandFuture<Void>`	`updateClient(ClientProperty property, String value)` Changes a single client property for this server query instance.
`CommandFuture<Void>`	`updateClient(Map<ClientProperty,String> options)` Updates several client properties for this server query instance.
`CommandFuture<String>`	`updateServerQueryLogin(String loginName)` Generates new login credentials for the currently connected server query instance, using the given name.
`CommandFuture<Void>`	`uploadFile(InputStream dataIn, long dataLength, String filePath, boolean overwrite, int channelId)` Uploads a file to the file repository at a given path and channel by reading `dataLength` bytes from an open `InputStream`.
`CommandFuture<Void>`	`uploadFile(InputStream dataIn, long dataLength, String filePath, boolean overwrite, int channelId, String channelPassword)` Uploads a file to the file repository at a given path and channel by reading `dataLength` bytes from an open `InputStream`.
`CommandFuture<Void>`	`uploadFileDirect(byte[] data, String filePath, boolean overwrite, int channelId)` Uploads a file that is already stored in memory to the file repository at a given path and channel.
`CommandFuture<Void>`	`uploadFileDirect(byte[] data, String filePath, boolean overwrite, int channelId, String channelPassword)` Uploads a file that is already stored in memory to the file repository at a given path and channel.
`CommandFuture<Long>`	`uploadIcon(InputStream dataIn, long dataLength)` Uploads an icon to the icon directory in the file repository by reading `dataLength` bytes from an open `InputStream`.
`CommandFuture<Long>`	`uploadIconDirect(byte[] data)` Uploads an icon that is already stored in memory to the icon directory in the file repository.
`CommandFuture<Void>`	`usePrivilegeKey(PrivilegeKey privilegeKey)` Uses an existing privilege key to join a server or channel group.
`CommandFuture<Void>`	`usePrivilegeKey(String token)` Uses an existing privilege key to join a server or channel group.
`CommandFuture<ServerQueryInfo>`	`whoAmI()` Gets information about the current server query instance.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - addBan
```
public CommandFuture<Integer> addBan(String ip,
                                     String name,
                                     String uid,
                                     long timeInSeconds,
                                     String reason)
```
    Adds a new ban entry. At least one of the parameters ip, name or uid needs to be non-null. Returns the ID of the newly created ban entry.
    
    Parameters:
    
    ip - a RegEx pattern to match a client's IP against, can be null
    
    name - a RegEx pattern to match a client's name against, can be null
    
    uid - the unique identifier of a client, can be null
    
    timeInSeconds - the duration of the ban in seconds. 0 equals a permanent ban
    
    reason - the reason for the ban, can be null
    
    Returns:
    
    the ID of the newly created ban entry
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    RegEx Pattern, addBan(String, String, String, String, long, String), Client.getId(), Client.getUniqueIdentifier(), Client.getIp()
    
    Number of query commands sent:
    
    1
  - addBan
```
public CommandFuture<Integer> addBan(String ip,
                                     String name,
                                     String uid,
                                     String myTSId,
                                     long timeInSeconds,
                                     String reason)
```
    Adds a new ban entry. At least one of the parameters ip, name, uid, or myTSId needs to be non-null. Returns the ID of the newly created ban entry.
    Note that creating a ban entry for the "empty" "myTeamSpeak" ID will ban all clients who don't have a linked "myTeamSpeak" account.
    
    Parameters:
    
    ip - a RegEx pattern to match a client's IP against, can be null
    
    name - a RegEx pattern to match a client's name against, can be null
    
    uid - the unique identifier of a client, can be null
    
    myTSId - the "myTeamSpeak" ID of a client, the string "empty", or null
    
    timeInSeconds - the duration of the ban in seconds. 0 equals a permanent ban
    
    reason - the reason for the ban, can be null
    
    Returns:
    
    the ID of the newly created ban entry
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    RegEx Pattern, Client.getId(), Client.getUniqueIdentifier(), Client.getIp()
    
    Number of query commands sent:
    
    1
  - addChannelClientPermission
```
public CommandFuture<Void> addChannelClientPermission(int channelId,
                                                      int clientDBId,
                                                      String permName,
                                                      int permValue)
```
    Adds a specified permission to a client in a specific channel.
    
    Parameters:
    
    channelId - the ID of the channel wherein the permission should be granted
    
    clientDBId - the database ID of the client to add a permission to
    
    permName - the name of the permission to grant
    
    permValue - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - addChannelGroup
```
public CommandFuture<Integer> addChannelGroup(String name)
```
    Creates a new channel group for clients using a given name and returns its ID.
    To create channel group templates or ones for server queries, use addChannelGroup(String, PermissionGroupDatabaseType).
    
    Parameters:
    
    name - the name of the new channel group
    
    Returns:
    
    the ID of the newly created channel group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup
    
    Number of query commands sent:
    
    1
  - addChannelGroup
```
public CommandFuture<Integer> addChannelGroup(String name,
                                              PermissionGroupDatabaseType type)
```
    Creates a new channel group using a given name and returns its ID.
    
    Parameters:
    
    name - the name of the new channel group
    
    type - the desired type of channel group
    
    Returns:
    
    the ID of the newly created channel group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup
    
    Number of query commands sent:
    
    1
  - addChannelGroupPermission
```
public CommandFuture<Void> addChannelGroupPermission(int groupId,
                                                     String permName,
                                                     int permValue)
```
    Adds a specified permission to a channel group.
    
    Parameters:
    
    groupId - the ID of the channel group to grant the permission
    
    permName - the name of the permission to be granted
    
    permValue - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), Permission
    
    Number of query commands sent:
    
    1
  - addChannelPermission
```
public CommandFuture<Void> addChannelPermission(int channelId,
                                                String permName,
                                                int permValue)
```
    Adds a specified permission to a channel.
    
    Parameters:
    
    channelId - the ID of the channel wherein the permission should be granted
    
    permName - the name of the permission to grant
    
    permValue - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Permission
    
    Number of query commands sent:
    
    1
  - addClientPermission
```
@Deprecated
public CommandFuture<Void> addClientPermission(int clientDBId,
                                                           String permName,
                                                           int value,
                                                           boolean skipped)
```
    Deprecated. This method is no longer preferred for adding permissions to a client.
    Use addClientPermission(int, IPermissionType, int, boolean) or addClientPermission(int, BPermissionType, boolean, boolean) instead.
    
    Adds a specified permission to a channel.
    
    Parameters:
    
    clientDBId - the database ID of the client to grant the permission
    
    permName - the name of the permission to grant
    
    value - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    skipped - if set to true, the permission will not be overridden by channel group permissions
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - addClientPermission
```
public CommandFuture<Void> addClientPermission(int clientDBId,
                                               IPermissionType permName,
                                               int value,
                                               boolean skipped)
```
    Adds a specified permission to a client.
    
    Parameters:
    
    clientDBId - the database ID of the client to grant the permission
    
    permName - the enum of the permission to grant
    
    value - the numeric value of the permission
    
    skipped - if set to true, the permission will not be overridden by channel group permissions
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    IPermissionType, Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - addClientPermission
```
public CommandFuture<Void> addClientPermission(int clientDBId,
                                               BPermissionType permName,
                                               boolean value,
                                               boolean skipped)
```
    Adds a specified permission to a client.
    
    Parameters:
    
    clientDBId - the database ID of the client to grant the permission
    
    permName - the enum of the permission to grant
    
    value - the boolean value of the permission
    
    skipped - if set to true, the permission will not be overridden by channel group permissions
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    BPermissionType, Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - addClientToServerGroup
```
public CommandFuture<Void> addClientToServerGroup(int groupId,
                                                  int clientDatabaseId)
```
    Adds a client to the specified server group.
    Please note that a client cannot be added to default groups or template groups.
    
    Parameters:
    
    groupId - the ID of the server group to add the client to
    
    clientDatabaseId - the database ID of the client to add
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - addComplaint
```
public CommandFuture<Void> addComplaint(int clientDBId,
                                        String message)
```
    Submits a complaint about the specified client. The length of the message is limited to 200 UTF-8 bytes and BB codes in it will be ignored.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    message - the message of the complaint, may not contain BB codes
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Complaint.getMessage()
    
    Number of query commands sent:
    
    1
  - addPermissionToAllServerGroups
```
public CommandFuture<Void> addPermissionToAllServerGroups(ServerGroupType type,
                                                          String permName,
                                                          int value,
                                                          boolean negated,
                                                          boolean skipped)
```
    Adds a specified permission to all server groups of the type specified by type on all virtual servers.
    
    Parameters:
    
    type - the kind of server group this permission should be added to
    
    permName - the name of the permission to be granted
    
    value - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    negated - if set to true, the lowest permission value will be selected instead of the highest
    
    skipped - if set to true, this permission will not be overridden by client or channel group permissions
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroupType, Permission
    
    Number of query commands sent:
    
    1
  - addPrivilegeKey
```
public CommandFuture<String> addPrivilegeKey(PrivilegeKeyType type,
                                             int groupId,
                                             int channelId,
                                             String description)
```
    Create a new privilege key that allows one client to join a server or channel group.
    - If type is set to SERVER_GROUP, groupId is used as a server group ID and channelId is ignored.
    - If type is set to CHANNEL_GROUP, groupId is used as a channel group ID and channelId is used as the channel in which the group should be set.
    Parameters:
    
    type - the type of token that should be created
    
    groupId - the ID of the server or channel group
    
    channelId - the ID of the channel, in case the token is channel group token
    
    description - the description for the token, can be null
    
    Returns:
    
    the created token for a client to use
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    PrivilegeKeyType, addPrivilegeKeyServerGroup(int, String), addPrivilegeKeyChannelGroup(int, int, String)
    
    Number of query commands sent:
    
    1
  - addPrivilegeKeyChannelGroup
```
public CommandFuture<String> addPrivilegeKeyChannelGroup(int channelGroupId,
                                                         int channelId,
                                                         String description)
```
    Creates a new privilege key for a channel group.
    
    Parameters:
    
    channelGroupId - the ID of the channel group
    
    channelId - the ID of the channel in which the channel group should be set
    
    description - the description for the token, can be null
    
    Returns:
    
    the created token for a client to use
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), Channel.getId(), addPrivilegeKey(PrivilegeKeyType, int, int, String), addPrivilegeKeyServerGroup(int, String)
    
    Number of query commands sent:
    
    1
  - addPrivilegeKeyServerGroup
```
public CommandFuture<String> addPrivilegeKeyServerGroup(int serverGroupId,
                                                        String description)
```
    Creates a new privilege key for a server group.
    
    Parameters:
    
    serverGroupId - the ID of the server group
    
    description - the description for the token, can be null
    
    Returns:
    
    the created token for a client to use
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), addPrivilegeKey(PrivilegeKeyType, int, int, String), addPrivilegeKeyChannelGroup(int, int, String)
    
    Number of query commands sent:
    
    1
  - addServerGroup
```
public CommandFuture<Integer> addServerGroup(String name)
```
    Creates a new server group for clients using a given name and returns its ID.
    To create server group templates or ones for server queries, use addServerGroup(String, PermissionGroupDatabaseType).
    
    Parameters:
    
    name - the name of the new server group
    
    Returns:
    
    the ID of the newly created server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup
    
    Number of query commands sent:
    
    1
  - addServerGroup
```
public CommandFuture<Integer> addServerGroup(String name,
                                             PermissionGroupDatabaseType type)
```
    Creates a new server group using a given name and returns its ID.
    
    Parameters:
    
    name - the name of the new server group
    
    type - the desired type of server group
    
    Returns:
    
    the ID of the newly created server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup, PermissionGroupDatabaseType
    
    Number of query commands sent:
    
    1
  - addServerGroupPermission
```
public CommandFuture<Void> addServerGroupPermission(int groupId,
                                                    String permName,
                                                    int value,
                                                    boolean negated,
                                                    boolean skipped)
```
    Adds a specified permission to a server group.
    
    Parameters:
    
    groupId - the ID of the channel group to which the permission should be added
    
    permName - the name of the permission to add
    
    value - the numeric value of the permission (or for boolean permissions: 1 = true, 0 = false)
    
    negated - if set to true, the lowest permission value will be selected instead of the highest
    
    skipped - if set to true, this permission will not be overridden by client or channel group permissions
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), Permission
    
    Number of query commands sent:
    
    1
  - addServerQueryLogin
```
public CommandFuture<CreatedQueryLogin> addServerQueryLogin(String loginName,
                                                            int clientDBId)
```
    Creates a server query login with name loginName for the client specified by clientDBId on the currently selected virtual server and returns the password of the created login. If the client already had a server query login, the existing login will be deleted and replaced.
    Moreover, this method can be used to create new global server query logins that are not tied to any particular virtual server or client. To create such a server query login, make sure no virtual server is selected (e.g. use selectVirtualServerById(0)) and call this method with clientDBId = 0.
    
    Parameters:
    
    loginName - the name of the server query login to add
    
    clientDBId - the database ID of the client for which a server query login should be created
    
    Returns:
    
    an object containing the password of the new server query login
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    deleteServerQueryLogin(int), getServerQueryLogins(), updateServerQueryLogin(String)
    
    Number of query commands sent:
    
    1
  - addTS3Listeners
```
public void addTS3Listeners(TS3Listener... listeners)
```
    Adds one or more TS3Listeners to the event manager of the query. These listeners will be notified when the TS3 server fires an event.
    Note that for the TS3 server to fire events, you must first also register the event types you want to listen to.
    
    Parameters:
    
    listeners - one or more listeners to register
    
    See Also:
    
    registerAllEvents(), registerEvent(TS3EventType, int), TS3Listener, TS3EventType
  - banClient
```
public CommandFuture<int[]> banClient(int clientId,
                                      long timeInSeconds)
```
    Bans a client with a given client ID for a given time.
    Please note that this will create up to three separate ban rules, one for the targeted client's IP address, one for their unique identifier, and potentially one more entry for their "myTeamSpeak" ID, if available.
    Exception: If the banned client connects via a loopback address (i.e. 127.0.0.1 or localhost), no IP ban is created.
    
    Parameters:
    
    clientId - the ID of the client
    
    timeInSeconds - the duration of the ban in seconds. 0 equals a permanent ban
    
    Returns:
    
    an array containing the IDs of the created ban entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), addBan(String, String, String, long, String)
    
    Number of query commands sent:
    
    1
  - banClient
```
public CommandFuture<int[]> banClient(int clientId,
                                      long timeInSeconds,
                                      String reason)
```
    Bans a client with a given client ID for a given time for the specified reason.
    Please note that this will create up to three separate ban rules, one for the targeted client's IP address, one for their unique identifier, and potentially one more entry for their "myTeamSpeak" ID, if available.
    Exception: If the banned client connects via a loopback address (i.e. 127.0.0.1 or localhost), no IP ban is created.
    
    Parameters:
    
    clientId - the ID of the client
    
    timeInSeconds - the duration of the ban in seconds. 0 equals a permanent ban
    
    reason - the reason for the ban, can be null
    
    Returns:
    
    an array containing the IDs of the created ban entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), addBan(String, String, String, long, String)
    
    Number of query commands sent:
    
    1
  - banClient
```
public CommandFuture<int[]> banClient(int clientId,
                                      String reason)
```
    Bans a client with a given client ID permanently for the specified reason.
    Please note that this will create up to three separate ban rules, one for the targeted client's IP address, one for their unique identifier, and potentially one more entry for their "myTeamSpeak" ID, if available.
    Exception: If the banned client connects via a loopback address (i.e. 127.0.0.1 or localhost), no IP ban is created.
    
    Parameters:
    
    clientId - the ID of the client
    
    reason - the reason for the ban, can be null
    
    Returns:
    
    an array containing the IDs of the created ban entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), addBan(String, String, String, long, String)
    
    Number of query commands sent:
    
    1
  - banClients
```
public CommandFuture<int[]> banClients(int[] clientIds,
                                       long timeInSeconds,
                                       String reason,
                                       boolean continueOnError)
```
    Bans multiple clients by their client ID for a given time for the specified reason.
    Please note that this will create up to three separate ban rules for each client, one for the targeted client's IP address, one for their unique identifier, and potentially one more entry for their "myTeamSpeak" ID, if available.
    Exception: If the banned client connects via a loopback address (i.e. 127.0.0.1 or localhost), no IP ban is created.
    Exception: If two or more clients are connecting from the same IP address, only one IP ban entry for that IP will be created.
    
    Parameters:
    
    clientIds - the IDs of the clients to be banned
    
    timeInSeconds - the duration of the ban in seconds. 0 equals a permanent ban
    
    reason - the reason for the ban, can be null
    
    continueOnError - if true, continue to the next client if banning one client fails, else do not create any bans on error
    
    Returns:
    
    an array containing the IDs of the created ban entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), addBan(String, String, String, long, String)
    
    Number of query commands sent:
    
    1
  - broadcast
```
public CommandFuture<Void> broadcast(String message)
```
    Sends a text message to all clients on all virtual servers. These messages will appear to clients in the tab for server messages.
    
    Parameters:
    
    message - the message to be sent
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - copyChannelGroup
```
public CommandFuture<Void> copyChannelGroup(int sourceGroupId,
                                            int targetGroupId,
                                            PermissionGroupDatabaseType type)
```
    Creates a copy of the channel group specified by sourceGroupId, overwriting any other channel group specified by targetGroupId.
    The parameter type can be used to create server query and template groups.
    
    Parameters:
    
    sourceGroupId - the ID of the channel group to copy
    
    targetGroupId - the ID of another channel group to overwrite
    
    type - the desired type of channel group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId()
    
    Number of query commands sent:
    
    1
  - copyChannelGroup
```
public CommandFuture<Integer> copyChannelGroup(int sourceGroupId,
                                               String targetName,
                                               PermissionGroupDatabaseType type)
```
    Creates a copy of the channel group specified by sourceGroupId with a given name and returns the ID of the newly created channel group.
    
    Parameters:
    
    sourceGroupId - the ID of the channel group to copy
    
    targetName - the name for the copy of the channel group
    
    type - the desired type of channel group
    
    Returns:
    
    the ID of the newly created channel group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId()
    
    Number of query commands sent:
    
    1
  - copyServerGroup
```
public CommandFuture<Integer> copyServerGroup(int sourceGroupId,
                                              int targetGroupId,
                                              PermissionGroupDatabaseType type)
```
    Creates a copy of the server group specified by sourceGroupId, overwriting another server group specified by targetGroupId.
    The parameter type can be used to create server query and template groups.
    
    Parameters:
    
    sourceGroupId - the ID of the server group to copy
    
    targetGroupId - the ID of another server group to overwrite
    
    type - the desired type of server group
    
    Returns:
    
    the ID of the newly created server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId()
    
    Number of query commands sent:
    
    1
  - copyServerGroup
```
public CommandFuture<Integer> copyServerGroup(int sourceGroupId,
                                              String targetName,
                                              PermissionGroupDatabaseType type)
```
    Creates a copy of the server group specified by sourceGroupId with a given name and returns the ID of the newly created server group.
    
    Parameters:
    
    sourceGroupId - the ID of the server group to copy
    
    targetName - the name for the copy of the server group
    
    type - the desired type of server group
    
    Returns:
    
    the ID of the newly created server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId()
    
    Number of query commands sent:
    
    1
  - createChannel
```
public CommandFuture<Integer> createChannel(String name,
                                            Map<ChannelProperty,String> options)
```
    Creates a new channel with a given name using the given properties and returns its ID.
    
    Parameters:
    
    name - the name for the new channel
    
    options - a map of options that should be set for the channel
    
    Returns:
    
    the ID of the newly created channel
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel
    
    Number of query commands sent:
    
    1
  - createFileDirectory
```
public CommandFuture<Void> createFileDirectory(String directoryPath,
                                               int channelId)
```
    Creates a new directory on the file repository in the specified channel.
    
    Parameters:
    
    directoryPath - the path to the directory that should be created
    
    channelId - the ID of the channel the directory should be created in
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - createFileDirectory
```
public CommandFuture<Void> createFileDirectory(String directoryPath,
                                               int channelId,
                                               String channelPassword)
```
    Creates a new directory on the file repository in the specified channel.
    
    Parameters:
    
    directoryPath - the path to the directory that should be created
    
    channelId - the ID of the channel the directory should be created in
    
    channelPassword - the password of that channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - createServer
```
public CommandFuture<CreatedVirtualServer> createServer(String name,
                                                        Map<VirtualServerProperty,String> options)
```
    Creates a new virtual server with the given name and returns an object containing the ID of the newly created virtual server, the default server admin token and the virtual server's voice port. Usually, the virtual server is also automatically started. This can be turned off on the TS3 server, though.
    If VirtualServerProperty.VIRTUALSERVER_PORT is not specified in the virtual server properties, the server will test for the first unused UDP port.
    Please also note that creating virtual servers usually requires the server query admin account and that there is a limit to how many virtual servers can be created, which is dependent on your license. Unlicensed TS3 server instances are limited to 1 virtual server with up to 32 client slots.
    
    Parameters:
    
    name - the name for the new virtual server
    
    options - a map of options that should be set for the virtual server
    
    Returns:
    
    information about the newly created virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer
    
    Number of query commands sent:
    
    1
  - createServerSnapshot
```
public CommandFuture<Snapshot> createServerSnapshot()
```
    Creates a Snapshot of the selected virtual server containing all settings, groups and known client identities. The data from a server snapshot can be used to restore a virtual servers configuration.
    
    Returns:
    
    a snapshot of the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    deployServerSnapshot(Snapshot)
    
    Number of query commands sent:
    
    1
  - deleteAllBans
```
public CommandFuture<Void> deleteAllBans()
```
    Deletes all active ban rules from the server. Use with caution.
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - deleteAllComplaints
```
public CommandFuture<Void> deleteAllComplaints(int clientDBId)
```
    Deletes all complaints about the client with specified database ID from the server.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Complaint
    
    Number of query commands sent:
    
    1
  - deleteBan
```
public CommandFuture<Void> deleteBan(int banId)
```
    Deletes the ban rule with the specified ID from the server.
    
    Parameters:
    
    banId - the ID of the ban to delete
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Ban.getId()
    
    Number of query commands sent:
    
    1
  - deleteChannel
```
public CommandFuture<Void> deleteChannel(int channelId)
```
    Deletes an existing channel specified by its ID, kicking all clients out of the channel.
    
    Parameters:
    
    channelId - the ID of the channel to delete
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), deleteChannel(int, boolean), kickClientFromChannel(String, int...)
    
    Number of query commands sent:
    
    1
  - deleteChannel
```
public CommandFuture<Void> deleteChannel(int channelId,
                                         boolean force)
```
    Deletes an existing channel with a given ID. If force is true, the channel will be deleted even if there are clients within, else the command will fail in this situation.
    
    Parameters:
    
    channelId - the ID of the channel to delete
    
    force - whether clients should be kicked out of the channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), kickClientFromChannel(String, int...)
    
    Number of query commands sent:
    
    1
  - deleteChannelClientPermission
```
public CommandFuture<Void> deleteChannelClientPermission(int channelId,
                                                         int clientDBId,
                                                         String permName)
```
    Removes a specified permission from a client in a specific channel.
    
    Parameters:
    
    channelId - the ID of the channel wherein the permission should be removed
    
    clientDBId - the database ID of the client
    
    permName - the name of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Client.getDatabaseId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteChannelGroup
```
public CommandFuture<Void> deleteChannelGroup(int groupId)
```
    Removes the channel group with the given ID.
    
    Parameters:
    
    groupId - the ID of the channel group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId()
    
    Number of query commands sent:
    
    1
  - deleteChannelGroup
```
public CommandFuture<Void> deleteChannelGroup(int groupId,
                                              boolean force)
```
    Removes the channel group with the given ID. If force is true, the channel group will be deleted even if it still contains clients, else the command will fail in this situation.
    
    Parameters:
    
    groupId - the ID of the channel group
    
    force - whether the channel group should be deleted even if it still contains clients
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId()
    
    Number of query commands sent:
    
    1
  - deleteChannelGroupPermission
```
public CommandFuture<Void> deleteChannelGroupPermission(int groupId,
                                                        String permName)
```
    Removes a permission from the channel group with the given ID.
    
    Parameters:
    
    groupId - the ID of the channel group
    
    permName - the name of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteChannelPermission
```
public CommandFuture<Void> deleteChannelPermission(int channelId,
                                                   String permName)
```
    Removes a permission from the channel with the given ID.
    
    Parameters:
    
    channelId - the ID of the channel
    
    permName - the name of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteClientPermission
```
@Deprecated
public CommandFuture<Void> deleteClientPermission(int clientDBId,
                                                              String permName)
```
    Deprecated. This method is no longer preferred for removing permissions from a client.
    Use deleteClientPermission(int, IPermissionType) or deleteClientPermission(int, BPermissionType) instead.
    
    Removes a permission from a client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    permName - the name of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteClientPermission
```
public CommandFuture<Void> deleteClientPermission(int clientDBId,
                                                  IPermissionType permName)
```
    Removes a permission from a client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    permName - the enum of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    IPermissionType, Client.getDatabaseId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteClientPermission
```
public CommandFuture<Void> deleteClientPermission(int clientDBId,
                                                  BPermissionType permName)
```
    Removes a permission from a client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    permName - the enum of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    BPermissionType, Client.getDatabaseId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteComplaint
```
public CommandFuture<Void> deleteComplaint(int targetClientDBId,
                                           int fromClientDBId)
```
    Deletes the complaint about the client with database ID targetClientDBId submitted by the client with database ID fromClientDBId from the server.
    
    Parameters:
    
    targetClientDBId - the database ID of the client the complaint is about
    
    fromClientDBId - the database ID of the client who added the complaint
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Complaint, Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - deleteCustomClientProperty
```
public CommandFuture<Void> deleteCustomClientProperty(int clientDBId,
                                                      String key)
```
    Removes the key custom client property from a client.
    
    Parameters:
    
    clientDBId - the database ID of the target client
    
    key - the key of the custom property to delete, cannot be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - deleteDatabaseClientProperties
```
public CommandFuture<Void> deleteDatabaseClientProperties(int clientDBId)
```
    Removes all stored database information about the specified client. Please note that this data is also automatically removed after a configured time (usually 90 days).
    See DatabaseClientInfo for a list of stored information about a client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), getDatabaseClientInfo(int), DatabaseClientInfo
    
    Number of query commands sent:
    
    1
  - deleteFile
```
public CommandFuture<Void> deleteFile(String filePath,
                                      int channelId)
```
    Deletes a file or directory from the file repository in the specified channel.
    
    Parameters:
    
    filePath - the path to the file or directory
    
    channelId - the ID of the channel the file or directory resides in
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - deleteFile
```
public CommandFuture<Void> deleteFile(String filePath,
                                      int channelId,
                                      String channelPassword)
```
    Deletes a file or directory from the file repository in the specified channel.
    
    Parameters:
    
    filePath - the path to the file or directory
    
    channelId - the ID of the channel the file or directory resides in
    
    channelPassword - the password of that channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - deleteFiles
```
public CommandFuture<Void> deleteFiles(String[] filePaths,
                                       int channelId)
```
    Deletes multiple files or directories from the file repository in the specified channel.
    
    Parameters:
    
    filePaths - the paths to the files or directories
    
    channelId - the ID of the channel the file or directory resides in
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - deleteFiles
```
public CommandFuture<Void> deleteFiles(String[] filePaths,
                                       int channelId,
                                       String channelPassword)
```
    Deletes multiple files or directories from the file repository in the specified channel.
    
    Parameters:
    
    filePaths - the paths to the files or directories
    
    channelId - the ID of the channel the file or directory resides in
    
    channelPassword - the password of that channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - deleteIcon
```
public CommandFuture<Void> deleteIcon(long iconId)
```
    Deletes an icon from the icon directory in the file repository.
    
    Parameters:
    
    iconId - the ID of the icon to delete
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    IconFile.getIconId()
    
    Number of query commands sent:
    
    1
  - deleteIcons
```
public CommandFuture<Void> deleteIcons(long... iconIds)
```
    Deletes multiple icons from the icon directory in the file repository.
    
    Parameters:
    
    iconIds - the IDs of the icons to delete
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    IconFile.getIconId()
    
    Number of query commands sent:
    
    1
  - deleteOfflineMessage
```
public CommandFuture<Void> deleteOfflineMessage(int messageId)
```
    Deletes the offline message with the specified ID.
    
    Parameters:
    
    messageId - the ID of the offline message to delete
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Message.getId()
    
    Number of query commands sent:
    
    1
  - deletePermissionFromAllServerGroups
```
public CommandFuture<Void> deletePermissionFromAllServerGroups(ServerGroupType type,
                                                               String permName)
```
    Removes a specified permission from all server groups of the type specified by type on all virtual servers.
    
    Parameters:
    
    type - the kind of server group this permission should be removed from
    
    permName - the name of the permission to remove
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroupType, Permission.getName()
    
    Number of query commands sent:
    
    1
  - deletePrivilegeKey
```
public CommandFuture<Void> deletePrivilegeKey(String token)
```
    Deletes the privilege key with the given token.
    
    Parameters:
    
    token - the token of the privilege key
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    PrivilegeKey
    
    Number of query commands sent:
    
    1
  - deleteServer
```
public CommandFuture<Void> deleteServer(int serverId)
```
    Deletes the virtual server with the specified ID.
    Only stopped virtual servers can be deleted.
    
    Parameters:
    
    serverId - the ID of the virtual server
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getId(), stopServer(int)
    
    Number of query commands sent:
    
    1
  - deleteServerGroup
```
public CommandFuture<Void> deleteServerGroup(int groupId)
```
    Deletes the server group with the specified ID, even if the server group still contains clients.
    
    Parameters:
    
    groupId - the ID of the server group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId()
    
    Number of query commands sent:
    
    1
  - deleteServerGroup
```
public CommandFuture<Void> deleteServerGroup(int groupId,
                                             boolean force)
```
    Deletes a server group with the specified ID.
    If force is true, the server group will be deleted even if it contains clients, else the command will fail in this situation.
    
    Parameters:
    
    groupId - the ID of the server group
    
    force - whether the server group should be deleted if it still contains clients
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId()
    
    Number of query commands sent:
    
    1
  - deleteServerGroupPermission
```
public CommandFuture<Void> deleteServerGroupPermission(int groupId,
                                                       String permName)
```
    Removes a permission from the server group with the given ID.
    
    Parameters:
    
    groupId - the ID of the server group
    
    permName - the name of the permission to revoke
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), Permission.getName()
    
    Number of query commands sent:
    
    1
  - deleteServerQueryLogin
```
public CommandFuture<Void> deleteServerQueryLogin(int clientDBId)
```
    Deletes the server query login with the specified client database ID.
    If you only know the name of the server query login, use getServerQueryLoginsByName(String) first.
    
    Parameters:
    
    clientDBId - the client database ID of the server query login (usually the ID of the associated client)
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addServerQueryLogin(String, int), getServerQueryLogins(), updateServerQueryLogin(String)
    
    Number of query commands sent:
    
    1
  - deployServerSnapshot
```
public CommandFuture<Void> deployServerSnapshot(Snapshot snapshot)
```
    Restores the selected virtual servers configuration using the data from a previously created server snapshot.
    
    Parameters:
    
    snapshot - the snapshot to restore
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    createServerSnapshot()
    
    Number of query commands sent:
    
    1
  - deployServerSnapshot
```
public CommandFuture<Void> deployServerSnapshot(String snapshot)
```
    Restores the configuration of the selected virtual server using the data from a previously created server snapshot.
    
    Parameters:
    
    snapshot - the snapshot to restore
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    createServerSnapshot()
    
    Number of query commands sent:
    
    1
  - downloadFile
```
public CommandFuture<Long> downloadFile(OutputStream dataOut,
                                        String filePath,
                                        int channelId)
```
    Downloads a file from the file repository at a given path and channel and writes the file's bytes to an open OutputStream.
    It is the user's responsibility to ensure that the given OutputStream is open and to close the stream again once the download has finished.
    Note that this method will not read the entire file to memory and can thus download arbitrarily sized files from the file repository.
    
    Parameters:
    
    dataOut - a stream that the downloaded data should be written to
    
    filePath - the path of the file on the file repository
    
    channelId - the ID of the channel to download the file from
    
    Returns:
    
    how many bytes were downloaded
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), downloadFileDirect(String, int)
    
    Number of query commands sent:
    
    1
  - downloadFile
```
public CommandFuture<Long> downloadFile(OutputStream dataOut,
                                        String filePath,
                                        int channelId,
                                        String channelPassword)
```
    Downloads a file from the file repository at a given path and channel and writes the file's bytes to an open OutputStream.
    It is the user's responsibility to ensure that the given OutputStream is open and to close the stream again once the download has finished.
    Note that this method will not read the entire file to memory and can thus download arbitrarily sized files from the file repository.
    
    Parameters:
    
    dataOut - a stream that the downloaded data should be written to
    
    filePath - the path of the file on the file repository
    
    channelId - the ID of the channel to download the file from
    
    channelPassword - that channel's password
    
    Returns:
    
    how many bytes were downloaded
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), downloadFileDirect(String, int, String)
    
    Number of query commands sent:
    
    1
  - downloadFileDirect
```
public CommandFuture<byte[]> downloadFileDirect(String filePath,
                                                int channelId)
```
    Downloads a file from the file repository at a given path and channel and returns the file's bytes as a byte array.
    Note that this method will read the entire file to memory. That means that if a file is larger than 2³¹-1 bytes in size, the download will fail.
    
    Parameters:
    
    filePath - the path of the file on the file repository
    
    channelId - the ID of the channel to download the file from
    
    Returns:
    
    a byte array containing the file's data
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), downloadFile(OutputStream, String, int)
    
    Number of query commands sent:
    
    1
  - downloadFileDirect
```
public CommandFuture<byte[]> downloadFileDirect(String filePath,
                                                int channelId,
                                                String channelPassword)
```
    Downloads a file from the file repository at a given path and channel and returns the file's bytes as a byte array.
    Note that this method will read the entire file to memory. That means that if a file is larger than 2³¹-1 bytes in size, the download will fail.
    
    Parameters:
    
    filePath - the path of the file on the file repository
    
    channelId - the ID of the channel to download the file from
    
    channelPassword - that channel's password
    
    Returns:
    
    a byte array containing the file's data
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), downloadFile(OutputStream, String, int, String)
    
    Number of query commands sent:
    
    1
  - downloadIcon
```
public CommandFuture<Long> downloadIcon(OutputStream dataOut,
                                        long iconId)
```
    Downloads an icon from the icon directory in the file repository and writes the file's bytes to an open OutputStream.
    It is the user's responsibility to ensure that the given OutputStream is open and to close the stream again once the download has finished.
    
    Parameters:
    
    dataOut - a stream that the downloaded data should be written to
    
    iconId - the ID of the icon that should be downloaded
    
    Returns:
    
    a byte array containing the icon file's data
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    IconFile.getIconId(), downloadIconDirect(long), uploadIcon(InputStream, long)
    
    Number of query commands sent:
    
    1
  - downloadIconDirect
```
public CommandFuture<byte[]> downloadIconDirect(long iconId)
```
    Downloads an icon from the icon directory in the file repository and returns the file's bytes as a byte array.
    Note that this method will read the entire file to memory.
    
    Parameters:
    
    iconId - the ID of the icon that should be downloaded
    
    Returns:
    
    a byte array containing the icon file's data
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    IconFile.getIconId(), downloadIcon(OutputStream, long), uploadIconDirect(byte[])
    
    Number of query commands sent:
    
    1
  - editChannel
```
public CommandFuture<Void> editChannel(int channelId,
                                       Map<ChannelProperty,String> options)
```
    Changes a channel's configuration using the given properties.
    
    Parameters:
    
    channelId - the ID of the channel to edit
    
    options - the map of properties to modify
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId()
    
    Number of query commands sent:
    
    1
  - editChannel
```
public CommandFuture<Void> editChannel(int channelId,
                                       ChannelProperty property,
                                       String value)
```
    Changes a single property of the given channel.
    Note that one can set many properties at once with the overloaded method that takes a map of channel properties and strings.
    
    Parameters:
    
    channelId - the ID of the channel to edit
    
    property - the channel property to modify, make sure it is editable
    
    value - the new value of the property
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), editChannel(int, Map)
    
    Number of query commands sent:
    
    1
  - editClient
```
public CommandFuture<Void> editClient(int clientId,
                                      Map<ClientProperty,String> options)
```
    Changes a client's configuration using given properties.
    Only ClientProperty.CLIENT_DESCRIPTION can be changed for other clients. To update the current client's properties, use updateClient(Map) or updateClient(ClientProperty, String).
    
    Parameters:
    
    clientId - the ID of the client to edit
    
    options - the map of properties to modify
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), updateClient(Map)
    
    Number of query commands sent:
    
    1
  - editClient
```
public CommandFuture<Void> editClient(int clientId,
                                      ClientProperty property,
                                      String value)
```
    Changes a single property of the given client.
    Only ClientProperty.CLIENT_DESCRIPTION can be changed for other clients. To update the current client's properties, use updateClient(Map) or updateClient(ClientProperty, String).
    
    Parameters:
    
    clientId - the ID of the client to edit
    
    property - the client property to modify, make sure it is editable
    
    value - the new value of the property
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), editClient(int, Map), updateClient(Map)
    
    Number of query commands sent:
    
    1
  - editDatabaseClient
```
public CommandFuture<Void> editDatabaseClient(int clientDBId,
                                              Map<ClientProperty,String> options)
```
    Changes a client's database settings using given properties.
    
    Parameters:
    
    clientDBId - the database ID of the client to edit
    
    options - the map of properties to modify
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    DatabaseClientInfo, Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - editInstance
```
public CommandFuture<Void> editInstance(ServerInstanceProperty property,
                                        String value)
```
    Changes the server instance configuration using given properties. If the given property is not changeable, IllegalArgumentException will be thrown.
    
    Parameters:
    
    property - the property to edit, must be changeable
    
    value - the new value for the edit
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if property is not changeable
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerInstanceProperty.isChangeable()
    
    Number of query commands sent:
    
    1
  - editServer
```
public CommandFuture<Void> editServer(Map<VirtualServerProperty,String> options)
```
    Changes the configuration of the selected virtual server using given properties.
    
    Parameters:
    
    options - the map of properties to edit
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServerProperty
    
    Number of query commands sent:
    
    1
  - getBans
```
public CommandFuture<List<Ban>> getBans()
```
    Gets a list of all bans on the selected virtual server.
    
    Returns:
    
    a list of all bans on the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Ban
    
    Number of query commands sent:
    
    1
  - getBindings
```
public CommandFuture<List<Binding>> getBindings()
```
    Gets a list of IP addresses used by the server instance.
    
    Returns:
    
    the list of bound IP addresses
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Binding
    
    Number of query commands sent:
    
    1
  - getChannelByNameExact
```
public CommandFuture<Channel> getChannelByNameExact(String name,
                                                    boolean ignoreCase)
```
    Finds and returns the channel matching the given name exactly.
    
    Parameters:
    
    name - the name of the channel
    
    ignoreCase - whether the case of the name should be ignored
    
    Returns:
    
    the found channel or null if no channel was found
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel, getChannelsByName(String)
    
    Number of query commands sent:
    
    1
  - getChannelsByName
```
public CommandFuture<List<Channel>> getChannelsByName(String name)
```
    Gets a list of channels whose names contain the given search string.
    
    Parameters:
    
    name - the name to search
    
    Returns:
    
    a list of all channels with names matching the search pattern
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel, getChannelByNameExact(String, boolean)
    
    Number of query commands sent:
    
    2
  - getChannelClientPermissions
```
public CommandFuture<List<Permission>> getChannelClientPermissions(int channelId,
                                                                   int clientDBId)
```
    Displays a list of permissions defined for a client in a specific channel.
    
    Parameters:
    
    channelId - the ID of the channel
    
    clientDBId - the database ID of the client
    
    Returns:
    
    a list of permissions for the user in the specified channel
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - getChannelGroupClients
```
public CommandFuture<List<ChannelGroupClient>> getChannelGroupClients(int channelId,
                                                                      int clientDBId,
                                                                      int groupId)
```
    Gets all client / channel ID combinations currently assigned to channel groups. All three parameters are optional and can be turned off by setting it to -1.
    
    Parameters:
    
    channelId - restricts the search to the channel with a specified ID. Set to -1 to ignore.
    
    clientDBId - restricts the search to the client with a specified database ID. Set to -1 to ignore.
    
    groupId - restricts the search to the channel group with the specified ID. Set to -1 to ignore.
    
    Returns:
    
    a list of combinations of channel ID, client database ID and channel group ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Client.getDatabaseId(), ChannelGroup.getId(), ChannelGroupClient
    
    Number of query commands sent:
    
    1
  - getChannelGroupClientsByChannelGroupId
```
public CommandFuture<List<ChannelGroupClient>> getChannelGroupClientsByChannelGroupId(int groupId)
```
    Gets all client / channel ID combinations currently assigned to the specified channel group.
    
    Parameters:
    
    groupId - the ID of the channel group whose client / channel assignments should be returned.
    
    Returns:
    
    a list of combinations of channel ID, client database ID and channel group ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), ChannelGroupClient, getChannelGroupClients(int, int, int)
    
    Number of query commands sent:
    
    1
  - getChannelGroupClientsByChannelId
```
public CommandFuture<List<ChannelGroupClient>> getChannelGroupClientsByChannelId(int channelId)
```
    Gets all channel group assignments in the specified channel.
    
    Parameters:
    
    channelId - the ID of the channel whose channel group assignments should be returned.
    
    Returns:
    
    a list of combinations of channel ID, client database ID and channel group ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), ChannelGroupClient, getChannelGroupClients(int, int, int)
    
    Number of query commands sent:
    
    1
  - getChannelGroupClientsByClientDBId
```
public CommandFuture<List<ChannelGroupClient>> getChannelGroupClientsByClientDBId(int clientDBId)
```
    Gets all channel group assignments for the specified client.
    
    Parameters:
    
    clientDBId - the database ID of the client whose channel group
    
    Returns:
    
    a list of combinations of channel ID, client database ID and channel group ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), ChannelGroupClient, getChannelGroupClients(int, int, int)
    
    Number of query commands sent:
    
    1
  - getChannelGroupPermissions
```
public CommandFuture<List<Permission>> getChannelGroupPermissions(int groupId)
```
    Gets a list of all permissions assigned to the specified channel group.
    
    Parameters:
    
    groupId - the ID of the channel group.
    
    Returns:
    
    a list of permissions assigned to the channel group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), Permission
    
    Number of query commands sent:
    
    1
  - getChannelGroups
```
public CommandFuture<List<ChannelGroup>> getChannelGroups()
```
    Gets a list of all channel groups on the selected virtual server.
    
    Returns:
    
    a list of all channel groups on the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup
    
    Number of query commands sent:
    
    1
  - getChannelInfo
```
public CommandFuture<ChannelInfo> getChannelInfo(int channelId)
```
    Gets detailed configuration information about the channel specified channel.
    
    Parameters:
    
    channelId - the ID of the channel
    
    Returns:
    
    information about the channel
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), ChannelInfo
    
    Number of query commands sent:
    
    1
  - getChannelPermissions
```
public CommandFuture<List<Permission>> getChannelPermissions(int channelId)
```
    Gets a list of all permissions assigned to the specified channel.
    
    Parameters:
    
    channelId - the ID of the channel
    
    Returns:
    
    a list of all permissions assigned to the channel
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Permission
    
    Number of query commands sent:
    
    1
  - getChannels
```
public CommandFuture<List<Channel>> getChannels()
```
    Gets a list of all channels on the selected virtual server.
    
    Returns:
    
    a list of all channels on the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel
    
    Number of query commands sent:
    
    1
  - getClientByNameExact
```
public CommandFuture<Client> getClientByNameExact(String name,
                                                  boolean ignoreCase)
```
    Finds and returns the client whose nickname matches the given name exactly.
    
    Parameters:
    
    name - the name of the client
    
    ignoreCase - whether the case of the name should be ignored
    
    Returns:
    
    the found client or null if no client was found
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client, getClientsByName(String)
    
    Number of query commands sent:
    
    1
  - getClientsByName
```
public CommandFuture<List<Client>> getClientsByName(String name)
```
    Gets a list of clients whose nicknames contain the given search string.
    
    Parameters:
    
    name - the name to search
    
    Returns:
    
    a list of all clients with nicknames matching the search pattern
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client, getClientByNameExact(String, boolean)
    
    Number of query commands sent:
    
    2
  - getClientByUId
```
public CommandFuture<ClientInfo> getClientByUId(String clientUId)
```
    Gets information about the client with the specified unique identifier.
    
    Parameters:
    
    clientUId - the unique identifier of the client
    
    Returns:
    
    information about the client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getUniqueIdentifier(), ClientInfo
    
    Number of query commands sent:
    
    2
  - getClientInfo
```
public CommandFuture<ClientInfo> getClientInfo(int clientId)
```
    Gets information about the client with the specified client ID.
    
    Parameters:
    
    clientId - the client ID of the client
    
    Returns:
    
    information about the client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), ClientInfo
    
    Number of query commands sent:
    
    1
  - getClientPermissions
```
public CommandFuture<List<Permission>> getClientPermissions(int clientDBId)
```
    Gets a list of all permissions assigned to the specified client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    Returns:
    
    a list of all permissions assigned to the client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Permission
    
    Number of query commands sent:
    
    1
  - getClients
```
public CommandFuture<List<Client>> getClients()
```
    Gets a list of all clients on the selected virtual server.
    
    Returns:
    
    a list of all clients on the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client
    
    Number of query commands sent:
    
    1
  - getComplaints
```
public CommandFuture<List<Complaint>> getComplaints()
```
    Gets a list of all complaints on the selected virtual server.
    
    Returns:
    
    a list of all complaints on the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Complaint, getComplaints(int)
    
    Number of query commands sent:
    
    1
  - getComplaints
```
public CommandFuture<List<Complaint>> getComplaints(int clientDBId)
```
    Gets a list of all complaints about the specified client.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    Returns:
    
    a list of all complaints about the specified client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), Complaint
    
    Number of query commands sent:
    
    1
  - getConnectionInfo
```
public CommandFuture<ConnectionInfo> getConnectionInfo()
```
    Gets detailed connection information about the selected virtual server.
    
    Returns:
    
    connection information about the selected virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ConnectionInfo, getServerInfo()
    
    Number of query commands sent:
    
    1
  - getCustomClientProperties
```
public CommandFuture<Map<String,String>> getCustomClientProperties(int clientDBId)
```
    Gets a map of all custom client properties and their values assigned to the client with database ID clientDBId.
    
    Parameters:
    
    clientDBId - the database ID of the target client
    
    Returns:
    
    a map of the client's custom client property assignments
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), searchCustomClientProperty(String), searchCustomClientProperty(String, String)
    
    Number of query commands sent:
    
    1
  - getDatabaseClientsByName
```
public CommandFuture<List<DatabaseClientInfo>> getDatabaseClientsByName(String name)
```
    Gets all clients in the database whose last nickname matches the specified name exactly.
    
    Parameters:
    
    name - the nickname for the clients to match
    
    Returns:
    
    a list of all clients with a matching nickname
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getNickname()
    
    Number of query commands sent:
    
    1 + n, where n is the amount of database clients with a matching nickname
  - getDatabaseClientByUId
```
public CommandFuture<DatabaseClientInfo> getDatabaseClientByUId(String clientUId)
```
    Gets information about the client with the specified unique identifier in the server database.
    
    Parameters:
    
    clientUId - the unique identifier of the client
    
    Returns:
    
    the database client or null if no client was found
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getUniqueIdentifier(), DatabaseClientInfo
    
    Number of query commands sent:
    
    2
  - getDatabaseClientInfo
```
public CommandFuture<DatabaseClientInfo> getDatabaseClientInfo(int clientDBId)
```
    Gets information about the client with the specified database ID in the server database.
    
    Parameters:
    
    clientDBId - the database ID of the client
    
    Returns:
    
    the database client or null if no client was found
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), DatabaseClientInfo
    
    Number of query commands sent:
    
    1
  - getDatabaseClients
```
public CommandFuture<List<DatabaseClient>> getDatabaseClients()
```
    Gets information about all clients in the server database.
    As this method uses internal commands which can only return 200 clients at once, this method can take quite some time to execute.
    Also keep in mind that the client database can easily accumulate several thousand entries.
    
    Returns:
    
    a List of all database clients
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    DatabaseClient
    
    Number of query commands sent:
    
    1 + n, where n = Math.ceil([amount of database clients] / 200)
  - getDatabaseClients
```
public CommandFuture<List<DatabaseClient>> getDatabaseClients(int offset,
                                                              int count)
```
    Gets information about a set number of clients in the server database, starting at offset.
    
    Parameters:
    
    offset - the index of the first database client to be returned. Note that this is not a database ID, but an arbitrary, 0-based index.
    
    count - the number of database clients that should be returned. Any integer greater than 200 might cause problems with the connection
    
    Returns:
    
    a List of database clients
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    DatabaseClient
    
    Number of query commands sent:
    
    1
  - getFileInfo
```
public CommandFuture<FileInfo> getFileInfo(String filePath,
                                           int channelId)
```
    Gets information about a file on the file repository in the specified channel.
    Note that this method does not work on directories and the information returned by this method is identical to the one returned by getFileList(String, int, String)
    
    Parameters:
    
    filePath - the path to the file
    
    channelId - the ID of the channel the file resides in
    
    Returns:
    
    some information about the file
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileInfo
```
public CommandFuture<FileInfo> getFileInfo(String filePath,
                                           int channelId,
                                           String channelPassword)
```
    Gets information about a file on the file repository in the specified channel.
    Note that this method does not work on directories and the information returned by this method is identical to the one returned by getFileList(String, int, String)
    
    Parameters:
    
    filePath - the path to the file
    
    channelId - the ID of the channel the file resides in
    
    channelPassword - the password of that channel
    
    Returns:
    
    some information about the file
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileInfos
```
public CommandFuture<List<FileInfo>> getFileInfos(String[] filePaths,
                                                  int channelId)
```
    Gets information about multiple files on the file repository in the specified channel.
    Note that this method does not work on directories and the information returned by this method is identical to the one returned by getFileList(String, int, String)
    
    Parameters:
    
    filePaths - the paths to the files
    
    channelId - the ID of the channel the file resides in
    
    Returns:
    
    some information about the file
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileInfos
```
public CommandFuture<List<FileInfo>> getFileInfos(String[] filePaths,
                                                  int channelId,
                                                  String channelPassword)
```
    Gets information about multiple files on the file repository in the specified channel.
    Note that this method does not work on directories and the information returned by this method is identical to the one returned by getFileList(String, int, String)
    
    Parameters:
    
    filePaths - the paths to the files
    
    channelId - the ID of the channel the file resides in
    
    channelPassword - the password of that channel
    
    Returns:
    
    some information about the file
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileInfos
```
public CommandFuture<List<FileInfo>> getFileInfos(String[] filePaths,
                                                  int[] channelIds,
                                                  String[] channelPasswords)
```
    Gets information about multiple files on the file repository in multiple channels.
    Note that this method does not work on directories and the information returned by this method is identical to the one returned by getFileList(String, int, String)
    
    Parameters:
    
    filePaths - the paths to the files, may not be null and may not contain null elements
    
    channelIds - the IDs of the channels the file resides in, may not be null
    
    channelPasswords - the passwords of those channels, may be null and may contain null elements
    
    Returns:
    
    some information about the files
    
    Throws:
    
    IllegalArgumentException - if the dimensions of filePaths, channelIds and channelPasswords don't match
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileList
```
public CommandFuture<List<FileListEntry>> getFileList(String directoryPath,
                                                      int channelId)
```
    Gets a list of files and directories in the specified parent directory and channel.
    
    Parameters:
    
    directoryPath - the path to the parent directory
    
    channelId - the ID of the channel the directory resides in
    
    Returns:
    
    the files and directories in the parent directory
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileList
```
public CommandFuture<List<FileListEntry>> getFileList(String directoryPath,
                                                      int channelId,
                                                      String channelPassword)
```
    Gets a list of files and directories in the specified parent directory and channel.
    
    Parameters:
    
    directoryPath - the path to the parent directory
    
    channelId - the ID of the channel the directory resides in
    
    channelPassword - the password of that channel
    
    Returns:
    
    the files and directories in the parent directory
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - getFileTransfers
```
public CommandFuture<List<FileTransfer>> getFileTransfers()
```
    Gets a list of active or recently active file transfers.
    
    Returns:
    
    a list of file transfers
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getHostInfo
```
public CommandFuture<HostInfo> getHostInfo()
```
    Displays detailed configuration information about the server instance including uptime, number of virtual servers online, traffic information, etc.
    
    Returns:
    
    information about the host
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getIconList
```
public CommandFuture<List<IconFile>> getIconList()
```
    Gets a list of all icon files on this virtual server.
    
    Returns:
    
    a list of all icons
  - getInstanceInfo
```
public CommandFuture<InstanceInfo> getInstanceInfo()
```
    Displays the server instance configuration including database revision number, the file transfer port, default group IDs, etc.
    
    Returns:
    
    information about the TeamSpeak server instance.
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getInstanceLogEntries
```
public CommandFuture<List<String>> getInstanceLogEntries(int lines)
```
    Fetches the specified amount of log entries from the server log.
    
    Parameters:
    
    lines - the amount of log entries to fetch, in the range between 1 and 100. Returns 100 entries if the argument is not in range
    
    Returns:
    
    a list of the latest log entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getInstanceLogEntries
```
public CommandFuture<List<String>> getInstanceLogEntries()
```
    Fetches the last 100 log entries from the server log.
    
    Returns:
    
    a list of up to 100 log entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getOfflineMessage
```
public CommandFuture<String> getOfflineMessage(int messageId)
```
    Reads the message body of a message. This will not set the read flag, though.
    
    Parameters:
    
    messageId - the ID of the message to be read
    
    Returns:
    
    the body of the message with the specified ID or null if there was no message with that ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Message.getId(), setMessageRead(int)
    
    Number of query commands sent:
    
    1
  - getOfflineMessage
```
public CommandFuture<String> getOfflineMessage(Message message)
```
    Reads the message body of a message. This will not set the read flag, though.
    
    Parameters:
    
    message - the message to be read
    
    Returns:
    
    the body of the message with the specified ID or null if there was no message with that ID
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Message.getId(), setMessageRead(Message)
    
    Number of query commands sent:
    
    1
  - getOfflineMessages
```
public CommandFuture<List<Message>> getOfflineMessages()
```
    Gets a list of all offline messages for the server query. The returned messages lack their message body, though. To read the actual message, use getOfflineMessage(int) or getOfflineMessage(Message).
    
    Returns:
    
    a list of all offline messages this server query has received
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPermissionAssignments
```
public CommandFuture<List<PermissionAssignment>> getPermissionAssignments(String permName)
```
    Displays detailed information about all assignments of the permission specified with permName. The output includes the type and the ID of the client, channel or group associated with the permission.
    
    Parameters:
    
    permName - the name of the permission
    
    Returns:
    
    a list of permission assignments
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    getPermissionOverview(int, int)
    
    Number of query commands sent:
    
    1
  - getPermissionIdByName
```
public CommandFuture<Integer> getPermissionIdByName(String permName)
```
    Gets the ID of the permission specified by permName.
    Note that the use of numeric permission IDs is deprecated and that this API only uses the string variant of the IDs.
    
    Parameters:
    
    permName - the name of the permission
    
    Returns:
    
    the numeric ID of the specified permission
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPermissionIdsByName
```
public CommandFuture<int[]> getPermissionIdsByName(String... permNames)
```
    Gets the IDs of the permissions specified by permNames.
    Note that the use of numeric permission IDs is deprecated and that this API only uses the string variant of the IDs.
    
    Parameters:
    
    permNames - the names of the permissions
    
    Returns:
    
    the numeric IDs of the specified permission
    
    Throws:
    
    IllegalArgumentException - if permNames is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPermissionOverview
```
public CommandFuture<List<PermissionAssignment>> getPermissionOverview(int channelId,
                                                                       int clientDBId)
```
    Gets a list of all assigned permissions for a client in a specified channel. If you do not care about channel permissions, set channelId to 0.
    
    Parameters:
    
    channelId - the ID of the channel
    
    clientDBId - the database ID of the client to create the overview for
    
    Returns:
    
    a list of all permission assignments for the client in the specified channel
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - getPermissions
```
public CommandFuture<List<PermissionInfo>> getPermissions()
```
    Displays a list of all permissions, including ID, name and description.
    
    Returns:
    
    a list of all permissions
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPermissionValue
```
public CommandFuture<Integer> getPermissionValue(String permName)
```
    Displays the current value of the specified permission for this server query instance.
    
    Parameters:
    
    permName - the name of the permission
    
    Returns:
    
    the permission value, usually ranging from 0 to 100
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPermissionValues
```
public CommandFuture<int[]> getPermissionValues(String... permNames)
```
    Displays the current values of the specified permissions for this server query instance.
    
    Parameters:
    
    permNames - the names of the permissions
    
    Returns:
    
    the permission values, usually ranging from 0 to 100
    
    Throws:
    
    IllegalArgumentException - if permNames is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getPrivilegeKeys
```
public CommandFuture<List<PrivilegeKey>> getPrivilegeKeys()
```
    Gets a list of all available tokens to join channel or server groups, including their type and group IDs.
    
    Returns:
    
    a list of all generated, but still unclaimed privilege keys
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addPrivilegeKey(PrivilegeKeyType, int, int, String), usePrivilegeKey(String)
    
    Number of query commands sent:
    
    1
  - getServerGroupClients
```
public CommandFuture<List<ServerGroupClient>> getServerGroupClients(int serverGroupId)
```
    Gets a list of all clients in the specified server group.
    
    Parameters:
    
    serverGroupId - the ID of the server group for which the clients should be looked up
    
    Returns:
    
    a list of all clients in the server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getServerGroupClients
```
public CommandFuture<List<ServerGroupClient>> getServerGroupClients(ServerGroup serverGroup)
```
    Gets a list of all clients in the specified server group.
    
    Parameters:
    
    serverGroup - the server group for which the clients should be looked up
    
    Returns:
    
    a list of all clients in the server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getServerGroupPermissions
```
public CommandFuture<List<Permission>> getServerGroupPermissions(int serverGroupId)
```
    Gets a list of all permissions assigned to the specified server group.
    
    Parameters:
    
    serverGroupId - the ID of the server group for which the permissions should be looked up
    
    Returns:
    
    a list of all permissions assigned to the server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), getServerGroupPermissions(ServerGroup)
    
    Number of query commands sent:
    
    1
  - getServerGroupPermissions
```
public CommandFuture<List<Permission>> getServerGroupPermissions(ServerGroup serverGroup)
```
    Gets a list of all permissions assigned to the specified server group.
    
    Parameters:
    
    serverGroup - the server group for which the permissions should be looked up
    
    Returns:
    
    a list of all permissions assigned to the server group
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getServerGroups
```
public CommandFuture<List<ServerGroup>> getServerGroups()
```
    Gets a list of all server groups on the virtual server.
    Depending on your permissions, the output may also contain global server query groups and template groups.
    
    Returns:
    
    a list of all server groups
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getServerGroupsByClientId
```
public CommandFuture<List<ServerGroup>> getServerGroupsByClientId(int clientDatabaseId)
```
    Gets a list of all server groups set for a client.
    
    Parameters:
    
    clientDatabaseId - the database ID of the client for which the server groups should be looked up
    
    Returns:
    
    a list of all server groups set for the client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), getServerGroupsByClient(Client)
    
    Number of query commands sent:
    
    2
  - getServerGroupsByClient
```
public CommandFuture<List<ServerGroup>> getServerGroupsByClient(Client client)
```
    Gets a list of all server groups set for a client.
    
    Parameters:
    
    client - the client for which the server groups should be looked up
    
    Returns:
    
    a list of all server group set for the client
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    getServerGroupsByClientId(int)
    
    Number of query commands sent:
    
    2
  - getServerIdByPort
```
public CommandFuture<Integer> getServerIdByPort(int port)
```
    Gets the ID of a virtual server by its port.
    
    Parameters:
    
    port - the port of a virtual server
    
    Returns:
    
    the ID of the virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getPort(), VirtualServer.getId()
    
    Number of query commands sent:
    
    1
  - getServerInfo
```
public CommandFuture<VirtualServerInfo> getServerInfo()
```
    Gets detailed information about the virtual server the server query is currently in.
    
    Returns:
    
    information about the current virtual server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getServerQueryLogins
```
public CommandFuture<List<QueryLogin>> getServerQueryLogins()
```
    Gets a list of all server query logins (containing login name, virtual server ID, and client database ID). If a virtual server is selected, only the server query logins of the selected virtual server are returned.
    
    Returns:
    
    a list of QueryLogin objects describing existing server query logins
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addServerQueryLogin(String, int), deleteServerQueryLogin(int), getServerQueryLoginsByName(String), updateServerQueryLogin(String)
    
    Number of query commands sent:
    
    1
  - getServerQueryLoginsByName
```
public CommandFuture<List<QueryLogin>> getServerQueryLoginsByName(String pattern)
```
    Gets a list of all server query logins (containing login name, virtual server ID, and client database ID) whose login name matches the specified SQL-like pattern. If a virtual server is selected, only the server query logins of the selected virtual server are returned.
    
    Parameters:
    
    pattern - the SQL-like pattern to match the server query login name against
    
    Returns:
    
    a list of QueryLogin objects describing existing server query logins
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addServerQueryLogin(String, int), deleteServerQueryLogin(int), getServerQueryLogins(), updateServerQueryLogin(String)
    
    Number of query commands sent:
    
    1
  - getVersion
```
public CommandFuture<Version> getVersion()
```
    Gets the version, build number and platform of the TeamSpeak3 server.
    
    Returns:
    
    the version information of the server
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getVirtualServers
```
public CommandFuture<List<VirtualServer>> getVirtualServers()
```
    Gets a list of all virtual servers including their ID, status, number of clients online, etc.
    
    Returns:
    
    a list of all virtual servers
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getVirtualServerLogEntries
```
public CommandFuture<List<String>> getVirtualServerLogEntries(int lines)
```
    Fetches the specified amount of log entries from the currently selected virtual server. If no virtual server is selected, the entries will be read from the server log instead.
    
    Parameters:
    
    lines - the amount of log entries to fetch, in the range between 1 and 100. Returns 100 entries if the argument is not in range
    
    Returns:
    
    a list of the latest log entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - getVirtualServerLogEntries
```
public CommandFuture<List<String>> getVirtualServerLogEntries()
```
    Fetches the last 100 log entries from the currently selected virtual server. If no virtual server is selected, the entries will be read from the server log instead.
    
    Returns:
    
    a list of up to 100 log entries
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - isClientOnline
```
public CommandFuture<Boolean> isClientOnline(int clientId)
```
    Checks whether the client with the specified client ID is online.
    Please note that there is no guarantee that the client will still be online by the time the next command is executed.
    
    Parameters:
    
    clientId - the ID of the client
    
    Returns:
    
    true if the client is online, false otherwise
    
    See Also:
    
    getClientInfo(int)
    
    Number of query commands sent:
    
    1
  - isClientOnline
```
public CommandFuture<Boolean> isClientOnline(String clientUId)
```
    Checks whether the client with the specified unique identifier is online.
    Please note that there is no guarantee that the client will still be online by the time the next command is executed.
    
    Parameters:
    
    clientUId - the unique ID of the client
    
    Returns:
    
    true if the client is online, false otherwise
    
    See Also:
    
    getClientByUId(String)
    
    Number of query commands sent:
    
    1
  - kickClientFromChannel
```
public CommandFuture<Void> kickClientFromChannel(int... clientIds)
```
    Kicks one or more clients from their current channels. This will move the kicked clients into the default channel and won't do anything if the clients are already in the default channel.
    
    Parameters:
    
    clientIds - the IDs of the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    kickClientFromChannel(Client...), kickClientFromChannel(String, int...)
    
    Number of query commands sent:
    
    1
  - kickClientFromChannel
```
public CommandFuture<Void> kickClientFromChannel(Client... clients)
```
    Kicks one or more clients from their current channels. This will move the kicked clients into the default channel and won't do anything if the clients are already in the default channel.
    
    Parameters:
    
    clients - the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    kickClientFromChannel(int...), kickClientFromChannel(String, Client...)
    
    Number of query commands sent:
    
    1
  - kickClientFromChannel
```
public CommandFuture<Void> kickClientFromChannel(String message,
                                                 int... clientIds)
```
    Kicks one or more clients from their current channels for the specified reason. This will move the kicked clients into the default channel and won't do anything if the clients are already in the default channel.
    
    Parameters:
    
    message - the reason message to display to the clients
    
    clientIds - the IDs of the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), kickClientFromChannel(int...), kickClientFromChannel(String, Client...)
    
    Number of query commands sent:
    
    1
  - kickClientFromChannel
```
public CommandFuture<Void> kickClientFromChannel(String message,
                                                 Client... clients)
```
    Kicks one or more clients from their current channels for the specified reason. This will move the kicked clients into the default channel and won't do anything if the clients are already in the default channel.
    
    Parameters:
    
    message - the reason message to display to the clients
    
    clients - the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    kickClientFromChannel(Client...), kickClientFromChannel(String, int...)
    
    Number of query commands sent:
    
    1
  - kickClientFromServer
```
public CommandFuture<Void> kickClientFromServer(int... clientIds)
```
    Kicks one or more clients from the server.
    
    Parameters:
    
    clientIds - the IDs of the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), kickClientFromServer(Client...), kickClientFromServer(String, int...)
    
    Number of query commands sent:
    
    1
  - kickClientFromServer
```
public CommandFuture<Void> kickClientFromServer(Client... clients)
```
    Kicks one or more clients from the server.
    
    Parameters:
    
    clients - the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    kickClientFromServer(int...), kickClientFromServer(String, Client...)
    
    Number of query commands sent:
    
    1
  - kickClientFromServer
```
public CommandFuture<Void> kickClientFromServer(String message,
                                                int... clientIds)
```
    Kicks one or more clients from the server for the specified reason.
    
    Parameters:
    
    message - the reason message to display to the clients
    
    clientIds - the IDs of the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), kickClientFromServer(int...), kickClientFromServer(String, Client...)
    
    Number of query commands sent:
    
    1
  - kickClientFromServer
```
public CommandFuture<Void> kickClientFromServer(String message,
                                                Client... clients)
```
    Kicks one or more clients from the server for the specified reason.
    
    Parameters:
    
    message - the reason message to display to the clients
    
    clients - the clients to kick
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    kickClientFromServer(Client...), kickClientFromServer(String, int...)
    
    Number of query commands sent:
    
    1
  - login
```
public CommandFuture<Void> login(String username,
                                 String password)
```
    Logs the server query in using the specified username and password.
    Note that you can also set the login in the TS3Config, so that you will be logged in right after the connection is established.
    
    Parameters:
    
    username - the username of the server query
    
    password - the password to use
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    logout()
    
    Number of query commands sent:
    
    1
  - logout
```
public CommandFuture<Void> logout()
```
    Logs the server query out and deselects the current virtual server.
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    login(String, String)
    
    Number of query commands sent:
    
    1
  - moveChannel
```
public CommandFuture<Void> moveChannel(int channelId,
                                       int channelTargetId)
```
    Moves a channel to a new parent channel specified by its ID. To move a channel to root level, set channelTargetId to 0.
    This will move the channel right below the specified parent channel, above all other child channels. This command will fail if the channel already has the specified target channel as the parent channel.
    
    Parameters:
    
    channelId - the channel to move
    
    channelTargetId - the new parent channel for the specified channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), moveChannel(int, int, int)
    
    Number of query commands sent:
    
    1
  - moveChannel
```
public CommandFuture<Void> moveChannel(int channelId,
                                       int channelTargetId,
                                       int order)
```
    Moves a channel to a new parent channel specified by its ID. To move a channel to root level, set channelTargetId to 0.
    The channel will be ordered below the channel with the ID specified by order. To move the channel right below the parent channel, set order to 0.
    Note that you can't re-order a channel without also changing its parent channel with this method. Use editChannel(int, ChannelProperty, String) to change ChannelProperty.CHANNEL_ORDER instead.
    
    Parameters:
    
    channelId - the channel to move
    
    channelTargetId - the new parent channel for the specified channel
    
    order - the channel to sort the specified channel below
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), moveChannel(int, int)
    
    Number of query commands sent:
    
    1
  - moveClient
```
public CommandFuture<Void> moveClient(int clientId,
                                      int channelId)
```
    Moves a single client into a channel.
    Consider using moveClients(int[], int) to move multiple clients.
    
    Parameters:
    
    clientId - the ID of the client to move
    
    channelId - the ID of the channel to move the client into
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveClients
```
public CommandFuture<Void> moveClients(int[] clientIds,
                                       int channelId)
```
    Moves multiple clients into a channel. Immediately returns true for an empty client ID array.
    Use this method instead of moveClient(int, int) for moving several clients as this will only send 1 command to the server and thus complete faster.
    
    Parameters:
    
    clientIds - the IDs of the clients to move, cannot be null
    
    channelId - the ID of the channel to move the clients into
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if clientIds is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveClient
```
public CommandFuture<Void> moveClient(Client client,
                                      ChannelBase channel)
```
    Moves a single client into a channel.
    Consider using moveClients(Client[], ChannelBase) to move multiple clients.
    
    Parameters:
    
    client - the client to move, cannot be null
    
    channel - the channel to move the client into, cannot be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if client or channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - moveClients
```
public CommandFuture<Void> moveClients(Client[] clients,
                                       ChannelBase channel)
```
    Moves multiple clients into a channel. Immediately returns true for an empty client array.
    Use this method instead of moveClient(Client, ChannelBase) for moving several clients as this will only send 1 command to the server and thus complete faster.
    
    Parameters:
    
    clients - the clients to move, cannot be null
    
    channel - the channel to move the clients into, cannot be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if clients or channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - moveClient
```
public CommandFuture<Void> moveClient(int clientId,
                                      int channelId,
                                      String channelPassword)
```
    Moves a single client into a channel using the specified password.
    Consider using moveClients(int[], int, String) to move multiple clients.
    
    Parameters:
    
    clientId - the ID of the client to move
    
    channelId - the ID of the channel to move the client into
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveClients
```
public CommandFuture<Void> moveClients(int[] clientIds,
                                       int channelId,
                                       String channelPassword)
```
    Moves multiple clients into a channel using the specified password. Immediately returns true for an empty client ID array.
    Use this method instead of moveClient(int, int, String) for moving several clients as this will only send 1 command to the server and thus complete faster.
    
    Parameters:
    
    clientIds - the IDs of the clients to move, cannot be null
    
    channelId - the ID of the channel to move the clients into
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if clientIds is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId(), Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveClient
```
public CommandFuture<Void> moveClient(Client client,
                                      ChannelBase channel,
                                      String channelPassword)
```
    Moves a single client into a channel using the specified password.
    Consider using moveClients(Client[], ChannelBase, String) to move multiple clients.
    
    Parameters:
    
    client - the client to move, cannot be null
    
    channel - the channel to move the client into, cannot be null
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if client or channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - moveClients
```
public CommandFuture<Void> moveClients(Client[] clients,
                                       ChannelBase channel,
                                       String channelPassword)
```
    Moves multiple clients into a channel using the specified password. Immediately returns true for an empty client array.
    Use this method instead of moveClient(Client, ChannelBase, String) for moving several clients as this will only send 1 command to the server and thus complete faster.
    
    Parameters:
    
    clients - the clients to move, cannot be null
    
    channel - the channel to move the clients into, cannot be null
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if clients or channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - moveFile
```
public CommandFuture<Void> moveFile(String oldPath,
                                    String newPath,
                                    int channelId)
```
    Moves and renames a file on the file repository within the same channel.
    
    Parameters:
    
    oldPath - the current path to the file
    
    newPath - the desired new path
    
    channelId - the ID of the channel the file resides in
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), moveFile to a different channel
    
    Number of query commands sent:
    
    1
  - moveFile
```
public CommandFuture<Void> moveFile(String oldPath,
                                    String newPath,
                                    int oldChannelId,
                                    int newChannelId)
```
    Renames a file on the file repository and moves it to a new path in a different channel.
    
    Parameters:
    
    oldPath - the current path to the file
    
    newPath - the desired new path
    
    oldChannelId - the ID of the channel the file currently resides in
    
    newChannelId - the ID of the channel the file should be moved to
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), moveFile within the same channel
    
    Number of query commands sent:
    
    1
  - moveFile
```
public CommandFuture<Void> moveFile(String oldPath,
                                    String newPath,
                                    int channelId,
                                    String channelPassword)
```
    Moves and renames a file on the file repository within the same channel.
    
    Parameters:
    
    oldPath - the current path to the file
    
    newPath - the desired new path
    
    channelId - the ID of the channel the file resides in
    
    channelPassword - the password of the channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), moveFile to a different channel
    
    Number of query commands sent:
    
    1
  - moveFile
```
public CommandFuture<Void> moveFile(String oldPath,
                                    String newPath,
                                    int oldChannelId,
                                    String oldPassword,
                                    int newChannelId,
                                    String newPassword)
```
    Renames a file on the file repository and moves it to a new path in a different channel.
    
    Parameters:
    
    oldPath - the current path to the file
    
    newPath - the desired new path
    
    oldChannelId - the ID of the channel the file currently resides in
    
    oldPassword - the password of the current channel
    
    newChannelId - the ID of the channel the file should be moved to
    
    newPassword - the password of the new channel
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), moveFile within the same channel
    
    Number of query commands sent:
    
    1
  - moveQuery
```
public CommandFuture<Void> moveQuery(int channelId)
```
    Moves the server query into a channel.
    
    Parameters:
    
    channelId - the ID of the channel to move the server query into
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveQuery
```
public CommandFuture<Void> moveQuery(ChannelBase channel)
```
    Moves the server query into a channel.
    
    Parameters:
    
    channel - the channel to move the server query into, cannot be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - moveQuery
```
public CommandFuture<Void> moveQuery(int channelId,
                                     String channelPassword)
```
    Moves the server query into a channel using the specified password.
    
    Parameters:
    
    channelId - the ID of the channel to move the client into
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId()
    
    Number of query commands sent:
    
    1
  - moveQuery
```
public CommandFuture<Void> moveQuery(ChannelBase channel,
                                     String channelPassword)
```
    Moves the server query into a channel using the specified password.
    
    Parameters:
    
    channel - the channel to move the client into, cannot be null
    
    channelPassword - the password of the channel, can be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    IllegalArgumentException - if channel is null
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - pokeClient
```
public CommandFuture<Void> pokeClient(int clientId,
                                      String message)
```
    Pokes the client with the specified client ID. This opens up a small popup window for the client containing your message and plays a sound. The displayed message will be formatted like this:
    hh:mm:ss - "Your Nickname" poked you: <your message in green color>
    The displayed message length is limited to 100 UTF-8 bytes. If a client has already received a poke message, all subsequent pokes will simply add a line to the already opened popup window and will still play a sound.
    
    Parameters:
    
    clientId - the ID of the client to poke
    
    message - the message to send, may contain BB codes
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId()
    
    Number of query commands sent:
    
    1
  - registerAllEvents
```
public CommandFuture<Void> registerAllEvents()
```
    Registers the server query to receive notifications about all server events.
    This means that the following actions will trigger event notifications:
    - A client joins the server or disconnects from it
    - A client switches channels
    - A client sends a server message
    - A client sends a channel message in the channel the query is in
    - A client sends a private message to the server query
    - A client uses a privilege key
    The limitations to when the query receives notifications about chat events cannot be circumvented.
    To be able to process these events in your application, register an event listener.
    Returns:
    
    whether all commands succeeded or not
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addTS3Listeners(TS3Listener...)
    
    Number of query commands sent:
    
    6
  - registerEvent
```
public CommandFuture<Void> registerEvent(TS3EventType eventType)
```
    Registers the server query to receive notifications about a given event type.
    If used with TS3EventType.TEXT_CHANNEL, this will listen to chat events in the current channel. If used with TS3EventType.CHANNEL, this will listen to all channel events. To specify a different channel for channel events, use registerEvent(TS3EventType, int).
    
    Parameters:
    
    eventType - the event type to be notified about
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addTS3Listeners(TS3Listener...), registerEvent(TS3EventType, int), registerAllEvents()
    
    Number of query commands sent:
    
    1
  - registerEvent
```
public CommandFuture<Void> registerEvent(TS3EventType eventType,
                                         int channelId)
```
    Registers the server query to receive notifications about a given event type.
    
    Parameters:
    
    eventType - the event type to be notified about
    
    channelId - the ID of the channel to listen to, will be ignored if set to -1. Can be set to 0 for TS3EventType.CHANNEL to receive notifications about all channel switches.
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Channel.getId(), addTS3Listeners(TS3Listener...), registerAllEvents()
    
    Number of query commands sent:
    
    1
  - registerEvents
```
public CommandFuture<Void> registerEvents(TS3EventType... eventTypes)
```
    Registers the server query to receive notifications about multiple given event types.
    If used with TS3EventType.TEXT_CHANNEL, this will listen to chat events in the current channel. If used with TS3EventType.CHANNEL, this will listen to all channel events. To specify a different channel for channel events, use registerEvent(TS3EventType, int).
    
    Parameters:
    
    eventTypes - the event types to be notified about
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addTS3Listeners(TS3Listener...), registerEvent(TS3EventType, int), registerAllEvents()
    
    Number of query commands sent:
    
    n, one command per TS3EventType
  - removeClientFromServerGroup
```
public CommandFuture<Void> removeClientFromServerGroup(int serverGroupId,
                                                       int clientDatabaseId)
```
    Removes the client specified by its database ID from the specified server group.
    
    Parameters:
    
    serverGroupId - the ID of the server group
    
    clientDatabaseId - the database ID of the client
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), Client.getDatabaseId(), removeClientFromServerGroup(ServerGroup, Client)
    
    Number of query commands sent:
    
    1
  - removeClientFromServerGroup
```
public CommandFuture<Void> removeClientFromServerGroup(ServerGroup serverGroup,
                                                       Client client)
```
    Removes the specified client from the specified server group.
    
    Parameters:
    
    serverGroup - the server group to remove the client from
    
    client - the client to remove from the server group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    removeClientFromServerGroup(int, int)
    
    Number of query commands sent:
    
    1
  - removeTS3Listeners
```
public void removeTS3Listeners(TS3Listener... listeners)
```
    Removes one or more TS3Listeners to the event manager of the query.
    If a listener was not actually registered, it will be ignored and no exception will be thrown.
    
    Parameters:
    
    listeners - one or more listeners to remove
    
    See Also:
    
    addTS3Listeners(TS3Listener...), TS3Listener, TS3EventType
  - renameChannelGroup
```
public CommandFuture<Void> renameChannelGroup(int channelGroupId,
                                              String name)
```
    Renames the channel group with the specified ID.
    
    Parameters:
    
    channelGroupId - the ID of the channel group to rename
    
    name - the new name for the channel group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), renameChannelGroup(ChannelGroup, String)
    
    Number of query commands sent:
    
    1
  - renameChannelGroup
```
public CommandFuture<Void> renameChannelGroup(ChannelGroup channelGroup,
                                              String name)
```
    Renames the specified channel group.
    
    Parameters:
    
    channelGroup - the channel group to rename
    
    name - the new name for the channel group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    renameChannelGroup(int, String)
    
    Number of query commands sent:
    
    1
  - renameServerGroup
```
public CommandFuture<Void> renameServerGroup(int serverGroupId,
                                             String name)
```
    Renames the server group with the specified ID.
    
    Parameters:
    
    serverGroupId - the ID of the server group to rename
    
    name - the new name for the server group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ServerGroup.getId(), renameServerGroup(ServerGroup, String)
    
    Number of query commands sent:
    
    1
  - renameServerGroup
```
public CommandFuture<Void> renameServerGroup(ServerGroup serverGroup,
                                             String name)
```
    Renames the specified server group.
    
    Parameters:
    
    serverGroup - the server group to rename
    
    name - the new name for the server group
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    renameServerGroup(int, String)
    
    Number of query commands sent:
    
    1
  - resetPermissions
```
public CommandFuture<String> resetPermissions()
```
    Resets all permissions and deletes all server / channel groups. Use carefully.
    
    Returns:
    
    a token for a new administrator account
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - searchCustomClientProperty
```
public CommandFuture<List<CustomPropertyAssignment>> searchCustomClientProperty(String key)
```
    Finds all clients that have any value associated with the key custom client property, and returns the client's database ID and the key and value of the matching custom property.
    
    Parameters:
    
    key - the key to search for, cannot be null
    
    Returns:
    
    a list of client database IDs and their matching custom client properties
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), searchCustomClientProperty(String, String), getCustomClientProperties(int)
    
    Number of query commands sent:
    
    1
  - searchCustomClientProperty
```
public CommandFuture<List<CustomPropertyAssignment>> searchCustomClientProperty(String key,
                                                                                String valuePattern)
```
    Finds all clients whose value associated with the key custom client property matches the SQL-like pattern valuePattern, and returns the client's database ID and the key and value of the matching custom property.
    Patterns are case insensitive. They support the wildcard characters %, which matches any sequence of zero or more characters, and _, which matches exactly one arbitrary character.
    
    Parameters:
    
    key - the key to search for, cannot be null
    
    valuePattern - the pattern that values need to match to be included
    
    Returns:
    
    a list of client database IDs and their matching custom client properties
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), searchCustomClientProperty(String), getCustomClientProperties(int)
    
    Number of query commands sent:
    
    1
  - selectVirtualServerById
```
public CommandFuture<Void> selectVirtualServerById(int id)
```
    Moves the server query into the virtual server with the specified ID.
    
    Parameters:
    
    id - the ID of the virtual server
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getId(), selectVirtualServerById(int, String), selectVirtualServerByPort(int), selectVirtualServer(VirtualServer)
    
    Number of query commands sent:
    
    1
  - selectVirtualServerById
```
public CommandFuture<Void> selectVirtualServerById(int id,
                                                   String nickname)
```
    Moves the server query into the virtual server with the specified ID and sets the server query's nickname.
    The nickname must be between 3 and 30 UTF-8 bytes long. BB codes will be ignored.
    
    Parameters:
    
    id - the ID of the virtual server
    
    nickname - the nickname, or null if the nickname should not be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getId(), selectVirtualServerById(int), selectVirtualServerByPort(int, String), selectVirtualServer(VirtualServer, String)
    
    Number of query commands sent:
    
    1
  - selectVirtualServerByPort
```
public CommandFuture<Void> selectVirtualServerByPort(int port)
```
    Moves the server query into the virtual server with the specified voice port.
    
    Parameters:
    
    port - the voice port of the virtual server
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getPort(), selectVirtualServerById(int), selectVirtualServerByPort(int, String), selectVirtualServer(VirtualServer)
    
    Number of query commands sent:
    
    1
  - selectVirtualServerByPort
```
public CommandFuture<Void> selectVirtualServerByPort(int port,
                                                     String nickname)
```
    Moves the server query into the virtual server with the specified voice port and sets the server query's nickname.
    The nickname must be between 3 and 30 UTF-8 bytes long. BB codes will be ignored.
    
    Parameters:
    
    port - the voice port of the virtual server
    
    nickname - the nickname, or null if the nickname should not be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    VirtualServer.getPort(), selectVirtualServerById(int, String), selectVirtualServerByPort(int), selectVirtualServer(VirtualServer, String)
    
    Number of query commands sent:
    
    1
  - selectVirtualServer
```
public CommandFuture<Void> selectVirtualServer(VirtualServer server)
```
    Moves the server query into the specified virtual server.
    
    Parameters:
    
    server - the virtual server to move into
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    selectVirtualServerById(int), selectVirtualServerByPort(int), selectVirtualServer(VirtualServer, String)
    
    Number of query commands sent:
    
    1
  - selectVirtualServer
```
public CommandFuture<Void> selectVirtualServer(VirtualServer server,
                                               String nickname)
```
    Moves the server query into the specified virtual server and sets the server query's nickname.
    The nickname must be between 3 and 30 UTF-8 bytes long. BB codes will be ignored.
    
    Parameters:
    
    server - the virtual server to move into
    
    nickname - the nickname, or null if the nickname should not be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    selectVirtualServerById(int, String), selectVirtualServerByPort(int, String), selectVirtualServer(VirtualServer)
    
    Number of query commands sent:
    
    1
  - sendOfflineMessage
```
public CommandFuture<Void> sendOfflineMessage(String clientUId,
                                              String subject,
                                              String message)
```
    Sends an offline message to the client with the given unique identifier.
    The message subject's length is limited to 200 UTF-8 bytes and BB codes in it will be ignored. The message body's length is limited to 4096 UTF-8 bytes and accepts BB codes
    
    Parameters:
    
    clientUId - the unique identifier of the client to send the message to
    
    subject - the subject for the message, may not contain BB codes
    
    message - the actual message body, may contain BB codes
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getUniqueIdentifier(), Message
    
    Number of query commands sent:
    
    1
  - sendTextMessage
```
public CommandFuture<Void> sendTextMessage(TextMessageTargetMode targetMode,
                                           int targetId,
                                           String message)
```
    Sends a text message either to the whole virtual server, a channel or specific client. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    To send a message to all virtual servers, use broadcast(String). To send an offline message, use sendOfflineMessage(String, String, String).
    
    Parameters:
    
    targetMode - where the message should be sent to
    
    targetId - the client ID of the recipient of this message. This value is ignored unless targetMode is CLIENT
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId()
    
    Number of query commands sent:
    
    1
  - sendChannelMessage
```
public CommandFuture<Void> sendChannelMessage(int channelId,
                                              String message)
```
    Sends a text message to the channel with the specified ID. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    This will move the client into the channel with the specified channel ID, but will not move it back to the original channel!
    
    Parameters:
    
    channelId - the ID of the channel to which the message should be sent to
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    sendChannelMessage(String), Channel.getId()
    
    Number of query commands sent:
    
    1
  - sendChannelMessage
```
public CommandFuture<Void> sendChannelMessage(String message)
```
    Sends a text message to the channel the server query is currently in. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    
    Parameters:
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - sendServerMessage
```
public CommandFuture<Void> sendServerMessage(int serverId,
                                             String message)
```
    Sends a text message to the virtual server with the specified ID. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    This will move the client to the virtual server with the specified server ID, but will not move it back to the original virtual server!
    
    Parameters:
    
    serverId - the ID of the virtual server to which the message should be sent to
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    sendServerMessage(String), VirtualServer.getId()
    
    Number of query commands sent:
    
    1
  - sendServerMessage
```
public CommandFuture<Void> sendServerMessage(String message)
```
    Sends a text message to the virtual server the server query is currently in. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    
    Parameters:
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - sendPrivateMessage
```
public CommandFuture<Void> sendPrivateMessage(int clientId,
                                              String message)
```
    Sends a private message to the client with the specified client ID. Your message may contain BB codes, but its length is limited to 1024 UTF-8 bytes.
    
    Parameters:
    
    clientId - the ID of the client to send the message to
    
    message - the text message to send
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getId()
    
    Number of query commands sent:
    
    1
  - setClientChannelGroup
```
public CommandFuture<Void> setClientChannelGroup(int groupId,
                                                 int channelId,
                                                 int clientDBId)
```
    Sets a channel group for a client in a specific channel.
    
    Parameters:
    
    groupId - the ID of the group the client should join
    
    channelId - the ID of the channel where the channel group should be assigned
    
    clientDBId - the database ID of the client for which the channel group should be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    ChannelGroup.getId(), Channel.getId(), Client.getDatabaseId()
    
    Number of query commands sent:
    
    1
  - setCustomClientProperties
```
public CommandFuture<Void> setCustomClientProperties(int clientDBId,
                                                     Map<String,String> properties)
```
    Sets the value of the multiple custom client properties for a client.
    If any key present in the map already has a value assigned for this client, the existing value will be overwritten. This method does not delete keys not present in the map.
    If properties contains an entry with null as its key, that entry will be ignored and no exception will be thrown.
    
    Parameters:
    
    clientDBId - the database ID of the target client
    
    properties - the map of properties to set, cannot be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), setCustomClientProperty(int, String, String), deleteCustomClientProperty(int, String)
    
    Number of query commands sent:
    
    properties.size()
  - setCustomClientProperty
```
public CommandFuture<Void> setCustomClientProperty(int clientDBId,
                                                   String key,
                                                   String value)
```
    Sets the value of the key custom client property for a client.
    If there is already an assignment of the key custom client property for this client, the existing value will be overwritten.
    
    Parameters:
    
    clientDBId - the database ID of the target client
    
    key - the key of the custom property to set, cannot be null
    
    value - the (new) value of the custom property to set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    Client.getDatabaseId(), setCustomClientProperties(int, Map), deleteCustomClientProperty(int, String)
    
    Number of query commands sent:
    
    1
  - setMessageRead
```
public CommandFuture<Void> setMessageRead(int messageId)
```
    Sets the read flag to true for a given message. This will not delete the message.
    
    Parameters:
    
    messageId - the ID of the message for which the read flag should be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    setMessageReadFlag(int, boolean)
    
    Number of query commands sent:
    
    1
  - setMessageRead
```
public CommandFuture<Void> setMessageRead(Message message)
```
    Sets the read flag to true for a given message. This will not delete the message.
    
    Parameters:
    
    message - the message for which the read flag should be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    setMessageRead(int), setMessageReadFlag(Message, boolean), deleteOfflineMessage(int)
    
    Number of query commands sent:
    
    1
  - setMessageReadFlag
```
public CommandFuture<Void> setMessageReadFlag(int messageId,
                                              boolean read)
```
    Sets the read flag for a given message. This will not delete the message.
    
    Parameters:
    
    messageId - the ID of the message for which the read flag should be set
    
    read - the boolean value to which the read flag should be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    setMessageRead(int), setMessageReadFlag(Message, boolean), deleteOfflineMessage(int)
    
    Number of query commands sent:
    
    1
  - setMessageReadFlag
```
public CommandFuture<Void> setMessageReadFlag(Message message,
                                              boolean read)
```
    Sets the read flag for a given message. This will not delete the message.
    
    Parameters:
    
    message - the message for which the read flag should be set
    
    read - the boolean value to which the read flag should be set
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    setMessageRead(Message), setMessageReadFlag(int, boolean), deleteOfflineMessage(int)
    
    Number of query commands sent:
    
    1
  - setNickname
```
public CommandFuture<Void> setNickname(String nickname)
```
    Sets the nickname of the server query client.
    The nickname must be between 3 and 30 UTF-8 bytes long. BB codes will be ignored.
    
    Parameters:
    
    nickname - the new nickname, may not be null
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    updateClient(Map)
    
    Number of query commands sent:
    
    1
  - startServer
```
public CommandFuture<Void> startServer(int serverId)
```
    Starts the virtual server with the specified ID.
    
    Parameters:
    
    serverId - the ID of the virtual server
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - startServer
```
public CommandFuture<Void> startServer(VirtualServer virtualServer)
```
    Starts the specified virtual server.
    
    Parameters:
    
    virtualServer - the virtual server to start
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServer
```
public CommandFuture<Void> stopServer(int serverId)
```
    Stops the virtual server with the specified ID.
    
    Parameters:
    
    serverId - the ID of the virtual server
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServer
```
public CommandFuture<Void> stopServer(int serverId,
                                      String reason)
```
    Stops the virtual server with the specified ID.
    
    Parameters:
    
    serverId - the ID of the virtual server
    
    reason - the reason message to display to clients when they are disconnected
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServer
```
public CommandFuture<Void> stopServer(VirtualServer virtualServer)
```
    Stops the specified virtual server.
    
    Parameters:
    
    virtualServer - the virtual server to stop
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServer
```
public CommandFuture<Void> stopServer(VirtualServer virtualServer,
                                      String reason)
```
    Stops the specified virtual server.
    
    Parameters:
    
    virtualServer - the virtual server to stop
    
    reason - the reason message to display to clients when they are disconnected
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServerProcess
```
public CommandFuture<Void> stopServerProcess()
```
    Stops the entire TeamSpeak 3 Server instance by shutting down the process.
    To have permission to use this command, you need to use the server query admin login.
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - stopServerProcess
```
public CommandFuture<Void> stopServerProcess(String reason)
```
    Stops the entire TeamSpeak 3 Server instance by shutting down the process.
    To have permission to use this command, you need to use the server query admin login.
    
    Parameters:
    
    reason - the reason message to display to clients when they are disconnected
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - unregisterAllEvents
```
public CommandFuture<Void> unregisterAllEvents()
```
    Unregisters the server query from receiving any event notifications.
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    Number of query commands sent:
    
    1
  - updateClient
```
public CommandFuture<Void> updateClient(Map<ClientProperty,String> options)
```
    Updates several client properties for this server query instance.
    
    Parameters:
    
    options - the map of properties to update
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    updateClient(ClientProperty, String), editClient(int, Map)
    
    Number of query commands sent:
    
    1
  - updateClient
```
public CommandFuture<Void> updateClient(ClientProperty property,
                                        String value)
```
    Changes a single client property for this server query instance.
    Note that one can set many properties at once with the overloaded method that takes a map of client properties and strings.
    
    Parameters:
    
    property - the client property to modify, make sure it is editable
    
    value - the new value of the property
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    updateClient(Map), editClient(int, Map)
    
    Number of query commands sent:
    
    1
  - updateServerQueryLogin
```
public CommandFuture<String> updateServerQueryLogin(String loginName)
```
    Generates new login credentials for the currently connected server query instance, using the given name.
    This will remove the current login credentials! You won't be logged out, but after disconnecting, the old credentials will no longer work. Make sure to not lock yourselves out!
    
    Parameters:
    
    loginName - the name for the server query login
    
    Returns:
    
    the generated password for the server query login
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    addServerQueryLogin(String, int), deleteServerQueryLogin(int), getServerQueryLogins()
    
    Number of query commands sent:
    
    1
  - uploadFile
```
public CommandFuture<Void> uploadFile(InputStream dataIn,
                                      long dataLength,
                                      String filePath,
                                      boolean overwrite,
                                      int channelId)
```
    Uploads a file to the file repository at a given path and channel by reading dataLength bytes from an open InputStream.
    It is the user's responsibility to ensure that the given InputStream is open and that dataLength bytes can eventually be read from it. The user is also responsible for closing the stream once the upload has finished.
    Note that this method will not read the entire file to memory and can thus upload arbitrarily sized files to the file repository.
    
    Parameters:
    
    dataIn - a stream that contains the data that should be uploaded
    
    dataLength - how many bytes should be read from the stream
    
    filePath - the path the file should have after being uploaded
    
    overwrite - if false, fails if there's already a file at filePath
    
    channelId - the ID of the channel to upload the file to
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), uploadFileDirect(byte[], String, boolean, int, String)
    
    Number of query commands sent:
    
    1
  - uploadFile
```
public CommandFuture<Void> uploadFile(InputStream dataIn,
                                      long dataLength,
                                      String filePath,
                                      boolean overwrite,
                                      int channelId,
                                      String channelPassword)
```
    Uploads a file to the file repository at a given path and channel by reading dataLength bytes from an open InputStream.
    It is the user's responsibility to ensure that the given InputStream is open and that dataLength bytes can eventually be read from it. The user is also responsible for closing the stream once the upload has finished.
    Note that this method will not read the entire file to memory and can thus upload arbitrarily sized files to the file repository.
    
    Parameters:
    
    dataIn - a stream that contains the data that should be uploaded
    
    dataLength - how many bytes should be read from the stream
    
    filePath - the path the file should have after being uploaded
    
    overwrite - if false, fails if there's already a file at filePath
    
    channelId - the ID of the channel to upload the file to
    
    channelPassword - that channel's password
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), uploadFileDirect(byte[], String, boolean, int, String)
    
    Number of query commands sent:
    
    1
  - uploadFileDirect
```
public CommandFuture<Void> uploadFileDirect(byte[] data,
                                            String filePath,
                                            boolean overwrite,
                                            int channelId)
```
    Uploads a file that is already stored in memory to the file repository at a given path and channel.
    
    Parameters:
    
    data - the file's data as a byte array
    
    filePath - the path the file should have after being uploaded
    
    overwrite - if false, fails if there's already a file at filePath
    
    channelId - the ID of the channel to upload the file to
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), uploadFile(InputStream, long, String, boolean, int)
    
    Number of query commands sent:
    
    1
  - uploadFileDirect
```
public CommandFuture<Void> uploadFileDirect(byte[] data,
                                            String filePath,
                                            boolean overwrite,
                                            int channelId,
                                            String channelPassword)
```
    Uploads a file that is already stored in memory to the file repository at a given path and channel.
    
    Parameters:
    
    data - the file's data as a byte array
    
    filePath - the path the file should have after being uploaded
    
    overwrite - if false, fails if there's already a file at filePath
    
    channelId - the ID of the channel to upload the file to
    
    channelPassword - that channel's password
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    FileInfo.getPath(), Channel.getId(), uploadFile(InputStream, long, String, boolean, int, String)
    
    Number of query commands sent:
    
    1
  - uploadIcon
```
public CommandFuture<Long> uploadIcon(InputStream dataIn,
                                      long dataLength)
```
    Uploads an icon to the icon directory in the file repository by reading dataLength bytes from an open InputStream.
    It is the user's responsibility to ensure that the given InputStream is open and that dataLength bytes can eventually be read from it. The user is also responsible for closing the stream once the upload has finished.
    Note that unlike the file upload methods, this will read the entire file to memory. This is because the CRC32 hash must be calculated before the icon can be uploaded. That means that all icon files must be less than 2³¹-1 bytes in size.
    Uploads that is already stored in memory to the icon directory in the file repository. If this icon has already been uploaded or if a hash collision occurs (CRC32), this command will fail.
    
    Parameters:
    
    dataIn - a stream that contains the data that should be uploaded
    
    dataLength - how many bytes should be read from the stream
    
    Returns:
    
    the ID of the uploaded icon
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    IconFile.getIconId(), uploadIconDirect(byte[]), downloadIcon(OutputStream, long)
    
    Number of query commands sent:
    
    1
  - uploadIconDirect
```
public CommandFuture<Long> uploadIconDirect(byte[] data)
```
    Uploads an icon that is already stored in memory to the icon directory in the file repository. If this icon has already been uploaded or if a CRC32 hash collision occurs, this command will fail.
    
    Parameters:
    
    data - the icon's data as a byte array
    
    Returns:
    
    the ID of the uploaded icon
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    TS3FileTransferFailedException - if the file transfer fails for any reason
    
    See Also:
    
    IconFile.getIconId(), uploadIcon(InputStream, long), downloadIconDirect(long)
    
    Number of query commands sent:
    
    1
  - usePrivilegeKey
```
public CommandFuture<Void> usePrivilegeKey(String token)
```
    Uses an existing privilege key to join a server or channel group.
    
    Parameters:
    
    token - the privilege key to use
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    PrivilegeKey, addPrivilegeKey(PrivilegeKeyType, int, int, String), usePrivilegeKey(PrivilegeKey)
    
    Number of query commands sent:
    
    1
  - usePrivilegeKey
```
public CommandFuture<Void> usePrivilegeKey(PrivilegeKey privilegeKey)
```
    Uses an existing privilege key to join a server or channel group.
    
    Parameters:
    
    privilegeKey - the privilege key to use
    
    Returns:
    
    a future to track the progress of this command
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    PrivilegeKey, addPrivilegeKey(PrivilegeKeyType, int, int, String), usePrivilegeKey(String)
    
    Number of query commands sent:
    
    1
  - whoAmI
```
public CommandFuture<ServerQueryInfo> whoAmI()
```
    Gets information about the current server query instance.
    
    Returns:
    
    information about the server query instance
    
    Throws:
    
    TS3CommandFailedException - if the execution of a command fails
    
    See Also:
    
    getClientInfo(int)
    
    Number of query commands sent:
    
    1

Class TS3ApiAsync

Method Summary

Methods inherited from class java.lang.Object

Method Detail

addBan

addBan

addChannelClientPermission

addChannelGroup

addChannelGroup

addChannelGroupPermission

addChannelPermission

addClientPermission

addClientPermission

addClientPermission

addClientToServerGroup

addComplaint

addPermissionToAllServerGroups

addPrivilegeKey

addPrivilegeKeyChannelGroup

addPrivilegeKeyServerGroup

addServerGroup

addServerGroup

addServerGroupPermission

addServerQueryLogin

addTS3Listeners

banClient

banClient

banClient

banClients

broadcast

copyChannelGroup

copyChannelGroup

copyServerGroup

copyServerGroup

createChannel

createFileDirectory

createFileDirectory

createServer

createServerSnapshot

deleteAllBans

deleteAllComplaints

deleteBan

deleteChannel

deleteChannel

deleteChannelClientPermission

deleteChannelGroup

deleteChannelGroup

deleteChannelGroupPermission

deleteChannelPermission

deleteClientPermission

deleteClientPermission

deleteClientPermission

deleteComplaint

deleteCustomClientProperty

deleteDatabaseClientProperties

deleteFile

deleteFile

deleteFiles

deleteFiles

deleteIcon

deleteIcons

deleteOfflineMessage

deletePermissionFromAllServerGroups

deletePrivilegeKey

deleteServer

deleteServerGroup

deleteServerGroup

deleteServerGroupPermission

deleteServerQueryLogin

deployServerSnapshot

deployServerSnapshot

downloadFile

downloadFile

downloadFileDirect

downloadFileDirect

downloadIcon

downloadIconDirect

editChannel

editChannel

editClient