asset.preview
Overview
- TEST-PLACE a catalog asset (by ObjectPath) to visually confirm it is the right asset. This is a TRANSIENT PREVIEW, NOT a permanent placement: the result is NOT saved and disappears on save/load, level travel, or restart. For permanent, saveable furniture use the build-mode / DT-based path instead. StaticMesh/SkeletalMesh spawn a plain preview actor; NiagaraSystem plays FX; SoundBase plays a one-shot sound. Placement: if screen pixels (x,y) are given, line-trace to the surface under them; otherwise place ~2m in front of the player. Get the path from asset.search first.
Metadata
| Field | Value |
|---|---|
| Display | Preview Catalog Asset (Test Placement) |
| Category | asset |
| Access | ScriptCheat |
| Scope | B1Standalone |
| Tags | Experimental |
| Aliases | — |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| path | string | yes | — | Full catalog asset ObjectPath (e.g. '/Game/BG/.../SM_x.SM_x'). |
| x | float | no | — | Screen X pixel (viewport-local). Optional — omit to place in front of player. |
| y | float | no | — | Screen Y pixel (viewport-local). Optional. |
| yaw | float | no | 0 | Yaw rotation in degrees (default 0). |
Usage
await inzoi.cli.execute('asset.preview', {
path: '',
x: 0.0, // optional
y: 0.0, // optional
yaw: 0, // optional
});