AssetImport
Since 0.6
Fields
| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
source | string | yes | The file this asset was imported from: a project-relative path, or just a file name when the file was copied in beside the scene. A record of where it came from, not a path the runtime loads — AssetRef.path is that. | ||
sourceSha256 | string | yes | SHA-256 of the source file's bytes at import, lower-case hex. A reimport that changes this is what makes a running world drop its cached mesh, because the hot-reload diff compares AssetRef values and not file contents. | ||
unitScale | number | yes | Multiply the file's units by this to get metres. 1 for a file already in metres, 0.01 for centimetres, 0.0254 for inches. Must be finite and between 1e-6 and 1e6, which is the range the runtime's single-precision transform can hold; the asset-import-invalid rule rejects anything else. | ||
upAxis | Axis | yes | Y, Z, -Y, -Z, X, -X | Which axis of the FILE points up. The engine is Y-up, so "Y" is a no-op. | |
forwardAxis | Axis | no | Y, Z, -Y, -Z, X, -X | Which axis of the FILE points depth-forward, so the file's basis can be turned onto the engine's. The target is glTF's own front, +Z, so "Z" is a no-op. Omitted means "Z", except when upAxis is "Z" or "-Z" — +Z cannot be both up and forward — where it means "-Y" and "Y" respectively, which is the Z-up convention every Z-up authoring tool exports. It must not name the same axis as upAxis. It does NOT put the model's nose on the entity's forward: the entity's forward is -Z and this lands on +Z. AssetRef.forward is the field that does that. | |
targetSizeM | number | no | When set, the longest measured side of AssetRef.bounds is scaled to this many metres, after unitScale. Must be finite and between 1e-6 and 1e6, the same range as unitScale. Without bounds there is nothing to measure and it is ignored. | ||
baseCenter | boolean | no | false | When true the origin moves to the base centre of the measured bounds: min.y to 0, x and z centred. Defaults to false. Base-centred is what lets an entity at y = 0 stand on the floor instead of sinking half-way into it. | |
collider | ImportCollider | no | none, box, trimesh, hulls | What the importer chose to build for collision. Informational: the collider that actually runs is the entity's collider component. Recorded so a reimport can offer the same choice, and so nothing safety-critical is inferred silently. | |
scan | ScanSettings | no | Present when the file was cooked as a scan: source and sourceSha256 then describe the scan file the person picked, and AssetRef.path the GLB the cook made from it. |