Files
ts3java/ts3-client/docs/myteamspeak/CONFIG_SYNC.md
T
erikbrockoandClaude Opus 5.5 212a4bcdbb myTeamSpeak docs: the synced config item, sync edge cases and limits
CONFIG_SYNC.md lists the class 5 config item's fields; none maps onto a
setting of ours, so sync leaves it alone. IMPLEMENTATION.md covers the
session lock, duplicate keys in the account, bookmarks following an
identity's conflict, interrupted runs, and what sync cannot catch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 22:04:26 +00:00

2.7 KiB

myTeamSpeak config item (class 5)

Apart from bookmarks, identities and the other item classes, TS3 synchronises a small set of settings as Item_Class CONFIG (5), Item_Data field 21 Config_data. It is a fixed schema, not free key/value pairs, and an account holds a single such item. On the throwaway account it has the uuid 11111111-aaaa-aaaa-aaaa-aaaaaaaaaaaa, is encrypted like the other items, and decrypts to:

Item_Data { 2: "11111111-aaaa-aaaa-aaaa-aaaaaaaaaaaa"  6: 5  9: 1790376625
  21 { 1: 1  3: 1 } }        // default_subscribe_mode = All, show_user_badges = true

Fields

# Field Type Meaning in TS3 Ours
1 default_subscribe_mode int32 Channel subscription mode for servers without a bookmark of their own; same values as Bookmark_Data.SubscriptionMode (0 Undefined, 1 All, 2 Current). Toggled by onToggleSubscribeMode; replaced the local subscribemode.dat. None: we always subscribe to all channels
2 user_badges repeated string The myTeamSpeak badges the user picked to show, by badge UUID; announced to servers in client_badges (overwolf=n:badges=uuid,…). None: we neither pick nor announce badges
3 show_user_badges bool Whether the picked badges are shown at all. None
4 global_presence_token bytes myTeamSpeak presence token. None
5 tschat_credentials Chat_Credentials{domain, username, password} Login for the old (pre-Matrix) TeamSpeak chat. None
7 tschat_de_data repeated TSCHAT_DE_Data{url, identity, username, server_id, address, port, name} Per-server data for the old chat. None

Per-bookmark settings of the same kind (subscription_mode 19, subscribed_channel_ids 20, channel_passwords 21) live in Bookmark_Data and survive our edits, which rewrite only the fields we model.

Audio settings (devices, volumes, voice activation, pre-processing) are not synchronised at all. A bookmark only names its capture and playback profile (capture_profile 11, playback_profile 12) and sound pack (17); the profiles themselves stay local.

Status

None of these fields maps onto a setting our client has, so MyTeamSpeakSync leaves class 5 alone: it neither reads nor writes the config item, and the official client's copy is never touched. Candidates, if the settings are added first:

  • default_subscribe_mode (+ bookmark subscription_mode): a "subscribe to all / only the current channel" choice.
  • user_badges / show_user_badges: choosing badges needs the badge list from myTeamSpeak (Badges_Service, UserBadgesList), so it is more than a sync field.

The rest belongs to the old TeamSpeak chat and presence, which we do not implement.