util/worker - Batch Job Worker

Reference for extensions/util/worker.lua. Processes batch work items from a JSON file (/work.json) for automated tasks like mesh compilation, imposter generation, mod testing, and vehicle previews.

Exports

Work Item Types

Internals

• Startup: Loads helper extensions (test/renderVehiclePreview, util/saveDynamicData, util/calibrateESC, util/compileImposters).
• 120-frame warmup: Waits 120 frames before processing to ensure the engine is fully initialized.
• Mesh compilation: compileDae(daePath) calls compileCollada() to convert DAE → CDAE with optional validation.
• Material loading: loadMaterialsInPath(path) finds and loads both .cs and .json material files.
• Auto-shutdown: After all work items are processed and all jobs complete, calls shutdown(0).
• Designed for headless/CLI usage: -lua extensions.load('util_worker') -console -nouserpath.

How It Works

1. Engine starts with util_worker extension loaded.
2. On load, reads /work.json containing an array of work items.
3. After 120 frames, iterates all items and dispatches to handler functions.
4. Handlers may queue async jobs via core_jobsystem.
5. Once all jobs complete, the process exits cleanly.

// Example /work.json
[
  {"type": "compileMesh", "filename": "vehicles/etk800/etk800.dae"},
  {"type": "compileImposters", "levels": ["west_coast_usa", "italy"]}
]

Additional Exports

• M.onExtensionLoaded - (undocumented)
• M.onJobDone - (undocumented)
• M.onPreRender - (undocumented)