Variablen-Parameter in TeamSpeak 3

Dieses Dokument enthält eine Liste von Variablenparametern, die sich ändern lassen.

Inhaltsverzeichnis

Client-Variablen

Spalten:

clientlist: Grünes Häkchen für Minimalinfos, gelbes Häkchen mit Schaltername (Bindestrich am Anfang bitte selbst dazudenken) für optionale Eigenschaften, leer falls grundsätzlich nicht vorhanden
clientinfo: Grünes Häkchen falls vorhanden, leer falls nicht
notifycliententerview: Grünes Häkchen falls vorhanden, leer falls nicht
clientupdate: Grünes Häkchen falls änderbar, gelbes Häkchen falls änderbar aber ohne offensichtlichen (egal ob sinnlosen) Effekt bei Query-Clients, roter Kreis falls nicht änderbar, leer falls als logischen Gründen nicht getestet
clientedit: Grünes Häkchen falls änderbar, roter Kreis falls nicht, leer falls als logischen Gründen nicht getestet
Doku: Grünes Häkchen falls laut Query-Manual angeblich änderbar, roter Kreis falls nicht, leer falls Eigenschaft nicht erwähnt (bitte beachte, dass diese Zeile Schwachsinn enthält und nur zum Vergleich enthalten ist)
clientdblist: Grünes Häkchen falls vorhanden, gelbes Häkchen falls entgegen offizieller Dokumentation vorhanden, leer falls nicht vorhanden
clientdbinfo: Grünes Häkchen falls vorhanden, gelbes Häkchen falls entgegen offizieller Dokumentation vorhanden, leer falls nicht vorhanden
clientdbedit: Grünes Häkchen falls änderbar, leer falls als logischen Gründen nicht getestet

Eigenschaft ~list ~info notify~
enterview ~update ~edit Doku ~dblist ~dbinfo ~dbedit

cid (Channel-ID) ²

clid (vorzeichenlose 16-Bit-Zahl) N/A

client_idle_time (in Sekunden) times

client_unique_identifier uid

client_nickname

client_version info

client_platform info

client_input_muted voice

client_output_muted voice

client_outputonly_muted

client_input_hardware voice

client_output_hardware voice

client_default_channel

client_meta_data (veraltet)

client_is_recording voice

client_version_sign (unbekannter 512-Bit-Base64-Hash)

client_security_hash (nur im SDK verwendet)

client_login_name (falls Query-Client)

client_database_id ³ N/A³

client_channel_group_id groups

client_servergroups (durch Kommas getrennt) groups

client_created times

client_lastconnected times

client_totalconnections

client_away away

client_away_message away

client_type

client_flag_avatar (kein Flag sondern MD5-Hash des Avatars) ¹

client_talk_power voice

client_talk_request

client_talk_request_msg

client_description

client_is_talker (darf normal nicht reden, gerade aber schon) voice

client_month_bytes_uploaded

client_month_bytes_downloaded

client_total_bytes_uploaded

client_total_bytes_downloaded

client_is_priority_speaker (änderbar als Recht) voice

client_unread_messages

client_nickname_phonetic

client_needed_serverquery_view_power (änderbar als Recht)

client_default_token

client_icon_id (vorzeichenbehaftet, änderbar als Recht) icon ⁵ ⁷

client_is_channel_commander voice

client_country (Großbritannien ist UK) country

client_channel_group_inherited_channel_id groups

client_badges⁶ badges

client_base64HashClientUID (Avatar-Dateiname)

connection_filetransfer_bandwidth_sent

connection_filetransfer_bandwidth_received

connection_packets_sent_total

connection_bytes_sent_total

connection_packets_received_total

connection_bytes_received_total

connection_bandwidth_sent_last_second_total

connection_bandwidth_sent_last_minute_total

connection_bandwidth_received_last_second_total

connection_bandwidth_received_last_minute_total

connection_connected_time

connection_client_ip ⁴ ⁴

client_flag_is_talking (redet gerade) voice

Es gibt noch clientgetnamefromdbid, der aber nur client_unique_identifier als cluid, client_database_id als cldbid und client_nickname als name zurückgibt und deshalb clientdbinfo unterlegen ist. clientgetnamefromuid gibt die gleiche Ausgabe und ist der Kombination aus clientdbfind (das, obgleich sinnlos, Wildcards auch für UIDs unterstützt) und clientdbinfo unterlegen.

Fußnoten:: ¹ = änderbar für Clients mit normaler UID (nicht änderbar für reine Query-Accounts) und muss nach dem Hochladen eines Avatars geändert werden, damit alle Clients diesen (erneut) herunterladen; ² = als ctid; ³ = als cldbid; ⁴ = als client_lastip (wird erst seit Serverversion 3.0.8 in der Datenbank gespeichert, obwohl der Parameter schon seit mindestens 3.0.0 leer zurückgegeben wird); ⁵ = in 3.2.0 entfernt, davor defekt da immer 0; ⁶ = String mit den Parametern overwolf (zeitweise Overwolf) mit 0 oder 1 als Wert (getrennt durch Gleichzeichen) sowie badges mit einer Kette an Abzeichen-GUIDs (getrennt durch Gleichzeichen), getrennt durch Doppelpunkt (ganz früher \s oder Komma glaube ich); ⁷ = clientaddperm verwenden; N/A = nicht anwendbar (Parameter dient zur Identifikation)

In (Server-?)Versionen vor etwa 3.0.11 war es möglich, sich mit clientupdate zu muten (Mikrofon und Lautsprecher) und eine Aufnahme zu starten. Ersteres wurde im Client angezeigt, letzteres konnte man wunderbar zum Trollen nutzen, da der Sound abgespielt wurde, die meisten Leute aber niemanden sehen konnten. Wahrscheinlich wurde es auch genau deshalb entfernt. Man kann Leute aber immer noch durchs Anfordern von Talk-Power trollen (wenn man denn zu wenig Talkpower hat).

Channel-Variablen

Spalten:

channellist: Grünes Häkchen für Minimalinfos, gelbes Häkchen mit Schaltername (Bindestrich am Anfang bitte selbst dazudenken) für optionale Eigenschaften, leer falls grundsätzlich nicht vorhanden
channelinfo: Grünes Häkchen falls vorhanden, roter Kreis falls nicht
notifychannelcreated: Grünes Häkchen falls vorhanden, leer falls nicht
notifychanneledited: Grünes Häkchen falls vorhanden, leer falls nicht
notifychannelmoved: Grünes Häkchen falls vorhanden, leer falls nicht
channeledit: Grünes Häkchen falls änderbar, gelbes Häkchen falls unter bestimmten Bedingungen änderbar (siehe Fußnote), roter Kreis falls nicht änderbar
channelmove: Grünes Häkchen falls änderbar, leer falls nicht
channelcreate: Grünes Häkchen falls setzbar, gelbes Häkchen falls unter bestimmten Bedingungen setzbar, rot falls Fehler (siehe Fußnote), leer falls ignoriert
Doku: Grünes Häkchen falls laut Query-Manual angeblich änderbar, roter Kreis falls nicht, leer falls Eigenschaft nicht erwähnt (bitte beachte, dass diese Zeile Schwachsinn enthält und nur zum Vergleich enthalten ist)

Eigenschaft ~list ~info notify~
created notify~
edited notify~
moved ~edit ~move ~create Doku

cid N/A

pid (Elternchannel) ² ² ² ² ²

channel_name

channel_topic topic

channel_description

channel_password⁶

channel_codec voice

channel_codec_quality voice

channel_maxclients limits

channel_maxfamilyclients limits

channel_order ³ ³

channel_flag_permanent flags

channel_flag_semi_permanent flags

channel_flag_temporary existiert überhaupt nicht

channel_flag_default flags

channel_flag_password¹ flags

channel_codec_latency_factor

channel_codec_is_unencrypted

channel_security_salt (nur im SDK verwendet) ¹⁵³⁸

channel_delete_delay ⁵ ⁵

channel_flag_maxclients_unlimited

channel_flag_maxfamilyclients_unlimited

channel_flag_maxfamilyclients_inherited

channel_filepath ¹⁷⁹⁶ ¹⁷⁹⁶

channel_needed_talk_power (auch änderbar als Recht) voice

channel_forced_silence

channel_name_phonetic

channel_icon_id (änderbar als Recht) icon ⁴ ¹⁵³⁸

channel_flag_private

seconds_empty secondsempty

total_clients

total_clients_family limits

channel_needed_subscribe_power (änderbar als Recht)

Fußnoten:: ¹ = wird beim Ändern von channel_password automatisch mitgeändert, kann aber auch manuell gesetzt werden (in dem Fall ist das Passwort entweder das letzte oder ein leeres Passwort, perfekt zum Trollen); werden beide gleichzeitig gesetzt, hat channel_password unabhängig von der Reihenfolge Priorität; ² = als cpid; ³ = als order; ⁴ = Änderung geht nach Neustart des Servers verloren; ⁵ = nur falls nicht falls permanent, sonst ¹⁵³⁸; ⁶ = Server-Query-Clients setzen es im Klartext, ansonsten wird SHA-1 als Base64 verwendet.
Was hier zurückgegeben wird, ist: Base64(SHA1(Base64(SHA1(Klartext))+virtualserver_keypair)); ¹⁵³⁸ = invalid parameter; ¹⁷⁹⁶ = currently not possible; N/A = nicht anwendbar (Parameter dient zur Identifikation)

Die nicht erwähnten Channel-Notifys enthalten keine der hier genannten Parameter.

Server-Variablen

Spalten:

serverlist: Grünes Häkchen für Minimalinfos, gelbes Häkchen mit Schaltername (Bindestrich am Anfang bitte selbst dazudenken) für optionale Eigenschaften, leer falls grundsätzlich nicht vorhanden
serverinfo: Grünes Häkchen falls vorhanden (alles ist vorhanden)
serverinfo Server-Vorlage: Grünes Häkchen falls vorhanden, rot falls defekt, leer falls nicht vorhanden
serverrequestconnectioninfo: Grünes Häkchen falls vorhanden, gelbes Häkchen falls änderbar aber ohne offensichtlichen (egal ob sinnlosen) Effekt bei Query-Clients, roter Kreis falls nicht änderbar, leer falls als logischen Gründen nicht getestet
serveredit: Grünes Häkchen falls änderbar, gelbes Häkchen falls änderbar aber ohne offensichtlichen Effekt, leer falls nicht
notifyserveredited: Grünes Häkchen falls bei der Benachrichtigung der Anlass der Änderung mitgeschickt wird (man wird auch über andere, wenn nicht sogar alle Änderungen informiert)
Doku: Grünes Häkchen falls laut Query-Manual angeblich änderbar, roter Kreis falls nicht, leer falls Eigenschaft nicht erwähnt (ist anders als bei Clients und Channels sogar überwiegend richtig)

Eigenschaft ~list ~info ~info
Server-
Vorlage ~request
connection
info ~edit notify~
edited Doku

virtualserver_unique_identifier uid ⁵

virtualserver_name ⁷

virtualserver_welcomemessage

virtualserver_platform

virtualserver_version

virtualserver_maxclients ¹

virtualserver_password (unbekannter 160-Bit-Base64-Hash⁸)

virtualserver_clientsonline ¹

virtualserver_channelsonline

virtualserver_created ⁹ ⁶

virtualserver_uptime ¹ ²

virtualserver_codec_encryption_mode

virtualserver_hostmessage

virtualserver_hostmessage_mode

virtualserver_filebase

virtualserver_default_server_group

virtualserver_default_channel_group

virtualserver_flag_password

virtualserver_default_channel_admin_group

virtualserver_max_download_total_bandwidth

virtualserver_max_upload_total_bandwidth

virtualserver_hostbanner_url

virtualserver_hostbanner_gfx_url

virtualserver_hostbanner_gfx_interval (in Sekunden, mindestens 60)

virtualserver_complain_autoban_count

virtualserver_complain_autoban_time

virtualserver_complain_remove_time

virtualserver_min_clients_in_channel_before_forced_silence

virtualserver_priority_speaker_dimm_modificator

virtualserver_id

virtualserver_antiflood_points_tick_reduce

virtualserver_antiflood_points_needed_command_block

virtualserver_antiflood_points_needed_ip_block

virtualserver_client_connections

virtualserver_query_client_connections

virtualserver_hostbutton_tooltip

virtualserver_hostbutton_url

virtualserver_hostbutton_gfx_url

virtualserver_queryclientsonline ¹

virtualserver_download_quota

virtualserver_upload_quota

virtualserver_month_bytes_downloaded

virtualserver_month_bytes_uploaded

virtualserver_total_bytes_downloaded

virtualserver_total_bytes_uploaded

virtualserver_port

virtualserver_autostart ⁷

virtualserver_machine_id ⁷

virtualserver_needed_identity_security_level

virtualserver_log_client

virtualserver_log_query

virtualserver_log_channel

virtualserver_log_permissions

virtualserver_log_server

virtualserver_log_filetransfer

virtualserver_min_client_version

virtualserver_name_phonetic

virtualserver_icon_id

virtualserver_reserved_slots

virtualserver_total_packetloss_speech (dimensionslos)

virtualserver_total_packetloss_keepalive (dimensionslos)

virtualserver_total_packetloss_control (dimensionslos)

virtualserver_total_packetloss_total (dimensionslos) ³

virtualserver_total_ping (in Millisekunden) ⁴

virtualserver_ip

virtualserver_weblist_enabled

virtualserver_ask_for_privilegekey

virtualserver_hostbanner_mode

virtualserver_channel_temp_delete_delay_default

virtualserver_status

connection_filetransfer_bandwidth_sent

connection_filetransfer_bandwidth_received

connection_filetransfer_bytes_sent_total

connection_filetransfer_bytes_received_total

connection_packets_sent_speech

connection_bytes_sent_speech

connection_packets_received_speech

connection_bytes_received_speech

connection_packets_sent_keepalive

connection_bytes_sent_keepalive

connection_packets_received_keepalive

connection_bytes_received_keepalive

connection_packets_sent_control

connection_bytes_sent_control

connection_packets_received_control

connection_bytes_received_control

connection_packets_sent_total

connection_bytes_sent_total

connection_packets_received_total

connection_bytes_received_total

connection_bandwidth_sent_last_second_total

connection_bandwidth_sent_last_minute_total

connection_bandwidth_received_last_second_total

connection_bandwidth_received_last_minute_total

Fußnoten:: ¹ = nicht falls server offline oder mit -short; ² = als connection_connected_time; ³ = als connection_packetloss_total; ⁴ = als connection_ping; ⁵ = immer leer; ⁶ = immer 0 (früher identisch zur Startzeit der Instanz, glaube ich); ⁷ = nicht mit -short; ⁸ = siehe Channel-Fußnote 6; ⁹ = wurde für den Standardserver mal eine Zeit lang bis einschließlich 3.0.12.4 nicht gesetzt (=0)

Weiterhin ist virtualserver_keypair in Schnappschüssen zu finden. Aus diesem Wert wird die UID berechnet – obwohl letzte, genau wie der ebenfalls ignorierte Port (neuer Server: wird automatisch vergeben; überschreiben: wird übernommen), im Snapshot gespeichert ist (seit 2015/2016 rum irgendwie nicht mehr scheint mir). Das Keypair ist 888 Bit lang und in Base64 kodiert. Es werden bestimmte Ansprüche an den Wert gestellt; einen Zufallswert anzugeben führt zu einem Einfrieren der Serverinstanz oder zu lustigen Fehlern, die das Starten des Servers verhindern. Dieser Wert wird zum Hashen der Passwörter verwendet, das Ändern des Keypairs macht also in jedem Fall sämtliche Passwörter ungültig.

Traffic

Bei Angaben zu Traffic existieren die Begriffe upload, download, sent und received.

Hierbei bedeuten upload und received dasselbe, ebenso wie download und sent bedeutungsgleich sind. Das ist nicht ganz eingängig, insbesondere bei den Eigenschaften zum Dateitraffic eines virtuellen Servers: Während der Dateitraffic für diesen Monat (virtualserver_month_bytes_*loaded) und für alle Zeiten (virtualserver_total_bytes_*loaded) die Namen downloaded und uploaded verwendet (und sich auf beendete Übertragungen beziehen), verwendet der Dateientraffic seit Start (connection_filetransfer_bytes_*_total) die Namen sent und received (bezieht sich aber auf aktuellen Traffic).

Kurzum lässt sich sagen, dass upload und download immer Clientsicht sind (und außerdem nur beendete Dateitransfers enthalten anstatt in Echtzeit zu zählen), während sent und received immer die Serversicht darstellen.

Alle Angaben sind in Byte, außer bei Rechten, dort sind sie in Mebibyte, weil sonst bei dem Wertebereich von Rechten bei 2 GiB (bzw. 1 Byte weniger um genau zu sein) Ende wäre.

Sind für virtualserver_max_download_total_bandwidth und virtualserver_max_upload_total_bandwidth andere Werte als für serverinstance_max_download_total_bandwidth und serverinstance_max_upload_total_bandwidth eingestellt, gilt der jeweils niedrigere Wert. Sie gelten jeweils nur für Dateientraffic. Laufen mehrere derartige Übertragungen wird die eingestellte Bandbreite gleichmäßig auf alle Übertragungen aufgeteilt. Im Test sorgten Uploadraten von 10.000 B/s für ständige Verbindungsabbrüche beim Dateiupload. Für Downloads habe ich das nicht getestet.