AssetImport
Since 0.6Changed in 0.7
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. | ||
bodyRig | integer | no | Present when the editor gave this model, which had no skeleton, its simple body rig: five joints up its middle (body_root, body_hips, body_spine, body_chest, body_head), the mesh skinned to them by height, and generated body clips (Idle, LeanLeft, LeanRight, Punch, Throw, ThrowBack, PointLeft, PointRight, Cheer). The number is the generator's version. source and sourceSha256 then describe the file the person picked, and AssetRef.path the rigged GLB the editor wrote from it. Absent: the file was copied as it is. |