FOLOSA BRIDGE HANDBUCH

Von der Folosa-Idee zum spielbereiten Foundry Actor.

Der vollständige Ablauf für Game Master: Modul installieren, Konto sicher verbinden, einen von drei Modi wählen, Render verfolgen, neue oder frühere Ergebnisse importieren und Fehler beheben.

Foundry
V13 oder neuer; V14 geprüft
Zugriff
Game-Master-Rechte
Eingaben
Build, Prompt oder Upload
Lieferung
Geprüftes WebM + PNG als Actors

1. Vor dem Start

Prüfe Konto, Dateien, Rechte und Umgebung vor der Installation.

Richtiges Folosa-Konto

Nutze dasselbe bestätigte Konto, dem Credits und frühere Generierungen gehören. Der Verlauf ist kontogebunden.

Als Game Master öffnen

Nur ein GM darf Bridge verbinden, kostenpflichtige Aufträge senden, in Foundry Data schreiben und Actors erstellen.

Foundry-Version prüfen

Verwende V13 oder neuer; V14 ist geprüft. Aktualisiere Bridge, bevor du einen alten Client untersuchst.

Uploads vorbereiten

PNG, JPG oder WebP, mindestens 300x300 px und höchstens 10 MB. Eine zentrierte Ganzkörperfigur mit Rand um Gliedmaßen und Effekte bietet Bewegungsraum.

2. Modul installieren und aktivieren

Nutze ZIP oder Manifest-URL, sofern der Paketmanager sie akzeptiert.

Welt sichern

Erstelle vor Installation oder Update ein Backup der Foundry-Welt.

Paket installieren

Lade das ZIP. Installiere per Manifest oder entpacke folosa-bridge nach Data/modules.

Foundry neu starten

Starte Anwendung oder Server neu, damit Skripte und Vorlagen geladen werden.

In der Welt aktivieren

Öffne Manage Modules, aktiviere Folosa Bridge und speichere.

Panel öffnen

Als GM unter Settings Folosa Bridge wählen oder Ctrl+B drücken. Während des Renderns darf das Panel geschlossen werden.

3. Konto sicher verbinden

Ein kurzlebiger Gerätecode erzeugt eine beschränkte, widerrufbare Berechtigung. Das Passwort wird nie in Foundry eingegeben.

Verbindung starten

Connect Folosa öffnet die Freigabeseite und zeigt einen temporären Code.

Bei Folosa anmelden

Melde dich im Browser an und prüfe vor der Freigabe die E-Mail-Adresse.

Gerät genehmigen

Genehmige nur den bekannten Foundry-Client und die richtige Welt. Der Code verfällt und ist einmalig.

Kontoleiste prüfen

Warte in Foundry auf Connected, E-Mail, Credits und Tarif. Der Status wird automatisch aktualisiert.

Scopes verstehen

Die Berechtigung liest Credits, eigene Jobs und Assets, erstellt Jobs und Checkout-Handoffs, aber keine Passwörter oder fremden Daten.

4. Einen von drei Modi wählen

Die Modi entsprechen den Web-Eingaben, senden in Bridge jedoch jeweils genau einen Foundry-Auftrag.

Build

Wähle Herkunft, Archetyp, Umgebung und Aktion. Bridge erstellt daraus einen strukturierten Ganzkörper-Token-Prompt.

Prompt

Schreibe eine präzise Beschreibung bis 800 Zeichen: ein Motiv, sichtbare Ausrüstung, Aktion und Stil.

Upload

Wähle ein Bild mit Nutzungsrecht. Optional beschreibst du eine Bewegung mit bereits sichtbarer Hand oder Waffe.

Modi nicht mischen

Nur der aktive Modus wird gesendet. Verborgene Werte anderer Modi werden ignoriert.

Stil wählen

Dark Fantasy, Anime und Ink ändern die Richtung; beim Upload bleibt das Referenzbild die Identitätsquelle.

Praktische Komposition

Vermeide abgeschnittene Nahaufnahmen. Verlange beim Prompt ein zentriertes Ganzkörpermotiv mit klarer Silhouette.

5. Qualität und Credits

Die Qualität bestimmt Lieferstufe und reservierte Credits.

Standard VTT

80 CRD pro Token für ein kompaktes transparentes 512p-WebM im Live-Spiel.

HD Pro

200 CRD pro Token für eine schärfere 1080p-Lieferung.

4K Master

280 CRD pro Token für die höchste archivorientierte Ausgabe.

Reservierung

Credits werden bei Annahme reserviert und bei Erfolg abgerechnet. Bestätigte Systemfehler geben sie frei. Mehrere Minuten Laufzeit sind kein Grund für eine zweite Einreichung.

6. Senden, warten, aktualisieren, stornieren

Die Aufgabenliste ist die maßgebliche Statusanzeige. Ein Refresh aktualisiert Konto und Verlauf.

Modus prüfen

Kontrolliere Modus, Bild oder Prompt, Stil, Qualität und Credit-Saldo.

Einmal erstellen

Create token nur einmal wählen. Ein Idempotency Key schützt eine angenommene Einreichung vor beabsichtigter Doppelabrechnung.

Status lesen

Queued wartet; Processing wird bearbeitet; Completed ist verfügbar; Partial failed enthält mindestens ein erfolgreiches Ergebnis.

Weiterarbeiten

Das Panel darf geschlossen werden. Der Server rendert weiter und Bridge prüft alle zehn Sekunden.

Nur bei sichtbarer Option stornieren

Cancel erscheint nur vor Übernahme eines queued Bridge-Jobs. Nach Start auf das Endergebnis warten.

Wichtig: Sobald ein externer Anbieter einen Auftrag übernommen hat, kann er nicht sicher storniert werden. Nur ein noch nicht übernommener Auftrag in der Warteschlange ist stornierbar.

7. Neue und frühere Ergebnisse verwenden

Die Liste zeigt die letzten 50 Aufträge des Kontos, einschließlich Web Forge.

Quelle erkennen

Foundry stammt aus Bridge; Website wurde auf folosa.com erstellt.

Automatischer Import

Nur neue Bridge-Jobs werden automatisch importiert. Web-Historie wird nie gesammelt importiert.

Manueller Import

Import prüft signierte Dateien anhand Größe und SHA-256, lädt sie in Foundry Data und erstellt Actors.

Actor öffnen

Open Actor öffnet einen bereits importierten Actor, den du erneut in Szenen ziehen kannst.

Gelöschten Actor wiederherstellen

Nach Refresh wird Import wieder angeboten. Es entstehen keine neue Generierung und keine neuen Kosten.

8. Actor im Spiel verwenden

Dateien liegen pro Auftrag in einem festen Ordner; Animation und Porträt bleiben getrennt.

Dateien finden

Unter Data/folosa/tokens/<job-id>. Nicht verschieben, solange Actors diese Pfade verwenden.

Actor prüfen

PNG-Porträt und WebM Prototype Token kontrollieren; systemspezifische Werte normal ergänzen.

In einer Szene testen

Actor in eine kleine Szene ziehen und Transparenz, Schleife, Größe und Leistung prüfen.

Sicher wiederverwenden

Denselben Actor in mehreren Szenen verwenden. Nur für andere Spielwerte duplizieren.

9. Credits, Checkout und Sicherheit

Kontoseiten öffnen über einen kurzen Handoff; die Berechtigung steht nicht in der Zahlungs-URL.

Credits kaufen

Credits öffnet Konto und Checkout. E-Mail und Paket prüfen, danach in Foundry einmal Refresh wählen.

Schlüssel rotieren

Rotate key ersetzt eine möglicherweise offengelegte Berechtigung und widerruft die alte.

Trennen

Disconnect widerruft die Berechtigung, löscht aber keine Jobs, Assets oder Actors.

Gemeinsame Geräte

Vor einem Benutzerwechsel trennen. Berechtigung niemals in Chat, Ticket, Makro oder Screenshot einfügen.

10. Fehlerbehebung

Arbeite die Tabelle der Reihe nach ab und sende nicht erneut, bevor der Status des ersten Jobs klar ist.

ProblemPrüfenLösung
Nicht verbundenFreigabeseite, E-Mail und Ablauf des Codes.Neue Verbindung starten und neuen Code genehmigen.
401 oder ungültige BerechtigungRotation, Widerruf oder Kopie zwischen Profilen.Trennen und neu verbinden; eine Berechtigung pro Client-Profil.
Saldo veraltetCheckout im gleichen E-Mail-Konto.Einmal Refresh; danach Transaktion im Konto prüfen.
Lange queuedJob-ID und Zeit; keine Kopie erstellen.Warten oder nur bei sichtbarem Cancel stornieren; sonst Support.
Mehrere Minuten processingExterner Anbieter arbeitet.Warten; Panel schließen ist sicher, doppelt senden nicht.
Completed, Import scheitertGM-Rechte, Schreibzugriff, Speicherplatz, Konsole.Berechtigung korrigieren, Refresh, erneut importieren; keine neue Abrechnung.
Actor da, Video leerToken-Pfad, WebM, Pause und Hardware.Pfad prüfen, in kleiner unpausierter Szene testen, Standard VTT nutzen.
Alter Web-Job fehltE-Mail und Grenze von 50 Jobs.Refresh; ältere Ergebnisse im Folosa-Konto manuell laden.

11. Checkliste vor der Sitzung

Kurze Abnahme vor dem Live-Spiel.

Konto

Richtige E-Mail verbunden und Credits aktuell.

Auftrag

Completed oder Partial failed und nur eine Einreichung vorhanden.

Dateien

Actor, PNG-Porträt und WebM-Textur funktionieren.

Szene

Transparenz, Größe, Schleife und Leistung auf einem Spielergerät prüfen.

Support

Bei einem Fehler Job-ID, Zeit, Modus, Qualität, Screenshot und Beschreibung senden, niemals die Berechtigung.