exo/voxy-zink-mac
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
Voxy on macOS via Zink+KosmicKrisp translation layer (GL4.6→Vulkan→Metal)
12 commits 1 branch 1 tag 27 MiB
  • C 72.6%
  • Java 14.2%
  • Shell 13.2%
Find a file
Exact
exo 80cd6b2b17 2026-07-18 refresh: rebase onto Mesa main (26.3.0-devel, Vulkan 1.4 KosmicKrisp), Voxy 0.2.17-beta, Sodium 0.8.12 
- Mesa macOS port rebased onto upstream main cf0588a5b83 (branch kk-mac-20260718);
  obsolete patches dropped (nullDescriptor, Metal4-pipeline guards), mtl_device
  descriptor guards re-added (3 static copies trap — caused macOS 26.5 boot abort)
- Voxy bumped to 0.2.17-beta @ 4c04acd4 (last MC 26.1.2 commit), 5 patches carried
- Prism instance: Sodium 0.8.12, new voxy jar; old jars in mods/disabled
- In-game verified macOS 26.5.2 / M5 Pro: 48 FPS vsync-capped, zink on Vulkan 1.4

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-18 11:45:29 +02:00
autoplay-mod WORKING: Voxy on Mac — 44 FPS, clean rendering, zero artifacts 2026-05-08 18:52:45 +02:00
mesa-src-new@06a1722dc6 MC BOOTS on Mac! KosmicKrisp Metal 4 fixes working 2026-05-08 10:40:13 +02:00
scripts WORKING: Voxy on Mac — 44 FPS, clean rendering, zero artifacts 2026-05-08 18:52:45 +02:00
.gitignore Tasks 1-3 complete: Mesa+GLFW built, Voxy patched, launcher researched 2026-05-08 01:51:39 +02:00
COMPATIBILITY.md Patch 5: cap maxDrawIndirectCount to 65535 + compatibility analysis 2026-05-08 03:27:33 +02:00
DEBUG_REPORT.md Status: title screen works, in-game rendering exits cleanly 2026-05-08 12:18:24 +02:00
gl_test Task 4 progress: MC downloaded, launch scripts ready, blocked on auth 2026-05-08 02:17:55 +02:00
gl_test.c Task 4 progress: MC downloaded, launch scripts ready, blocked on auth 2026-05-08 02:17:55 +02:00
gl_test2 Task 4 progress: MC downloaded, launch scripts ready, blocked on auth 2026-05-08 02:17:55 +02:00
gl_test2.c Task 4 progress: MC downloaded, launch scripts ready, blocked on auth 2026-05-08 02:17:55 +02:00
HANDOFF.md 2026-07-18 refresh: rebase onto Mesa main (26.3.0-devel, Vulkan 1.4 KosmicKrisp), Voxy 0.2.17-beta, Sodium 0.8.12 2026-07-18 11:45:29 +02:00
LAUNCHER.md Tasks 1-3 complete: Mesa+GLFW built, Voxy patched, launcher researched 2026-05-08 01:51:39 +02:00
PATCHES.md 2026-07-18 refresh: rebase onto Mesa main (26.3.0-devel, Vulkan 1.4 KosmicKrisp), Voxy 0.2.17-beta, Sodium 0.8.12 2026-07-18 11:45:29 +02:00
README.md 2026-07-18 refresh: rebase onto Mesa main (26.3.0-devel, Vulkan 1.4 KosmicKrisp), Voxy 0.2.17-beta, Sodium 0.8.12 2026-07-18 11:45:29 +02:00
SETUP.md Tasks 1-3 complete: Mesa+GLFW built, Voxy patched, launcher researched 2026-05-08 01:51:39 +02:00
test_kk MC BOOTS on Mac! KosmicKrisp Metal 4 fixes working 2026-05-08 10:40:13 +02:00
test_kk_context.c MC BOOTS on Mac! KosmicKrisp Metal 4 fixes working 2026-05-08 10:40:13 +02:00
test_kk_stress MC BOOTS on Mac! KosmicKrisp Metal 4 fixes working 2026-05-08 10:40:13 +02:00
test_kk_stress.c MC BOOTS on Mac! KosmicKrisp Metal 4 fixes working 2026-05-08 10:40:13 +02:00

README.md

Voxy on Mac — GL 4.6 via Zink + KosmicKrisp

Run Voxy (Minecraft LOD mod requiring OpenGL 4.6) on Apple Silicon Macs using Mesa's translation layer stack.

Voxy GL 4.6 → Zink (GL→Vulkan) → KosmicKrisp (Vulkan→Metal) → Apple GPU

Verified (2026-07-18, macOS 26.5.2): 48 FPS vsync-capped (p50=60) on M5 Pro, MC 26.1.2, Sodium 0.8.12, Voxy 0.2.17-beta, Mesa 26.3.0-devel — KosmicKrisp now exposes Vulkan 1.4. (Previous milestone: 44 FPS, 2026-05-08, Mesa 26.2.0-devel / Vulkan 1.3.)

Quick Start

  1. Build Mesa + GLFW (see SETUP.md)
  2. Install Prism Launcher, create MC 26.1.2 + Fabric instance
  3. Copy mods: patched Voxy + Sodium + Fabric API
  4. Set wrapper command: ~/voxy-zink-mac/scripts/zink-mc-wrapper.sh
  5. Set custom GLFW + JVM args (see LAUNCHER.md)
  6. Launch!

Key Fixes

Fix File Issue
LC_NUMERIC=C wrapper script French locale breaks MSL float literals (commas vs dots)
Dimension guards mtl_device.m Metal rejects 0-size textures
sampleCount validation mtl_heap.m Metal 4 rejects sampleCount>1 on non-MSAA
sparsePageSize guard mtl_heap.m Only Apple7+ GPUs support sparse
NULL pipeline guard vk_pipeline.c Prevents SIGSEGV on failed pipeline creation
maxDrawIndirectCount cap Voxy patch KosmicKrisp caps at 65535 vs Voxy's 400K
macOS ARM64 natives Voxy patch RocksDB + LWJGL natives for aarch64
CpuLayout macOS Voxy patch oshi-based CPU topology detection

Requirements

  • macOS 26+ (Metal 4)
  • Apple Silicon (M1+)
  • Mesa: mesa-src-new branch kk-mac-20260718 (macOS port rebased onto upstream main 26.3.0-devel)
  • Patched GLFW (lucamignatti fork, EGL context path — unchanged, fork tip)

2026-07-18 refresh — what changed

Upstream KosmicKrisp absorbed most of the fork (120 commits since May): Vulkan 1.4, native multiDrawIndirect/drawIndirectCount/nullDescriptor, EXT_line_rasterization, Metal 4 pipelines/encoding, tessellation. The macOS port was rebased onto upstream main (kk-mac-20260718); obsolete patches dropped. Still ours: EGL surfaceless-Metal platform, KOPPER_METAL, glwrapper, visible-layer display workaround, texture-descriptor guards (all three static copies of mtl_new_texture_descriptor need them — the mtl_device.m copy caused the macOS 26.5 boot abort), maxDrawIndirectCount still 65535 → Voxy cap patch still required. Voxy bumped to 0.2.17-beta (4c04acd4, last MC 26.1.2 commit before upstream dev moved to 26.2), Sodium 0.8.12. Voxy's upstream dev is now MC 26.2 (0.2.18-beta) and MC 26.2 ships an experimental native Vulkan renderer — next migration target when the 26.1.x server ecosystem moves.