Dependency Tree

Analyzes level asset dependencies by walking scene objects and building a dependency graph of files, textures, materials, shapes, and SimObjects.

Overview

util_dependencyTree scans .level.json, .material.json, and .datablock.json files for a target level folder, then recursively inspects each SimObject for its dependencies (textures, materials, shapes, files) and what it provides (named objects, materials). Outputs the tree as dependencytree.json.

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

Exports (M)

Internals

Target Folder

Hardcoded to levels/gridmap. Change folder local variable to analyze other levels.

Dependency Categories

Each entity tracks:

• deps: What it depends on - categories: file, tex, material, shape, simobject
• provides: What it makes available - categories: simobject, material, shape

Supported Object Classes

Shape Info Processing

After scene objects, .meshes.json files are also scanned. Each shape's materials become dependencies, and the shape file itself is registered as a provides.

Path Normalization

File paths in dependencies are normalized relative to the source file's directory. Shape and texture extensions are stripped for consistent matching.

How It Works

1. Call test() to run the analysis.
2. All .level.json, .material.json, and .datablock.json files in the folder are parsed.
3. Each SimObject is recursively inspected for dependencies.
4. Shape info files (.meshes.json) add material dependencies.
5. Results are written to dependencytree.json.

Lua Examples

-- Run dependency analysis on the default folder (gridmap)
extensions.util_dependencyTree.test()

-- Output: dependencytree.json containing entities with deps/provides

Additional Exports

• M.test - (undocumented)