edit_entire_level
Replace all tiles and modify metadata for VibeTide 2D platformer levels to create custom gameplay environments with controlled enemy and coin parameters.
Instructions
Edit an entire VibeTide level, replacing all tiles and optionally metadata.
Args:
level_data: The original level data (for reference)
new_tiles: 2D array of tile types (each 0-7)
new_name: New name for the level (optional)
new_description: New description for the level (optional)
max_enemies: Maximum enemies parameter (1-10, optional)
enemy_spawn_chance: Enemy spawn chance percentage (0-100, optional)
coin_spawn_chance: Coin spawn chance percentage (0-100, optional)
Returns the completely modified level data.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level_data | Yes | ||
| new_tiles | Yes | ||
| new_name | No | ||
| new_description | No | ||
| max_enemies | No | ||
| enemy_spawn_chance | No | ||
| coin_spawn_chance | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- vibe_tide_mcp_server.py:908-1032 (handler)The @mcp.tool()-decorated handler function that implements the core logic for the 'edit_entire_level' tool. It validates the input new_tiles 2D array and optional metadata parameters, constructs the new level data, encodes it using LevelEncoder, generates visualization and play URL, and returns the result.
@mcp.tool() async def edit_entire_level( level_data: Dict[str, Any], new_tiles: List[List[int]], new_name: Optional[str] = None, new_description: Optional[str] = None, max_enemies: Optional[int] = None, enemy_spawn_chance: Optional[float] = None, coin_spawn_chance: Optional[float] = None, ) -> Dict[str, Any]: """Edit an entire VibeTide level, replacing all tiles and optionally metadata. Args: level_data: The original level data (for reference) new_tiles: 2D array of tile types (each 0-7) new_name: New name for the level (optional) new_description: New description for the level (optional) max_enemies: Maximum enemies parameter (1-10, optional) enemy_spawn_chance: Enemy spawn chance percentage (0-100, optional) coin_spawn_chance: Coin spawn chance percentage (0-100, optional) Returns the completely modified level data. """ try: # Validate new tiles array if not isinstance(new_tiles, list) or not new_tiles: return {"success": False, "error": "new_tiles must be a non-empty 2D array"} # Validate dimensions height = len(new_tiles) width = len(new_tiles[0]) if new_tiles else 0 if width == 0: return {"success": False, "error": "new_tiles rows cannot be empty"} # Validate all rows have same width and contain valid tile types for row_idx, row in enumerate(new_tiles): if not isinstance(row, list): return {"success": False, "error": f"Row {row_idx} is not a list"} if len(row) != width: return { "success": False, "error": f"Row {row_idx} has length {len(row)}, expected {width}", } for col_idx, tile_type in enumerate(row): if not isinstance(tile_type, int) or tile_type < 0 or tile_type > 7: return { "success": False, "error": f"Invalid tile type {tile_type} at ({row_idx}, {col_idx}) - must be integer 0-7", } # Create new level data edited_level = { "tiles": [row.copy() for row in new_tiles], "width": width, "height": height, "name": new_name or level_data.get("name", "Edited Level"), "description": new_description or level_data.get("description", "A custom edited level"), } # Add game parameters if provided if max_enemies is not None: if not isinstance(max_enemies, int) or max_enemies < 0 or max_enemies > 10: return {"success": False, "error": "max_enemies must be integer 0-10"} edited_level["maxEnemies"] = max_enemies elif "maxEnemies" in level_data: edited_level["maxEnemies"] = level_data["maxEnemies"] if enemy_spawn_chance is not None: if ( not isinstance(enemy_spawn_chance, (int, float)) or enemy_spawn_chance < 0 or enemy_spawn_chance > 100 ): return { "success": False, "error": "enemy_spawn_chance must be number 0-100", } edited_level["enemySpawnChance"] = float(enemy_spawn_chance) elif "enemySpawnChance" in level_data: edited_level["enemySpawnChance"] = level_data["enemySpawnChance"] if coin_spawn_chance is not None: if ( not isinstance(coin_spawn_chance, (int, float)) or coin_spawn_chance < 0 or coin_spawn_chance > 100 ): return { "success": False, "error": "coin_spawn_chance must be number 0-100", } edited_level["coinSpawnChance"] = float(coin_spawn_chance) elif "coinSpawnChance" in level_data: edited_level["coinSpawnChance"] = level_data["coinSpawnChance"] # Generate encoded version try: encoded_level = level_encoder.encode(edited_level) play_url = f"{VIBE_TIDE_CONFIG['web_player_url']}?level={encoded_level}" except Exception as e: logger.warning(f"Failed to encode edited level: {e}") encoded_level = None play_url = None # Generate visualization visualization = visualize_level(edited_level) return { "success": True, "level_data": edited_level, "encoded_level": encoded_level, "play_url": play_url, "visualization": visualization, "change_summary": f"Replaced entire level: {width}x{height} tiles", "message": f"Successfully edited entire level '{edited_level['name']}'", } except Exception as e: logger.error(f"Failed to edit entire level: {e}") return {"success": False, "error": f"Failed to edit entire level: {str(e)}"}