- function-inventory: complete public API for 10 Rust crates + 56 Dart files - coverage-analysis: 312 Rust tests, 221 Dart tests, doc coverage gaps - doc-quality-analysis: duplications, broken refs, useless content audit - link-coverage-report: all internal/external links validated - external/teaspeak: TeaSpeak voice server architecture & protocol - external/respeak: ReSpeak org, tsclientlib, tsproto, crypto docs - external/yatqa-en/de: yat.qa admin tool (English + German) - reviews/: cross-validation reports for all analyses All documentation only, no code changes.
349 lines
14 KiB
Markdown
349 lines
14 KiB
Markdown
# YaTQA Wissensdatenbank (Deutsch)
|
||
|
||
> Quelle: https://yat.qa/ — Abgerufen: 13.06.2026
|
||
> Version: v3.9.9b (01. Mrz 2023)
|
||
|
||
## Überblick
|
||
|
||
**YaTQA** (Yet Another TeamSpeak³ Query Admin Tool) ist eine Windows-Anwendung zur Verwaltung von **TeamSpeak-3-Servern und -Instanzen** über das ServerQuery-Interface. Es bietet eine grafische Oberfläche für alle Query-Befehle und macht das Erlernen der rohen Query-Syntax überflüssig.
|
||
|
||
- **Autor:** Janni „Яedeemer" K. (Norddeutschland)
|
||
- **Sprache:** Geschrieben in Delphi 2009 (über 50.000 Zeilen Quelltext)
|
||
- **Entwicklungsbeginn:** 10. April 2011
|
||
- **Erstveröffentlichung:** 29. Juni 2011
|
||
- **Lizenz:** Kostenlos und voll funktionsfähig (keine Adware/Spyware)
|
||
- **Plattformen:** Windows XP und neuer, Linux mittels Wine
|
||
- **Größe:** ~1,3 MiB Installer
|
||
- **Enthaltene Sprachen:** Deutsch und Englisch (Auswahl während der Installation)
|
||
- **Unterstützte Server:** TeamSpeak 3.9.0 bis 3.13.7, TeaSpeak 1.4.10-beta
|
||
- **Download:** https://dl.yat.qa/stable/
|
||
- **Website:** https://yat.qa/
|
||
|
||
### Motto
|
||
*„Dinosaurier haben kein TeamSpeak benutzt und sind vor 66 Millionen Jahren ausgestorben. Zufall? Vermutlich nicht."*
|
||
|
||
---
|
||
|
||
## Funktionen
|
||
|
||
**YaTQA unterstützt alle ServerQuery-Funktionen ohne Ausnahme.** Die folgende Liste beschränkt sich auf Funktionen, die der normale TS-Client nicht bietet.
|
||
|
||
### Allgemeine Funktionen (Kein Admin erforderlich)
|
||
|
||
- **DNS-Auflösung:** Detaillierte Visualisierung der DNS-Auflösung (simuliert 10 verschiedene Client-Versionen)
|
||
- **Blacklist-Prüfung:** TeamSpeaks Blacklist auf eine IP überprüfen
|
||
- **Blacklist2:** TeamSpeaks Blacklist2 für virtuelle Server prüfen
|
||
- **Benutzerdiagramm:** Serverstatistiken von Planet TeamSpeak als Diagramm anzeigen und als PNG speichern
|
||
- **Client-Cache:** Avatare, Icons und Chatlogs im Client-Cache finden
|
||
|
||
### Konsole (Query-Interface)
|
||
|
||
- **Autovervollständigung:** Befehlsvervollständigung einschließlich undokumentierter Befehle
|
||
- **Parameterhilfe:** Zeigt alle Parameter eines Befehls basierend auf eigener Forschung
|
||
- **Werteauswahl:** Strg+Leertaste für Werteliste
|
||
- **Ergebnisanalyse:** Gruppierte Datensätze mit Erklärungen
|
||
- **Skripting:** Befehlslisten aus Dateien laden und ausführen
|
||
- **Events:** Server-Events abonnieren und in der Konsole protokollieren
|
||
|
||
### SSH-Tunnel
|
||
|
||
- **Verschlüsselung:** Vollständig verschlüsselte Verbindung (außer Dateiübertragungen)
|
||
- **Geschwindigkeit:** Auf vielen Servern merkbar schneller (ähnlich wie `tcp_nodelay`)
|
||
- **Privatsphäre:** IP wird immer verborgen (man erscheint als 127.0.0.1)
|
||
- **Flood-Umgehung:** Umgeht alle Flood-Beschränkungen (127.0.0.1 steht üblicherweise auf der Whitelist)
|
||
|
||
### Instanz-Funktionen (Erfordert serveradmin)
|
||
|
||
- Instanzstatistiken anzeigen/bearbeiten
|
||
- Lizenzdetails und IP-Bindings anzeigen
|
||
- Alle virtuellen Server anzeigen
|
||
- Lokale Notizen zu Servern erstellen (lokal gespeichert)
|
||
- Virtuelle Server starten/stoppen/erstellen/löschen/umbenennen
|
||
- Unsichtbar werden (Server-Fehler, könnte behoben werden)
|
||
- Nachricht an alle Server senden
|
||
- Snapshots erstellen/massenweise erstellen/wiederherstellen (inkl. Dateien)
|
||
- Manipulierte Snapshots einspielen
|
||
- Server mittels Snapshots kopieren
|
||
- Rechte auf Vorlagengruppen zurücksetzen
|
||
- Channel-Datei-Backups speichern/wiederherstellen (inkrementelles Backup unterstützt)
|
||
|
||
### Funktionen für virtuelle Server
|
||
|
||
- Host-Message-Modal-Quit und hohe Sicherheitsstufe ignorieren
|
||
- Sehr detaillierte Serverstatistiken
|
||
- Mehrere Server gleichzeitig bearbeiten
|
||
- Ausklappbarer Serverbaum (optional immer im Vordergrund)
|
||
- Mehrere Nutzer gleichzeitig verschieben/kicken/bannen/beschreiben
|
||
- Mehrere Channel gleichzeitig erstellen
|
||
- Channel als Vorlage für weitere verwenden
|
||
- Mehrere Channel gleichzeitig bearbeiten
|
||
- Nachrichten an mehrere Nutzer/Channel gleichzeitig senden
|
||
- Rechte mehrerer Nutzer/Channel gleichzeitig bearbeiten
|
||
- Dateien zwischen Channeln verschieben
|
||
- Bildvorschau ohne Download (bmp, gif, jpg, png, pbm, pgm, ppm, xbm, xpm)
|
||
- Upload/Download ganzer Ordnerstrukturen
|
||
- Nutzer zu Gruppen hinzufügen durch Namenseingabe
|
||
- Funktionierende Rechteübersicht mit Echtzeitbearbeitung
|
||
- Rechte zwischen Servern/Instanzen kopieren
|
||
- Rechtewerte und -powers vergleichen
|
||
- Alle Clients/Gruppen mit einem bestimmten Recht finden
|
||
- Mehrere Gruppen gleichzeitig bearbeiten
|
||
- Verbesserte Clientdatenbank mit mehr Details und Suchfunktionen
|
||
- Gesamte Clientdatenbank mit einem Klick herunterladen
|
||
- Clientdatenbank als HTML oder CSV exportieren
|
||
- Gebannte Nutzer und IP-teilende Profile hervorheben
|
||
- Log an beliebiger Stelle lesen
|
||
- User CustomInfo verwalten (suchen, anzeigen, bearbeiten, hinzufügen)
|
||
- Log als HTML oder TXT exportieren
|
||
- Avatare und Icons herunterladen
|
||
- Avatar-Besitzer auf dem Server identifizieren
|
||
- Servervorlage verwalten
|
||
- Uploads/Downloads überwachen
|
||
|
||
### Unterstützte Bildformate
|
||
|
||
| Format | Beschreibung |
|
||
|--------|-------------|
|
||
| bmp | Windows Bitmap |
|
||
| gif | Graphics Interchange Format |
|
||
| jpg/jpeg | Joint Photographic Experts Group |
|
||
| png | Portable Network Graphics |
|
||
| pbm | Portable Bitmap (ASCII und binär) |
|
||
| pgm | Portable Graymap (ASCII und binär) |
|
||
| ppm | Portable Pixmap (ASCII und binär) |
|
||
| xbm | X BitMap |
|
||
| xpm | X PixMap |
|
||
|
||
---
|
||
|
||
## Architektur / Funktionsweise
|
||
|
||
### Verbindungsmethoden
|
||
- **Raw TCP/Telnet:** Standard-Query-Verbindung (Standardport 10011)
|
||
- **YaTQA-SSH-Tunnel:** Über Plink (PuTTY-Suite) — verschlüsselt, schneller, IP verborgen
|
||
- **TeamSpeak SSH:** Natives TS3.3+-SSH (auch unterstützt, aber weniger Vorteile)
|
||
|
||
### Datenspeicherung
|
||
- **Portable Modus:** Alle Daten im Installationsverzeichnis (`yatqa.ini` vorhanden)
|
||
- **Standardmodus:** Einige Dateien in `%APPDATA%\YaTQA`
|
||
- **Icon-Cache:** 16-Bit-RES-Format (`icons.res`)
|
||
- **Befehlsverlauf:** `commandhistory.txt`
|
||
- **Debug-Log:** `RedeemerTS3.log` (erstellt mit `-debug`-Schalter)
|
||
|
||
### DNS-Auflösung
|
||
YaTQA simuliert die Auflösungsschritte des TeamSpeak-Clients und zeigt sie visuell an. Verwendet Googles DNS-Server für Zuverlässigkeit. Unterstützt:
|
||
- A- und CNAME-Einträge
|
||
- SRV-Einträge
|
||
- TSDNS-Auflösung
|
||
- Alle 10 verschiedenen Client-Version-DNS-Verhaltensweisen
|
||
|
||
### Snapshot-System
|
||
- Snapshots enthalten alle Servereinstellungen (außer Port und Server-ID)
|
||
- Snapshots enthalten KEINE Dateien, Icons oder Avatare
|
||
- Datei-Backups enthalten Dateien und Icons (keine Avatare wegen Serverbeschränkungen)
|
||
- Pseudo-Snapshots ermöglichen Serverkopien ohne Keypair
|
||
- Unterstützt Zstd-komprimierte Snapshots (3.10.0+-Format)
|
||
|
||
### Anti-Flood-Schutz
|
||
- Konfigurierbare „Befehle bis Flood"-Einstellung (empfohlen: ~20)
|
||
- Konfigurierbare Verzögerung zwischen Befehlen (empfohlen: 340ms für fremde Server)
|
||
- SSH-Verbindungen umgehen Flood-Beschränkungen (127.0.0.1 auf Whitelist)
|
||
|
||
---
|
||
|
||
## Konfiguration
|
||
|
||
### Anwendungseinstellungen
|
||
|
||
| Einstellung | Beschreibung |
|
||
|------------|-------------|
|
||
| Verbesserte XP-Unicode-Anzeige | Verwendet Arial Unicode MS für bessere CJK-Unterstützung |
|
||
| Daten bei Tabwechsel aktualisieren | Automatisch Daten aktualisieren |
|
||
| Lokale Zeit verwenden | Lokale Zeit statt UTC |
|
||
| Verbesserte Channel-Dropdowns | Baumansicht für Unterchannel |
|
||
| In den Tray minimieren | Minimieren in den Systemtray |
|
||
| Tray-Icon immer anzeigen | Permanent anzeigen |
|
||
| Icon-Caching aktivieren | Icons in `icons.res` cachen (empfohlen) |
|
||
| Keine Icons verwenden | Icon-Anzeige deaktivieren |
|
||
| Windows Aero verwenden | Aero-Design nutzen (Vista+) |
|
||
| Aero-Glow deaktivieren | Weißen Schatten hinter Menütext entfernen |
|
||
| Beim Start nach Updates suchen | Automatisch nach Updates suchen |
|
||
| Sortiereinstellungen speichern | Sortierpräferenzen merken |
|
||
| Sprunglisten aktivieren | Windows 7+-Sprunglisten-Integration |
|
||
|
||
### Kompatibilitätseinstellungen
|
||
|
||
| Einstellung | Beschreibung |
|
||
|------------|-------------|
|
||
| Befehle bis Flood | Verzögerung zwischen Befehlen (340 empfohlen für fremde Server) |
|
||
| Nicht-Standard-Query-Port erlauben | Verbindung zu anderen Ports als 10011 |
|
||
| Löschen wichtiger Gruppen erlauben | Löschen der ersten 5 Server-/4 Channelgruppen erlauben |
|
||
| Verlassen wichtiger Gruppen erlauben | serveradmin darf Admin Server Query verlassen |
|
||
| Machine-ID ändern erlauben | Änderung der Machine-ID ermöglichen |
|
||
|
||
### SSH-Tunnel-Profile
|
||
SSH-Profile für Server konfigurieren. Bei Verbindung zu einem Server mit passendem SSH-Profil verwendet YaTQA automatisch den Tunnel.
|
||
|
||
### Kreisdiagramm-Styles
|
||
Auswahl aus 4 verschiedenen Kreisdiagramm-Styles (durch Benutzerabstimmung ausgewählt).
|
||
|
||
---
|
||
|
||
## Startparameter
|
||
|
||
| Parameter | Beschreibung |
|
||
|-----------|-------------|
|
||
| `-a` | Verbindung zum Standardserver |
|
||
| `-b [IP]` | Blacklist-Prüfung |
|
||
| `-c IP Query_Port [User Pass [Voice_Port]]` | Verbindung zum angegebenen Server |
|
||
| `-d` | DNS-Auflösung |
|
||
| `-i` | Iconsammlung |
|
||
| `-p` | Rechtedateien-Editor |
|
||
| `-s [IP]` | Benutzerstatistik |
|
||
| `-debug` | Debug-Logging aktivieren |
|
||
|
||
---
|
||
|
||
## Systemanforderungen
|
||
|
||
### Mindestanforderungen
|
||
- **Betriebssystem:** Windows XP+ (Desktop), Windows 2012+ (Server)
|
||
- **Speicher:** 3 MB für YaTQA (mehr für Konfiguration/Snapshots)
|
||
- **Auflösung:** 960×720 (allgemein), 1024×720 (Serverbaum), 1024×768 (Konsole)
|
||
|
||
### Fehlende Funktionen unter Windows XP
|
||
- Geist-Modus
|
||
- Nameserver für DNS-Auflösung ändern
|
||
- Einklappbare DNS-Ergebnisse
|
||
- Einklappbare Gruppen im Servergruppenmodus der Benutzer-DB
|
||
|
||
### Fehlende Funktionen unter Windows Vista/XP
|
||
- Sprunglisten
|
||
|
||
### Wine/Linux-Einschränkungen
|
||
- Speicherlecks (Wine unterstützt kein Entfernen von Link-Labels)
|
||
- Auch unter XP fehlende Funktionen fehlen unter Wine
|
||
- Zusätzliche Einschränkungen: Keine Array-Gruppierung, keine DNS-Gruppierung, kein Servergruppenmodus in der Benutzer-DB
|
||
- Plink muss manuell installiert werden (Version 0.61+)
|
||
|
||
---
|
||
|
||
## Schlüsselkonzepte
|
||
|
||
### ServerQuery-Interface
|
||
Das TeamSpeak-3-ServerQuery-Interface ist ein textbasiertes Protokoll zur Serververwaltung. YaTQA kapselt diese Schnittstelle in einer GUI mit:
|
||
- Befehlsautovervollständigung
|
||
- Parameterhilfe
|
||
- Werteauswahl
|
||
- Ergebnisanalyse
|
||
|
||
### Virtueller Server
|
||
Ein virtueller Server ist eine unabhängige TeamSpeak-Serverinstanz, die auf einem einzelnen physischen Serverprozess läuft. Mehrere virtuelle Server können auf einer Instanz laufen.
|
||
|
||
### Instanz
|
||
Der Serverprozess, der einen oder mehrere virtuelle Server hostet. Verwaltet über den „serveradmin"-Account.
|
||
|
||
### Snapshot
|
||
Ein vollständiges Backup der Einstellungen eines virtuellen Servers (ohne Port und ID). Enthält keine Dateien, Icons oder Avatare.
|
||
|
||
### Pseudo-Snapshot
|
||
Ein vom Benutzer manipulierter Snapshot, der zum Kopieren von Servern ohne Beibehaltung des originalen Keypairs verwendet werden kann.
|
||
|
||
### Rechtesystem
|
||
TeamSpeak verwendet ein hierarchisches Rechtesystem mit:
|
||
- Servergruppen
|
||
- Channelgruppen
|
||
- Client-Rechte
|
||
- Rechte-Powers (Werte, die steuern, was gesetzt werden kann)
|
||
|
||
### Anti-Flood
|
||
TeamSpeak-Server begrenzen die Häufigkeit von Query-Befehlen. YaTQA bietet konfigurierbare Verzögerungen und „Befehle bis Flood"-Einstellungen, um Bans zu vermeiden.
|
||
|
||
### Blacklist / Blacklist2
|
||
TeamSpeak führt Blacklists gebannter IPs (Blacklist1) und Server-UIDs (Blacklist2).
|
||
|
||
### Abzeichen
|
||
Visuelle Indikatoren im TeamSpeak, die Benutzerstatus, Addon-Creator-Status usw. anzeigen. YaTQA kann Abzeichen konfigurieren.
|
||
|
||
### DNS-Auflösung
|
||
TeamSpeak-Clients lösen Serveradressen über mehrere Methoden auf: A-Einträge, CNAME, SRV-Einträge und TSDNS. YaTQA visualisiert diesen Prozess.
|
||
|
||
---
|
||
|
||
## Bekannte Einschränkungen
|
||
|
||
- **Channel-Passwörter:** YaTQA sendet grundsätzlich keine Channel-Passwörter. Erfordert `b_channel_join_ignore_password` und `b_ft_ignore_password`-Rechte.
|
||
- **Unicode:** Nur Basic Multilingual Plane (BMP) unterstützt (TeamSpeak-Einschränkung).
|
||
- **Integrierte DNS-Auflösung:** Nur A- und CNAME-Einträge (TSDNS und SRV im integrierten Resolver nicht unterstützt).
|
||
- **Geist-Modus:** Viele Funktionen funktionieren nicht; Geist hat nur Query-Gast-Rechte.
|
||
- **Konsole:** Nur die üblichen Einschränkungen des TS3-Servers.
|
||
|
||
---
|
||
|
||
## IPv6-Unterstützung
|
||
|
||
Eckige Klammern `[]` um die Serveradresse schreiben. Unterstützt seit v1.4/2.0-pre für Query-Verbindungen. IPv4-Tunnel (z.B. `[::ffff:7f00:1]`) werden nicht unterstützt.
|
||
|
||
---
|
||
|
||
## Projekthistorie
|
||
|
||
- **10.04.2011:** Entwicklungsbeginn (ursprünglich „TS3Telnet" genannt)
|
||
- **29.06.2011:** Erste Alpha-Version veröffentlicht
|
||
- **18.04.2014:** v2.0 führte Registrierungserfordernis für einige Funktionen ein
|
||
- **22.08.2019:** YaTQA wieder uneingeschränkt Freeware
|
||
- **01.03.2023:** v3.9.9b veröffentlicht (Zeitlimit dauerhaft entfernt)
|
||
|
||
### Namensherkunft
|
||
„Yet Another TeamSpeak³ Query App" — benannt, weil es beim Entwicklungsbeginn bereits viele Query-Tools gab, aber keines auf dem Rechner des Autors funktionierte.
|
||
|
||
### Aussprache
|
||
[jatka] in IPA-Lautschrift — auch als deutsches Wort aussprechbar.
|
||
|
||
---
|
||
|
||
## Globale Tastenkürzel
|
||
|
||
| Kürzel | Aktion |
|
||
|--------|--------|
|
||
| Strg+F | Filtern (Rechte, Log) oder Suchen |
|
||
| Strg+Alt+F | In Listen suchen |
|
||
| F3 | Weiter suchen |
|
||
| Strg+A | Alles auswählen |
|
||
| Strg+C | Kopieren oder ausgewählte Daten speichern |
|
||
| Strg+Alt+A | Spalten automatisch anpassen |
|
||
| F2 | Umbenennen |
|
||
| F5 | Tab aktualisieren |
|
||
| NUM + | Ausgewählte Checkbox-Elemente aktivieren |
|
||
| NUM - | Ausgewählte Checkbox-Elemente deaktivieren |
|
||
| Strg+Leertaste | Parameterwert auswählen (Konsole) |
|
||
| Strg+E | Ausgewählten Text escapen (Konsole) |
|
||
| Strg+S | Diagramm als Bild speichern |
|
||
|
||
---
|
||
|
||
## Ressourcen
|
||
|
||
- **Website:** https://yat.qa/
|
||
- **Download:** https://dl.yat.qa/stable/
|
||
- **Funktionen:** https://yat.qa/funktionen/
|
||
- **Anleitung:** https://yat.qa/manual/ (nur Englisch)
|
||
- **Changelog:** https://yat.qa/changelog/ (nur Englisch)
|
||
- **FAQ:** https://yat.qa/haeufige-fragen/
|
||
- **Support:** https://yat.qa/unterstuetzung/
|
||
- **Ressourcen:** https://yat.qa/ressourcen/
|
||
- **Über:** https://yat.qa/ueber/
|
||
|
||
---
|
||
|
||
## Übersetzung
|
||
|
||
YaTQAs Originalsprache ist Deutsch. Die Übersetzung erfolgt mit OmegaT und XLIFF-Dateien. Den Autor vorher kontaktieren. Das Übersetzungssystem verwendet:
|
||
- `%s` — Zeichenketten-Platzhalter
|
||
- `%d` — Dezimalzahl-Platzhalter
|
||
- `&` — Tastenkürzel
|
||
- `&&` — Tatsächliches Kaufmanns-Und
|
||
- `|` — Senkrechter Strich (Hinweistext-Trennzeichen)
|
||
- `\r\n` — Neue Zeile
|
||
- `\t` — Tabulator
|