Desktop Extractor

Desktop-Extractor & Importe

Daten ins Basetool bekommst du nicht nur über die Web-Oberfläche. Zwei Wege füttern das Basetool aus dem Spiel heraus: der Refinery-Screenshot-Import (aus deinen Raffinerie-Screenshots wird ein vorausgefüllter Raffinerie-Auftrag) und der Blueprint-Import (deine freigeschalteten Baupläne landen im Persönlichen Inventar). Beides erzeugt ein Desktop-Tool auf deinem eigenen Rechner — der Basetool Blueprint Extractor.

Eine wichtige Grundregel vorweg: Importe füllen nur vor, sie speichern nie. Egal über welchen Weg die Daten ins Basetool kommen — du landest immer auf einem vorausgefüllten Formular und musst die Daten prüfen und selbst speichern. Es gibt keinen Weg, der unter Umgehung der Prüfung etwas anlegt.

Das Desktop-Tool

Der Basetool Blueprint Extractor läuft lokal auf deinem Windows-Rechner. Er liest Spiel-Screenshots aus und erzeugt daraus JSON-Dateien — für Raffinerie-Aufträge und für Baupläne.

• Repo & Downloads: https://github.com/krt-profit/basetool-bp-extractor
• Die Bildverarbeitung passiert vollständig auf deinem Rechner. Screenshots bzw. Bilddaten verlassen deine Maschine nie — nur das fertige JSON wird (wenn du es willst) übertragen.

Refinery-Screenshot-Import

Du dokumentierst Raffinerie-Aufträge ohnehin per Screenshot? Daraus macht der Extractor einen vorausgefüllten Auftrag.

So funktioniert es

1. Im Spiel den SETUP-Bildschirm der Raffinerie aufnehmen (mit gezogenem GET QUOTE, damit die Mengen feststehen).
2. Den/die Screenshot(s) im Extractor verarbeiten — er erzeugt eine RefineryExtract-JSON-Datei.
3. Diese JSON ins Basetool bringen (per Datei-Upload oder per Direkt-Übertragung, siehe unten).
4. Das Basetool gleicht die ausgelesenen Namen gegen die Stammdaten ab und öffnet die Seite Raffinerie-Auftrag anlegen mit vorausgefüllten Feldern.
5. Du prüfst den Entwurf, korrigierst Hinweise und speicherst selbst — gespeichert wird ausschließlich über den normalen Anlegen-Weg.

Datei-Upload

Auf der Seite Raffinerie-Auftrag anlegen gibt es einen Import-Button: Du wählst die vom Extractor erzeugte JSON-Datei aus, und das Formular wird direkt im Seitenkontext mit dem Entwurf gefüllt (kein Neuladen nötig). Was du vorher schon ins Formular getippt hattest, wird dabei verworfen — der Import ersetzt den Formularinhalt komplett.

Prüfen vor dem Speichern

Der Import liest „best effort" — er zeigt dir also auch, was er nicht sicher zuordnen konnte. Typische Hinweise:

• Nicht zugeordnetes Material — der ausgelesene Name passt auf kein bekanntes Material. Häufig bietet das Basetool Vorschläge an, die du per Klick zuweisen kannst.
• Geringe Treffersicherheit — das Material wurde nur unscharf zugeordnet; bitte gegenprüfen. Die Sicherheit wird als Prozentwert angezeigt.
• Unbestätigte Zeile / Auftrag — es wurde kein GET QUOTE gezogen, also fehlen Mengen. Hier hilft nur: im Spiel neu aufnehmen, nachdem du eine Quote gezogen hast.
• Ort / Methode nicht aufgelöst — kommt vor, wenn der Panel-Ausschnitt die Kopfzeile nicht enthält; trage Ort und Methode dann von Hand nach.
• Summen-Abweichung — die Zeilensummen passen nicht exakt zum Kopf-Total. Das ist ein Warnhinweis, kein Fehler: prüfe die Zeilen, und wenn du den Auftrag nach dem Quote noch geändert hast, nimm neu auf.

Pflichtfelder ohne Treffer (z. B. ein leeres Material-Feld) musst du vor dem Speichern füllen. Alles, was nur als Hinweis markiert ist, kannst du übernehmen oder korrigieren.

Startzeit aus dem Screenshot

Wenn der Extractor in den Bilddateien einen Aufnahme-Zeitstempel findet (aus dem Dateinamen oder dem Änderungsdatum), trägt das Basetool diesen als Startzeitpunkt des Auftrags vor. Zeiten werden intern in UTC gehalten und dir in lokaler Zeit (Europe/Berlin) angezeigt. Findet sich kein Zeitstempel, bleibt das Feld leer und der Startzeitpunkt wird beim Speichern auf „jetzt" gesetzt.

Mehr zu Raffinerie-Aufträgen selbst: Raffinerie.

Blueprint-Import (Persönliches Inventar)

Der Extractor kann auch deine im Spiel freigeschalteten Baupläne erfassen und als Blueprints-JSON exportieren. Diese Datei importierst du im Persönlichen Inventar unter Meine Blueprints.

So läuft der Import dort:

1. Auf der Blueprints-Seite den JSON-Import über die Add-Leiste starten und die Datei auswählen.
2. Es öffnet sich eine Vorschau mit allen erkannten Bauplänen — mit „Alle / Keine / Anwenden", pro Zeile Suche und optionalen Notizen.
3. Du wählst aus, was übernommen werden soll, und bestätigst.

Hinweis zu Standard-Bauplänen: Ein kleiner Satz Start-Baupläne (Starter-Pistole, -Gewehr, deren Magazine, die Field-Recon-Suit-Teile) ist auf jedem Star-Citizen-Account von Haus aus freigeschaltet und taucht deshalb nicht in einem Extractor-Import auf. Diese Baupläne vergibt das Basetool automatisch an jeden Nutzer — du musst sie nicht importieren, und du kannst sie auch nicht entfernen.

Direkt-Übertragung (Ein-Klick „an Basetool senden")

Statt die JSON-Datei zu speichern und von Hand hochzuladen, kann der Extractor das Ergebnis am Ende mit einem Klick direkt ans Basetool übertragen. Du landest dann automatisch auf der passenden Seite — Raffinerie-Anlegen bzw. Blueprint-Import — mit den Daten schon vorausgefüllt.

Anmelden des Desktop-Tools

Damit der Extractor in deinem Namen senden darf, meldet er sich einmalig per Keycloak an:

• Die Anmeldung läuft über den Geräte-Flow (Device-Login): Der Extractor zeigt dir einen Code bzw. öffnet einen Anmelde-Link, du bestätigst die Anmeldung im Browser mit deinem üblichen Profit-Login.
• Mit „Angemeldet bleiben" merkt sich der Extractor die Anmeldung sicher im Windows-Anmeldeinformations-Speicher, sodass spätere Übertragungen ohne erneute Bestätigung gehen. Ohne diese Option fragt jede Übertragung erneut nach.
• Mit der Aktion „Vom Basetool trennen" im Extractor meldest du das Tool wieder ab und löschst die gespeicherte Anmeldung.

Es braucht keine besondere Rolle — jedes angemeldete Mitglied darf seine eigenen Extrakte senden. Die Daten gehören immer dir; der Extractor handelt nie für jemand anderen.

Was übertragen wird (und was nicht)

• Übertragen wird nur das fertige JSON, und auch nur dann, wenn du im Extractor explizit Senden klickst. Es gibt keine Hintergrund-Synchronisation, kein automatisches Senden, keine Telemetrie.
• Screenshots und Bilddaten verlassen deinen Rechner nie — nur der bereits ausgewertete Entwurf wird übertragen.
• Auch bei der Direkt-Übertragung gilt: das Basetool füllt nur vor. Erst dein Klick auf Speichern legt den Auftrag bzw. den Bauplan an. Die Übertragung ist nur ein anderer Transportweg für denselben Entwurf — kein neuer Speicherweg.

Bist du im Browser noch nicht angemeldet, führt dich das Basetool zuerst durch den normalen Login und bringt dich danach wieder auf das vorausgefüllte Formular. Ist eine Übertragung abgelaufen oder bereits verbraucht, bekommst du einfach das leere Anlege-Formular mit einem kurzen Hinweis — nichts geht kaputt, nichts wird ungefragt gespeichert.

Verfügbarkeit

Die Direkt-Übertragung setzt eine serverseitige Freischaltung durch die Betreiber voraus (eigenes Ingest-Gateway und Keycloak-Konfiguration). Ist diese in eurer Umgebung noch nicht aktiv, nutzt den Datei-Upload — er funktioniert immer und liefert exakt dasselbe Ergebnis.

Wer darf was?

Aktion	Wer
Refinery-JSON importieren / vorausfüllen lassen	jedes angemeldete Mitglied
Blueprint-JSON importieren	jedes angemeldete Mitglied (für das eigene Inventar)
Direkt-Übertragung aus dem Extractor	jedes angemeldete Mitglied (eigene Daten)
Gespeicherten Raffinerie-Auftrag anlegen	wie im normalen Anlegen-Weg (Org-Einheit-Bezug, siehe Raffinerie)

Importe selbst brauchen keine erhöhte Rolle. Beim Speichern des geprüften Entwurfs gelten die normalen Berechtigungen und der Org-Einheit-Bezug des jeweiligen Anlegen-Wegs. Die maßgebliche Rollen-Matrix steht in Rollen und Berechtigungen bzw. ausführlich in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.

Probleme & Stolpersteine

• „Unbestätigter Auftrag": Du hast vor dem Screenshot kein GET QUOTE gezogen — ohne Quote fehlen die Mengen. Im Spiel Quote ziehen und neu aufnehmen.
• Falsch zugeordnete Materialien: Nutze die Vorschläge, die das Basetool an der Zeile anbietet, oder korrigiere das Material-Feld von Hand. Wiederkehrende Namensvarianten kann die Administration über Material-Aliasse pflegen (siehe Administration).
• Direkt-Übertragung tut nichts: Prüfe, ob der Extractor angemeldet ist (ggf. neu anmelden) und ob die Funktion in eurer Umgebung freigeschaltet ist — sonst den Datei-Upload verwenden.
• Parallele Bearbeitung: Speicherst du einen Entwurf, während jemand anderes denselben Datensatz ändert, kann es einen Konflikt geben (Hinweis „bitte neu laden"). Seite neu laden und erneut speichern.

Weitere Hilfe: FAQ und Troubleshooting · Fehler melden unter https://github.com/krt-profit/basetool/issues.