# MK8 Logger Aroma Plugin - Benutzerhandbuch

> **Video-Anleitung:** https://mk8u.de/tutorial (Englisch, ohne Ton) – von der Registrierung bis zum ersten Rennen.

Das **MK8 Logger Aroma Plugin** ist ein Plugin für die Wii U (Aroma Custom Firmware), das deine VR-Punkte (VS Race und Battle) nach jedem Rennen automatisch an den Mario Kart 8 Logger Server hochlädt.

---

## Voraussetzungen

Bevor du das Plugin installieren kannst, benötigst du:

1. **Eine Wii U** mit [Aroma](https://aroma.foryour.cafe/) Custom Firmware
2. **WiiUPluginLoaderBackend** und **NotificationModule** (Aroma-Standardkomponenten)
3. **Einen Account** auf dem Mario Kart 8 Logger
4. **Ein verknüpftes Pretendo-Profil** in deinem Account (Pretendo PID)
5. **Einen API Token** (wird über die Profil-Seite generiert, benötigt für Upload/Sync)

---

## Schritt 1: Pretendo-Profil verknüpfen

Falls du noch kein Pretendo-Profil verknüpft hast:

1. Melde dich im Mario Kart 8 Logger an
2. Gehe zur **Spieler**-Seite
3. Suche dein Spielerprofil (nach deinem Mii-Namen)
4. Klicke auf den **"This is me"** Button bei deinem Profil
5. Dein Pretendo-Profil wird nun mit deinem Account verknüpft

Du kannst auf deiner **Profil-Seite** überprüfen, ob die Verknüpfung erfolgreich war. Dort werden dein Mii-Name und deine Player-ID angezeigt.

---

## Schritt 2: API Token generieren

1. Gehe zu deiner **Profil-Seite**
2. Scrolle zum Abschnitt **"API Token"**
3. Klicke auf **"Generate API Token"**
4. Dein Token wird einmalig vollständig angezeigt - kopiere ihn oder lade die Token-Datei herunter

> **Wichtig:** Bewahre deinen Token sicher auf! Er funktioniert wie ein Passwort und ermöglicht das Hochladen von VR-Punkten in deinem Namen.

---

## Schritt 3: Token-Datei herunterladen

1. Klicke auf der Profil-Seite im API Token Bereich auf **"Download for Aroma Plugin"**
2. Eine Datei wird heruntergeladen, die deinen Token enthält
3. Diese Datei wird im nächsten Schritt auf die SD-Karte kopiert

---

## Schritt 4: Plugin installieren

### 4a: Plugin-Datei herunterladen

1. Scrolle auf deiner Profil-Seite zum Abschnitt **"MK8 Logger Aroma Plugin"**
2. Klicke auf **"mk8logger.wps"**, um die Plugin-Datei herunterzuladen

### 4b: Dateien auf die SD-Karte kopieren

Kopiere die heruntergeladenen Dateien an die richtigen Stellen auf deiner SD-Karte:

**Plugin-Datei:**
```
SD-Karte/wiiu/environments/aroma/plugins/mk8logger.wps
```

**Token-Datei:**
```
SD-Karte/wiiu/token/
```

### SD-Karten Ordnerstruktur

```
SD-Karte/
  └── wiiu/
      ├── environments/
      │   └── aroma/
      │       └── plugins/
      │           └── mk8logger.wps              ← Plugin-Datei
      ├── plugins/
      │   └── config/
      │       └── mk8logger.cfg                  ← Konfiguration (automatisch erstellt)
      ├── token/
      │   └── {PID}_api_token.txt                ← API-Token (selbst anlegen)
      └── memsearch.txt                          ← Hex-Suchmuster (optional)
```

---

## Schritt 5: Wii U neu starten

1. Stecke die SD-Karte in deine Wii U
2. Starte die Konsole neu
3. Das Plugin wird automatisch von Aroma geladen
4. Starte Mario Kart 8 - das Plugin aktiviert sich automatisch, sobald Mario Kart 8 gestartet wird
5. Spiele ein Rennen - deine VR-Punkte werden nun automatisch hochgeladen!

---

## Konfigurationsmenü öffnen

Im **Wii U-Menü** (nicht im Spiel):

> **L + D-Pad Down + SELECT**

→ Aroma-Einstellungen → *Mario Kart 8 Logger*

---

## Konfigurationsoptionen

Die Meldungen des Plugins erscheinen auf Deutsch, wenn deine Wii U auf Deutsch eingestellt ist (Systemeinstellungen → Sprache), sonst auf Englisch (ab v0.41.00). Das Menü selbst ist wie das ganze Aroma-Menü englisch.

| Option | Standard | Beschreibung |
|--------|----------|--------------|
| Show VR Display | **AN** | Zeigt nach jedem Online-Rennen deinen VR mit der Änderung an (z. B. „VR: 8812 (+19)") |
| Show Nintendo Network ID | **AN** | Zeigt beim Spielstart dein Konto an („User: Mii (NNID)") |
| Upload VR to mk8u.de | **AN** | Meldet Rennergebnisse und deinen VR an mk8u.de |
| Upload time trial bests to mk8u.de | **AN** | Schickt eine neue Zeitfahr-Bestzeit direkt nach der Zieleinfahrt an mk8u.de (ab v0.17.00) |
| Upload race screenshots (ScreenshotWUPS) | **AN** | Screenshots, die du während eines Online-Rennens mit dem Plugin **ScreenshotWUPS** machst (dessen Tastenkombination), kommen ca. 30 s nach dem Rennergebnis zu diesem Rennen auf mk8u.de (wie viele pro Rennen, legt mk8u.de fest) – sichtbar für angemeldete Nutzer (ab v0.22.00) |
| Upload ghost download rankings to mk8u.de | **AN** | Schickt automatisch die Rangliste, die das Spiel beim Geister-Download lädt (Zeiten rund um deinen Platz), an mk8u.de (ab v0.20.00) |
| Live cheat alarm (impossible items) | **AN** | Bekommt ein Gegner ein Item, das das Spiel auf seinem Platz nie vergibt (auf Platz 1: Blooper, Stachi-Panzer, Stern, Kugelwilli, Blitz, Goldener Pilz), erscheint bis Rennende ein roter Hinweis mit seinem Namen und das Plugin speichert ein TV-Foto, das mit dem Rennen hochgeht (ab v0.25.00) |
| Check for plugin updates | **AN** | Einmal pro Spielstart (nach etwa 30 s) fragt das Plugin mk8u.de nach einer neueren Version (ab v0.28.00) |
| Install updates automatically | **AN** | Lädt die neuere Version über eine geprüfte Verbindung, prüft sie und ersetzt deine `mk8logger.wps` - aktiv nach dem nächsten Neustart der Konsole. Ausgeschaltet kommt nur ein Hinweis. Der Dateiname muss `mk8logger` enthalten (ab v0.28.00) |
| Import all time trial bests now | *(Aktion)* | Einschalten schickt **einmalig** die gespeicherten Bestzeiten aller Strecken an mk8u.de; schon bekannte Zeiten werden übersprungen. Nur im Spiel, nachdem das Hauptmenü geladen ist (ab v0.19.00) |
| Share game files with mk8u.de (home network) | *(Aktion)* | Gibt die Dateien des laufenden Spiels in deinem Heimnetz an deinen Browser, damit die 3D-Ansicht von mk8u.de Originalgrafik, Karts und Musik aus **deinem eigenen Spiel** bauen kann. Adresse und Code zum Eintragen auf mk8u.de bleiben als Meldung stehen, bis mk8u.de verbunden ist (3D-Ansicht → „Dein Spiel“). Mit derselben Adresse und demselben Code wird das GamePad zum Controller fürs Selbst fahren auf mk8u.de, mit Lenken durch Neigen; MK8 reagiert so lange nicht darauf (ab v0.42.00). Nur während MK8 läuft – das Menü dafür im Spiel öffnen; endet beim Ausschalten oder Spielende. Anleitung: [Dein Spiel verbinden](/docs/dein-spiel) (ab v0.40.00) |
| Sync VR from other consoles | **AUS** | Übernimmt beim Spielstart (~15 s) den VR, der zuletzt von einer anderen Konsole hochgeladen wurde |
| Token | *(Info)* | Pfad zur API-Token-Datei |
| Device Hash | *(Info)* | Kennung dieser Konsole (für den Support) |

Für Upload und Sync wird ein API-Token benötigt:
```
SD:/wiiu/token/{Principal_ID}_api_token.txt
```
Die Token-Datei mit dem richtigen Namen (10-stellige Principal ID) lädst du auf deiner Profil-Seite herunter.

### Debug

Nur sichtbar, wenn der Admin für dein Konto „Aroma Debug" einschaltet (für den Support):

| Option | Beschreibung |
|--------|--------------|
| Memory Search | Sucht das Byte-Muster aus `SD:/wiiu/memsearch.txt` im Speicher und schreibt die Umgebung ins Log |
| Reset Device Hash | Setzt die gespeicherte Konsolen-Kennung zurück (Hilfe bei HTTP 400), danach MK8 neu starten |

---

## Was macht das Plugin?

Nach der Installation arbeitet das Plugin vollautomatisch im Hintergrund:

- **Rennergebnisse:** Nach jedem Online-Rennen werden Platzierungen, Punkte und VR aller Spieler an mk8u.de gemeldet
- **Automatischer Upload:** Nach jedem Rennen werden deine VR-Punkte an den Server gesendet
- **VS Race & Battle:** Beide Spielmodi werden unterstützt
- **Region & Land:** Das Plugin sendet automatisch deine Region und deinen Ländercode mit
- **Konsolen-Synchronisation:** VR-Punkte können zwischen mehreren Wii U Konsolen synchronisiert werden

Du kannst deine VR-Punkte auf deiner **Profil-Seite** im Abschnitt "VR Points" einsehen. Dort wird auch ein Verlaufsdiagramm mit deiner VR-Entwicklung angezeigt.

---

## Mehrere Konsolen synchronisieren

Wenn du das Plugin auf mehreren Wii U Konsolen verwendest, werden die VR-Punkte über die Konsolen-Seriennummer synchronisiert:

1. Installiere das Plugin auf beiden Konsolen (jeweils mit dem gleichen API Token)
2. Jede Konsole sendet beim Upload automatisch ihre Seriennummer mit
3. Beim Abrufen der VR-Punkte erkennt jede Konsole, ob die neuesten Punkte von einer anderen Konsole stammen
4. Falls ja, werden die lokalen Punkte automatisch aktualisiert

> **Hinweis:** Du verwendest auf allen Konsolen denselben API Token, da dieser an deinen Account gebunden ist.

---

## Fehlerbehebung

### Schnellübersicht

| Problem | Lösung |
|---------|--------|
| VR wird nicht angezeigt | *Show VR Display* im Konfigurationsmenü aktivieren; der VR erscheint nach jedem Online-Rennen |
| Upload schlägt fehl (HTTP 400) | Support fragen: Mit „Aroma Debug" erscheint *Reset Device Hash* |
| Upload schlägt fehl (kein Token) | Token-Datei mit richtigem Dateinamen (PID) anlegen |
| Sync funktioniert nicht | Upload muss ebenfalls aktiviert sein |

### Das Plugin wird nicht geladen

- Stelle sicher, dass `mk8logger.wps` im richtigen Ordner liegt: `/wiiu/environments/aroma/plugins/`
- Überprüfe, ob Aroma, WiiUPluginLoaderBackend und NotificationModule korrekt installiert sind
- Starte die Wii U neu

### VR-Punkte werden nicht hochgeladen

- Überprüfe, ob die Token-Datei im Ordner `/wiiu/token/` liegt und den korrekten Dateinamen hat (`{PID}_api_token.txt`)
- Stelle sicher, dass *Upload VR to mk8u.de* im Konfigurationsmenü aktiviert ist
- Stelle sicher, dass dein API Token aktiv ist (Profil-Seite prüfen)
- Überprüfe die Internetverbindung deiner Wii U
- Falls der Token widerrufen wurde: Generiere einen neuen Token und lade die neue Token-Datei herunter
- Bei HTTP 400: Support fragen – mit „Aroma Debug" kannst du die Konsolen-Kennung mit *Reset Device Hash* zurücksetzen

### Token ist abgelaufen oder ungültig

1. Gehe zu deiner Profil-Seite
2. Klicke auf **"Regenerate Token"** im API Token Bereich
3. Lade die neue Token-Datei herunter (**"Download for Aroma Plugin"**)
4. Ersetze die alte Token-Datei auf der SD-Karte durch die neue

### Kein Pretendo-Profil verknüpft

Das Plugin benötigt ein verknüpftes Pretendo-Profil, um deine VR-Punkte dem richtigen Spieler zuordnen zu können. Folge [Schritt 1](#schritt-1-pretendo-profil-verknüpfen) oben.

---

## Token verwalten

Auf deiner Profil-Seite kannst du deinen API Token verwalten:

| Aktion | Beschreibung |
|--------|-------------|
| **Generate API Token** | Erstellt einen neuen Token (nur sichtbar, wenn noch keiner existiert) |
| **Download for Aroma Plugin** | Lädt die Token-Datei für die SD-Karte herunter |
| **Reveal Full Token** | Zeigt den vollständigen Token an (einmalig, Seite neu laden zum Verstecken) |
| **Regenerate Token** | Erstellt einen neuen Token und macht den alten ungültig |
| **Revoke Token** | Löscht den Token vollständig |

> **Achtung:** Wenn du einen Token regenerierst oder widerrufst, musst du die neue Token-Datei erneut auf die SD-Karte kopieren!

---

## Häufig gestellte Fragen

**Muss ich das Plugin nach jedem Rennen manuell aktivieren?**
Nein, das Plugin arbeitet vollautomatisch im Hintergrund.

**Kann ich den Token auch für andere Tools verwenden?**
Ja, der API Token kann auch für eigene Scripts oder Tools verwendet werden, die VR-Punkte über die HTTP API hochladen. Details findest du im "How to use" Bereich auf der Profil-Seite.

**Werden nur meine eigenen VR-Punkte hochgeladen?**
Beim Einzel-Upload (automatisch durch das Plugin) werden nur deine eigenen Punkte hochgeladen. Über den Batch-Upload können auch die VR-Punkte anderer Spieler im selben Rennen erfasst werden.

**Was passiert, wenn meine Wii U offline ist?**
Die VR-Punkte werden nur hochgeladen, wenn eine Internetverbindung besteht. Fehlgeschlagene Uploads gehen verloren und werden nicht nachgeholt.

---

## Unterstützte Regionen

| Region | Title ID |
|--------|----------|
| EUR (PAL) | `00050000-1010ED00` |
| USA (NTSC-U) | `00050000-1010EC00` |
| JPN (NTSC-J) | `00050000-1010EB00` |

---

**Version:** 1.2 | **Letzte Aktualisierung:** 2026-03-01