Skip to content

Metal 4: promote locally validated MobileGL hotpath to master - #23

Merged
21Z121Z1 merged 348 commits into
masterfrom
feature/mobilegl-inspired-hotpath
Aug 11, 2026
Merged

Metal 4: promote locally validated MobileGL hotpath to master#23
21Z121Z1 merged 348 commits into
masterfrom
feature/mobilegl-inspired-hotpath

Conversation

@21Z121Z1

Copy link
Copy Markdown
Owner

What

Promote feature/mobilegl-inspired-hotpath (26e5adff3fbd5384b16ea9875c354c3a008a695a) to master.

Why

This is the current Metal 4 renderer/hotpath branch with validated render-command packets, argument tables, bounded terrain ICB, residency, and production Iris-on-Metal integration.

Local Apple GPU validation

  • Device: Apple M1 Pro, 16-core GPU, macOS 26.5.1, Metal 4, Xcode 26.6, Java 25, arm64, AC power.
  • Static and GPU verification, native/synthetic render-contract validation, Metal 4 API/pipeline/readback, MRT, MetalFX offscreen, frame-generation lifecycle, and Metal 4 presentation validation passed.
  • Real Minecraft client on the same deterministic New World passed Sodium-only, BSL, and Potato lanes. Each lane used the physical M1 Pro with Metal 4 main renderer closure, 17/17 render-contract captures, 0 failed captures, 0 dropped captures, 0 legacy encoder violations, and an empty validation-failure list. BSL and Potato were loaded through MetalWorldRenderingPipeline; local fixture archives were used only as test inputs.
  • Candidate admission for mobilegl-complete admitted argument tables, render-command packet, terrain ICB, and pipeline prewarm; terrain ICB attempts/accepted batches/allocations matched, draws were positive, and fallback/zero-allocation counters were zero.
  • Full local ABBA performance gate: 4 interleaved paired blocks, 30 s warmup + 120 s sample. Decision: accepted-candidate; correctness passed, no runtime failures, no guardrail regressions. Stable improvements included average FPS +3.69%, FPS median +1.83%, GPU p95 -0.38%, GPU p99 -5.49%, Java-to-native FFM calls/frame -9.85%, and native setter operations/frame -5.80%.

Checks and scope

No source changes were made during local validation; the PR head is the already-published SHA above. Generated local logs, copied world data, and shader-pack fixtures are not part of the PR.

The performance run did not produce complete paired structured values for resident memory or render-pass store/load bytes, so those metrics are not claimed. The 1% low FPS metric was not an improvement; the acceptance decision is based on the repository's declared gate and the stable metrics listed above.

21Z121Z1 and others added 30 commits August 2, 2026 18:07
github-actions Bot and others added 26 commits August 4, 2026 01:26
Scope Metal 4 native state to device lifetime
…-fix

fix: stabilize Metal 4 Sodium terrain geometry
Adopt capability-governed hosted Metal validation on feature/mobilegl-inspired-hotpath, including strict offscreen GPU gates, iPhoneOS cross-build, iOS Simulator runtime coverage, static policy auditing, and negotiated-capability handling for Metal 4 fallback semantics.
Copilot AI lite review requested due to automatic review settings August 11, 2026 07:24

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

@21Z121Z1
21Z121Z1 merged commit 6a8ef77 into master Aug 11, 2026
13 checks passed
@21Z121Z1
21Z121Z1 deleted the feature/mobilegl-inspired-hotpath branch August 11, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants