Skip to content

feat: build chunk mesh data off the main thread (MeshData + Jobs, Physics.BakeMesh) #264

Description

@nigel-hall-codes

Parent: #259 (techdesign) — see sdlc/#259/design.md, lever L4. Gated on #446 (profile first — #260 closed without recording numbers).
Reanalyzed 2026-07-04: gate moved #260#446; note on the ChunkBinReader seam added; approach unchanged.

Why

The import builds mesh geometry on the main thread (BuildMesh: SetVertices/SetTriangles/SetUVs + RecalculateNormals), single-threaded. This is the "parallelism that helps the Unity import" lever.

What

⚠ Honest gate

Only pays off if mesh build / collider cook is a large share of import time. If #446 shows SaveAsPrefabAsset or the authoring uploads (#447) dominate, those are not parallelizable this way — prioritize #447/#261/#262/#263 instead. Do not start until #446's numbers justify it.

Done when

Off-thread mesh build + parallel bin parsing measurably reduce cold-import time (per #446) with identical resulting meshes.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions