Resave Materials

Batch-converts legacy TorqueScript material files (materials.cs) to the new JSON format.

Overview

util_resaveMaterials scans the entire filesystem for materials.cs files, executes each via TorqueScript, collects the resulting SimObjects, and re-saves them in the new format using PersistenceManager. This is a one-time migration utility.

Extension path: lua/ge/extensions/util/resaveMaterials.lua

Exports (M)

Internals

Conversion Flow

1. Creates a PersistenceManager instance.
2. Finds all materials.cs files recursively from /.
3. For each file with size > 0:
   • Executes via TorqueScriptLua.exec(fn).
   • Collects all SimObjects whose getFileName() matches the source file.
   • Marks each object dirty in the PersistenceManager.
   • Calls saveDirtyNewFormat() to write the new format.
   • Deletes the temporary SimObjects.
4. Cleans up the PersistenceManager.

Helper: getSimObjects(fileName)

Iterates scenetree.getAllObjects(), returning those whose getFileName() matches the given path.

Job System

Uses core_jobsystem.create(work, 1) to yield every second, keeping the UI responsive.

Log Filtering

Sets IngameConsoleLogBlacklist and WinConsoleLogBlacklist to "DA" to suppress noisy debug output during conversion.

How It Works

1. Load the extension (typically via CLI).
2. onExtensionLoaded starts a background job.
3. The job iterates all materials.cs files, executes them, and resaves in new format.
4. Logs DONE on completion.

Lua Examples

-- Typically run as a batch tool:
-- beamng.exe -onLevelLoad_ext "util/resaveMaterials"

-- Or load manually:
extensions.load("util/resaveMaterials")

Additional Exports

• M.onExtensionLoaded - (undocumented)
• M.work - (undocumented)

See Also

• Auto Annotation - Related reference
• Booster - Related reference
• Calibrate ESC - Related reference
• Game Engine Overview - Guide