PortMaster ist ein Werkzeug, mit dem Sie PC-Spielports herunterladen und installieren können (z. B., Stardew Valley, Half-Life, Celeste) direkt auf Linux-basierten Retro-Handhelds wie dem TrimUI Brick und den meisten Anbernic-Handhelds.

1. Voraussetzungen #

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein unterstütztes Gerät und BetriebssystemGeräte, auf denen Firmware läuft, wie TrimUI Stock, ArkOS, AmberELEC, RockNIX, JELOS, muOS, oder Knulli. Andere können ebenfalls unterstützt werden.
• InternetverbindungIhr Gerät muss mit WLAN verbunden sein, um die PortMaster-App und Spieldateien herunterzuladen.
• Spieldateien (nur kommerziell)Bei kostenpflichtigen Spielen müssen Sie das Spiel auf dem PC (Steam, GOG oder Itch.io) rechtmäßig besitzen, um auf die erforderlichen Datendateien zugreifen zu können.

2. Installation von PortMaster #

Die meisten benutzerdefinierten Firmware-Versionen werden mit PortMaster vorinstalliert geliefert.

1. Navigiere zu Werkzeuge oder Häfen Abschnitt des Hauptmenüs Ihres Geräts.
2. Wählen Sie PortMaster um die Anwendung zu starten.
3. Wenn PortMaster fehlt:
   • Installieren oder aktualisieren Sie Ihre Firmware zuerst auf die neueste Version
   • Herunterladen Install.PortMaster.sh vom PortMaster GitHub-Releases.
   • Kopiere die Datei in das roms/ports/ Ordner auf Ihrer SD-Karte.
   • Navigieren Sie auf Ihrem Gerät zum Menü "Ports" und führen Sie das Installationsskript aus.

3. Installation von “Ready to Run”-Spielen #

Dies sind kostenlose Open-Source-Spiele, die keine zusätzlichen Dateien benötigen.

1. Öffnen PortMaster App auf Ihrem Gerät.
2. Navigiere zu “Bereit für den Start der Häfen” (oder “Alle Ports”).
3. Zum Finden eines Spiels scrollen (z.B., Super Mario 64 Port, Spelunky Classic).
4. Presse A (oder deine Auswahltaste) zum Installieren.
5. Sobald Sie fertig sind, beenden Sie PortMaster. Das Spiel wird in Ihrem Gerät angezeigt Häfen Menü und ist spielbereit.

4. Installation kommerzieller Spiele #

Kostenpflichtige Spiele wie Stardew Valley oder Vizepolizeistadt erfordert, dass Sie gekaufte Spieldateien von Ihrem PC kopieren.

Schritt A: Installiere das Port-Skript #

1. Öffnen Sie PortMaster auf Ihrem Handheld.
2. Finde das Spiel in der Liste (z.B., Stardew Valley).
3. Wählen Sie Installieren.
   • Hinweis: Dies installiert nur den Linux “Wrapper” (das Startskript), nicht den eigentlichen Spielinhalt.

Schritt B: Übertragen von Spieldateien #

1. Anforderungen prüfenBesuch PortMaster Spiele um genau zu sehen, welche Dateien für Ihr spezifisches Spiel benötigt werden.
2. Dateien auf dem PC suchen:
   • Dampf: Rechtsklick auf Spiel > Verwalten > Lokale Dateien durchsuchen.
   • GOG/ItchÖffnen Sie den Installationsordner.
3. Übertragen auf SD-Karte:
   • Legen Sie die SD-Karte Ihres Handheld-Geräts in Ihren PC ein.
   • Navigiere zu roms/ports/ oder Häfen/) Ordner.
   • Öffnen Sie den Ordner, der für das spezifische Spiel erstellt wurde (z. B., roms/ports/stardewvalley/).
   • Kopiere deine PC-Spiel-Assets in die Spieldaten Ordner (oder wo die spezifischen Anweisungen des Spiels dies angeben).

Häufige Beispiele #

• Stardew ValleyErfordert die Version vom “Compatibility”-Branch von Steam. Kopieren Sie den Inhalt des Spielordners in den Spieldaten Ordner auf der SD-Karte.
• BalatroExtrahieren Balatro.liebe von Steam .exe (mit 7-Zip) oder .app Datei. Kopieren Balatro.liebe in den Port-Ordner.
• Half-LifeKopiere die Ventil Ordner von deiner Steam-Installation nach roms/ports/halflife/.

5. Fehlerbehebung #

• Spiel stürzt abWenn ein Spiel versucht zu laden und Sie sofort ins Menü zurückwirft:
  • Navigieren Sie zum Ordner des Spiels auf der SD-Karte (z. B., ROMs/Ports/Spielname/).
  • Öffnen Log.txt Datei, um den Fehler zu sehen (normalerweise fehlende Dateien).
• Steuerung funktioniert nichtStellen Sie sicher, dass Ihre Controller-Eingabe in EmulationStation oder den Betriebssystemeinstellungen korrekt konfiguriert ist, bevor Sie PortMaster starten.
• Fehlende Texturen/AudioZeigt normalerweise an, dass Sie die falschen Dateien oder eine inkompatible Version der Spieldaten kopiert haben. Überprüfen Sie die Dateiliste im PortMaster-Wiki.