Skip to content

Configuration

TamKungZ edited this page Oct 27, 2026 · 1 revision

Configuration

DX12MC is configured with JVM system properties (-Dname=value). Defaults and minimums below are read from the source; values below the minimum are raised to it.

Core (config.Config)

Property Default Meaning
dx12mc.mode native native, debug (aliases takeover, diagnostic) or probe (alias check); anything else is native
dx12mc.clear 18202AFF Clear colour, RGBA hex
dx12mc.overlay false Debug overlay
dx12mc.overlay.refreshMillis 250 (min 50) Overlay refresh interval
dx12mc.perfLog true Periodic performance log
dx12mc.perfLog.seconds 5 (min 2) Performance log interval

dx12mc.vsync is no longer used; VSync follows the vanilla option.

Tuning

Tuning limits for memory and per-frame work. Only change these when measuring.

Property Default
dx12mc.mesh.cache.max / .bytes 4096 / 256 MiB
dx12mc.mesh.createsPerFrame 4
dx12mc.mesh.indexUpdatesPerFrame 4
dx12mc.region.cache.max / .bytes 2048 / 256 MiB
dx12mc.region.page.bytes 8 MiB
dx12mc.region.rebuildsPerFrame 6
dx12mc.region.drawCostIndices 12000
dx12mc.region.cache.staleFrames 300
dx12mc.region.sharedQuads 131072
dx12mc.stream.bytesPerFrame 6 MiB
dx12mc.immediate.scratch.elements 1048576
dx12mc.transient.vertexMiB / .indexMiB 24 / 8
dx12mc.staging.maxOutstandingBytes 64 MiB
dx12mc.texture.maxDimension 16384
dx12mc.texture.maxBytes 256 MiB
dx12mc.texture.maxTotalBytes 512 MiB
dx12mc.texture.maxUploadChunkBytes 4 MiB
dx12mc.texture.updateCallCostPixels 131072

Clone this wiki locally