scene_build_blocks
Create an official .gia asset pack from a list of scene pieces and stage it in the editor's import folder for later game import.
Instructions
Turn a list of pieces into an official asset pack (.gia) and put it in the editor’s import folder. template is a block name from scene_block_catalog or any asset id from scene_search_assets. position is in metres; rotation in degrees per axis. Give size (metres per axis: the piece is stretched to exactly that; blocks default to 1,1,1) or scale (1 = the model’s own size, the default for non-block assets). For blocks position is the centre in x and z and the bottom in y (measured in play: a block at y 0.5 and 1 high has its top at 1.5); other models are anchored at their base. Monsters (group 怪物) are imported alive with their official AI parameters. createAtStart:false places a piece without creating it, so a node graph can create it later by GUID (the editor assigns new GUIDs on import; read them from the save). patrol (monsters only) makes the creature walk a path that already exists in the map while it has no target: templates:[{pathId,waypointIds}] with ids from inspect_level_paths; since the game update of 2026-10-09 the importer drops the template list, so a patrol written here does not reach the game: steer creatures with custom aggro instead. offset [x, y, z] is added to every position: the same list of pieces on ground of another height (a new empty save has its ground at y=0) or as a second copy elsewhere. Returns the pack’s bounds. Nothing changes in the game until scene_import_assets runs. solid false switches the native collision (原生碰撞) of a piece off, for a thing that is to be walked through; left out it is on. A character walks over low things by itself (a fence of 1.56 m, with jumping allowed and no key pressed, 2026-10-12): what keeps a player in is a wall of at least 2.4 m and a class that may not climb.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| blocks | Yes | ||
| offset | No | ||
| install | No | ||
| entityIdStart | No |