@weppy/roblox-mcp 1.4.2 → 1.5.0

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "1.4.2"
+    "version": "1.5.0"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-      "version": "1.4.2",
+      "version": "1.5.0",
       "author": {
         "name": "hope1026"
       },

package/README.md

@@ -67,7 +67,15 @@ AI works from a synchronized local mirror, so multi-file updates stay consistent
 - Basic: one-way sync (Studio -> Local)
 - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
 
-### 3) Roblox Explorer: Browse Studio hierarchy in VSCode
+### 3) Playtest: Let AI run and verify tests automatically
+
+AI can control Roblox Studio playtests directly. It can start and stop Play (F5) or Run (F8), inject test scripts, collect logs, and generate local reports automatically.
+
+- "Start a Run-mode playtest and check whether the NPC reaches the target."
+- "Write a test that verifies the SpawnLocation is above the ground and run it."
+- "Validate that the script I just changed runs without errors in playtest."
+
+### 4) Roblox Explorer: Browse Studio hierarchy in VSCode
 
 View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status — all without switching to Studio.
 
@@ -101,6 +109,15 @@ View the full instance tree of your Roblox Studio place directly inside VSCode.
 - [Compatibility](docs/compatibility.md)
 - [Troubleshooting](docs/troubleshooting.md)
 
+### Workflow Guides
+
+- [Instances & Properties](docs/en/tools/instances-and-properties.md) - search, creation, editing, tags
+- [Scripting & Code Execution](docs/en/tools/scripting.md) - script management and Luau execution
+- [World & Environment](docs/en/tools/world-and-environment.md) - lighting, terrain, camera
+- [Assets & Effects](docs/en/tools/assets-and-effects.md) - asset insertion, tweening, effects
+- [Playtest & Automated Tests](docs/en/tools/playtest.md) - playtest control and automated validation
+- [System & Debugging](docs/en/tools/system-and-debugging.md) - connection, logs, batch execution
+
 ## FAQ
 
 **How do I let Claude edit my Roblox scripts?**

package/docs/en/tools/assets-and-effects.md

@@ -0,0 +1,104 @@
+# Assets & Effects
+
+> Insert assets and control tweening, audio, particles, animation, and collision groups.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `manage_assets` | Pro | Search Creator Store, insert models and packages, inspect asset info |
+| `manage_tween` | Pro | Create, play, pause, and cancel tweens |
+| `manage_animation` | Pro | Load, play, stop, and inspect animation tracks |
+| `manage_audio` | Pro | Play, stop, pause, and resume sounds; set the audio listener |
+| `manage_effects` | Pro | Emit particles, clear effects, and toggle effect state |
+| `manage_physics` | Pro | Register collision groups and configure collisions |
+
+## Key Workflows
+
+### Build a scene with assets
+
+```
+"Search Creator Store for a tree model and place three of them in Workspace."
+```
+
+Use `manage_assets.search_insert` to search and insert in a single step.
+
+### Create interactive set pieces
+
+```
+"Make the door open with a 3-second tween when clicked."
+```
+
+Use `manage_tween.create` to define the motion, then `manage_tween.play` to trigger it. Pair it with `manage_audio.play` for a matching sound effect.
+
+### Combine particles and audio
+
+```
+"Play an explosion sound and emit burst particles when the boss appears."
+```
+
+Use `manage_effects.emit` for the particles and `manage_audio.play` for the sound in the same workflow.
+
+## Action Reference
+
+### Manage Assets (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `insert` | Insert a model by asset ID | Pro |
+| `info` | Get asset metadata | Pro |
+| `search` | Search Creator Store | Pro |
+| `search_insert` | Search and insert the first match | Pro |
+| `insert_free` | Insert a free model | Pro |
+| `insert_package` | Insert a package | Pro |
+| `export` | Export the current selection | Pro |
+
+### Manage Tween (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `create` | Create a tween with target properties | Pro |
+| `play` | Play a created tween | Pro |
+| `pause` | Pause a running tween | Pro |
+| `cancel` | Cancel a tween | Pro |
+
+### Manage Animation (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `load` | Load animation on a Humanoid or AnimationController | Pro |
+| `play` | Play a loaded animation track | Pro |
+| `stop` | Stop a playing animation | Pro |
+| `get_tracks` | List all loaded animation tracks | Pro |
+
+### Manage Audio (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `play` | Play a sound and create `Sound` if needed | Pro |
+| `stop` | Stop a playing sound | Pro |
+| `pause` | Pause a playing sound | Pro |
+| `resume` | Resume a paused sound | Pro |
+| `set_listener` | Set the audio listener type or target | Pro |
+
+### Manage Effects (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `emit` | Emit particles from a `ParticleEmitter` | Pro |
+| `clear` | Clear all particles | Pro |
+| `toggle` | Enable or disable an effect | Pro |
+
+### Manage Physics (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `register_group` | Register a collision group | Pro |
+| `set_collidable` | Set whether two groups can collide | Pro |
+| `get_groups` | List all registered collision groups | Pro |
+
+## Related Docs
+
+- [Instances & Properties](instances-and-properties.md) - create and place objects
+- [World & Environment](world-and-environment.md) - lighting, terrain, and camera
+- [Tools Reference](overview.md)

package/docs/en/tools/instances-and-properties.md

@@ -0,0 +1,104 @@
+# Instances & Properties
+
+> Search, create, and edit Roblox Studio instances while managing properties, attributes, and tags.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `query_instances` | Mixed | Search instances, traverse hierarchy, inspect class info |
+| `mutate_instances` | Mixed | Create, delete, clone, move, and rename instances |
+| `manage_properties` | Mixed | Read and write properties, attributes, and tags |
+
+## Key Workflows
+
+### Understand scene structure
+
+```
+"Find every Part under Workspace and tell me its position and size."
+```
+
+Use `query_instances.search_class` to find the parts, then `manage_properties.mass_get` to read `Position` and `Size` in bulk.
+
+### Place objects in bulk
+
+```
+"Place 4 SpawnLocations in a square at the center of the map and give each one a different TeamColor."
+```
+
+Use `mutate_instances.mass_create` to create them in one request, then `manage_properties.mass_set` to assign their properties together.
+
+### Manage tagged objects
+
+```
+"Find every object tagged Collectible and set Anchored to true."
+```
+
+Use `manage_properties.get_tagged` to collect the tagged instances, then `manage_properties.mass_set` to update them.
+
+## Action Reference
+
+### Query Instances (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get instance properties by path | Basic |
+| `children` | Get immediate children or all descendants | Basic |
+| `find_child` | Find first child by name and optional class filter | Basic |
+| `find_descendant` | Find first descendant by name | Basic |
+| `wait_for_child` | Wait for child to appear (with timeout) | Basic |
+| `class_info` | Get class information and valid properties | Basic |
+| `search_name` | Search instances by name pattern (supports wildcards) | Basic |
+| `search_class` | Search instances by class name | Basic |
+| `file_tree` | Get file tree structure from root | Pro |
+| `project_structure` | Get complete project structure | Pro |
+| `descendants` | Get all descendants of an instance | Pro |
+| `ancestors` | Get all ancestors of an instance | Pro |
+| `search_property` | Search instances by property value | Pro |
+| `search_tag` | Search instances by tag | Pro |
+
+### Mutate Instances (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `create` | Create a new instance | Basic |
+| `create_with_props` | Create instance with initial properties | Basic |
+| `delete` | Delete an instance | Basic |
+| `clone` | Clone an instance | Basic |
+| `move` | Move instance to a new parent | Basic |
+| `rename` | Rename an instance | Basic |
+| `pivot` | Set pivot position or CFrame | Basic |
+| `create_tree` | Create a hierarchical instance tree | Pro |
+| `mass_create` | Create multiple instances at once | Pro |
+| `mass_delete` | Delete multiple instances | Pro |
+| `mass_duplicate` | Duplicate multiple instances | Pro |
+| `smart_duplicate` | Duplicate with spacing and count | Pro |
+
+### Manage Properties (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get a single property value | Basic |
+| `set` | Set a single property value | Basic |
+| `get_all` | Get all properties of an instance | Basic |
+| `set_multiple` | Set multiple properties at once | Basic |
+| `get_attr` | Get attribute value | Basic |
+| `set_attr` | Set attribute value | Basic |
+| `get_all_attrs` | Get all attributes | Basic |
+| `delete_attr` | Delete an attribute | Basic |
+| `add_tag` | Add a tag to an instance | Basic |
+| `remove_tag` | Remove a tag from an instance | Basic |
+| `check_tag` | Check whether an instance has a tag | Basic |
+| `get_tags` | Get all tags on an instance | Basic |
+| `get_tagged` | Get all instances with a specific tag | Basic |
+| `set_calculated` | Set a property using a mathematical expression | Pro |
+| `set_relative` | Set a property relative to its current value | Pro |
+| `mass_set` | Set a property on multiple instances | Pro |
+| `mass_get` | Get a property from multiple instances | Pro |
+| `modify_children` | Modify all children of a parent | Pro |
+
+## Related Docs
+
+- [Scripting & Code Execution](scripting.md) - add or update scripts on instances
+- [Assets & Effects](assets-and-effects.md) - insert models, tween objects, add effects
+- [Tools Reference](overview.md)

package/docs/en/tools/overview.md

@@ -2,6 +2,20 @@
 
 For detailed parameters, check MCP tool definitions directly.
 
+## Workflow Guides
+
+Use these workflow-oriented guides to navigate the toolset:
+
+| Category | Description | Included tools |
+|----------|-------------|----------------|
+| [Instances & Properties](instances-and-properties.md) | Instance search, creation, editing, and tags | `query_instances`, `mutate_instances`, `manage_properties` |
+| [Scripting & Code Execution](scripting.md) | Script management and Luau execution | `manage_scripts`, `execute_luau` |
+| [World & Environment](world-and-environment.md) | Lighting, terrain, spatial queries, and camera | `manage_lighting`, `manage_terrain`, `spatial_query`, `manage_camera` |
+| [Assets & Effects](assets-and-effects.md) | Asset insertion, tweening, animation, audio, and effects | `manage_assets`, `manage_tween`, `manage_animation`, `manage_audio`, `manage_effects`, `manage_physics` |
+| [Playtest & Automated Tests](playtest.md) | Playtest control and automated validation | `system_info` (`play`, `stop`, `pause`, `resume`, `play_status`, `run_test`) |
+| [Sync](../sync/overview.md) | Studio and local file synchronization | `manage_sync`, `workspace_state` |
+| [System & Debugging](system-and-debugging.md) | Connection checks, logs, selection, and batch execution | `system_info` (`ping`, `connection`, `usage`, ...), `manage_logs`, `manage_selection`, `batch_execute` |
+
 Related docs:
 - [Sync Deep Dive](../sync/overview.md)
 
@@ -248,6 +262,12 @@ Sync policy:
 | `place_info` | Get place ID, name, creator | Pro |
 | `services` | List all Roblox services | Pro |
 | `studio_settings` | Get Studio preferences | Pro |
+| `play` | Start playtest in Play (F5) or Run (F8) mode | Pro |
+| `stop` | Stop the active playtest | Pro |
+| `pause` | Pause the active Run-mode playtest | Pro |
+| `resume` | Resume the paused Run-mode playtest | Pro |
+| `play_status` | Get playtest state and available actions | Pro |
+| `run_test` | Inject a temporary test script, run playtest, collect logs, and write local report files | Pro |
 
 ## Batch Execute (Pro)
 

package/docs/en/tools/playtest.md

@@ -0,0 +1,140 @@
+# Playtest & Automated Tests
+
+> Control Roblox Studio playtests with AI, inject test scripts, and automatically generate logs and local reports.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `system_info` | Pro | `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` actions |
+
+> For the other `system_info` actions such as `ping`, `connection`, and `usage`, see [System & Debugging](system-and-debugging.md).
+
+## Key Workflows
+
+### Manual playtest control
+
+```
+"Start the game in Play mode (F5)."
+"Stop the current playtest."
+```
+
+Typical flow: `play` -> `play_status` -> `stop`.
+
+### Run an automated test
+
+```
+"Write and run a test that checks whether the SpawnLocation is positioned correctly."
+```
+
+`run_test` injects the test script, starts the playtest automatically, collects logs, and cleans up.
+
+### CI-style verification
+
+```
+"Run a Run-mode (F8) test that verifies the NPC reaches the target, and show me the logs if it fails."
+```
+
+Use `run_test` with `mode: "run"` for server-focused validation.
+
+## Playtest State Machine
+
+```text
+Edit --play--> Running --stop--> Edit
+                  |               ^
+                pause             |
+                  |               |
+                  v               |
+               Paused --resume--> Running
+```
+
+| State | Available actions |
+|-------|-------------------|
+| `edit` | `play` |
+| `running` | `stop`, `pause` (Run mode only) |
+| `paused` | `resume`, `stop` |
+
+- Play mode (F5): client + server simulation, no pause or resume
+- Run mode (F8): server-only simulation, supports pause and resume
+
+## `run_test` Pipeline
+
+`run_test` orchestrates these steps automatically:
+
+### 1. Prepare
+
+- Read place information with `place_info`
+- Clear the existing log buffer
+
+### 2. Inject the script
+
+- Create `ServerScriptService.__MCP_TestRunner` with a wrapped test script
+- The wrapper handles `START` and `FINISHED` signals plus error tracebacks
+
+### 3. Execute and monitor
+
+- Start the playtest in Play or Run mode
+- Poll logs every 500 ms
+- Finish when `[WEPPY_TEST]:FINISHED` is detected
+- Stop automatically on timeout (default 60 seconds, maximum 300)
+
+### 4. Clean up
+
+- Stop the playtest automatically
+- Delete the injected test script
+- Collect final logs
+
+### 5. Write reports
+
+Reports and logs are written to local files:
+
+```text
+roblox-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
+├── test-report.md
+└── test-log.txt
+```
+
+Example `test-report.md`:
+
+```markdown
+# Test Report
+
+- Status: passed
+- Test Name: spawn_location_test
+- Mode: run
+- Place ID: 123456
+- Duration (ms): 1523
+- Total Logs: 12
+- Signal Count: 2
+
+## Signals
+
+- START: 2026-03-12T10:30:00.000Z
+- FINISHED: 2026-03-12T10:30:01.523Z
+```
+
+## Action Reference
+
+| Action | Description | Parameters | Tier |
+|--------|-------------|------------|------|
+| `play` | Start a playtest in Play (F5) or Run (F8) mode | `mode`: `"play"` \| `"run"` | Pro |
+| `stop` | Stop the current playtest | - | Pro |
+| `pause` | Pause a Run-mode playtest | - | Pro |
+| `resume` | Resume a paused Run-mode playtest | - | Pro |
+| `play_status` | Get playtest state and available actions | - | Pro |
+| `run_test` | Inject a test script, run playtest, collect logs, and write reports | `script` (required), `test_name`, `mode`, `timeout` | Pro |
+
+### `run_test` Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|:--------:|-------------|
+| `script` | string | ✅ | Luau test code body to execute |
+| `test_name` | string | - | Display name used in the report |
+| `mode` | `"play"` \| `"run"` | - | Playtest mode, defaults to `"play"` |
+| `timeout` | number | - | Timeout in seconds, default 60, maximum 300 |
+
+## Related Docs
+
+- [System & Debugging](system-and-debugging.md) - connection actions and log management
+- [Scripting & Code Execution](scripting.md) - write scripts and run Luau
+- [Tools Reference](overview.md)

package/docs/en/tools/scripting.md

@@ -0,0 +1,66 @@
+# Scripting & Code Execution
+
+> Manage script source code and run arbitrary Luau inside Roblox Studio.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `manage_scripts` | Mixed | Create, read, edit, search, and analyze script dependencies |
+| `execute_luau` | Pro | Run arbitrary Luau in the Roblox Studio sandbox |
+
+## Key Workflows
+
+### Edit a script
+
+```
+"Change maxPlayers from 12 to 24 in the GameManager script under ServerScriptService."
+```
+
+Use `manage_scripts.search` to find the relevant line, then `manage_scripts.edit_replace` to update it.
+
+### Refactor multiple scripts (Pro)
+
+```
+"Replace OldModule with NewModule across every script."
+```
+
+Use `manage_scripts.replace` to apply the change across multiple scripts in one request.
+
+### Inspect runtime data (Pro)
+
+```
+"Calculate the average Health of every Humanoid currently in Workspace."
+```
+
+Use `execute_luau` to run custom Luau and read live runtime data.
+
+## Action Reference
+
+### Manage Scripts (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get_source` | Get script source code | Basic |
+| `set_source` | Set script source code | Basic |
+| `create` | Create a new script | Basic |
+| `delete` | Delete a script | Basic |
+| `edit_replace` | Replace specific lines in a script | Basic |
+| `edit_insert` | Insert lines at a position | Basic |
+| `edit_delete` | Delete specific lines | Basic |
+| `search` | Search for text in scripts | Basic |
+| `get_dependencies` | Get script dependencies | Basic |
+| `replace` | Batch replace across scripts | Pro |
+
+### Execute Luau (Pro)
+
+Run arbitrary Luau inside the Roblox Studio sandbox.
+
+- Blocked services: `HttpService`, `DataStoreService`, `MessagingService`
+- Inaccessible APIs: `CoreGui`, `CorePackages`
+
+## Related Docs
+
+- [Instances & Properties](instances-and-properties.md) - create or move script instances
+- [Playtest & Automated Tests](playtest.md) - inject and run test scripts
+- [Tools Reference](overview.md)

package/docs/en/tools/system-and-debugging.md

@@ -0,0 +1,85 @@
+# System & Debugging
+
+> Check connection state, manage logs, control Studio selection, and batch commands for debugging workflows.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `system_info` | Mixed | `ping`, `connection`, `usage`, `place_info`, `services`, `studio_settings` |
+| `manage_logs` | Basic | Query logs, clear buffers, and filter recent errors |
+| `manage_selection` | Mixed | Read, replace, and monitor Studio selection |
+| `batch_execute` | Pro | Execute multiple commands in one batch |
+
+> For the playtest actions on `system_info` such as `play`, `stop`, and `run_test`, see [Playtest & Automated Tests](playtest.md).
+
+## Key Workflows
+
+### Check the connection
+
+```
+"Check whether Studio is connected correctly."
+```
+
+Use `system_info.ping` for a quick health check.
+
+### Debug recent errors
+
+```
+"Show me the most recent error logs."
+```
+
+Use `manage_logs.errors` to filter only recent errors. `manage_logs.get` also supports incremental polling with a `sinceSeq` cursor.
+
+### Run a batch workflow (Pro)
+
+```
+"Turn every Part in Workspace red, then focus the camera on the first one."
+```
+
+Use `batch_execute` to bundle multiple commands into one request.
+
+## Action Reference
+
+### System Info (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `ping` | Test the connection | Basic |
+| `connection` | Get server and plugin connection info | Basic |
+| `usage` | Get the current tier (`basic` or `pro`) | Basic |
+| `place_info` | Get place ID, name, and creator | Pro |
+| `services` | List all Roblox services | Pro |
+| `studio_settings` | Get Studio preferences | Pro |
+
+### Manage Logs (Basic)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get filtered logs with optional `sinceSeq` cursor support | Basic |
+| `clear` | Clear the log buffer | Basic |
+| `errors` | Get recent errors only | Basic |
+
+### Manage Selection (Mixed)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `get` | Get the current selection | Basic |
+| `set` | Replace the current selection | Basic |
+| `clear` | Clear the selection | Basic |
+| `cached` | Get cached selection without a round trip | Basic |
+| `context` | Get detailed context with source and properties | Pro |
+| `details` | Get hierarchical details with ancestors and descendants | Pro |
+| `add` | Add items to the selection | Pro |
+| `remove` | Remove items from the selection | Pro |
+| `watch` | Monitor selection changes | Pro |
+
+### Batch Execute (Pro)
+
+Execute multiple commands in one batch. Each command includes a tool name and arguments, runs sequentially, and can optionally continue after errors.
+
+## Related Docs
+
+- [Playtest & Automated Tests](playtest.md) - playtest control on `system_info`
+- [Scripting & Code Execution](scripting.md) - run Luau for investigation or debugging
+- [Tools Reference](overview.md)

package/docs/en/tools/world-and-environment.md

@@ -0,0 +1,102 @@
+# World & Environment
+
+> Build and inspect the game world with lighting, terrain, spatial queries, and camera tools.
+
+## Included Tools
+
+| Tool | Tier | Description |
+|------|:----:|-------------|
+| `manage_lighting` | Pro | Configure Lighting, Atmosphere, Sky, and time of day |
+| `manage_terrain` | Pro | Generate and edit terrain, including voxel data |
+| `spatial_query` | Pro | Raycasts, ground checks, placement validation, and heightmaps |
+| `manage_camera` | Basic | Inspect camera state, move focus, and get suggested views |
+
+## Key Workflows
+
+### Set the mood (Pro)
+
+```
+"Switch the map to a sunset mood with orange skies, heavier fog, and 18:00 time."
+```
+
+Use `manage_lighting.time` for the clock, `manage_lighting.atmosphere` for fog, and `manage_lighting.sky` for sky visuals.
+
+### Shape terrain (Pro)
+
+```
+"Create a grassy hill with radius 200 at the center of the map and surround it with water."
+```
+
+Use `manage_terrain.fill_ball` for the hill, then `manage_terrain.fill_block` to place surrounding water.
+
+### Validate placement (Pro)
+
+```
+"Find a flat area where I can place this building."
+```
+
+Use `spatial_query.find_flat` to find candidates, `spatial_query.check_placement` to validate them, and `manage_camera.focus_position` to inspect the result visually.
+
+## Action Reference
+
+### Manage Lighting (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `lighting` | Set Lighting service properties | Pro |
+| `atmosphere` | Set Atmosphere properties | Pro |
+| `sky` | Set Sky properties | Pro |
+| `terrain_props` | Set Terrain water and visual properties | Pro |
+| `time` | Set time of day | Pro |
+
+### Manage Terrain (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `fill_block` | Fill block-shaped terrain | Pro |
+| `fill_ball` | Fill sphere-shaped terrain | Pro |
+| `fill_cylinder` | Fill cylinder-shaped terrain | Pro |
+| `fill_wedge` | Fill wedge-shaped terrain | Pro |
+| `clear_region` | Clear terrain in a region | Pro |
+| `clear_bounds` | Clear terrain in bounds | Pro |
+| `replace_material` | Replace material in a region | Pro |
+| `colors_get` | Get material colors | Pro |
+| `colors_set` | Set material colors | Pro |
+| `read_voxel` | Read a single voxel | Pro |
+| `read_voxels` | Read bulk voxel data | Pro |
+| `write_voxels` | Write bulk voxel data | Pro |
+| `generate` | Generate procedural terrain | Pro |
+| `smooth` | Smooth terrain | Pro |
+
+### Spatial Query (Pro)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `raycast` | Cast a single ray | Pro |
+| `find_ground` | Find the ground position below a point | Pro |
+| `check_placement` | Check whether a placement is collision-free | Pro |
+| `multi_raycast` | Cast multiple rays in batch | Pro |
+| `scan_area` | Generate a heightmap of an area | Pro |
+| `find_flat` | Find flat areas for building | Pro |
+| `find_spawn` | Find suitable spawn positions | Pro |
+| `analyze_walkable` | Analyze a walkability grid | Pro |
+| `spatial_map` | Get all BasePart positions | Pro |
+| `find_space` | Find empty space for an object | Pro |
+| `bounds` | Get instance bounding boxes | Pro |
+| `snap_grid` | Snap a position to the grid | Pro |
+| `collision` | Check AABB collision | Pro |
+
+### Manage Camera (Basic)
+
+| Action | Description | Tier |
+|--------|-------------|------|
+| `info` | Get camera position, rotation, FOV, and viewport size | Basic |
+| `focus_path` | Move the camera to focus on an instance | Basic |
+| `focus_position` | Move the camera to focus on a position | Basic |
+| `suggest` | Get a suggested camera view for a target | Basic |
+
+## Related Docs
+
+- [Instances & Properties](instances-and-properties.md) - place world objects
+- [Assets & Effects](assets-and-effects.md) - add effects, audio, and animation
+- [Tools Reference](overview.md)