﻿=====================================================================
  LATTICE  v1.1
  Live Stats for PlanetSide 2
=====================================================================

Inoffizielles Fan-Tool. Nicht mit Daybreak Game Company verbunden oder
von Daybreak unterstützt. PlanetSide 2 und die Fraktionssymbole sind
Marken von Daybreak Game Company.

English version: README.txt


INHALT
------
  1. Was ist LATTICE?
  2. Voraussetzungen
  3. Service-ID besorgen (wichtig!)
  4. Installation und erster Start
  5. Bedienung
  5a. Layout anpassen
  6. Sounds
  7. Crosshair-Overlay
  8. Autostart mit PlanetSide 2
  9. Hochkant-Monitor / zweiter Bildschirm
 10. Wo werden meine Daten gespeichert?
 11. Probleme und Lösungen
 12. Neu in Version 1.1
 13. Lizenz


1. WAS IST LATTICE?
-------------------
Ein Dashboard, das deine Kills, Tode und vieles mehr live mitzählt,
während du PlanetSide 2 spielst. Es läuft komplett im Browser, du musst
nichts installieren.

  - Live-Werte: Kills, Tode, K/D, Headshot-Rate, Killstreak, Kills pro
    Minute, Revives, zerstörte Fahrzeuge, XP
  - Killfeed mit Gegnernamen, Waffen und Fahrzeugen
  - Auswertung nach Fraktionen, Klassen, Waffen, Gegnern (inkl. Nemesis)
    und Fahrzeugen
  - Kills pro Leben als Diagramm
  - Verlauf: jede Session wird gespeichert, mit Tagesübersicht und
    Diagrammen für 7, 30, 90 Tage oder alles
  - Sounds für Multikills, Killstreaks, Revenge usw. (eigene Dateien)
  - Crosshair-Editor mit Overlay für Windows
  - Eigenes Layout: Fenster verschieben, Größe ändern, ausblenden –
    getrennt für Hochkant und Querformat
  - Startet automatisch mit PlanetSide 2, wenn gewünscht
  - Deutsch und Englisch


2. VORAUSSETZUNGEN
------------------
  - Windows 10 oder 11 (für Crosshair und Autostart; das Dashboard selbst
    läuft in jedem aktuellen Browser)
  - Aktueller Browser: Chrome, Edge oder Firefox
  - Ein PlanetSide-2-Charakter
  - Eine eigene, kostenlose Service-ID von Daybreak (siehe Punkt 3)


3. SERVICE-ID BESORGEN (WICHTIG!)
---------------------------------
Das Dashboard holt sich die Spieldaten über die offizielle Census-
Schnittstelle von Daybreak. Dafür brauchst du eine Service-ID. Sie ist
kostenlos.

  Anmeldung:  https://census.daybreakgames.com/#devSignup
  (falls der Link nicht direkt springt: https://census.daybreakgames.com/
   öffnen und dort "Sign up for a Service ID" wählen)

  - Den Namen der ID darfst du frei wählen. Nur Kleinbuchstaben und
    Zahlen, keine Leerzeichen, z. B. "ps2trackermax".
  - Du gibst deine E-Mail-Adresse an und bekommst die ID per Mail.
  - Die Freischaltung kann ein paar Stunden bis einige Tage dauern.
  - Bis dahin funktioniert das Dashboard mit "s:example". Das ist aber
    stark gedrosselt, Namen von Gegnern und Waffen laden dann langsam.

  Bitte jeder seine eigene ID! Gib deine ID nicht weiter und zeige sie
  nicht in Screenshots oder Streams. Wird eine ID missbraucht, kann
  Daybreak sie drosseln oder sperren.


4. INSTALLATION UND ERSTER START
--------------------------------
  1. Vor dem Entpacken: Rechtsklick auf die ZIP-Datei > Eigenschaften >
     unten den Haken bei "Zulassen" setzen > OK. Sonst blockiert Windows
     später die Skripte für Crosshair und Autostart.
  2. ZIP entpacken, z. B. nach  Desktop\LATTICE
     (nicht nach "C:\Programme", dort fehlen die Schreibrechte).
  3. "lattice.html" doppelklicken. Das Dashboard öffnet sich im
     Browser.
  4. Charaktername und Service-ID eintragen. Das "s:" vor der ID ergänzt
     das Dashboard selbst. Als Event-Stream "Daybreak offiziell" lassen.
  5. Auf "Verbinden" klicken.

  Oben rechts steht danach "LIVE · DAYBREAK" in Grün. Der Timer läuft,
  sobald dein Charakter im Spiel online ist.

  Zum Ausprobieren ohne Spiel gibt es "Demo ansehen".


5. BEDIENUNG
------------
  Reiter "Session"    Live-Werte deiner aktuellen Spielsitzung.
  Reiter "Verlauf"    Alle gespeicherten Sessions mit Tagesübersicht.
  Reiter "Crosshair"  Fadenkreuz gestalten (siehe Punkt 7).
  Reiter "Sounds"     Sounds zuordnen, testen, Lautstärke (Punkt 6).

  - Die Session startet automatisch beim Einloggen ins Spiel und wird
    beim Ausloggen automatisch im Verlauf gespeichert.
  - "Session beenden" speichert sofort und startet eine neue Session.
  - "Verwerfen" setzt die Session auf null, ohne zu speichern.
  - "Einstellungen" > anderen Charakter oder eine neue Service-ID
    eintragen.
  - DE | EN schaltet die Sprache um, "♪ Sound" schaltet alle Sounds
    stumm oder an.
  - Beim Start läuft ein kurzes Intro. Ein Klick startet es mit Ton,
    eine Taste oder ein weiterer Klick überspringt es.


5a. LAYOUT ANPASSEN
-------------------
  Im Reiter "Session" oben rechts auf "Layout" klicken. Dann:

  - Fenster und Kacheln mit der Maus an eine andere Stelle ziehen oder
    mit ◀ ▶ nach vorne bzw. hinten schieben.
  - ↔− / ↔+  macht ein Fenster schmaler oder breiter (12er-Raster),
    ↕− / ↕+  niedriger oder höher. Die Größe steht daneben, z. B. "6×10".
  - ✕ blendet ein Fenster oder eine Kachel aus. Ausgeblendetes steht oben
    in der Leiste und lässt sich mit "+" zurückholen.
  - "Vorlage": "Standard" oder "Kompakt" (nur Zahlen, Kills pro Leben
    und Killfeed – gut für kleine Bildschirme oder OBS).
  - "Zurücksetzen" stellt das Standard-Layout wieder her.
  - "Fertig" beendet den Bearbeitungsmodus.

  Das Layout wird getrennt für Hochkant und Querformat gespeichert. Wer
  den Monitor dreht oder das Fenster wechselt, bekommt automatisch die
  passende Anordnung.


6. SOUNDS
---------
Im Paket sind keine Sounddateien enthalten. Du kannst eigene Sounds im
Format .ogg in den Ordner "sounds" legen. Welche Dateinamen das Dashboard
erwartet, steht in  sounds\LIESMICH.txt.

  - Ausgelöst werden u. a.: First Blood, Double bis Ludicrous Kill
    (Kills innerhalb von 5 Sekunden), Killstreaks (5, 10, 15, 20, 25,
    ab 30 alle 10), Headshot-Serien, Revenge, Domination, Messer-,
    Pistolen-, Schrotflinten- und Granaten-Kills, Überfahren, Abschüsse
    von Luftfahrzeugen, Revive-Serien, Death-Streaks, Teamkills sowie
    Start und Ende der Session.
  - Im Reiter "Sounds" kannst du jedes Ereignis ein- und ausschalten,
    einen anderen Sound zuordnen und mit ▶ probehören.
  - Browser spielen erst Ton ab, nachdem man einmal auf die Seite
    geklickt hat. Erscheint unten "Klicken, um Sounds zu aktivieren",
    einfach einmal irgendwo auf die Seite klicken.
  - Waffen-Sounds (Messer, Pistole usw.) funktionieren ab dem zweiten
    Kill mit einer neuen Waffe, weil die Waffenart erst geladen wird.


7. CROSSHAIR-OVERLAY
--------------------
  1. Im Reiter "Crosshair" dein Fadenkreuz gestalten.
  2. "Für Overlay speichern" klicken und die Datei "crosshair.png" in
     den LATTICE-Ordner speichern. Ab dann speichert der
     Browser automatisch dorthin.
  3. "crosshair-overlay.bat" doppelklicken. Das Fadenkreuz erscheint in
     der Mitte des Hauptbildschirms.

  - Strg + Alt + C  blendet es ein und aus.
  - Beenden: die .bat noch einmal starten oder Rechtsklick auf das
    Symbol unten rechts in der Taskleiste > "Beenden".
  - Änderungen im Editor erscheinen nach dem Speichern sofort.
  - PlanetSide 2 muss im Modus "Randloses Fenster" laufen. Über
    exklusives Vollbild kann sich kein Overlay legen.
  - Das Overlay ist nur ein durchsichtiges Fenster über dem Spiel. Es
    liest nichts aus dem Spiel und greift nicht ein. Eine offizielle
    Freigabe von Daybreak gibt es dafür nicht; Nutzung auf eigenes Risiko.


8. AUTOSTART MIT PLANETSIDE 2
----------------------------
  "Autostart einrichten.bat" doppelklicken. Ab dann öffnen sich das
  Dashboard und das Crosshair automatisch, sobald PlanetSide 2 läuft.
  Wird das Spiel beendet, schließt sich das Crosshair wieder.
  Der Autostart startet nach jedem Windows-Neustart von selbst mit.

  - Nur Dashboard ohne Crosshair: "ps2-autostart.ps1" mit dem Editor
    öffnen, oben  $StartCrosshair = $false  setzen und
    "Autostart einrichten.bat" erneut ausführen.
  - Entfernen: "Autostart entfernen.bat" doppelklicken.


9. HOCHKANT-MONITOR / ZWEITER BILDSCHIRM
----------------------------------------
Das Dashboard passt sich an. Auf einem hochkant gedrehten Monitor
(z. B. 1080 x 1920) passt alles ohne Scrollen auf den Bildschirm.
Tipp: Im Browser F11 drücken für Vollbild.

Für OBS: "lattice.html?overlay=1" als Browserquelle zeigt eine
kompakte Ansicht mit durchsichtigem Hintergrund.


10. WO WERDEN MEINE DATEN GESPEICHERT?
--------------------------------------
Alles bleibt auf deinem PC, im Speicher deines Browsers. Online-Verbin-
dungen gibt es nur zu Daybreak (Spieldaten), bei Auswahl des alternativen
Streams zu Nanite Systems und zu Google Fonts (Schriftarten).

  Achtung: Wenn du im Browser die Website-Daten löschst, ist auch der
  Verlauf weg. Sichere ihn ab und zu mit "Export" im Reiter "Verlauf".
  Mit "Import" holst du ihn zurück, auch auf einen anderen PC.


11. PROBLEME UND LÖSUNGEN
-------------------------
  "Verbindung weg" in Rot
    > Service-ID prüfen (Tippfehler?). Unter Einstellungen den anderen
      Event-Stream ausprobieren. Ist die ID noch nicht freigeschaltet,
      vorübergehend "s:example" nutzen.

  "Charakter nicht gefunden"
    > Schreibweise prüfen. Der Name muss genau so geschrieben sein wie
      im Spiel.

  Crosshair oder Autostart startet nicht / Windows warnt
    > Siehe Installation, Schritt 1 ("Zulassen"). Alternativ: Rechtsklick
      auf die .ps1-Datei > Eigenschaften > "Zulassen".

  Crosshair im Spiel nicht sichtbar
    > PlanetSide 2 auf "Randloses Fenster" stellen.

  Keine Sounds
    > Liegen .ogg-Dateien im Ordner "sounds"? Ist "♪ Sound an"? Einmal
      auf die Seite klicken. Danach F5.

  Timer zeigt --:--:--
    > Das ist richtig, solange dein Charakter offline ist.


12. NEU IN VERSION 1.1
----------------------
  - Neuer Name: aus "PS2 Tracker" wird LATTICE, mit neuem Logo und
    animiertem Intro
  - Layout-Editor (siehe 5a)
  - Dashboard-Datei heißt jetzt lattice.html

  Update von 1.0: Neue Dateien über die alten kopieren und einmal
  "Autostart einrichten.bat" ausführen, falls der Autostart genutzt wird.
  Verlauf und Einstellungen bleiben in Chrome und Edge erhalten. In
  Firefox vorher den Verlauf exportieren und danach wieder importieren.


13. LIZENZ
----------
MIT-Lizenz, siehe LICENSE.txt. Die Fraktionssymbole im Ordner
"emblems" sind Marken von Daybreak Game Company und fallen nicht unter
die MIT-Lizenz.
