Editor tools

Create a world object from the JSON string in object. If parent_id is omitted, the object is created under the root.

Create a Material object from one built-in material name by looking up its uploaded texture data ids. The available material names are: {}. Returns the newly created material id.

Delete an object, recursively removing its children and clearing pointer links that target it.

Read the current dirty script text from the editor workspace, with optional TypeScript diagnostics.

Read TypeScript diagnostics for all scripts in the current editor workspace.

Read the stored raw code for one script object.

List direct children under in, with optional pagination and recursive child expansion up to depth levels.

List referenced mesh, animation, and texture data ids in the world, with optional mode filtering and pagination.

Inspect one object. Returns object summary data plus parent, children, incoming pointers, referenced data ids, optional script code, and info or physics fields based on mode.

Inspect cached mesh, animation, or texture data by data_id. Texture results are metadata-only in this text response, and uncached data returns a failure payload describing the referenced types.

Search objects by AND-ing all provided filters. Supports name, type, parent, pointer relationships, referenced data ids, and substring search over serialized object info.

Get the parent path from the root object down to one object, with optional pagination over the path entries.

Get the current game title, description, max players, and visibility.

Get warnings about floating objects with no support below them.

Duplicate an object and its children under the same parent. offset moves the copied subtree in world space, and the copied root name is auto-suffixed with _Copy if clone_name is omitted.

Edit one object at jspath using the JSON string in jsvalue. jspath can be a dot-separated path like a.b.c or a JSON-encoded array of path segments.

Set one or more current game settings. Omitted fields are left unchanged. Setting visibility to Published only changes visibility; it does not save or publish the current editor world.

Write raw code for one script object.

Run one temporary server script against the editor world, then remove the temporary Script object. Use this for short command-style edits that are easier in TypeScript than individual object tools. Returns console logs plus created, deleted, and modified object summaries.

Move an object and its physical descendants by translation in world space.

Move an object and its physical descendants so the root object ends up at target_point. This fails if the root object has no direct physics position.

Scale an object and its physical descendants by scale_multiplier around center_point. If center_point is omitted, the tool uses the object's current physics position and fails if the object has no direct physics position.

Rotate an object and its physical descendants by rotation_magnitude radians around rotation_axis and center_point. If center_point is omitted, the tool uses the object's current physics position and fails if the object has no direct physics position.

Create a brick from a center point, size, and optional XYZ rotation in degrees.

Create an axis-aligned brick from two opposite corners.

Create a vertical wall from two floor-level centerline endpoints, plus height and thickness.

Create a brick from two endpoint centers, width, and height. The brick length runs along local Z from start to end, and local Y stays as close to world up as possible.

Create a ball from a center point and radius.

Create a cylinder from a center point, radius, length, and optional XYZ rotation in degrees. The unrotated cylinder length runs along local Z.

Create a cylinder from two endpoint centers and a radius.

Report that tool behavior or the current system instructions or tool definitions are missing, conflicting, or unclear for the task. Use this instead of guessing when tool calling does not go to plan.

Run multiple tool calls concurrently and return one status per subcall. Each tool_calls[].args value must be a JSON string for that subtool, and timeout_ms applies to the whole batch.