@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/en/tools/overview.md

@@ -1,277 +0,0 @@
-# Roblox MCP Tools
-
-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)
-
-Sync policy:
-- Basic: Studio -> Local one-way sync
-- Pro: Bidirectional sync + broader advanced action coverage (better AI token efficiency with bulk workflows)
-
-## 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 new parent | Basic |
-| `rename` | Rename an instance | Basic |
-| `pivot` | Set pivot position or CFrame | Basic |
-| `create_tree` | Create 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 instance | Basic |
-| `remove_tag` | Remove a tag from instance | Basic |
-| `check_tag` | Check if 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 property using mathematical expression | Pro |
-| `set_relative` | Set property relative to current value | Pro |
-| `mass_set` | Set property on multiple instances | Pro |
-| `mass_get` | Get property from multiple instances | Pro |
-| `modify_children` | Modify all children of a parent | Pro |
-
-## 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 script | Basic |
-| `edit_insert` | Insert lines at position | Basic |
-| `edit_delete` | Delete specific lines | Basic |
-| `search` | Search for text in script | Basic |
-| `get_dependencies` | Get script dependencies | Basic |
-| `replace` | Batch replace across scripts | Pro |
-
-## 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/visual properties | Pro |
-| `time` | Set time of day | Pro |
-
-## Manage Selection (Mixed)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `get` | Get current selection | Basic |
-| `set` | Replace current selection | Basic |
-| `clear` | Clear selection | Basic |
-| `cached` | Get cached selection without round-trip | Basic |
-| `context` | Get detailed context with source and properties | Pro |
-| `details` | Get hierarchical details with ancestors/descendants | Pro |
-| `add` | Add items to selection | Pro |
-| `remove` | Remove items from selection | Pro |
-| `watch` | Monitor selection changes | Pro |
-
-## Manage Camera (Basic)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `info` | Get camera position, rotation, FOV, viewport size | Basic |
-| `focus_path` | Move camera to focus on instance | Basic |
-| `focus_position` | Move camera to focus on position | Basic |
-| `suggest` | Get suggested camera view for target | Basic |
-
-## 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 Audio (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `play` | Play a sound (creates 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 audio listener type/target | Pro |
-
-## Manage Animation (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `load` | Load animation on Humanoid/AnimationController | Pro |
-| `play` | Play a loaded animation track | Pro |
-| `stop` | Stop a playing animation | Pro |
-| `get_tracks` | List all loaded animation tracks | 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 |
-
-## Manage Effects (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `emit` | Emit particles from ParticleEmitter | Pro |
-| `clear` | Clear all particles | Pro |
-| `toggle` | Enable or disable effect | 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 region | Pro |
-| `clear_bounds` | Clear terrain in bounds | Pro |
-| `replace_material` | Replace material in region | Pro |
-| `colors_get` | Get material colors | Pro |
-| `colors_set` | Set material colors | Pro |
-| `read_voxel` | Read single voxel data | 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 ground position below point | Pro |
-| `check_placement` | Check if placement is collision-free | Pro |
-| `multi_raycast` | Cast multiple rays in batch | Pro |
-| `scan_area` | Generate heightmap of area | Pro |
-| `find_flat` | Find flat areas for building | Pro |
-| `find_spawn` | Find suitable spawn positions | Pro |
-| `analyze_walkable` | Analyze walkability grid | Pro |
-| `spatial_map` | Get all BasePart positions | Pro |
-| `find_space` | Find empty space for object | Pro |
-| `bounds` | Get bounding box of instances | Pro |
-| `snap_grid` | Snap position to grid | Pro |
-| `collision` | Check AABB collision | Pro |
-
-## Manage Assets (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `insert` | Insert model by asset ID | Pro |
-| `info` | Get asset metadata | Pro |
-| `search` | Search Creator Store | Pro |
-| `search_insert` | Search and insert first match | Pro |
-| `insert_free` | Insert free model | Pro |
-| `insert_package` | Insert package | Pro |
-| `export` | Export current selection | Pro |
-
-## Manage Sync (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `status_current_place` | Get sync status for the current connected place | Pro |
-| `history` | Get change history | Pro |
-| `directions` | Get per-type sync directions | Pro |
-| `read_file` | Read a synced file | Pro |
-| `write_file` | Write to a synced file | Pro |
-| `progress` | Get real-time sync progress and bandwidth | Pro |
-
-## Workspace State (Pro)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `sync` | Fetch current Workspace state | Pro |
-| `snapshot` | Get full instance tree structure | Pro |
-| `changes` | Get recent changes | Pro |
-| `viewport` | Get camera and viewport info | Pro |
-
-## Manage Logs (Basic)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `get` | Get filtered logs | Basic |
-| `clear` | Clear log buffer | Basic |
-| `errors` | Get recent errors only | Basic |
-
-## System Info (Mixed)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `ping` | Test connection | Basic |
-| `connection` | Get server/plugin connection info | Basic |
-| `usage` | Get current tier (basic/pro) | Basic |
-| `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)
-
-Execute multiple commands in a single batch. Each command specifies a tool name and arguments. Commands execute sequentially with optional continue-on-error behavior.
-
-## Execute Luau (Pro)
-
-Execute arbitrary Luau code in Roblox Studio sandbox. Blocked services: HttpService, DataStoreService, MessagingService. Cannot access CoreGui/CorePackages.

package/docs/en/tools/playtest.md

@@ -1,140 +0,0 @@
-# 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 under `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/`.
-
-```text
-{projectRoot}/weppy-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

@@ -1,66 +0,0 @@
-# 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

@@ -1,93 +0,0 @@
-# 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 |
-
-### Manage Context (Basic)
-
-| Action | Description | Tier |
-|--------|-------------|------|
-| `begin` | Start a structured execution context for the current session/place scope | Basic |
-| `update` | Update intent, affected areas, or replay metadata for the active context | Basic |
-| `end` | Close the active execution context and persist the final snapshot | Basic |
-
-### 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

@@ -1,102 +0,0 @@
-# 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)