Deterministic 3D Gaussian Splatting
Validation & Sanitization Engine

A standalone C++20 tool to inspect raw binary .ply streams, detect mathematical singularities (NaN / Inf positions, degenerate needle splats, zero quaternions), and prune corrupt elements before game engine ingest.

Clone Repository

$ gskit validate scene.ply

gskit-cli — validation stream

SIMD I/O • 4.8M Splats in 142ms

$ gskit validate --report-json scene.ply

[INFO] Header parsed: format binary_little_endian 1.0 (SH degree: 3)

[WARN] Anisotropy violation: 14,209 needle splats (max/min scale ratio > 1000x)

[FAIL] Singular quaternion: 312 degenerate [0, 0, 0, 0] rotation vectors

[WARN] Bandwidth penalty: 82,100 dead splats with sigmoid(opacity) < 1e-4

----------------------------------------------------------------------

$ gskit clean scene.ply -o clean.ply --prune-dead --clamp-scale

✓ Sanitized: 4,725,593 valid splats written to clean.ply (VRAM reduction: -14.2%)

[Core Architecture]

Pre-Ingest Mathematical Matrix

01 / I/O CORE

Zero-Dep C++20 Stream

Direct memory-mapped pointer traversal. Processes multi-gigabyte point clouds without copying vertex buffers into intermediate objects.

02 / SANITIZER

Singularity Pruning

Clamps scale explosions (exp(s) > 10⁶), normalizes degenerate quaternions, and validates spherical harmonics degrees (0, 1, 2, 3).

03 / COMPUTE READY

Unreal & Unity Buffer

Prevents GPU crashes, NaN tile corruptions, and rasterizer overdraw before importing assets into custom Niagara or compute shaders.

[Automation Interface]

Model Context Protocol (MCP) Server

GSKit exposes a native MCP server, enabling local coding agents (Cursor, Claude Code, Windsurf) to programmatically audit and repair 3DGS assets inside automated pipelines.

$ gskit mcp --stdio

inspect_scene Returns JSON telemetry on splat counts, bounding boxes, and corrupted quaternion indices.

prune_dead_splats Executes threshold filtering on residual invisible splats and needle geometries.