mk8u.de
Login

Benutzerhandbuch

Download as Markdown

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 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 (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 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