diff --git a/addons/spx_tilemap_exporter/README.md b/addons/spx_tilemap_exporter/README.md new file mode 100644 index 000000000000..09e86c0de4dd --- /dev/null +++ b/addons/spx_tilemap_exporter/README.md @@ -0,0 +1,189 @@ +# SPX TileMap Exporter + +A Godot editor plugin for exporting TileMap scenes and decorators to SPX JSON format for dynamic loading in the SPX runtime. + +## Quick Start + +```bash +# 1. Copy the plugin to your project's addons directory +cp -r spx_tilemap_exporter /path/to/your/project/addons/ + +# 2. Navigate to your project directory +cd /path/to/your/project + +# 3. Export the scene +python addons/spx_tilemap_exporter/export.py --godot /path/to/godot --scene main.tscn + +# Export files are saved in the `res://_export//` directory +``` + +## Features + +- **TileMap Export**: Export TileMapLayer, TileSet, and physics collision data +- **Decorator Export**: Export Sprite2D nodes and prefab instances from scenes +- **Automatic Texture Copy**: Automatically copy related textures to the export directory +- **Coordinate System Conversion**: Automatically convert Godot coordinates to SPX coordinates (Y-axis flip) +- **Collision Shape Support**: Support for exporting rectangle, circle, capsule, and polygon colliders +- **CLI Support**: Provides CLI scripts for batch automation exports + +## Installation + +1. Copy the `spx_tilemap_exporter` folder to the `addons/` directory of the Godot project you want to export + +> **Note**: If you only use command-line export, the above steps complete the installation. +> To use the editor menu export feature, you also need to enable the "SPX TileMap Exporter" plugin in the Godot editor under **Project > Project Settings > Plugins**. + +## Usage + +### Command Line Export (Recommended) + +Using the Python script for export is the simplest method: + +**Method 1: Specify Godot path via command line argument** + +```bash +python export.py --godot /path/to/godot --scene levels/level1.tscn +``` + +**Method 2: Specify Godot path via environment variable** + +```bash +# Linux/macOS +export GODOT_PATH=/path/to/godot + +# Windows +set GODOT_PATH=C:\path\to\godot.exe + +# Export a specific scene +python export.py --scene levels/level1.tscn +``` + +**Godot Path Priority:** +1. `--godot` command line argument (highest priority) +2. `GODOT_PATH` environment variable +3. If neither is specified, an error message will be displayed + +**Parameters:** + +| Parameter | Description | +|-----------|-------------| +| `--godot PATH` | Specify the Godot executable path (takes priority over environment variable) | +| `--scene PATH` | Specify the scene file path to export, `res://` prefix is optional (default: `res://main.tscn`) | + + +### Editor Menu Export + +> **Prerequisite**: You need to enable the plugin in the Godot editor first (**Project > Project Settings > Plugins**) + +After enabling the plugin, you can access export features through the **Project > Tools** menu: + +| Menu Item | Function | +|-----------|----------| +| **SPX Export TileMap...** | Export only the TileMap data from the current scene | +| **SPX Export Decorators...** | Export only the decorator data from the current scene | +| **SPX Export All...** | Export both TileMap and decorator data | + + +### Direct Godot CLI Usage + +For more granular control, you can use the Godot command line directly: + +```bash +# Basic usage (exports default scene res://main.tscn) +godot --headless --path -s addons/spx_tilemap_exporter/export_cli.gd + +# Export a specific scene +godot --headless --path -s addons/spx_tilemap_exporter/export_cli.gd -- --scene res://levels/level1.tscn +``` + +| Parameter | Description | +|-----------|-------------| +| `--scene ` | Specify the scene path to export (must be placed after `--`) | + +## Export Output + +Export files are saved in the `res://_export//` directory: + +``` +_export/ +└── / + ├── tilemap.json # TileMap data + ├── tilemap/ # TileMap texture directory + │ └── *.png + ├── decorator.json # Decorator data + └── decorator/ # Decorator texture directory + └── *.png +``` + +## Configuration + +### CLI Script Configuration + +Edit the constants in `export_cli.gd` to modify the default configuration: + +```gdscript +const DEFAULT_SCENE_PATH = "res://main.tscn" # Default scene path to export +const EXPORT_TILEMAP = true # Whether to export TileMap +const EXPORT_DECORATORS = true # Whether to export decorators +``` + +### Excluding Nodes + +The following nodes are automatically excluded during decorator export: + +- Nodes belonging to the `spx_ignore` group +- TileMapLayer and TileMap nodes (exported separately) +- Nodes with names containing `_ignore` or `_skip` + +## File Descriptions + +| File | Description | +|------|-------------| +| `plugin.cfg` | Plugin configuration file | +| `spx_tilemap_exporter.gd` | Main plugin script, provides editor menu functionality | +| `tilemap_extractor.gd` | TileMap data extraction and export logic | +| `decorator_extractor.gd` | Decorator data extraction and export logic | +| `export_cli.gd` | Command-line export script (Godot --headless mode) | +| `export.py` | Python automation export script | + + +## Requirements + +- Godot 4.x +- Python 3.8+ (when using the Python export script) + +--- + +## For Engine Developers + +> The following content is for SPX engine developers only. Regular users can skip this section. + +### Plugin Rapid Iteration + +When developing the `spx_tilemap_exporter` plugin, you can use the `--copy` parameter to copy the latest plugin code from the engine source directory to the target project: + +```bash +# Export with addon copy (copy latest plugin from source to project directory) +python export.py --copy + +# Combined usage: copy plugin and export a specific scene +python export.py --copy --scene my_scene.tscn + +# Combined usage: specify Godot path, copy plugin, and export a specific scene +python export.py --godot /path/to/godot --copy --scene my_scene.tscn +``` + +| Parameter | Description | +|-----------|-------------| +| `--godot PATH` | Specify the Godot executable path (takes priority over `GODOT_PATH` environment variable) | +| `--copy` | Copy the latest plugin from `pkg/gdspx/godot/addons/` to the current project directory for rapid plugin development iteration | + +**Workflow:** + +1. Modify the plugin code in `pkg/gdspx/godot/addons/spx_tilemap_exporter/` +2. Navigate to the test project directory (e.g., `tutorial/AA-00Town/`) +3. Run `python export.py --copy` to automatically copy the plugin and test the export + +## License + +SPX Team © 2026 diff --git a/addons/spx_tilemap_exporter/README.zh.md b/addons/spx_tilemap_exporter/README.zh.md new file mode 100644 index 000000000000..d8a4944531fd --- /dev/null +++ b/addons/spx_tilemap_exporter/README.zh.md @@ -0,0 +1,189 @@ +# SPX TileMap Exporter + +Godot 编辑器插件，用于将 TileMap 场景和装饰器导出为 SPX JSON 格式，以便在 SPX 运行时动态加载。 + +## 快速开始 + +```bash +# 1. 将插件复制到项目的 addons 目录 +cp -r spx_tilemap_exporter /path/to/your/project/addons/ + +# 2. 进入项目目录 +cd /path/to/your/project + +# 3. 导出场景 +python addons/spx_tilemap_exporter/export.py --godot /path/to/godot --scene main.tscn + +# 导出文件保存在 `res://_export/<场景名>/` 目录： +``` + +## 功能特性 + +- **TileMap 导出**：导出 TileMapLayer、TileSet 及物理碰撞数据 +- **装饰器导出**：导出场景中的 Sprite2D 节点和预制体实例 +- **纹理自动复制**：自动将相关纹理复制到导出目录 +- **坐标系转换**：自动将 Godot 坐标系转换为 SPX 坐标系（Y 轴翻转） +- **碰撞形状支持**：支持导出矩形、圆形、胶囊体和多边形碰撞器 +- **命令行支持**：提供 CLI 脚本用于批量自动化导出 + +## 安装 + +1. 将 `spx_tilemap_exporter` 文件夹复制到需要导出的 Godot 项目的 `addons/` 目录 + +> **注意**：如果只使用命令行导出，以上步骤即可完成安装。 +> 如需使用编辑器菜单导出功能，还需在 Godot 编辑器中 **项目 > 项目设置 > 插件** 启用 "SPX TileMap Exporter" 插件。 + +## 使用方法 + +### 命令行导出（推荐） + +使用 Python 脚本进行导出是最简单的方式： + +**方式一：通过命令行参数指定 Godot 路径** + +```bash +python export.py --godot /path/to/godot --scene levels/level1.tscn +``` + +**方式二：通过环境变量指定 Godot 路径** + +```bash +# Linux/macOS +export GODOT_PATH=/path/to/godot + +# Windows +set GODOT_PATH=C:\path\to\godot.exe + +# 导出指定场景 +python export.py --scene levels/level1.tscn +``` + +**Godot 路径优先级：** +1. `--godot` 命令行参数（最高优先级） +2. `GODOT_PATH` 环境变量 +3. 如果都未指定，将显示错误提示 + +**参数说明：** + +| 参数 | 说明 | +|------|------| +| `--godot PATH` | 指定 Godot 可执行文件路径（优先级高于环境变量） | +| `--scene PATH` | 指定要导出的场景文件路径，`res://` 前缀可选（默认：`res://main.tscn`） | + + +### 编辑器菜单导出 + +> **前提条件**：需要先在 Godot 编辑器中启用插件（**项目 > 项目设置 > 插件**） + +启用插件后，可通过 **项目 > 工具** 菜单访问导出功能： + +| 菜单项 | 功能 | +|--------|------| +| **SPX Export TileMap...** | 仅导出当前场景的 TileMap 数据 | +| **SPX Export Decorators...** | 仅导出当前场景的装饰器数据 | +| **SPX Export All...** | 同时导出 TileMap 和装饰器数据 | + + +### 直接使用 Godot CLI + +如果需要更精细的控制，也可以直接使用 Godot 命令行： + +```bash +# 基础用法（导出默认场景 res://main.tscn） +godot --headless --path <项目路径> -s addons/spx_tilemap_exporter/export_cli.gd + +# 导出指定场景 +godot --headless --path <项目路径> -s addons/spx_tilemap_exporter/export_cli.gd -- --scene res://levels/level1.tscn +``` + +| 参数 | 说明 | +|------|------| +| `--scene ` | 指定要导出的场景路径（必须放在 `--` 之后） | + +## 导出输出 + +导出文件保存在 `res://_export/<场景名>/` 目录： + +``` +_export/ +└── <场景名>/ + ├── tilemap.json # TileMap 数据 + ├── tilemap/ # TileMap 纹理目录 + │ └── *.png + ├── decorator.json # 装饰器数据 + └── decorator/ # 装饰器纹理目录 + └── *.png +``` + +## 配置 + +### CLI 脚本配置 + +编辑 `export_cli.gd` 中的常量来修改默认配置： + +```gdscript +const DEFAULT_SCENE_PATH = "res://main.tscn" # 默认导出的场景路径 +const EXPORT_TILEMAP = true # 是否导出 TileMap +const EXPORT_DECORATORS = true # 是否导出装饰器 +``` + +### 排除节点 + +装饰器导出时会自动排除以下节点： + +- 属于 `spx_ignore` 组的节点 +- TileMapLayer 和 TileMap 节点（单独导出） +- 名称包含 `_ignore` 或 `_skip` 的节点 + +## 文件说明 + +| 文件 | 描述 | +|------|------| +| `plugin.cfg` | 插件配置文件 | +| `spx_tilemap_exporter.gd` | 主插件脚本，提供编辑器菜单功能 | +| `tilemap_extractor.gd` | TileMap 数据提取和导出逻辑 | +| `decorator_extractor.gd` | 装饰器数据提取和导出逻辑 | +| `export_cli.gd` | 命令行导出脚本（Godot --headless 模式） | +| `export.py` | Python 自动化导出脚本 | + + +## 环境要求 + +- Godot 4.x +- Python 3.8+（使用 Python 导出脚本时） + +--- + +## 引擎开发者 + +> 以下内容仅供 SPX 引擎开发者参考，普通用户可忽略此章节。 + +### 插件快速迭代 + +在开发 `spx_tilemap_exporter` 插件时，可以使用 `--copy` 参数将最新的插件代码从引擎源码目录复制到目标项目： + +```bash +# 带 addon 复制的导出（从源码复制最新插件到项目目录） +python export.py --copy + +# 组合使用：复制插件并导出指定场景 +python export.py --copy --scene my_scene.tscn + +# 组合使用：指定 Godot 路径、复制插件并导出指定场景 +python export.py --godot /path/to/godot --copy --scene my_scene.tscn +``` + +| 参数 | 说明 | +|------|------| +| `--godot PATH` | 指定 Godot 可执行文件路径（优先级高于 `GODOT_PATH` 环境变量） | +| `--copy` | 从 `pkg/gdspx/godot/addons/` 复制最新的插件到当前项目目录，用于快速迭代插件开发 | + +**工作流程：** + +1. 在 `pkg/gdspx/godot/addons/spx_tilemap_exporter/` 修改插件代码 +2. 进入测试项目目录（如 `tutorial/AA-00Town/`） +3. 运行 `python export.py --copy` 自动复制插件并测试导出 + +## 许可证 + +SPX Team © 2026 diff --git a/addons/spx_tilemap_exporter/export.py b/addons/spx_tilemap_exporter/export.py new file mode 100644 index 000000000000..8408063c56ef --- /dev/null +++ b/addons/spx_tilemap_exporter/export.py @@ -0,0 +1,304 @@ +#!/usr/bin/env python3 +""" +Copy the spx_tilemap_exporter addon from pkg/gdspx/godot/addons to the current +project's addons directory, and use Godot to run the export script for automatic +spx_tilemap data export. + +Godot Path: + --godot: Command line argument to specify Godot executable path (highest priority) + GODOT_PATH: Environment variable to specify Godot executable path + + If neither is specified, an error message will be displayed with instructions. +""" + +import argparse +import os +import shutil +import subprocess +from pathlib import Path + + +def copy_addon(project_root: Path, script_dir: Path) -> bool: + """Copy the spx_tilemap_exporter addon to the project's addons directory""" + # Source path: pkg/gdspx/godot/addons/spx_tilemap_exporter + src_path = project_root / "pkg" / "gdspx" / "godot" / "addons" / "spx_tilemap_exporter" + + # Destination path: tutorial/AA-00Town/addons/spx_tilemap_exporter + dst_path = script_dir / "addons" / "spx_tilemap_exporter" + + # Check if source directory exists + if not src_path.exists(): + print(f"Error: Source directory does not exist: {src_path}") + return False + + # Ensure parent directory of destination exists + dst_path.parent.mkdir(parents=True, exist_ok=True) + + # If destination directory already exists, remove it first + if dst_path.exists(): + print(f"Removing existing directory: {dst_path}") + shutil.rmtree(dst_path) + + # Copy directory + print(f"Copying addon:") + print(f" Source: {src_path}") + print(f" Destination: {dst_path}") + shutil.copytree(src_path, dst_path) + print("Addon copy completed!") + + return True + + +# Global variable to store Godot path from command line argument +_godot_path_override: Path | None = None + + +def set_godot_path_override(path: str | None) -> None: + """Set the Godot path override from command line argument""" + global _godot_path_override + if path: + _godot_path_override = Path(path) + else: + _godot_path_override = None + + +def get_godot_path() -> Path | None: + """Get the path to the Godot executable + + Priority: + 1. Command line argument (--godot) + 2. Environment variable (GODOT_PATH) + 3. Error message with instructions + """ + global _godot_path_override + + # Priority 1: Command line argument + if _godot_path_override: + if not _godot_path_override.exists(): + print(f"Error: Godot executable does not exist: {_godot_path_override}") + return None + return _godot_path_override + + # Priority 2: Environment variable + godot_path = os.environ.get("GODOT_PATH") + if godot_path: + godot_path = Path(godot_path) + if not godot_path.exists(): + print(f"Error: Godot executable does not exist: {godot_path}") + return None + return godot_path + + # Priority 3: Error message + print("Error: Godot path not specified") + print("") + print("Please specify the Godot executable path using one of the following methods:") + print(" 1. Command line argument: python export.py --godot /path/to/godot") + print(" 2. Environment variable: export GODOT_PATH=/path/to/godot") + print(" set GODOT_PATH=C:\\path\\to\\godot.exe (Windows)") + return None + + +def import_project(script_dir: Path) -> bool: + """Use Godot to import the project (rescan and import resources)""" + godot_path = get_godot_path() + if not godot_path: + return False + + # Build import command + # godot --headless --path --import + cmd = [ + str(godot_path), + "--headless", + "--path", str(script_dir), + "--import" + ] + + print("") + print("Importing project resources:") + print(f" Command: {' '.join(cmd)}") + print("") + + # Execute command + try: + result = subprocess.run(cmd, cwd=str(script_dir)) + if result.returncode != 0: + print(f"Error: Project import failed with return code: {result.returncode}") + return False + print("Project import completed!") + return True + except Exception as e: + print(f"Error: Failed to execute Godot import: {e}") + return False + + +def run_export(script_dir: Path, scene_path: str | None = None) -> bool: + """Use Godot to run the export script + + Args: + script_dir: Path to the project directory + scene_path: Optional scene path to export (e.g., "main.tscn" or "res://main.tscn") + If None, uses export_cli.gd's default (res://main.tscn) + The "res://" prefix is automatically added if not present. + """ + godot_path = get_godot_path() + if not godot_path: + return False + + # Auto-add res:// prefix if not present + if scene_path and not scene_path.startswith("res://"): + scene_path = "res://" + scene_path + + # Build command + # godot --headless --path -s addons/spx_tilemap_exporter/export_cli.gd [-- --scene ] + export_script = "addons/spx_tilemap_exporter/export_cli.gd" + + cmd = [ + str(godot_path), + "--headless", + "--path", str(script_dir), + "-s", export_script + ] + + # Add scene path argument if specified + if scene_path: + cmd.extend(["--", "--scene", scene_path]) + + print("") + print("Running export script:") + print(f" Command: {' '.join(cmd)}") + if scene_path: + print(f" Scene: {scene_path}") + else: + print(" Scene: (using default: res://main.tscn)") + print("") + + # Execute command + try: + result = subprocess.run(cmd, cwd=str(script_dir)) + if result.returncode != 0: + print(f"Error: Export script execution failed with return code: {result.returncode}") + return False + return True + except Exception as e: + print(f"Error: Failed to execute Godot: {e}") + return False + + +def main(): + # Parse command line arguments + parser = argparse.ArgumentParser( + description="SPX TileMap Export Tool - Export TileMap data from Godot project to SPX format.", + formatter_class=argparse.RawDescriptionHelpFormatter, + epilog=""" +Godot Path (one of the following is required): + --godot Command line argument to specify Godot executable path + GODOT_PATH Environment variable to specify Godot executable path + + Priority: --godot argument > GODOT_PATH environment variable + + Example: python export.py --godot /path/to/godot + export GODOT_PATH=/path/to/godot (Linux/macOS) + set GODOT_PATH=C:\\path\\to\\godot.exe (Windows) + +Usage Examples: + # Basic export with Godot path from environment variable + python export.py + + # Specify Godot executable path via command line + python export.py --godot /path/to/godot + python export.py --godot C:\\path\\to\\godot.exe + + # Export with addon copy (copies spx_tilemap_exporter to project first) + python export.py --copy + + # Export a specific scene (res:// prefix is optional) + python export.py --scene levels/level1.tscn + python export.py --scene res://levels/level1.tscn + + # Combine multiple options + python export.py --godot /path/to/godot --copy --scene my_scene.tscn + +Workflow: + 1. [Optional] Copy spx_tilemap_exporter addon to project (with --copy) + 2. Import project resources using Godot + 3. Run export script to generate SPX TileMap data + +Note: + This script should be placed in the target project directory + (e.g., tutorial/AA-00Town/). It will automatically detect the + project structure and export TileMap data accordingly. +""" + ) + parser.add_argument( + "--godot", + type=str, + default=None, + metavar="PATH", + help="Path to the Godot executable (overrides GODOT_PATH environment variable)" + ) + parser.add_argument( + "--copy", + action="store_true", + help="Copy spx_tilemap_exporter addon to project addons directory (not copied by default)" + ) + parser.add_argument( + "--scene", + type=str, + default=None, + metavar="PATH", + help="Path to the scene file to export, res:// prefix is optional (default: res://main.tscn)" + ) + args = parser.parse_args() + + # Set Godot path override from command line argument + set_godot_path_override(args.godot) + + # Get the directory where this script is located (works regardless of where it's executed from) + script_dir = Path(__file__).resolve().parent.parent.parent + + # Calculate project root directory (script is under tutorial/AA-00Town, go up two levels) + project_root = script_dir.parent.parent + + # Determine number of steps based on whether copying is enabled + total_steps = 3 if args.copy else 2 + current_step = 0 + + print("=" * 50) + print("SPX TileMap Export Tool") + print("=" * 50) + print("") + + # Step 1: Copy addon (only when --copy argument is specified) + if args.copy: + current_step += 1 + print(f"[Step {current_step}/{total_steps}] Copying spx_tilemap_exporter addon") + print("-" * 50) + if not copy_addon(project_root, script_dir): + return 1 + print("") + + # Step 2: Import project (let Godot rescan and import resources) + current_step += 1 + print(f"[Step {current_step}/{total_steps}] Importing project resources") + print("-" * 50) + if not import_project(script_dir): + return 1 + + print("") + + # Step 3: Run export script + current_step += 1 + print(f"[Step {current_step}/{total_steps}] Running Godot export script") + print("-" * 50) + if not run_export(script_dir, args.scene): + return 1 + + print("") + print("=" * 50) + print("All done!") + print("=" * 50) + return 0 + + +if __name__ == "__main__": + exit(main()) diff --git a/addons/spx_tilemap_exporter/export_cli.gd b/addons/spx_tilemap_exporter/export_cli.gd index e4da1d8d1862..d9d7c23bd3cc 100644 --- a/addons/spx_tilemap_exporter/export_cli.gd +++ b/addons/spx_tilemap_exporter/export_cli.gd @@ -2,43 +2,53 @@ extends SceneTree ## Command-line export script for SPX TileMap and Decorator data ## -## Usage: godot --headless --path -s addons/spx_tilemap_exporter/export_cli.gd +## Usage: godot --headless --path -s addons/spx_tilemap_exporter/export_cli.gd [-- --scene ] ## -## Configuration is done via constants below: +## Arguments: +## --scene Path to the scene file to export (default: res://main.tscn) +## +## Examples: +## godot --headless --path . -s addons/spx_tilemap_exporter/export_cli.gd +## godot --headless --path . -s addons/spx_tilemap_exporter/export_cli.gd -- --scene res://levels/level1.tscn const TileMapExtractor = preload("res://addons/spx_tilemap_exporter/tilemap_extractor.gd") const DecoratorExtractor = preload("res://addons/spx_tilemap_exporter/decorator_extractor.gd") # ============================================================================ -# Configuration - modify these as needed +# Configuration - default values (can be overridden via command line) # ============================================================================ -const SCENE_PATH = "res://main.tscn" +const DEFAULT_SCENE_PATH = "res://main.tscn" const EXPORT_TILEMAP = true const EXPORT_DECORATORS = true # ============================================================================ func _init() -> void: - # Get scene name for export directory - var scene_name = SCENE_PATH.get_file().get_basename() - var export_base = "res://_export/" + scene_name + # Parse command line arguments + var scene_path = _parse_scene_argument() + + # Get export directory path (preserves scene path structure) + # e.g., "res://main.tscn" -> "res://_export/main" + # e.g., "res://levels/level1.tscn" -> "res://_export/levels/level1" + var export_path = scene_path.get_file().get_basename() + var export_base = "res://_export/" + export_path print("SPX Export CLI") print("==============") - print("Scene: ", SCENE_PATH) + print("Scene: ", scene_path) print("Output: ", export_base) print("Export TileMap: ", EXPORT_TILEMAP) print("Export Decorators: ", EXPORT_DECORATORS) print("") # Load the scene - var packed_scene = load(SCENE_PATH) + var packed_scene = load(scene_path) if not packed_scene: - printerr("ERROR: Failed to load scene: ", SCENE_PATH) + printerr("ERROR: Failed to load scene: ", scene_path) quit(1) return if not packed_scene is PackedScene: - printerr("ERROR: Loaded resource is not a PackedScene: ", SCENE_PATH) + printerr("ERROR: Loaded resource is not a PackedScene: ", scene_path) quit(1) return @@ -180,6 +190,25 @@ func _export_decorators(scene_root: Node, output_path: String, node_offset: Vect # Helper Functions # ============================================================================ +func _parse_scene_argument() -> String: + """Parse --scene argument from command line, return default if not specified""" + # Use get_cmdline_user_args() for arguments after "--" separator + var args = OS.get_cmdline_user_args() + + # Look for --scene argument + for i in range(args.size()): + if args[i] == "--scene" and i + 1 < args.size(): + var scene_arg = args[i + 1] + # Validate the scene path + if not scene_arg.begins_with("res://"): + scene_arg = "res://" + scene_arg + print("Using scene from command line: ", scene_arg) + return scene_arg + + # Return default if not specified + return DEFAULT_SCENE_PATH + + func _find_tilemap_layers(node: Node) -> Array[TileMapLayer]: var layers: Array[TileMapLayer] = [] _find_tilemap_layers_recursive(node, layers)