cat projects/libraries/crshader.html SOL.VIN JOURNAL v1.47-prod [ MFET2 ]

PROJECT // CRShader // Libraries

CRShader

2026-09-26

Ultrafast shader trans-compiler and live runtime development toolchain for Godot Engine 4.8+ via Crystal and Lapis.

CRShader is an ultrafast shader trans-compiler and live runtime development toolchain for Godot Engine 4.8+ powered by Crystal and Lapis. It introduces a declarative, type-safe Crystal shader DSL that transpiles down to optimized Godot GDShader (.gdshader) and GLSL compute kernels with native machine speed (~1.1ms transpilation, >100,000 LOC/s).

Key Architectural Features:

  • High-Speed Transpiler: Lexes, parses, and transpiles complex spatial and screen-space post-processing shaders in ~1.1ms at >100,000 lines of code per second.
  • Transparent In-Memory Loading: Registers ResourceFormatLoaderCRShader with Godot's ResourceLoader, allowing .crshader files to be assigned directly to ShaderMaterial without requiring intermediate files on disk.
  • Godot Editor Integration & CRShader Studio: Full GDExtension plugin loaded via crystal_bridge.dll / .so, featuring in-editor syntax highlighting and an embedded dock panel for live editing and side-by-side transpilation preview.
  • Interactive Shader Viewer & Sandbox: Bundled standalone showcase viewers allowing real-time inspection, parameter tweaking, and hot-reloading across a rich gallery of 20+ shaders on 3D meshes and screen-space quads.
  • Mirrored Godot Documentation & Completion: Complete offline API documentation generated under CRShader::Language capturing every Godot 4 built-in function, stage variable, and preprocessor macro.
SKILLS USED:
Crystal Godot 4 GDShader GLSL Shaders Game Engine Development