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)
11 commits 1 branch 1 tag 28 MiB
  • C 72.6%
  • Java 14.2%
  • Shell 13.2%
Find a file
Exact
exo deb76910f4 Add README with quick start guide and key fixes summary 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-08 18:53:16 +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 Status: title screen works, in-game rendering exits cleanly 2026-05-08 12:18:24 +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 Patch 5: cap maxDrawIndirectCount to 65535 + compatibility analysis 2026-05-08 03:27:33 +02:00
README.md Add README with quick start guide and key fixes summary 2026-05-08 18:53:16 +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: 44 FPS on M5 Pro, MC 26.1.2, Sodium 0.8.11, Voxy 0.2.15-beta.

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 (lucamignatti fork) with KosmicKrisp + Zink
  • Patched GLFW (lucamignatti fork, EGL context path)