Start here
DawnlightCore is a shader-focused modification of Survivalcraft. It connects resource declarations, shader registration and rendering commands through a general-purpose pipeline. Shader pack authors use JSON to organize execution and GLSL to implement visual effects.
This documentation is for authors creating independent shader packs. Start with environment setup and GLSL essentials, then follow chapters 00–10 through loading, grading, separate resources, Terrain integration and MRT data. Each chapter supplies complete source, an independent download, a static receipt and separately recorded game observations. The JSON and ABI reference covers fields, behavior constraints, public catalogs and version differences.
Prerequisites
- JSON: read objects, arrays, strings and numbers, and distinguish field names from reference IDs.
- GLSL: understand vertex and fragment shaders, uniforms, texture sampling and coordinate transforms.
- Basic rendering concepts: know the roles of color, depth, textures and framebuffers.
Writing a shader pack primarily involves JSON and GLSL. The host's C# code provides lifecycle management, rendering capabilities and public contracts. Extending that source is necessary when you need a new host capability.
Suggested reading order
| Course | Practical goal |
|---|---|
| 00 · Load the starter | Load from an empty directory and return to BuiltIn |
| 01 · First post-process | Edit warmth strength and reload |
| 02 · Separate resource | Trace writers, readers and ordering |
| 03 · Scene integration | Override opaque Terrain |
| 04 · MRT data | Write normals and teaching identifiers |
| 05 · Options and settings | Build and validate this independent snapshot |
| 06 · Time, weather and custom data | Build and validate this independent snapshot |
| 07 · Stable content and materials | Build and validate this independent snapshot |
| 08 · A post chain and its cost | Build and validate this independent snapshot |
| 09 · Compose an independent pack | Build and validate this independent snapshot |
| 10 · Verify and distribute | Build and validate this independent snapshot |
Use the following concepts alongside the course. The runtime record states the actual test scope.
| Order | Page | What you should be able to answer |
|---|---|---|
| 1 | Versions and support | Which host commit, Manifest version and Scene ABI does the documentation target? |
| 2 | From configuration to a frame | How do Pass, Command, Program and Resource work together? |
| 3 | Resources, targets and drawBuffers | Where does a draw write its output, and how does the next draw read it? |
| 4 | Analyzer and evidence | What evidence establishes valid configuration, and what establishes actual visual results? |
Using this documentation
Concept pages explain relationships and constraints. Field names retain their original spelling so you can search for them and compare them with the source. Snippets state their purpose explicitly. A complete loadable pack must also provide resources, scene routing, fallback behavior and whole-frame output; saving an isolated snippet as shaderpack.json is not enough.
The top of each page identifies the main contracts and host baseline. Source links point to the exact commit in the public upstream repository. If behavior differs, compare versions before checking the relevant file.
Trace the data flow first
When reading an example, trace a path: who produces a resource → which command writes it → who reads it next → how it reaches the final output. This helps locate problems before you memorize every field.
Runtime and documentation scope
The initial runtime baseline is Windows x64, .NET 10, OpenGL ES 3.2 and a single main view. See Versions and support for Android, full VR, multiple views and other capability boundaries.
This website is a static reference. The browser does not run Survivalcraft shader packs. Tool output, real driver compilation, game visuals and performance each require their own evidence.
Tools, troubleshooting and practice
Use seven symptom paths and the repair lab when a check fails. Try three independent effects after the course, then study the versioned Dawnlight / ToonLab / MakeUp slices and history/temporal/shadow boundaries.