BuildConfiguration.json

{
  "//": "Optional engine features. auto lets the engine decide per configuration, on forces every configuration, off strips it everywhere. Command line flags such as -Tracy=off override these.",

  "//BugSplat": "Crash upload to the engine's BugSplat database. auto means on for Editor targets and off for Game targets, and it is gated at runtime on the user's consent either way.",

  "//GpuValidation": "Default state of GPU-assisted validation, which instruments every shader to catch out-of-bounds and null reads from inside them. auto means off. Only the default lives here: the switch is --gpuvalidation / --nogpuvalidation on the engine command line, so a session spent chasing a GPU fault never costs a rebuild to enter or leave. Expect a large frame-rate cost while it is on.",

  "//Box3DDebugChecks": "Box3D's own asserts and internal validation. auto means Debug only, so a Development physics measurement is not an instrumented one. Turn it on when chasing a Box3D-side assert.",

  "//ForceInlineHint": "What LUMINA_FORCEINLINE_HINT expands to, for code hot enough to want inlining but big enough that forcing it everywhere costs more size than it wins back. auto means forced except in Debug; off demotes it to plain inline and leaves the choice to the optimizer, which is what a PGO or size-tuned build wants. Plain FORCEINLINE is unaffected.",

  "Features": {
    "Tracy": "auto",
    "Validation": "auto",
    "GpuValidation": "auto",
    "Aftermath": "auto",
    "RadeonGpuDetective": "auto",
    "VerboseLogging": "auto",
    "BugSplat": "auto",
    "ForceInlineHint": "auto"
  }
}