# Doesi Studio 0.4.4

Viewer-Aktionen lassen sich pro Studio-Profil beim Start automatisch aktivieren. Unter Spiele → Viewer Control → Modulstatus den Schalter setzen. Standardmäßig ist er aus. Änderungen gelten ab dem nächsten Studio-Start; Not-Aus und die Prüfung von Eingabegerät und Spielprofil bleiben wirksam.

Neu in 0.4.3: Automatische Ausrüstung mit konfigurierbaren Fangboni, klar getrennte Bereiche für Connections und Spiele sowie eine überarbeitete Oberfläche. Standardbilder liegen im Portalpaket. [Ausrüstung und neue Navigation](docs/Studio-0.4.3-DE.md).

Neu in 0.4.0: Fang-Angebote mit mehreren Commands und Kanalpunkte-Belohnungen, 1–50 Fängen pro Nutzung und Gesamtpreis in Studio-Währung. Viewer Control startet automatisch; unter Studio heisst „Chatbot“ jetzt „Update“. Viewer in der Loyalität suchen und filtern, Punkte hinzufügen oder abziehen, Guthaben mit Konfliktprüfung festlegen, nach Namen übertragen, Buchungen durchsuchen und als CSV exportieren. Vergaberegeln sind direkt bearbeitbar. Stream-Deck-Kopplung und Viewer-Karten-Fix sind enthalten. [Anleitung](docs/UPDATE-0.4.0.md).

Neu in 0.2.7: Teile und Ausrüstung direkt mit `!kauf Gegenstandsname [Anzahl]` kaufen; eigene Schiffe mit `!verschrotte Schiffsname [Anzahl]` in Packmaterial zerlegen. Namen mit Leerzeichen brauchen keine Anführungszeichen. Gespeicherte Preise, Voraussetzungen und Freigaben gelten weiterhin. Beide Befehle stehen in der automatisch aktualisierten Commands-Liste.

Neu in 0.2.6: Schiffe, Material, Packs und Rezepte direkt suchen. Ausrüstung & Upgrades als eigener sichtbarer Tab mit Angel, Jammer, Scanner und Kiste. Vollständige Standardrezepte samt Materialtausch sind automatisch vorhanden. Lesbare Chatbefehle wie `!schiffli jammer2` ersetzen generierte Codes; alte Codes bleiben gültige Aliase. [Schnellstart](docs/Fishing-Quickstart-CH.md).

Neu in 0.2.5: Fangspiel-Befehle stehen direkt in der Commands-Liste, einschließlich Handel, Shop, Rezepte und eigener Verwendungen. Umbenennen des Hauptcommands aktualisiert Namen, Syntax, Beispiele und Aliase automatisch. Aktiv-Status und Einstellungen bleiben mit dem Fangspiel verbunden. Verwendungen und Rezepte führen in vier Schritten durch Kosten, Voraussetzungen und Belohnungen. Wählbare Ausrüstungsvorlagen für Quantum-Jammer, Angel, Scanner, Traumfänger und eigene Geräte enthalten Materialkäufe, Mk-II-/Mk-III-Upgrades und einen bearbeitbaren Einsatz.

Neu in 0.2.4: frei bearbeitbare Verwendungen, Rezepte, Shops, Missionen und Freischaltungen; Geschenke und reservierte Tausch-/Verkaufsangebote zwischen Zuschauern; passende Fang-Sounds pro Pack. Zutaten, Werkzeuge, Kosten, Belohnungen, Cooldowns, Limits und Studio-Aktionen im visuellen Editor festlegen. Sechs inaktive Vorlagen pro Pack erleichtern den Einstieg. [Verwendungen, Rezepte und Handel](docs/Collection-Gameplay-CH.md).

Neu in 0.2.3: Fang-Commands funktionieren mit getrenntem Bot- und Broadcaster-Login. Sammlung und XP bleiben dem Twitch-Kanal zugeordnet; Antworten kommen vom verknüpften Bot. Frei wählbare Commands wie !schiffli bleiben unverändert. Fang testen öffnet bei fehlender Browserquelle automatisch die Vorschau; ein aktiver Cooldown wird im Chat erklärt.

Enthalten: 255 Star-Citizen-Fänge, 32 Fische und 32 Sandmaa-Fundstücke mit Bildern und bearbeitbarer Abstimmung. Neue Fang-Effekte und vier transparente WebMs mit 60 FPS und Fang-Sounds. Unveränderte alte Startpacks werden erweitert; bestehende Fang-IDs und Fortschritte bleiben erhalten. Weitere Vorlagen über die drei Bilderpaket-Buttons laden.

Neu in 0.2.2: Studio-Updater für Programmpfade mit abschließendem Trennzeichen korrigiert. Download und Installationsstart verwenden denselben normalisierten Pfad. Startfehler werden deutlich angezeigt und protokolliert.

Aus Version 0.2.0 und 0.2.1 diese vollständige Version einmal manuell installieren: Studio schließen, in einen neuen Ordner entpacken und die neue EXE starten. Das ausgewählte Profil wird automatisch weiterverwendet.

Neu in 0.2.1: **Community → Fang- & Sammelspiele**. Eigene Packs, passende Animationen, Sammlung, XP-Umwandlung und bearbeitbare Ränge. [Anleitung](docs/Collection-Games-CH.md).

Neue Navigation: **Studio, Connections, Stream, Automatisierung, Spiele, Community und Einstellungen** als obere Tabs; links stehen nur die passenden Unterseiten. [Bedienung](docs/Navigation-DE.md).

Neu: Zuschauernamen in Viewer-Control-Overlays lassen sich unter **Viewer Control → Overlay & OBS** ausblenden. [Anleitung](docs/Studio-Tools-DE.md).

Neu: lokale OBS-Browserquellen werden nach dem Studio-Start und nach einer neuen OBS-Verbindung automatisch ohne Cache neu geladen. [Einrichtung](docs/Studio-Tools-DE.md).

Neu: optionaler WebM-Raid-Alert mit Ton vor dem Shoutout-Clip, bearbeitbare Alert-/Overlay-Texte und eine lokale OBS-Browserquelle. [Shoutout einrichten](docs/Shoutout-DE.md).

Neu: automatische Wiederverbindung für Alert-Overlays und OBS, Zeitlimits für Stream Labels und ausgewählte OBS-Browserquellen ohne Cache neu laden. [Bedienung](docs/Studio-Tools-DE.md).

[Neu: Profile, Audio-Test, Medienvorschau, visueller Editor und Stream Labels](docs/Studio-Tools-DE.md).

Commands-Update: Aktiv/Inaktiv-Filter und direkt bearbeitbare INI-Antworten. [Anleitung](docs/Commands-DE.md).

Chatbot, StreamOps und Viewer Control in einer nativen Desktop-Anwendung für Windows x64 und Linux x64.

## Starten

Entpacke das vollständige ZIP in einen eigenen Ordner. Windows: `DoesiStudio.exe` starten. Linux: `DoesiStudio` ausführen. Die .NET-Laufzeit ist enthalten; ein SDK wird nur zum Quellcode-Build benötigt. Unter Linux benötigt die Oberfläche X11/XWayland, Fontconfig, libICE/libSM und die üblichen Desktop-Bibliotheken. Für lokale Audio-/Videoeffekte empfehlen sich PipeWire sowie mpv/ffmpeg.

Der Einrichtungsassistent führt durch Profile, Chatbot-Anmeldung, OBS, StreamOps und Viewer Control. Die Sprache folgt dem System: Deutsch für deutsche Sprachregionen, sonst Englisch. Deutsch und Englisch können dauerhaft manuell ausgewählt werden.

## Bestehende Daten übernehmen

Alle alten Anwendungen vor dem Import schließen. In **Import** die alten Datenordner wählen, die Vorschau prüfen und einen neuen Profilnamen angeben. Die Quelldaten und bestehende Studio-Profile werden nicht überschrieben. Zugangsdaten werden nicht kopiert; die Module anschließend neu anmelden.

Studio speichert Profile getrennt vom Programm:
- Linux: `~/.local/share/DoesiStudio/profiles/<Profil>/`
- Windows: `%LOCALAPPDATA%\DoesiStudio\profiles\<Profil>\`
- Unterordner: `chatbot`, `streamops`, `viewer-control`.

## Satisfactory

Unter **StreamOps → Satisfactory einrichten** den Spielordner wählen oder Steam erkennen lassen. Satisfactory muss geschlossen sein. SML zunächst mit [Satisfactory Mod Manager](https://smm.ficsit.app/) installieren. Danach **Mitgelieferte Bridge installieren** wählen. Enthalten ist der vom Nutzer gelieferte kompilierte Stand **StreamOpsBridge 0.2.5 VehicleContext** für Steam/Epic und Windows/Proton, mit SML-Abhängigkeit `^3.12.0`.

Eine vorhandene Bridge wird nur nach Auswahl von **Vorhandene Bridge nach vollständiger Sicherung ersetzen** ersetzt. Neuere Versionen bleiben geschützt; Backups liegen außerhalb des Mods-Verzeichnisses in `FactoryGame/StreamOps-Backups`. Andere Mods werden nicht verändert. Ein eigenes kompiliertes Mod-ZIP kann ebenfalls gewählt werden.

Einzelspieler-Spielstand einmal laden, Spiel schließen, **bridge.json automatisch erkennen**, **Bridge aktivieren**, Spiel erneut starten und **Spielverbindung prüfen**. Die Aktivierung erhält Token, Port und weitere Einstellungen und sichert die ursprüngliche Datei. Bei mehreren Proton-Konfigurationen die richtige `bridge.json` manuell auswählen. Lokaler Einzelspieler/Listen-Host wird unterstützt; die Mod blockiert Clients, weitere Mitspieler und Dedicated Server. Die hochgeladenen Server-Binaries ändern diese Mod-Regel nicht.

## Viewer Control und OBS

Modul starten, ein Spielprofil wählen oder **Neues Spielprofil** verwenden. Für OBS eine Browserquelle mit `http://127.0.0.1:17565/overlay` anlegen, auf die Basisleinwandgröße setzen und oberhalb der Spielaufnahme platzieren. **Audio über OBS steuern** aktivieren. Der Standardport kann in einer importierten Konfiguration abweichen; die im Programm angezeigte URL ist maßgebend. Für das lokale Overlay Monitor wählen oder alle Monitore aktivieren. Randloses Vollbild verwenden und vor Live-Einsatz eine Aktion testen.

Linux: Die im Modul angezeigte uinput-Einrichtung ausführen, anschließend ab-/anmelden. Windows: Tastatur/Maus, Hotkeys, WASAPI-Audio und Overlays sind verfügbar. Neue StreamOps-Flightstick-Aktionen nutzen optional vJoy; Windows-Tastatur/Maus werden gemeinsam gesperrt. Physische Controller/Flightsticks/Lenkräder sperren und das Viewer-Lenkrad verwenden bleibt Linux vorbehalten. Studio und Spiel auf derselben Berechtigungsstufe starten. Windows-Ausführung muss vor Live-Einsatz auf einem Windows-PC geprüft werden.

Chatbot und StreamOps enthalten ihre öffentlichen Twitch-App-IDs. Viewer Control verwendet eine importierte eigene Client-ID oder verlangt eine öffentliche Twitch-App-ID mit Device-Code-Anmeldung. Diese ID wurde in den Quellen nicht mitgeliefert. Die Modul-Anmeldungen bleiben getrennt.

## Aktualisieren

Unter Studio → Update nach Studio-Updates suchen, herunterladen und nach Prüfung installieren. Das gesamte Programm wird aktualisiert; persönliche Profile bleiben erhalten. Von Preview2 einmalig das neue vollständige ZIP in einen eigenen Ordner entpacken. Studio nutzt einen eigenen Downloadkanal; der Einzelprogramm-Updater des alten Chatbots ersetzt Studio nicht. Mehrere Instanzen, die dasselbe Profil oder denselben lokalen API-Port verwenden, gleichzeitig vermeiden.

## Entwicklungsstand

Dies ist eine Preview. Satisfactory-Spielverifikation und Windows-Desktop-/Audio-/Input-Tests auf echten Systemen stehen für dieses zusammengeführte Paket noch aus. DRG benötigt eine zusätzliche, nicht enthaltene Spielmod. Neue Eingabeaktionen besitzen einen geführten Editor; erweiterte Spielmod-Aktionen werden weiterhin im JSON-Editor bearbeitet. Die drei Engines sind integriert, besitzen aber noch getrennte Twitch-Sitzungen und Währungen.

## Quellcode bauen

.NET 10 SDK und Python 3.11+ installieren. `bash build.sh` erstellt nach allen Tests beide x64-Pakete. `bash build.sh linux-x64` baut Linux, `bash build.sh win-x64` Windows. Auf Windows: `powershell -ExecutionPolicy Bypass -File build.ps1`. Ausgabe in `artifacts/`. Die Tests und Analyzer bleiben aktiv.

Preview4: Tastatur/Maus/Flightstick, gesamtes Studio aktualisieren und vollständige Profilbackups. [Anleitung](docs/Studio-Preview4-DE.md).


Shoutout und Server-Spiele sind direkt integriert. Die separate Doesi-Core-DLL wird nicht mehr benötigt. Einrichtung: [Preview4-Anleitung](docs/Studio-Preview4-DE.md).
