Skip to content
AEOWUN
Docs Menu

AI Assistant [BETA]

Configure an AI provider, inspect your project and review editor changes.

Open the AI Assistant

Open a project and choose Features → AI Assistant. The Assistant appears in the editor's side panel.

Use the Assistant to ask about your project, inspect scripts and editor objects, and request supported changes through the same conversation.

Worldkiln AI settings with provider selection and agent permissions. Sensitive configuration values are hidden.

Choose a model

Open the Assistant's provider controls and select a service:

Provider Connection
Google Gemini Gemini API
OpenAI OpenAI API
OpenAI-compatible (custom) A compatible custom API endpoint
Ollama (local) A locally running Ollama server

Enter the provider's API key where required, choose an available model, and configure the endpoint when using a custom or local provider.

Once a model is selected, enter a request in the message field. Enter sends the message; Shift+Enter adds another line. Use Stop to cancel an active response.

The Worldkiln AI Assistant replies to a greeting alongside the Landscaping project viewport.

Ask about the current project

Open the project you want to work on, then ask a specific question. For example:

Which scripts refer to the Actor named Guard, and where are they located?

The Assistant can use project tools to inspect the current hierarchy, list and read project text files, search scripts, and consult AeoScript documentation. Ask follow-up questions when you need more detail.

Request editor changes

The Assistant can use supported tools to create or update scripts, attach a script to an Actor, create an Actor or Cell, change supported resource properties, select project nodes, and save the project.

Describe the result you want. For example:

Create a script for the existing Guard Actor that moves it to a destination and logs when navigation finishes.

Review the request and resulting activity in the Assistant panel. For script changes, inspect the generated code in the Script Editor and test it in Play.

Choose how changes are approved

The Assistant's agent settings offer three access modes:

Mode Behavior
Ask Before Changes Requests approval before applying supported editing operations
Auto Apply Applies supported editing operations using the configured access policy
Full Access Enables the broader set of agent operations

When approval is required, the Assistant shows the proposed operation. Select Approve operation to proceed or Reject operation to cancel the request.

The Assistant also includes parser-first validation and automatic correction settings for AeoScript generation. These can validate drafts and attempt corrections before applying them.

Review and reverse changes

Expand Activity and change details to follow the tools and edits used in a request. Where available, file-change cards show what was added or removed, with Keep and Revert actions.

Use Undo latest agent change to reverse the most recent eligible operation. The editor's usual Save and Play workflow remains the way to check and finalize project changes.

Work through a complete example

  1. Open a project that contains an Actor.
  2. Ask the Assistant to find the Actor and inspect its attached scripts.
  3. Ask it to write a short movement script for that Actor.
  4. Review and approve the requested operation when prompted.
  5. Open the script, review its code, and start Play.
  6. Read Output for its result. Request a revision if the behavior needs adjustment.

For scripting concepts, see AeoScript and Actor APIs. For editor navigation, see Editor Workspace.