Repository navigation
An Basetool senden
Statt eine JSON-Datei zu speichern und von Hand hochzuladen, kannst du das Ergebnis direkt an dein eigenes Basetool-Konto senden. Das gilt für beide Workflows. Für Blueprints gibt es zusätzlich den direkten Abgleich — siehe Blueprints synchronisieren.
Wichtig: Es wird nichts automatisch gesendet. Der Versand passiert ausschließlich, wenn du „An Basetool senden" oder „Blueprints synchronisieren" klickst. Und auch dann verlassen nur die Blueprint-Namen bzw. die abgelesenen Werte deinen Rechner — kein Spieler-Handle, keine Ordner- oder Dateinamen, keine Screenshots, keine Logs.
Die neue Austausch-Schnittstelle. Ab Version 2.10.0 sendet der Extractor über die Austausch-Schnittstelle des Basetools (
/exchange/v1); die alten Adressen (/v1/blueprint-preview,/v1/refinery-extract) werden gleichzeitig abgeschaltet. Eine ältere Version zeigt dann „Versand fehlgeschlagen: Diese Schnittstelle wurde abgeschaltet. Bitte aktualisiere den SC Extractor auf die neueste Version." — Abhilfe: aktualisieren (siehe Updates). Nach dem Update meldest du dich einmal neu im Browser an und gibst deinem PC einen Namen (siehe unten).
Der orangefarbene Knopf „An Basetool senden" steht jeweils im letzten Schritt eines Workflows:
- Blueprints — in der Zusammenfassung (Schritt 3), daneben „Blueprints synchronisieren".
- Refinery — im Export-Schritt (Schritt 5).
Daneben gibt es immer die Alternative „Als JSON exportieren", falls du lieber eine Datei speichern und manuell importieren willst.
Es gibt keinen separaten „Anmelden"-Knopf. Die Anmeldung passiert automatisch beim ersten Senden. Auf der Start-Seite siehst du nur den Verbindungsstatus (siehe unten).
Beim ersten Senden erscheint ein Hinweis „An Basetool senden" mit der Erklärung, was gesendet wird:
„Die erzeugte JSON-Datei wird über eine verschlüsselte Verbindung an dein eigenes Basetool-Konto gesendet (Blueprint-Namen bzw. die abgelesenen Mengen/Beträge — kein Spieler-Handle, keine Ordner- oder Dateinamen). Danach öffnet sich die Basetool-Seite mit vorausgefüllten Werten — gespeichert wird erst nach deiner Prüfung dort. Bilder und Logs verlassen deinen Rechner nie."
Darunter fragt die App nach dem Namen dieser Installation (vorausgefüllt:
„Windows-PC"). Unter diesem Namen erscheint dein PC im Basetool unter „Verbundene
Anwendungen" — dort siehst du ihn und kannst ihn auch trennen. Erlaubt sind höchstens
40 Zeichen: Buchstaben, Ziffern, Leerzeichen, -, _ und .. Wähle etwas, woran
du den Rechner erkennst („Spiele-PC", „Laptop") — die App nimmt dafür bewusst nie
den Computernamen.
Mit „Senden" stimmst du zu (das wird gemerkt), mit „Abbrechen" brichst du ab.
Beim ersten Senden (oder wenn die gemerkte Anmeldung nicht mehr reicht) öffnet die App deinen Browser und zeigt im Fenster „Im Browser bestätigen" einen Code (z. B. „Code: ABCD-EFGH"):
„Wir haben deinen Browser geöffnet. Melde dich an (falls nötig), gib dort den unten gezeigten Code ein und bestätige die Freigabe. Gib nur Codes ein, die dir diese App gerade anzeigt."
Im Browser meldest du dich bei deinem Basetool-Konto an (falls nicht schon geschehen), gibst den Code aus der App ein — abtippen, markieren oder mit „Code kopieren" in die Zwischenablage legen und im Browser einfügen — und bestätigst auf der folgenden Seite die angefragten Berechtigungen. Die App öffnet bewusst die Seite ohne vorausgefüllten Code: So siehst du jedes Mal die Warnung, nur eigene Codes einzugeben — ein fremder Code, den dir jemand schickt, würde seinem Programm Zugriff auf dein Konto geben. Gib nur Codes ein, die du selbst gerade auf deinem PC erzeugt hast. Solange wartet die App („Warte auf Freigabe…"). Öffnet sich kein Browser, hilft „Browser erneut öffnen".
Steht über dem Code ein Hinweis zur einmaligen Neuanmeldung, erklärt er, warum die gemerkte Anmeldung nicht mehr reicht — nach dem Umstieg auf die Austausch-Schnittstelle oder nachdem du den direkten Abgleich eingeschaltet hast (der braucht zusätzliche Berechtigungen, die eine bestehende Anmeldung nicht nachträglich bekommen kann).
Nach der Freigabe sendet die App („Sende an Basetool…"). Danach erscheint „Gesendet":
„Die Daten liegen in deinem Basetool bereit. Öffne die Seite, um sie zu prüfen und zu speichern."
Mit „Im Basetool öffnen" kommst du direkt zur vorausgefüllten Seite im Browser. Dort prüfst du die Werte und speicherst sie — erst dann sind sie im Basetool dauerhaft abgelegt. „Schließen" schließt nur das Fenster (die Daten liegen trotzdem im Basetool bereit).
In der Blueprint-Zusammenfassung steht neben „An Basetool senden" der Knopf „Blueprints synchronisieren". Der Unterschied:
| An Basetool senden | Blueprints synchronisieren | |
|---|---|---|
| Wohin | Vorschau im Browser, du übernimmst | direkt in „Meine Blueprints" |
| Prüfung | du prüfst jede Zeile | keine Prüfung — nur Hinzufügen |
| Entfernt etwas? | nein | nie |
Beim ersten Mal erklärt die App, was der Abgleich tut, und fragt, ob du ihn einschalten willst („Einschalten und synchronisieren"). Danach meldest du dich einmal neu an. Der Abgleich:
-
prüft das Spielkonto: Vor dem ersten Abgleich eines Kontos fragt die App das
Basetool, ob das Spielkonto aus den Logs zu deinem Basetool-Konto gehört. Dafür wird
nur das Handle an diese eine Prüfung geschickt — gespeichert wird es nirgends.
- Passt es nicht („Anderes Spielkonto?"), hält die App an. Stammen die Logs von einem anderen Konto, wähle in der Zusammenfassung dein eigenes. Nur wenn es wirklich deins ist: „Trotzdem synchronisieren" — und das RSI-Handle in deinem Basetool-Profil korrigieren.
- Steht in deinem Profil kein RSI-Handle, kann das Basetool nicht prüfen. Die App fragt dann „Ist das dein Spielkonto?" und gleicht erst ab, wenn du „Ja, es ist meins" bestätigst. Trägst du dein RSI-Handle im Basetool-Profil ein, entfällt die Frage. Deine Antwort gilt, bis du die App schließt.
- liest zuerst deine Blueprints im Basetool und fügt dann nur hinzu, was dort fehlt. Er entfernt nie etwas — das Log beweist nur, dass du einen Blueprint bekommen hast, nicht, dass er weg ist.
- ordnet die Namen mit derselben Zuordnung zu wie der Web-Import. Namen, die das Basetool nicht kennt oder die auf mehrere Blueprints passen, listet die App auf — die importierst du im Web.
- fügt nicht wieder hinzu, was du im Basetool gelöscht hast. Diese Blueprints stehen im Ergebnis; nur wenn du „Trotzdem hinzufügen" klickst, kommen sie zurück.
Jeden Abgleich kannst du im Basetool unter „Verbundene Anwendungen" rückgängig machen.
Nach der ersten erfolgreichen Anmeldung merkt sich die App die Verbindung. Beim nächsten Senden läuft alles still im Hintergrund — ohne Browser, ohne Code: Du siehst nur kurz „Sende an Basetool…" und dann „Gesendet". Auch ein Abmelden im Basetool-Web beendet diese gemerkte Anmeldung nicht.
Auf der Start-Seite zeigt ein kleiner Punkt unten rechts den Status:
- „Mit Basetool verbunden" — eine Anmeldung ist gespeichert.
- „Nicht mit Basetool verbunden" — keine gespeicherte Anmeldung.
Im Extractor: Auf der Start-Seite klickst du bei bestehender Verbindung auf „Vom Basetool trennen". Eine Rückfrage erklärt:
„Die gespeicherte Anmeldung wird zurückgezogen und vom Rechner gelöscht. Beim nächsten Senden wird die Freigabe erneut abgefragt."
Mit „Trennen" wird die Anmeldung serverseitig zurückgezogen und lokal gelöscht.
Im Basetool: Unter „Verbundene Anwendungen" kannst du diese Installation (z. B. „Spiele-PC") oder den SC Extractor als Ganzes trennen. Beim nächsten Senden sagt die App dann, dass die Verbindung getrennt wurde, löscht die gespeicherte Anmeldung und fragt die Freigabe beim Senden danach neu ab.
Hinweis: Das Trennen entfernt nur die gespeicherte Anmeldung, nicht die einmal erteilte Einwilligung und den Namen (die liegen in der
config.json). Willst du auch die Einwilligungs-Abfrage zurücksetzen, lösche dieconfig.json— siehe Datenschutz und Deinstallation.
Sobald du „An Basetool senden" nutzt, merkt sich die App zwei Dinge außerhalb des Programmordners:
| Datei | Ort | Inhalt |
|---|---|---|
config.json |
%APPDATA%\Basetool SC Extractor\ |
Die erteilte Einwilligung, der Name dieser Installation, ob der direkte Abgleich eingeschaltet ist, die Ziel-Adresse und der zuletzt genutzte Channel-Ordner — kein Geheimnis. (Die Datei kann schon vorher existieren: ein erfolgreicher Blueprint-Lauf legt sie an, um sich den Ordner zu merken.) |
| Auffrischungs-Token | Windows-Anmeldeinformations-Manager, Eintrag „Basetool SC Extractor" | Die gemerkte Anmeldung (DPAPI-geschützt), der Name des Schlüssels, an den sie gebunden ist, und welche Berechtigungen sie hat. |
Warum eine Kopie nichts nützt: Die gemerkte Anmeldung ist an einen privaten Schlüssel gebunden (Verfahren DPoP, RFC 9449). Der Schlüssel liegt im Schlüsselspeicher von Windows — auf Rechnern mit TPM im Sicherheitschip — und lässt sich nicht exportieren, auch nicht von der App selbst. Sie kann damit nur signieren. Eine Kopie des Eintrags ist deshalb auf keinem anderen Rechner verwendbar.
Der Schlüssel ist deine Installation. Das Basetool erkennt diesen PC an genau diesem Schlüssel. Kann Windows keinen dauerhaften Schlüssel anlegen, sendet die App gar nicht — sonst wäre jeder Start eine neue Installation. Dann bleibt der Weg über „Als JSON exportieren" und den Import im Web.
Beides bleibt bei einer Deinstallation erhalten — wie du es entfernst, steht unter Deinstallation.
Schlägt etwas fehl, zeigt die App eine kurze Begründung und was zu tun ist. Kam die Ablehnung vom Basetool, endet die Meldung mit „Referenz für eine Meldung: …" — diese Referenz bitte angeben, wenn du den Fehler meldest; damit lässt sich die Anfrage im Basetool wiederfinden. Beim Senden hast du dann immer die Möglichkeit, „Stattdessen als JSON speichern" zu wählen und die Datei manuell hochzuladen.
Die häufigsten Fälle:
| Meldung | Ursache | Lösung |
|---|---|---|
| „the approval window expired — please try again" | Du hast die Freigabe im Browser nicht rechtzeitig (~10 Min.) bestätigt. | Erneut senden und im Browser zügig bestätigen. |
| „the request was denied" | Die Anfrage wurde im Browser abgelehnt. | Erneut senden und bestätigen (mit dem richtigen Konto). |
| „could not reach the basetool: …" | Keine Verbindung zum Server (Netz, DNS, Firewall). | Internetverbindung/Firewall prüfen, erneut versuchen — oder JSON speichern und manuell hochladen. |
| „Diese Version des SC Extractors ist zu alt …" | Das Basetool verlangt eine neuere Version. | Aktualisieren (Updates). |
| „Diese Verbindung wurde im Basetool unter „Verbundene Anwendungen" getrennt …" | Du hast diese Installation oder den Extractor im Basetool getrennt. | Einfach erneut senden — die App meldet sich neu an. |
| „Diese Funktion ist für den SC Extractor im Basetool gerade nicht freigegeben …" | Die Funktion ist serverseitig (noch) nicht für den Extractor freigegeben, oder du hast sie bei der Anmeldung nicht bestätigt. | Später erneut versuchen oder @greluc fragen. |
| „Versand abgelehnt: Das Basetool nimmt Daten nur von freigegebenen Programmen an …" | Diese Programmversion ist nicht (mehr) freigegeben — z. B. ein selbst gebauter Fork. | Eine offizielle Version von der Releases-Seite verwenden; bleibt es dabei, @greluc melden. |
| „Senden ist auf diesem Rechner nicht möglich: Windows stellt keinen Schlüsselspeicher bereit …" | Windows kann keinen dauerhaften, nicht exportierbaren Schlüssel anlegen. | „Als JSON exportieren" und im Basetool importieren. |
| „Deine Systemuhr geht rund … Sekunden vor/nach." | Die Anmeldung wird nur in einem Zeitfenster von wenigen Sekunden akzeptiert. | Unter Einstellungen → Zeit und Sprache → Datum und Uhrzeit die Uhr synchronisieren („Jetzt synchronisieren"), dann erneut senden. |
| „Diese Schnittstelle wurde abgeschaltet …" | Eine alte Version spricht noch die abgeschalteten Adressen an. | Aktualisieren (Updates). |
| „Das Basetool bittet um eine Pause …" | Zu viele Anfragen in kurzer Zeit. | Die genannte Zeit abwarten, dann erneut senden. |
| „Das Tageskontingent für Übertragungen ist aufgebraucht …" | Das Tageslimit für Schreibvorgänge ist erreicht. | Später (spätestens am nächsten Tag) erneut senden. |
| „Das Basetool ist gerade nicht erreichbar …" | Wartung oder eine kurze Störung. | Die genannte Zeit abwarten, dann erneut senden. |
| „Noch nicht gesendet: Nach einem Fehler wartet der Extractor …" | Nach einem Fehler wartet die App vor dem nächsten Versuch — erst 5 Sekunden, nach jedem weiteren Fehler doppelt so lange (höchstens 5 Minuten), und nie kürzer, als das Basetool verlangt. Das schützt das Basetool vor Anfragewellen. | Die genannte Zeit abwarten, dann erneut senden. |
| „… die aktuellen Nutzungsbedingungen … noch nicht angenommen" | Im Basetool wartet eine neue Fassung der Bedingungen. | Das Basetool im Browser öffnen, zustimmen, erneut senden. |
| „… Registrierung … wartet noch auf Freischaltung" | Dein Basetool-Konto ist noch nicht freigeschaltet. | Freischaltung abwarten. |
| „Dein Basetool-Konto darf das nicht …" | Deinem Konto fehlt die Berechtigung. | @greluc oder die Organisationsleitung fragen. |
| „Das Basetool hat die Anmeldung auch nach einer Erneuerung nicht angenommen …" | Die gespeicherte Anmeldung wird nicht mehr akzeptiert. | Später erneut; hilft das nicht: Start → „Vom Basetool trennen" und beim nächsten Senden neu anmelden. |
| „Nicht gesendet: … mehr, als ein Import aufnehmen kann (höchstens 2000)" | Ein Import nimmt höchstens 2000 Blueprints auf. | „Blueprints synchronisieren" verwenden. |
| „Die Daten passen nicht zum Format des Basetools …" | Das Basetool hat den Inhalt als ungültig abgelehnt. | JSON speichern und @greluc melden (mit der Referenz). |
| eine andere Server-Meldung | Der Server hat die Daten aus einem anderen Grund abgelehnt. | Die Meldung lesen; im Zweifel JSON speichern und manuell importieren. |
Browser öffnet nicht? Hat dein System keinen funktionierenden Standardbrowser, kann die automatische Anmeldung hängen. Workaround: abbrechen und stattdessen „Als JSON exportieren" nutzen und die Datei manuell im Basetool importieren.
Manueller Import im Basetool:
- Refinery: Raffinerieverwaltung → „Neuer Auftrag" → „Aus Screenshot-Extract importieren (JSON)" → Datei wählen → Formular prüfen und speichern.
- Blueprints: Meine Blueprints → „JSON importieren" → Vorschau prüfen → übernehmen. Das Basetool liest das neue Dateiformat und auch Dateien älterer Versionen.
Ist der Knopf im Refinery-Export ausgegraut, fehlt dem Auftrag etwas, das das Basetool verlangt — siehe Workflow: Refinery → Wenn „An Basetool senden" gesperrt ist.
Siehe auch: Datenschutz & lokale Verarbeitung · Das JSON-Datenformat · Deinstallation
Inoffizielles Star-Citizen-Fan-Tool — nicht mit der Cloud-Imperium-Unternehmensgruppe affiliiert. Star Citizen®, Roberts Space Industries® and Cloud Imperium® are registered trademarks of Cloud Imperium Rights LLC.
Installation & Wartung
Bedienung
Refinery im Detail
Daten & Konto
Hilfe