AI tools: Start here and scenes

Overview, finding tools, entities, prefabs and saving. 43 tools. You see every step your AI takes and can undo any of them.

apply_scene_text

Create or edit many objects at once with scene text: `entity Name { ... }` blocks. Existing names are edited (partially), new names are created. All in one undoable step.

builder_guide core

The full workflow for building a whole game from scratch in TTR Engine, from plan to packaged app.

No arguments.

capabilities

What can be done to one object: its editable fields, components it could gain, and the tools that act on it.

create_creature

Build and add a creature from a short spec: generic lofted body, spine, limbs, tail, fins/wings, automatic skin weights. Presets minnow/bass/shark, sparrow/gull, dog. Fish need a named ocean; birds fly; dog has the existing quadruped walk/trot/gallop rig and cycles. Generated model faces +Z, animator facing 0. Native bounded authoring, no downloads or external generation. Aggregate scene authoring limit: 1000 creatures, including passive dogs; over-capacity requests are refused before writing assets or entities.

create_entity core

Add an object. Give a unique name, optional group, and components as scene text. One undoable step.

create_sequence

Create (or resize) a cinematic sequence in the project's Sequences folder: a timeline of transform tracks with bezier/ease curves, property tracks (lights, colours, visibility, any field), animation clips on characters, camera cuts, events and slow motion that slows physics, animation and particles together. Give json for a whole sequence at once (format "ttr.sequence", in script_reference), or build it key by key with add_track, set_key, add_clip, add_event, add_camera_cut, set_time_scale_key and record_physics. An existing sequence keeps its tracks (length and hold_player change); replace: true starts it over.

delete_entity core

Remove an object and everything attached to it (an assembled car's body, wheels and lamps; a character's held gun), listed in the reply. Undo brings them all back with the same ids.

duplicate_entity

Copy an object under a new name, optionally moved by an offset in meters.

edit_entity core

Change an object with scene text. Only what you write changes; everything else keeps its value. One undoable step.

engine_overview core

Project, open scene, unsaved changes, object count by group, selection, camera, assets and frame rate. Start here.

No arguments.

find_asset

Search for models and surfaces: the project's own models first (installed packs, imports; hero quality first, placeholders marked, KIT files of separate parts marked with how to place one part), then Poly Haven's free CC0 library: 500+ photo-scanned 3D models and 800+ scanned surfaces (concrete, brick, dirt, metal, wood...). Returns paths or ids, real-world sizes and popularity. Then import_asset for Poly Haven ids.

find_reference

Look for reference pictures of something you're about to build (a jet, a car, an animal, a building): searches Wikimedia Commons (free licenses, no account) and returns a numbered contact sheet with each picture's size, license and link. Three-view drawings and plain side/top/front photos help most. Save good ones with add_reference.

find_tools core

Find the right tools for a goal in plain words ("make a character from a picture", "enemies with swords", "make it run faster"). Leads with the proven pipelines (the order of tools for the best result), then the best-matching tools. Start here when you don't know which tool to use.

get_asset

An asset's full record: permanent id, size, bounds, counts, memory, license, source and import warnings.

get_entity

One object in full, as scene text (the same format edit_entity accepts).

get_plan

The scene's game brief (requirements with stable ids, plain text and the check that proves each; proof_report plays them) and its Game Plan (requirements with route tests, and decisions). Protected items are the person's and can't be changed by agents.

No arguments.

get_sequence

Read a cinematic sequence: every track with its keys' span, recorded stretches, camera cuts, events and the time scale (story seconds, and how long it takes to watch with slow motion). json: true also returns the file.

hello

Say hello to the person's Arcwright editor: the connection test from Connect an AI App. The editor shows your app's name and a short message, so the person sees the link works. Changes nothing.

inspect

Look closely: frame one object, or one spot on it (part: a point in its own frame, e.g. a canopy, an eye, a hoof), from several angles at once, in channels that show what surfaces are made of, beside a reference photo, or as a motion strip over time. Every view is measured (brightness, blown highlights, crushed shadows, fine detail). Use it to judge detail and realism up close; screenshot is for the whole scene.

list_assets

Models in the project's Assets folder that fit the game's art style, best quality first (hero, standard; placeholder-quality low-poly models only in a toy-style game or with include_placeholders), with size in meters, triangles, textures, GPU memory, license, and a KIT notice for files that hold separate parts.

list_builders

The builders working in this scene, each on its own copy (the editor's multiview shows them live): name, what it is doing, the checks it ran, and what it changed so far. The person brings a builder's work into their scene after a review.

No arguments.

list_components

Every component type with its fields, types, units and meaning, plus the scene text syntax. Read this before editing.

list_entities core

List objects: name, id, group, components and role. Filter by text, group or component.

measure

Measure between two objects: centre to centre (straight, along the ground, height difference) and the gap between their bounding boxes (0 when they touch or overlap, with how deep). Check spacing, reach and fit without guessing: "is the jump 3 m?", "does the car fit through the gate?".

new_scene

Start a new, empty scene (just a sun) and save it as Scenes/<name>.ttrscene. The current scene must be saved first if it has changes.

open_scene

Open another scene from the project in the editor (so the person watches the scene you work on). Use discard: true to replace an unsaved scene without saving it.

place

Move an object by describing where it goes; the engine computes exact coordinates from real sizes. Relations: on_top_of, against, next_to, in_front_of, between, on_ground, at. Optionally turn it to face another object.

prefab_apply

Pushes a copy's own changes into its prefab, so every copy gets them: the components the copy keeps (or the ones named) are written into the prefab file and the copy stops keeping them. Every copy is then remade.

prefab_list

Lists the project's prefabs (Assets/Prefabs), their parts, and how many copies of each this scene has.

No arguments.

prefab_make

Saves an object as a prefab (Assets/Prefabs/<name>.ttrprefab), with the objects attached to it as its parts, and makes the object its first copy. Then place more with prefab_place (or world.spawnPrefab in scripts): edit the prefab and every copy follows. Use it for anything placed many times: enemies, crates, trees, lamps, houses.

prefab_place

Places a copy of a prefab: it follows the prefab (edit the prefab, every copy changes) while its place, name and group are its own. Its parts come with it, named <copy>_<part>.

prefab_refresh

Remakes every prefab copy from its prefab file (after a prefab file was edited by hand or by write_file), keeping each copy's own changes. One undoable step.

No arguments.

prefab_revert

Puts a copy back to its prefab: it stops keeping its own version of the named components (default all) and is remade from the prefab. Undoable.

project_map

What this project already has: its scenes (object counts, which is open), scripts with what each says it does (its first comment) and which objects in the open scene run it, briefs, prefabs, sprite sheets, tilesets, sounds and UI files. Read it when you come back to a project or before making something new, and reuse what's there instead of making a second copy. Start each script with a one-line comment saying what it does.

No arguments.

redo

Redo the most recently undone change.

No arguments.

report_problem

Report a problem in Arcwright itself to the Arcwright team so it gets fixed: a tool that failed or gave a wrong result, something that froze, a feature you needed that is missing. Never the person's game or files, never personal data or keys. The person decides in Privacy & Updates: they are asked each time (the default: a card in the editor with Send / Always send / Don't send), reports go automatically, or never. Say what you were doing, what happened and what you expected. The same problem is sent once.

save_scene core

Save the scene to its file, or with name to Scenes/<name>.ttrscene (save as: the open scene's own file is left as it was).

scene_load_check

List what the open scene uses that can't be loaded here (model files, weapon sets, surfaces and recipes), each with why, and what loads only through the developer checkout's material library (missing on a player's machine). Use before packing or exporting a game.

No arguments.

select_builder

Work inside a builder: your own copy of the scene, shown live in the editor's multiview with your status and checks, which the person reviews and brings into their scene. Every later call of this connection then reads and changes only that copy (until you select another, or "my scene"). Use create: true to start a new one with that name. Any single call can instead pass an extra "builder" argument. Project files (scripts, kits, briefs) are shared, so tools that write them are refused inside a builder.

select_entity

Select an object in the editor so the person sees which one you mean, or several (entities): the Inspector then edits all of them at once.

spatial_query

Ask about space instead of guessing: what's near an object or point (with compass directions), its exact box, or where on the ground a footprint fits free of obstacles.

status

Say what you're doing right now, in a short plain sentence (what and why): the editor's workshop shows it to the people watching, above the code you're changing. Empty clears it.

undo

Undo the most recent change (yours or the person's; check history first).

No arguments.