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>
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user