Edit Mode

Edit Mode is the most powerful AI Assistant mode and enables AI-driven modifications to your Mattercraft project. It can propose changes to scenes, scripts, components, and project configuration that you can accept or reject individually.

Usage

1. Open AI Assistant panel
2. Select Edit Mode
3. Describe desired changes in natural language
4. Review proposed modifications
5. Accept or reject changes individually or as a group

You can also upload images or code snippets into the prompt input to help give more context to your edit request.

Change Review Process

Changes are displayed with a pencil icon across the Mattercraft editor.

Each change can be:

• Accepted: Applied to your project immediately
• Rejected: Discarded without affecting project
• Modified: Edited before accepted (manual intervention required and will be classed as a proposed change until accepted)

Query Types

Scene Modifications

"Add a rotation animation to the cube that plays when clicked"

"Create a particle system for the fire effect"

"Make the robot character dance when the experience starts"

Component Creation

"Create a custom dancefloor component with animated tiles"

"Make a cyberpunk shader for the drink can"

"Build a UI button component with hover effects"

Code Generation

"Write a script that tracks user interactions"

"Create a component that loads 3D models dynamically"

"Generate a custom material with animated properties"

Implementation Process

Edit Mode follows this workflow:

1. Project Analysis: Examines current project state
2. Dependency Check: Verifies required components/behaviors
3. Code Generation: Creates necessary scripts and components
4. Scene Integration: Adds components to scene hierarchy
5. Configuration: Sets appropriate properties and parameters
6. Validation: Checks for TypeScript errors and conflicts

Generated Code Quality

Edit Mode produces:

• Type-safe TypeScript: Full type annotations and proper interfaces
• Documented code: Comments explaining functionality
• Configurable components: Exposed properties for UI editing
• Performance-optimized: Efficient algorithms and resource usage
• Standard-compliant: Follows Mattercraft coding conventions

Best Practices

Queries

• Be specific about desired functionality
• Mention performance requirements if applicable
• Specify UI requirements for generated components
• Include context about existing project structure

Change Management

• Review all proposed changes before accepting
• Test functionality after applying modifications
• Use commit history for important changes

Example Prompts

Animation Creation

Input: Make an animation that spins the hat and play it when the user taps on the hat

Process:

1. Analyzes scene structure to locate hat object
2. Creates new animation layer and timeline
3. Adds rotation keyframes with appropriate easing
4. Configures PlayLayerClip behavior for click interaction
5. Applies changes to scene file

Custom Component

Input: Create a custom component that's a dancefloor

Process:

1. Creates new TypeScript file with component template
2. Implements procedural geometry generation
3. Adds animation system for tile effects
4. Exposes configurable properties (size, colors, speed)
5. Integrates component into scene hierarchy

Shader Development

Input: Make a custom shader that's a cyberpunk vibe for this drink's can

Process:

1. Analyzes target object materials
2. Creates GLSL vertex and fragment shaders
3. Implements cyberpunk visual effects (neon, glitch, etc.)
4. Adds configurable properties for customization
5. Applies shader to target object