Client Core

Initializes core rendering resources: materials, shaders, state blocks, and sampler states required by the engine's rendering pipeline.

Module Overview

Public Functions

Initialization Sequence (initializeCore)

1. setRandomSeed(-1) - seed RNG
2. require("client/objectsRequiredForStartup") - GUI profiles, cursor
3. canvas_module.initializeCanvas() - create render window
4. M.loadCoreMaterials() - common + track builder + JSON materials
5. createCommonMaterialData() - sampler states
6. createShaderData() - particles, reflections, foliage, terrain shaders
7. createWaterShaderData() - water/underwater shaders and materials
8. createScatterSkyData() - scatter sky shader
9. createCloudsData() - cloud layer and basic clouds shaders
10. createVehicleData() - prop selection shader/material

Scene Objects Created (Key Subset)

Shaders

Materials

Sampler States

Console Variables Set

Usage Example

-- Called internally by client/init.lua
local core = require("client/core")
core.initializeCore()

-- Hot-reload path
core.reloadCore()

Notes

• initializeCore is guarded by M.initialized to prevent double-init.
• All objects use find-or-create pattern: scenetree.findObject() before createObject().
• Track builder materials come in A–H variants, each with _center and _border sub-materials.
• JSON materials are loaded recursively from core/ directory.

See Also

• client/canvas - Canvas initialization
• client/init - High-level client init calling initializeCore
• client/objectsRequiredForStartup - GUI profiles