Game Porting Toolkit 4: Agentenbasierte Spiele-Ports auf dem Mac

„I am using Claude Code for everything today.” David Srour, ein Ingenieur im Metal Ecosystem Team von Apple, sprach diesen Satz auf einer Bühne der WWDC 2026 aus und verbrachte dann den Rest von Session 357 damit, Microsofts MiniEngine von D3D12 unter Windows auf Metal 4 unter macOS zu portieren – wobei ein Agent die Plattformarbeit erledigte.¹ Das Vehikel ist Game Porting Toolkit 4, das agentenbasierte Skills als Plugin liefert, das Sie aus dem Game-Porting-Toolkit-Marketplace auf GitHub installieren: Experten-Skills, die das Plattformwissen tragen, Workflow-Skills, die einen meilensteinbasierten Prozess durchsetzen, und einen Porting-Assistenten-Agenten, der beide orchestriert.¹ Apple baute außerdem das Primitiv, das die Demo überhaupt erst möglich machte. macOS 27 ergänzt gpucapture und gpudebug, Kommandozeilen-Tools, mit denen ein Agent ein GPU-Frame erfassen und analysieren kann, ohne dass ein Mensch Xcode bedient.¹

Apple veröffentlichte ein hauseigenes Skill-Paket für einen Coding-Agenten, das auf eine Domäne abzielt, die Agenten zuvor nicht eigenständig berühren konnten: das Hochfahren eines Renderers, das Debuggen falscher Pixel und das Tuning eines Upscalers. Session 356 ist das Begleitstück, in dem Paweł Sasko von CD PROJEKT RED durchgeht, wie das Studio Cyberpunk 2077: Ultimate Edition von Hand auf den Mac brachte. Der Cyberpunk-Port ist älter als die agentenbasierten Skills; niemand bei CDPR ließ einen Porting-Assistenten laufen. Apple stellt die beiden Sessions bewusst nebeneinander und schließt den Cyberpunk-Vortrag damit, dass es Entwickler auf den agentenbasierten verweist.² Zusammen gelesen führen sie ein einziges Argument: Das manuelle Playbook funktioniert auf AAA-Maßstab, und Game Porting Toolkit 4 übergibt dieses Playbook an einen Agenten.

Kurzfassung

• Game Porting Toolkit 4 ergänzt agentenbasierte Skills für das Spiele-Porting: Experten-Skills (Domänenwissen), Workflow-Skills (ein meilensteinbasierter Prozess) und einen Porting-Assistenten-Agenten, der sie orchestriert – verteilt als Plugin aus dem Game-Porting-Toolkit-Marketplace auf GitHub.¹
• Der Workflow durchläuft Discover (Codebasis-Scan, Referenz-Captures aus der Evaluierungsumgebung, Präferenzfragen), Plan, Execute und Validate; jeder Meilenstein lädt seine Experten-Skills automatisch „without relying on whether the model decides to use them or not”, und der Agent „stores what it learns across milestones”.¹
• macOS 27 liefert gpucapture und gpudebug, CLI-Tools, die „support fully autonomous agent workflows”, sowie Metal-HUD-Erweiterungen für MetalFX: eine Belichtungsanzeige, ein Jitter-Streudiagramm, das Werte außerhalb des Bereichs rot markiert, und Live-Overrides.¹
• Apple demonstrierte die Skills, indem es Microsofts MiniEngine von D3D12 auf Metal 4 portierte, und richtete den Assistenten dann auf Godot, das einen Metal-4-Backend erhielt, der „up and running in a few days” war.¹
• Cyberpunk 2077 belegt die zugrunde liegende Pipeline auf AAA-Maßstab, auf manuelle Weise: Profiling zuerst in der Evaluierungsumgebung, das „For this Mac”-Auto-Preset, automatisch kalibriertes HDR über EDR und kopfverfolgtes räumliches Audio – und es gewann den Mac Game of the Year bei den App Store Awards 2025 von Apple.²

Der Porting-Assistent und seine Skills (Session 357)

David Srour benennt seinen Agenten und installiert das Plugin aus dem Game-Porting-Toolkit-Marketplace, ab 3:26.

Ein typischer Port bedeutet, die Arbeit abzustecken, einen Build zum Laufen zu bringen, Shader zu konvertieren, den Renderer hochzufahren, Eingaben neu zuzuordnen, für ein natives Gefühl zu polieren und die Performance zu optimieren.¹ Game Porting Toolkit 4 greift diese Liste mit zwei Arten von Skills an. Experten-Skills bieten technische Anleitung: Plattformwissen, Best Practices und Hinweise auf gängige Porting-Anti-Patterns. Workflow-Skills bieten den strukturierten Ansatz. Der Porting-Assistenten-Agent verbindet sie miteinander, und Apple ist deutlich, warum Orchestrierung wichtig ist: „During execution, all planned milestones automatically load the necessary expert skills without relying on whether the model decides to use them or not.”¹ Die Skill-Auswahl ist nicht länger ein Würfelwurf des Modells, sondern wird Teil der Prozessdefinition.

Die Verteilung läuft über das eigene Plugin-System des Agenten. „The skills and assistant are provided as a plugin from the Game Porting Toolkit marketplace on GitHub. You will first add the marketplace. And then install the plugin.”¹ Das Repository hinter diesem Marketplace ist apple/game-porting-toolkit, beschrieben als „Resources for porting games and engines to Apple platforms”; sein README dokumentiert dieselbe Aufteilung: Experten-Skills, die Metal 4, MetalFX, Shader-Kompilierung, Plattform-Frameworks und Debugging-Tools abdecken, und Workflow-Skills, die einen meilensteinbasierten Porting-Prozess durchführen und den Zustand zwischen Sessions persistieren.³ In Claude Code ist die Registrierung des Marketplace ein einziger Befehl: /plugin marketplace add apple/game-porting-toolkit.³

Der Workflow des Assistenten hat drei Phasen. Discover betrachtet Ihre Codebasis, holt Referenz-Captures aus der Evaluierungsumgebung (dieselbe Umgebung mit übersetztem Windows-Build, die CDPR nutzte – mehr dazu weiter unten) und stellt Ihnen Fragen zu Ihren Präferenzen. Anschließend planen Sie gemeinsam mit dem Assistenten die Meilensteinziele, „since porting a whole title is usually too big for one session”.¹ Für jeden Meilenstein führt der Agent die Änderungen aus, während Sie ihn anleiten, und dann durchläuft die Validierung eine mehrstufige Checkliste: Die App startet ordnungsgemäß, die Metal-Validierung besteht bei API-Nutzung und Shadern, Screen-Captures bestätigen die visuelle Korrektheit gegenüber Ground-Truth-Referenzen, der Agent überprüft den Code anhand bekannter Anti-Patterns aus den verwendeten Skills, und er prüft auf Speicherprobleme.¹ Der Agent „stores what it learns across milestones, so nothing gets lost between sessions” außerdem.¹

Die MiniEngine-Demo zeigt, was die Experten-Skills tatsächlich bringen. Für den ersten Meilenstein – ein Fenster mit korrektem Frame-Pacing – laden vier Skills zusammen: Fenstererstellung und -lebenszyklus, Swap-Chain-Konzept-Mapping, Drawable-Präsentation und metal-cpp-Objektlebensdauern.¹ Für das Szenen-Rendering lehrt der Resources-Skill das Residency-Modell von Metal 4: Registrieren Sie Ressourcen frühzeitig in einem Residency-Set, denn ohne dieses Wissen erzeugt der Agent Code, der kompiliert, während die GPU die Textur nicht lesen kann.¹ Die Shader-Pipeline- und Converter-Skills lassen den Agenten Argument-Buffer-Offsets aus der Laufzeit des Metal Shader Converter abfragen, statt MiniEngines Index-mal-Größe-Arithmetik zu kopieren, die bricht, wenn der Converter Buffer anders anordnet: „No error, just incorrect rendering.”¹ Der Synchronisations-Skill bildet das Barrier-Modell von D3D12 auf das Producer-Consumer-Modell von Metal 4 ab, statt den Agenten auf pauschale Barriers an Encoder-Grenzen zurückfallen zu lassen, die in einfachen Fällen funktionieren und mit wachsender Pipeline still brechen.¹ Über alle drei hinweg zeichnet sich ein Muster ab: Der Fehlerfall, den die Skills verhindern, ist selten ein Absturz. Es sind falsche Pixel ohne Fehlermeldung.

Die Skills reichen über das erste Spielbare hinaus. Ein Game-Controller-Skill deckt die GCController-Erkennung ab und lehrt den Agenten, abzufragen, was ein verbundenes Gerät tatsächlich unterstützt, statt das feste Layout von XInput anzunehmen.¹ Zwei MetalFX-Skills behandeln Upscaling und Frame-Interpolation: Der Upscaling-Skill konfiguriert Jitter im Pixel-Raum (normalisierte Werte würden die zeitliche Akkumulation faktisch deaktivieren), richtet Motion-Vektoren mit dem richtigen Maßstab und den richtigen Konventionen ein und liefert MIP-Bias- und History-Reprojection-Setup; der Frame-Interpolations-Skill etabliert einen dedizierten Present-Thread, damit interpolierte und gerenderte Frames gleichmäßig beabstandet bleiben.¹

Srour schloss mit einer zweiten Codebasis: „I pointed the porting assistant at Godot, a production engine with an existing Metal 3 backend, and asked it to add Metal 4 alongside it.”¹ Derselbe Workflow, dieselben Skills, Validierung gegen Ground Truths. „It’s still a collaborative effort, but the skills sped things up significantly. It was up and running in a few days.”¹ Seine Arbeitsteilung für die gesamte Session ist der Teil, der es wert ist, jedem zitiert zu werden, der dem agentenbasierten Porting skeptisch gegenübersteht: „I let the skills do the heavy lifting, while I focused on other things: making the architectural decisions, reviewing the agent’s output, and providing important context about the game.”¹

gpucapture und gpudebug: das Primitiv für autonomes Debugging

Der entscheidende Moment in Session 357 kommt mitten im MiniEngine-Port, als das erste Licht mit falscher Beleuchtung und sichtbar verzerrten Wandtexturen erscheint. Srour benennt die Lücke direkt: „Normally I’d capture a frame in Xcode and diagnose the issue. But until now, an agent couldn’t do that on its own.”¹ GPU-Debugging war die harte Wand für autonome Grafikarbeit; alles lief über eine GUI.

macOS 27 reißt die Wand ein: „macOS 27 introduces new command-line tools which support fully autonomous agent workflows: gpucapture for capturing a GPU frame, and gpudebug for analyzing it.”¹ In der Demo beschreibt Srour die visuellen Symptome, der Agent lädt einen Skill zum Debuggen von Rendering-Problemen mit einer strukturierten Symptom-zu-Ursache-Methodik, erfasst einen Trace mit gpucapture, während die App läuft, und nutzt dann gpudebug, um „anything you’d normally check in Xcode, resource bindings, constants, resource contents, and data flow through the pipeline” zu inspizieren, indem er nachverfolgt, wo die Ausgabe von der Evaluierungsumgebung abweicht, bis er das Problem findet und behebt.¹ Dieselben Tools speisen anschließend die Validierung: Der Agent vergleicht Dispatch-Aufrufe, Pipelines und Dispatch-Dimensionen mit dem ursprünglichen Trace – ein Seite-an-Seite-Vergleich, den Srour als mühsam bezeichnet, um ihn für jeden Meilenstein von Hand durchzuführen.¹ Apples Produktseite macht die Einordnung explizit: Mit Kommandozeilenzugriff für Metal-Tools können Agenten Metal-Workloads jetzt direkt erfassen, debuggen und profilen.³

macOS 27 erweitert außerdem das Metal HUD für die MetalFX-Integrationsarbeit. Das HUD zeigt jetzt den Belichtungsparameter des Upscalers an, damit Sie bestätigen können, dass er die API erreicht, zeigt Informationen zur Jitter-Sequenz mit auf einem Streudiagramm rot markierten Jittern außerhalb des Bereichs und bietet Live-Overrides für Jitter-Multiplikatoren und Motion-Vektor-Maßstäbe, die wirksam werden, während die App läuft.¹ Die Demo-Diagnose ist ein sauberes Beispiel für die Technik: wackelnde Artefakte während der Kamerabewegung, das HUD zeigt die X-Skala des Motion-Vektors negiert an, das Umklappen im Overrides-Panel behebt das Wackeln, und „if the HUD overrides fix the output, that tells you where the bug is”.¹ Anschließend verfolgen Sie die Korrektur zurück zur Quelllogik.

Cyberpunk 2077: das manuelle Playbook auf AAA-Maßstab (Session 356)

Paweł Sasko führt durch das „For this Mac”-Preset auf einem M5 Max MacBook Pro, ab 15:26.

Session 356 stellt Garrett Austin, einen Ingenieur im Game-Performance-Team von Apple, an die Seite von Paweł Sasko, Associate Game Director bei CD PROJEKT RED.² Um beim Zeitablauf präzise zu sein: Cyberpunk 2077: Ultimate Edition erschien auf dem Mac und gewann den Mac Game of the Year bei den App Store Awards 2025 von Apple, bevor die agentenbasierten Skills von Game Porting Toolkit 4 existierten.² CDPR erledigte jeden Schritt in der Session von Hand. Der Grund, warum die Session in einen Beitrag über agentenbasiertes Porting gehört, ist, dass die Pipeline, die CDPR manuell durchlief, dieselbe ist, die der Porting-Assistent nun orchestriert – Evaluierungsumgebung, Metal Shader Converter, MetalFX, Ground-Truth-Validierung – und Apple verbindet die beiden selbst, indem es die Cyberpunk-Session damit schließt, Zuschauer zu „Speedrun your game port with agentic coding” zu schicken.²

CDPRs erster Schritt legte das Muster fest. „Before we started building the native path for Cyberpunk 2077 on Mac, we used Apple’s Game Porting Toolkit to evaluate the Windows build in a translated environment on macOS. This let us gain valuable insight before writing any code.”² Das Studio fuhr einen vordefinierten Satz von Hotspot-Sequenzen in der Evaluierungsumgebung und las jeden Durchlauf aus drei Blickwinkeln: statistische Frame-Time-Daten aus dem In-Engine-Profiler, Metal-HUD-Korrelation zwischen Szenenereignissen und dem Trace sowie Engine-internes Profiling, aufgeschlüsselt nach Thread.² Die Signale waren früh klar. Die GPU-Zeit sah auf High-Spec-Hardware gesund aus, während dichtes Fahren durch die Stadt CPU-Druck als den eigentlichen Hotspot offenlegte. Die Umgebung markierte sogar ihre eigenen Artefakte – Frame-Time-Oszillation durch Live-Shader-Übersetzung und schwer wirkende Audio-Middleware, die beide in nativen Binaries verschwanden; Game Porting Toolkit identifizierte sie, sodass CDPR wusste, dass es früh nachforschen musste.² Übertragen Sie das auf die Discover-Phase von Session 357, in der der Assistent Referenz-Captures aus derselben Evaluierungsumgebung holt, bevor er auch nur einen Meilenstein plant, und die Vererbung ist direkt.

Der Auslieferungsschliff ist der Punkt, an dem sich die Mac-Version abhebt – beginnend mit dem ersten Start. „For this Mac” ist ein geräteabhängiges Grafik-Preset-System: Es erkennt die Hardware in Ihrem Mac und konfiguriert die Einstellungen für das Gerät automatisch.² CDPR wählte gerätespezifische Einstellungen, die die Bildtreue halten, setzte Ziel-Frameraten von 30 oder 60 FPS, fuhr MetalFX mit Dynamic Resolution Scaling zwischen abgestimmten Mindest- und Höchstauflösungsgrenzen, setzte VSync für das Frame-Pacing und aktivierte HDR je nach Display-Fähigkeit, und stimmte dann jede verbleibende Einstellung pro Gerät in einer Schleife aus Messen, Verfeinern und erneutem Validieren ab.² Sasko demonstrierte das Ergebnis auf einem MacBook Pro mit dem M5-Max-Chip: Ultra-Preset als Basis, ein 60-FPS-Lock mit VSync, Dynamic Resolution Scaling mit Rendering zwischen 50 und 80 Prozent einer Ausgabe von 2336x1460, das 60 FPS durch Dogtowns Black Market hielt – eines der schwersten Gebiete im Spiel – mit Out-of-the-box-Einstellungen.² Die Idee verbreitet sich: „other developers are starting to adopt ‘For this Mac’ settings in their games as well”.²

HDR wird ohne Kalibrierungsbildschirm ausgeliefert. CDPR implementierte HDR über Apples Extended-Dynamic-Range-Pipeline, indem es maximumExtendedDynamicRangeColorComponentValue für den aktuellen maximalen EDR-Wert des Displays abfragte und ihn direkt an den Tone-Mapper weitergab; der Wert ändert sich mit Display-Hardware und -Bedingungen, sodass der Tone-Mapper immer dem folgt, was das Panel tatsächlich leisten kann.² HDR schaltet sich standardmäßig ein, wenn ein Display den nötigen Spielraum dafür hat: Das Spiel prüft maximumPotentialExtendedDynamicRangeColorComponentValue und aktiviert HDR, wenn der maximale potenzielle EDR-Wert des Displays 2.0 übersteigt.²

Audio erhält dieselbe Standard-an-Behandlung. Cyberpunks Middleware implementiert Apples Spatial-Audio-APIs über AVAudioEngine, und CDPR aktivierte Head-Tracking für AirPods, indem es die Eigenschaft listenerHeadTrackingEnabled des AVAudioEnvironmentNode auf true setzte – standardmäßig an, ohne zusätzliche Einrichtung.² Game Mode hilft derselben Hardware: Er gibt Spielen höher priorisierten Zugriff auf CPU und GPU und verdoppelt die Bluetooth-Abtastrate, was die Latenz für drahtlose Controller und AirPods-Audio senkt, und macOS aktiviert ihn automatisch für Apps, die als Spiele kategorisiert sind.²

Die Ergebniszahlen schließen den Fall für die Plattform ab. Cyberpunk 2077 hat sich 35 Millionen Mal über alle Plattformen hinweg verkauft, plus weitere 10 Millionen Exemplare von Phantom Liberty, und Cyberpunk 2077: Ultimate Edition gewann den Mac Game of the Year bei den App Store Awards 2025 von Apple.² Saskos Fazit ist das, was sich Studios merken werden: „what matters is not how much work you put into something, but what the result is for our players”.²

Wie Sie starten

Die beiden Sessions fügen sich zu einer Abfolge zusammen:

1. Fahren Sie zuerst Ihren Windows-Build in der Evaluierungsumgebung. Kein Code erforderlich, und die Umgebung unterstützt jetzt Metal 4 für Kompatibilitäts- und Performance-Tests.³ Folgen Sie CDPRs Lesart: Hotspot-Sequenzen, Frame-Time-Statistiken, Metal-HUD-Korrelation und CPU-Profiling pro Thread, und behandeln Sie Artefakte der Übersetzungsschicht als markierte Hinweise, nicht als Urteile.²
2. Installieren Sie die Skills. Fügen Sie den Game-Porting-Toolkit-Marketplace hinzu und installieren Sie das Plugin; in Claude Code lautet die Marketplace-Registrierung /plugin marketplace add apple/game-porting-toolkit.¹³ Wenn Sie unsicher sind, was als Nächstes zu tun ist, fragen Sie den Porting-Assistenten; sein erster Schritt ist die Discovery.¹
3. Planen Sie Meilensteine mit dem Assistenten und lassen Sie die Validierung jeden einzelnen absichern. App-Start, Metal-Validierung, Capture-Vergleich gegen Ground Truth, Anti-Pattern-Review und Speicherprüfungen laufen pro Meilenstein, und der Agent trägt das Gelernte in die nächste Session.¹
4. Wechseln Sie zu macOS 27 für die Debugging-Schleife. gpucapture und gpudebug geben dem Agenten autonome Frame-Erfassung und -Analyse, und die MetalFX-Erweiterungen des Metal HUD (Belichtungsanzeige, Jitter-Streudiagramm, Live-Overrides) lokalisieren Upscaler-Bugs, während das Spiel läuft.¹
5. Stehlen Sie die Cyberpunk-Auslieferungs-Checkliste. Ein Auto-Preset im „For this Mac”-Stil für den ersten Start, EDR-getriebenes automatisch kalibriertes HDR mit Standard-an oberhalb von 2.0 potenziellem Spielraum und kopfverfolgtes räumliches Audio über listenerHeadTrackingEnabled.²

FAQ

Was genau fügt Game Porting Toolkit 4 für Agenten hinzu?

Drei Dinge: Experten-Skills, die einem Coding-Agenten Plattformwissen, Best Practices und Anti-Pattern-Hinweise über Metal 4, MetalFX, Shader-Kompilierung, Plattform-Frameworks und Debugging hinweg geben; Workflow-Skills, die einen meilensteinbasierten Prozess mit persistiertem Zustand durchsetzen; und einen Porting-Assistenten-Agenten, der die Methodik orchestriert und pro Meilenstein die richtigen Experten-Skills automatisch lädt, statt die Wahl dem Modell zu überlassen.¹³

Auf welchem Coding-Agenten läuft der Porting-Assistent?

Apples Session-Demo läuft vollständig auf Claude Code; Srour sagt, er sei „using Claude Code for everything today”.¹ Die Skills installieren sich als Plugin aus dem Game-Porting-Toolkit-Marketplace auf GitHub, und das Repository organisiert seine Installationsdokumentation pro Coding-Agent, wobei der Marketplace-Befehl von Claude Code direkt dokumentiert ist.³

Was sind gpucapture und gpudebug?

Neue Kommandozeilen-Tools in macOS 27. gpucapture erfasst ein GPU-Frame aus einer laufenden Anwendung; gpudebug analysiert die Erfassung und legt Resource-Bindings, Konstanten, Ressourceninhalte und Pipeline-Datenfluss offen, die zuvor die GUI von Xcode erforderten. Apple baute sie, damit Agenten-Workflows „fully autonomous” sein können: Ein Agent kann jetzt von einem visuellen Symptom über eine Ursache zu einer validierten Korrektur gelangen, ohne dass ein Mensch Frames erfasst.¹

Hat CD PROJEKT RED die agentenbasierten Skills genutzt, um Cyberpunk 2077 zu portieren?

Nein. Der Mac-Port von Cyberpunk 2077 war eine manuelle Arbeit, die erschien und den Mac Game of the Year bei den App Store Awards 2025 von Apple gewann, bevor die agentenbasierten Skills von Game Porting Toolkit 4 existierten.² Die Relevanz läuft in die andere Richtung: CDPRs Pipeline (zuerst Evaluierungsumgebung, Metal Shader Converter, MetalFX mit Dynamic Resolution Scaling, Ground-Truth-Validierung der Optik) ist dasselbe Playbook, das der Porting-Assistent nun mit einem Agenten ausführt.¹²

Wie funktioniert das „For this Mac”-Preset?

Es erkennt die Hardware im Mac des Spielers und konfiguriert Grafik- und Videoeinstellungen für dieses Gerät automatisch: ein 30- oder 60-FPS-Ziel, MetalFX mit Dynamic Resolution Scaling innerhalb abgestimmter Auflösungsgrenzen, VSync, Ausgabeauflösung und HDR je nach Display-Fähigkeit, wobei jede verbleibende Einstellung pro Gerät von Hand abgestimmt ist. Auf einem M5 Max MacBook Pro verwendet das Preset Ultra als Basis und hält gesperrte 60 FPS, während es 50 bis 80 Prozent von 2336x1460 rendert.²

Running Agentic AI on the Mac with MLX behandelt die Seite der lokalen Inferenz agentenbasierter Arbeit auf dem Mac, und Xcode 27 Went Agentic behandelt die IDE-Seite; Game Porting Toolkit 4 ist das spiele-porting-spezifische dritte Standbein. Metal 4 Essentials erläutert die API, auf die die Skills abzielen. Der vollständige Serien-Hub ist die Apple Ecosystem Series.

Quellen