[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FBNVCNBKPFGQF5P5QJZMXK":3,"skill-same:01M7FBNVCNBKPFGQF5P5QJZMXK":60},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7FBNVCNBKPFGQF5P5QJZMXK","godot-scene-authoring",null,"在 Godot 4 里新做关卡、房间、HUD、菜单、NPC、道具、背景时用，决定内容摆进 .tscn 还是代码运行时搭。新建项目第一个场景，往已有项目加场景，打开场景一片空看不到东西，美术策划要在编辑器里直接看和调，自定义显示节点在编辑器里不显示，@tool 节点把材质 z_index 写进 tscn，确定性模拟 联机 服务器要读场景里摆的位置。先自查项目是摆在场景里还是运行时生成，再按结果新做或迁移。脚本生成 tscn、@tool 自绘节点、预制场景、_validate_property、internal 子节点、NOTIFICATION_EDITOR_PRE_SAVE、C# 重载。level authoring, WYSIWYG, prefab, data-driven, bake on save, empty scene, audit.","MindsMaster\u002Fgodot-claude-code-skills","MindsMaster","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F167383411?v=4","01M7FBJFZBSAXET9TF9WDFRCJW","An5w1r","01M7FBJFZZRARX0F1VSWHTH9EM",3,"MIT","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-authoring\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: godot-scene-authoring\ndescription: 在 Godot 4 里新做关卡、房间、HUD、菜单、NPC、道具、背景时用，决定内容摆进 .tscn 还是代码运行时搭。新建项目第一个场景，往已有项目加场景，打开场景一片空看不到东西，美术策划要在编辑器里直接看和调，自定义显示节点在编辑器里不显示，@tool 节点把材质 z_index 写进 tscn，确定性模拟 联机 服务器要读场景里摆的位置。先自查项目是摆在场景里还是运行时生成，再按结果新做或迁移。脚本生成 tscn、@tool 自绘节点、预制场景、_validate_property、internal 子节点、NOTIFICATION_EDITOR_PRE_SAVE、C# 重载。level authoring, WYSIWYG, prefab, data-driven, bake on save, empty scene, audit.\n---\n\n# Godot 场景摆放\n\n内容定义在哪：有位置、有外观的东西摆进 `.tscn`，代码只管规则和运行时才出现的东西。\n\n验收标准：不运行游戏，在编辑器里拖动灯、NPC、血条，存盘后游戏里同样改变。\n\n## 范围\n\n| 不含 | 去哪 |\n|---|---|\n| 场景拆分、节点通信、`owner` 规则 | godot-scene-architecture |\n| `EditorPlugin`、Inspector 插件、导入插件 | godot-editor-tooling |\n| 自定义 `Resource`、配表 | godot-resources-data |\n| C# 热重载通用规则 | godot-csharp |\n\n## 先查内置\n\n| 需求 | 用这个 | 别自己写 |\n|---|---|---|\n| 背景 道具 灯 HUD 菜单布局 | 节点直接摆进 `.tscn`，UI 用 Container 和 `Theme` | 代码 `new` 整棵树，场景只剩空壳 |\n| 运行时才出现的敌人 子弹 列表行 | 预制 `.tscn` + `PackedScene.instantiate()` | 代码逐个 `new` 子节点再设外观 |\n| 不开编辑器生成场景文件 | `extends SceneTree` 脚本建节点、设 owner、`PackedScene.pack`、`ResourceSaver.save` | 手拼大段 tscn 文本 |\n| 自定义显示节点在编辑器里可见 | `@tool` + 按导出属性 `_draw` 或建内部子节点 | 只在运行时按配表建 |\n| 代码派生的属性不进 tscn | `_validate_property` 去掉 `PROPERTY_USAGE_STORAGE` | 存盘前清掉、存完再设回 |\n| 节点自己生成的辅助子节点 | `add_child(n, false, Node.INTERNAL_MODE_BACK)` 不设 owner | 设 owner 存进场景 |\n| 模拟 服务器 回放要读摆好的位置 | 存盘时导出：`Node.NOTIFICATION_EDITOR_PRE_SAVE` 或 `EditorPlugin.scene_saved` | JSON 里手写坐标 |\n| 同一类物件不同外观 | 预制场景实例后覆盖属性，或继承场景 | 配表里写贴图路径 颜色 尺寸 |\n| Tiled LDtk 外部关卡 | `EditorImportPlugin` 导入成场景，见 godot-editor-tooling | 运行时解析 |\n\n- 默认直接导出 `Texture2D`，拖进 Inspector\n- 有资源表或 MOD 覆盖时导出 ID 字符串，`@tool` 里解析成贴图\n\n## 做法\n\n### 自查\n\n动手前先确认项目现在的做法，细节和脚本见 [references\u002Faudit.md](references\u002Faudit.md)：\n\n1. 读几个现有 `.tscn`，看节点数和游戏画面对不对得上\n2. 搜脚本里的 `.new()` 加 `add_child`、给 `Control` 设 `position` `size`、`load` 贴图\n3. 搜配表里的坐标、贴图路径、颜色字段\n4. 无头跑审计脚本，数 `_ready` 后多出的、owner 为空的节点\n\n| 结果 | 做法 |\n|---|---|\n| 新项目，或还没有内容场景 | 按下文新做 |\n| 内容摆在场景里 | 照现有结构加 |\n| 场景空壳，内容运行时建 | 报告自查结果和迁移范围，同意后按 [references\u002Fmigration.md](references\u002Fmigration.md) 迁 |\n| 未同意迁移 | 新系统摆进场景，已有的代码搭系统跟着现状写 |\n| 两种都有 | 按系统分开判断，HUD、菜单、关卡、NPC 各算一项 |\n\n- 程序生成的地图、按数据数量建的列表行属于运行时内容，不算问题\n\n### 内容归属\n\n| 内容 | 放哪 |\n|---|---|\n| 背景层、灯、NPC 站位和朝向、道具、机关外观、HUD 和菜单布局 | `.tscn` |\n| 敌人、投射物、掉落、列表行、弹窗 | 预制 `.tscn`，代码 `instantiate()` 后设数据 |\n| 出现条件、对话、商店、波次、伤害 | `Resource` 或配表 |\n| 模拟 服务器要的位置和尺寸 | 场景里摆，存盘导出成数据 |\n| 程序生成的地图 | 代码生成，`@tool` 里用同一种子给编辑器生成 |\n\n- 同一项只有一个来源，外观不在场景和配表里各写一份\n\n### 新做场景\n\n关卡的树，每一项都是存盘的节点，重复的东西是预制场景实例：\n\n```\nLevel            Node2D  level.gd\n├ Background     Parallax2D \u002F Sprite2D\n├ Ground         TileMapLayer\n├ Props          Node2D \u002F crate.tscn 实例若干\n├ Npcs           Node2D \u002F npc.tscn 实例 覆盖朝向和对话 ID\n├ SpawnPoints    Node2D \u002F Marker2D 若干\n└ Hud            hud.tscn 实例\n```\n\n不开编辑器时用一次性脚本生成，`godot --headless -s make_level.gd`，跑完删掉脚本：\n\n\u003C!-- check: gdonly -->\n```gdscript\nextends SceneTree\n\nfunc _initialize() -> void:\n\tvar level := Node2D.new()\n\tlevel.name = \"Level\"\n\tvar points := Node2D.new()\n\tpoints.name = \"SpawnPoints\"\n\tlevel.add_child(points)\n\tpoints.owner = level\n\tfor i in 3:\n\t\tvar marker := Marker2D.new()\n\t\tmarker.name = \"Spawn%d\" % i\n\t\tmarker.position = Vector2(200.0 * i, 0.0)\n\t\tpoints.add_child(marker)\n\t\tmarker.owner = level\n\tvar packed := PackedScene.new()\n\tpacked.pack(level)\n\tResourceSaver.save(packed, \"res:\u002F\u002Flevel.tscn\")\n\tlevel.free()\n\tquit()\n```\n\n- 每个后代都设 `owner` 为场景根，只设直接子节点不够\n- 实例化的子场景只给它的根设 owner\n- 编辑器里的场景根是 `EditorInterface.get_edited_scene_root()`\n- 小场景可直接写 tscn 文本，注意事项见 godot-scene-architecture\n\n脚本只取场景里摆好的节点，运行时内容从预制场景实例化：\n\n```gdscript\nextends Node2D\n\n@export var enemy_scene: PackedScene\n@onready var spawn_points: Node2D = $SpawnPoints\n\nfunc spawn_wave() -> void:\n\tfor point: Node in spawn_points.get_children():\n\t\tvar enemy := enemy_scene.instantiate() as Node2D\n\t\tenemy.position = (point as Node2D).position\n\t\tadd_child(enemy)\n```\n\n### 自绘节点\n\n`Sprite2D` 能表达的用 `Sprite2D`。需要自己语义的节点，如按米算高度，同样按导出属性在编辑器里画出来：\n\n```gdscript\n@tool\nclass_name GroundProp\nextends Node2D\n\n@export var texture: Texture2D:\n\tset(value):\n\t\ttexture = value\n\t\tqueue_redraw()\n@export var height: float = 64.0:\n\tset(value):\n\t\theight = value\n\t\tqueue_redraw()\n\nfunc _draw() -> void:\n\tif texture == null:\n\t\treturn\n\tvar size := texture.get_size() * (height \u002F texture.get_height())\n\tdraw_texture_rect(texture, Rect2(Vector2(-size.x \u002F 2.0, -size.y), size), false)\n```\n\n- 存盘的是节点和导出属性，画法跟着脚本走\n- setter 里只 `queue_redraw()` 或改自身状态\n- setter 在进树前就会调用，用到树的操作先判断 `is_inside_tree()`\n\n### 派生属性\n\n`_ready` 或 setter 里按环境算出的属性，如按视口选的 `material`、按深度算的 `z_index`，存盘时照样写进 tscn。用 `_validate_property` 去掉存盘位：\n\n```gdscript\n@tool\nextends Node2D\n\n@export var depth: float = 0.0:\n\tset(value):\n\t\tdepth = value\n\t\tz_index = -10 if depth > 0.0 else 10\n\nfunc _validate_property(property: Dictionary) -> void:\n\tif property.name == \"z_index\":\n\t\tproperty.usage &= ~PROPERTY_USAGE_STORAGE\n```\n\n- 对继承来的引擎属性也生效，脚本须是 `@tool`\n- 去掉后场景里手设的值也不存，该属性只能由代码决定\n\n节点自己生成、不属于内容的子节点，如地面条、阴影，用 internal 子节点，不设 owner：\n\n```gdscript\n@tool\nextends Node2D\n\nvar _shadow: Sprite2D\n\nfunc _ready() -> void:\n\t_shadow = Sprite2D.new()\n\t_shadow.modulate = Color(0.0, 0.0, 0.0, 0.4)\n\tadd_child(_shadow, false, Node.INTERNAL_MODE_BACK)\n```\n\n| | 不设 owner | 不设 owner 且 internal |\n|---|---|---|\n| 视口里画出来 | 是 | 是 |\n| 场景面板里看得到、点得中 | 否 | 否 |\n| 存进 tscn | 否 | 否 |\n| `get_children()` 拿得到 | 是 | 否，要 `get_children(true)` |\n| `duplicate()` 和 Ctrl+D 带上 | 是 | 否 |\n\n- 只不设 owner 时，复制节点会连生成的子节点一起复制，新节点 `_ready` 再建一份\n- 设了 owner 的 internal 子节点照样存盘，读回来变成普通子节点\n\n### 存盘导出\n\n确定性模拟、回滚联机、服务器不依赖场景树时，位置照样摆在场景里，存盘时导出成数据文件一起提交：\n\n```gdscript\n@tool\nextends Node2D\n\n@export_file(\"*.json\") var export_path: String = \"res:\u002F\u002Froom_points.json\"\n\nfunc _notification(what: int) -> void:\n\tif what == NOTIFICATION_EDITOR_PRE_SAVE:\n\t\texport_points()\n\nfunc export_points() -> void:\n\tvar points: Array[Dictionary] = []\n\tfor child: Node in get_children():\n\t\tvar marker := child as Marker2D\n\t\tif marker != null:\n\t\t\tpoints.append({\"name\": String(marker.name), \"x\": marker.position.x, \"y\": marker.position.y})\n\tvar file := FileAccess.open(export_path, FileAccess.WRITE)\n\tfile.store_string(JSON.stringify({\"points\": points}, \"\\t\"))\n```\n\n- 只在编辑器里、打包场景前发给被存场景的每个节点\n- 这时节点被锁，`add_child` `remove_child` 报错，只能读写属性和文件\n- 统一导出放在插件里时连 `EditorPlugin.scene_saved`，文件写盘后调用\n\n### 编辑器视口\n\n| 项 | 编辑器里 |\n|---|---|\n| 场景里的 `Camera2D` | 不生效，跟镜头走的视差层、跟随节点停在原点 |\n| `CanvasLayer` 内容 | 跟着编辑器平移缩放 |\n| `SubViewport` 内容 | 按单位变换贴出，只显示子视口尺寸以内 |\n| 单个 `SubViewport` 开的 `Viewport.use_hdr_2d` | 不生效，只按项目设置 `rendering\u002Fviewport\u002Fhdr_2d` |\n| `@tool` 的 `_process` | 低处理器模式下只在重绘时推进 |\n| 切换场景标签页 | 场景根先出树再进树，`_ready` 只跑一次 |\n\n- 材质按 `get_viewport()` 在进树后选\n- `_process` 里每帧 `queue_redraw()` 会让编辑器一直刷新\n- `_exit_tree` 里释放的东西在 `_enter_tree` 里补回\n- 改了全局着色器参数、静态缓存的节点，在 `_exit_tree` 里还原\n- 换场景时先 `remove_child()` 再 `queue_free()`，否则旧节点帧末出树会还原掉新设的值\n- 只在当前编辑场景里做的事，判断 `is_part_of_edited_scene()`，`_ready` 里可用\n\n## 陷阱\n\n| 现象 | 做法 |\n|---|---|\n| 生成节点存进了子场景文件 | 生成节点挂在实例化子场景下且 owner 设为子场景根。生成节点一律不设 owner |\n| 预制场景里多个 ColorRect Label 要统一换材质 | 子节点勾 `CanvasItem.use_parent_material`，代码只给根设 |\n| 只打开存盘也出 diff | 编辑器给旧 tscn 补 `uid`，新版补 `unique_id`，和逻辑改动分开提交 |\n| 提交的导出数据过期 | 导出只在编辑器存盘时写。加无头检查：重新导出并与提交的文件比对 |\n| 美术在编辑器看得到但改了不生效 | 编辑器里只画了一份不存盘的假画面。内容要真的在场景里 |\n| 同一系统里混用摆场景和代码搭 | 先自查，跟随该系统现状 |\n\n## 参考\n\n- [references\u002Fcsharp.md](references\u002Fcsharp.md)：C# 项目先读，本文各节示例的 C# 写法、`[Tool]` 热重载\n- [references\u002Faudit.md](references\u002Faudit.md)：自查清单、搜索命令、无头审计脚本、报告格式\n- [references\u002Fmigration.md](references\u002Fmigration.md)：迁移顺序、坐标换算、无头编辑器验证插件、常见报错\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fbest_practices\u002Fscenes_versus_scripts.html\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fbest_practices\u002Fscene_organization.html\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fplugins\u002Frunning_code_in_the_editor.html\n","# Godot 场景摆放\n\n内容定义在哪：有位置、有外观的东西摆进 `.tscn`，代码只管规则和运行时才出现的东西。\n\n验收标准：不运行游戏，在编辑器里拖动灯、NPC、血条，存盘后游戏里同样改变。\n\n## 范围\n\n| 不含 | 去哪 |\n|---|---|\n| 场景拆分、节点通信、`owner` 规则 | godot-scene-architecture |\n| `EditorPlugin`、Inspector 插件、导入插件 | godot-editor-tooling |\n| 自定义 `Resource`、配表 | godot-resources-data |\n| C# 热重载通用规则 | godot-csharp |\n\n## 先查内置\n\n| 需求 | 用这个 | 别自己写 |\n|---|---|---|\n| 背景 道具 灯 HUD 菜单布局 | 节点直接摆进 `.tscn`，UI 用 Container 和 `Theme` | 代码 `new` 整棵树，场景只剩空壳 |\n| 运行时才出现的敌人 子弹 列表行 | 预制 `.tscn` + `PackedScene.instantiate()` | 代码逐个 `new` 子节点再设外观 |\n| 不开编辑器生成场景文件 | `extends SceneTree` 脚本建节点、设 owner、`PackedScene.pack`、`ResourceSaver.save` | 手拼大段 tscn 文本 |\n| 自定义显示节点在编辑器里可见 | `@tool` + 按导出属性 `_draw` 或建内部子节点 | 只在运行时按配表建 |\n| 代码派生的属性不进 tscn | `_validate_property` 去掉 `PROPERTY_USAGE_STORAGE` | 存盘前清掉、存完再设回 |\n| 节点自己生成的辅助子节点 | `add_child(n, false, Node.INTERNAL_MODE_BACK)` 不设 owner | 设 owner 存进场景 |\n| 模拟 服务器 回放要读摆好的位置 | 存盘时导出：`Node.NOTIFICATION_EDITOR_PRE_SAVE` 或 `EditorPlugin.scene_saved` | JSON 里手写坐标 |\n| 同一类物件不同外观 | 预制场景实例后覆盖属性，或继承场景 | 配表里写贴图路径 颜色 尺寸 |\n| Tiled LDtk 外部关卡 | `EditorImportPlugin` 导入成场景，见 godot-editor-tooling | 运行时解析 |\n\n- 默认直接导出 `Texture2D`，拖进 Inspector\n- 有资源表或 MOD 覆盖时导出 ID 字符串，`@tool` 里解析成贴图\n\n## 做法\n\n### 自查\n\n动手前先确认项目现在的做法，细节和脚本见 [references\u002Faudit.md](references\u002Faudit.md)：\n\n1. 读几个现有 `.tscn`，看节点数和游戏画面对不对得上\n2. 搜脚本里的 `.new()` 加 `add_child`、给 `Control` 设 `position` `size`、`load` 贴图\n3. 搜配表里的坐标、贴图路径、颜色字段\n4. 无头跑审计脚本，数 `_ready` 后多出的、owner 为空的节点\n\n| 结果 | 做法 |\n|---|---|\n| 新项目，或还没有内容场景 | 按下文新做 |\n| 内容摆在场景里 | 照现有结构加 |\n| 场景空壳，内容运行时建 | 报告自查结果和迁移范围，同意后按 [references\u002Fmigration.md](references\u002Fmigration.md) 迁 |\n| 未同意迁移 | 新系统摆进场景，已有的代码搭系统跟着现状写 |\n| 两种都有 | 按系统分开判断，HUD、菜单、关卡、NPC 各算一项 |\n\n- 程序生成的地图、按数据数量建的列表行属于运行时内容，不算问题\n\n### 内容归属\n\n| 内容 | 放哪 |\n|---|---|\n| 背景层、灯、NPC 站位和朝向、道具、机关外观、HUD 和菜单布局 | `.tscn` |\n| 敌人、投射物、掉落、列表行、弹窗 | 预制 `.tscn`，代码 `instantiate()` 后设数据 |\n| 出现条件、对话、商店、波次、伤害 | `Resource` 或配表 |\n| 模拟 服务器要的位置和尺寸 | 场景里摆，存盘导出成数据 |\n| 程序生成的地图 | 代码生成，`@tool` 里用同一种子给编辑器生成 |\n\n- 同一项只有一个来源，外观不在场景和配表里各写一份\n\n### 新做场景\n\n关卡的树，每一项都是存盘的节点，重复的东西是预制场景实例：\n\n```\nLevel            Node2D  level.gd\n├ Background     Parallax2D \u002F Sprite2D\n├ Ground         TileMapLayer\n├ Props          Node2D \u002F crate.tscn 实例若干\n├ Npcs           Node2D \u002F npc.tscn 实例 覆盖朝向和对话 ID\n├ SpawnPoints    Node2D \u002F Marker2D 若干\n└ Hud            hud.tscn 实例\n```\n\n不开编辑器时用一次性脚本生成，`godot --headless -s make_level.gd`，跑完删掉脚本：\n\n\u003C!-- check: gdonly -->\n```gdscript\nextends SceneTree\n\nfunc _initialize() -> void:\n\tvar level := Node2D.new()\n\tlevel.name = \"Level\"\n\tvar points := Node2D.new()\n\tpoints.name = \"SpawnPoints\"\n\tlevel.add_child(points)\n\tpoints.owner = level\n\tfor i in 3:\n\t\tvar marker := Marker2D.new()\n\t\tmarker.name = \"Spawn%d\" % i\n\t\tmarker.position = Vector2(200.0 * i, 0.0)\n\t\tpoints.add_child(marker)\n\t\tmarker.owner = level\n\tvar packed := PackedScene.new()\n\tpacked.pack(level)\n\tResourceSaver.save(packed, \"res:\u002F\u002Flevel.tscn\")\n\tlevel.free()\n\tquit()\n```\n\n- 每个后代都设 `owner` 为场景根，只设直接子节点不够\n- 实例化的子场景只给它的根设 owner\n- 编辑器里的场景根是 `EditorInterface.get_edited_scene_root()`\n- 小场景可直接写 tscn 文本，注意事项见 godot-scene-architecture\n\n脚本只取场景里摆好的节点，运行时内容从预制场景实例化：\n\n```gdscript\nextends Node2D\n\n@export var enemy_scene: PackedScene\n@onready var spawn_points: Node2D = $SpawnPoints\n\nfunc spawn_wave() -> void:\n\tfor point: Node in spawn_points.get_children():\n\t\tvar enemy := enemy_scene.instantiate() as Node2D\n\t\tenemy.position = (point as Node2D).position\n\t\tadd_child(enemy)\n```\n\n### 自绘节点\n\n`Sprite2D` 能表达的用 `Sprite2D`。需要自己语义的节点，如按米算高度，同样按导出属性在编辑器里画出来：\n\n```gdscript\n@tool\nclass_name GroundProp\nextends Node2D\n\n@export var texture: Texture2D:\n\tset(value):\n\t\ttexture = value\n\t\tqueue_redraw()\n@export var height: float = 64.0:\n\tset(value):\n\t\theight = value\n\t\tqueue_redraw()\n\nfunc _draw() -> void:\n\tif texture == null:\n\t\treturn\n\tvar size := texture.get_size() * (height \u002F texture.get_height())\n\tdraw_texture_rect(texture, Rect2(Vector2(-size.x \u002F 2.0, -size.y), size), false)\n```\n\n- 存盘的是节点和导出属性，画法跟着脚本走\n- setter 里只 `queue_redraw()` 或改自身状态\n- setter 在进树前就会调用，用到树的操作先判断 `is_inside_tree()`\n\n### 派生属性\n\n`_ready` 或 setter 里按环境算出的属性，如按视口选的 `material`、按深度算的 `z_index`，存盘时照样写进 tscn。用 `_validate_property` 去掉存盘位：\n\n```gdscript\n@tool\nextends Node2D\n\n@export var depth: float = 0.0:\n\tset(value):\n\t\tdepth = value\n\t\tz_index = -10 if depth > 0.0 else 10\n\nfunc _validate_property(property: Dictionary) -> void:\n\tif property.name == \"z_index\":\n\t\tproperty.usage &= ~PROPERTY_USAGE_STORAGE\n```\n\n- 对继承来的引擎属性也生效，脚本须是 `@tool`\n- 去掉后场景里手设的值也不存，该属性只能由代码决定\n\n节点自己生成、不属于内容的子节点，如地面条、阴影，用 internal 子节点，不设 owner：\n\n```gdscript\n@tool\nextends Node2D\n\nvar _shadow: Sprite2D\n\nfunc _ready() -> void:\n\t_shadow = Sprite2D.new()\n\t_shadow.modulate = Color(0.0, 0.0, 0.0, 0.4)\n\tadd_child(_shadow, false, Node.INTERNAL_MODE_BACK)\n```\n\n| | 不设 owner | 不设 owner 且 internal |\n|---|---|---|\n| 视口里画出来 | 是 | 是 |\n| 场景面板里看得到、点得中 | 否 | 否 |\n| 存进 tscn | 否 | 否 |\n| `get_children()` 拿得到 | 是 | 否，要 `get_children(true)` |\n| `duplicate()` 和 Ctrl+D 带上 | 是 | 否 |\n\n- 只不设 owner 时，复制节点会连生成的子节点一起复制，新节点 `_ready` 再建一份\n- 设了 owner 的 internal 子节点照样存盘，读回来变成普通子节点\n\n### 存盘导出\n\n确定性模拟、回滚联机、服务器不依赖场景树时，位置照样摆在场景里，存盘时导出成数据文件一起提交：\n\n```gdscript\n@tool\nextends Node2D\n\n@export_file(\"*.json\") var export_path: String = \"res:\u002F\u002Froom_points.json\"\n\nfunc _notification(what: int) -> void:\n\tif what == NOTIFICATION_EDITOR_PRE_SAVE:\n\t\texport_points()\n\nfunc export_points() -> void:\n\tvar points: Array[Dictionary] = []\n\tfor child: Node in get_children():\n\t\tvar marker := child as Marker2D\n\t\tif marker != null:\n\t\t\tpoints.append({\"name\": String(marker.name), \"x\": marker.position.x, \"y\": marker.position.y})\n\tvar file := FileAccess.open(export_path, FileAccess.WRITE)\n\tfile.store_string(JSON.stringify({\"points\": points}, \"\\t\"))\n```\n\n- 只在编辑器里、打包场景前发给被存场景的每个节点\n- 这时节点被锁，`add_child` `remove_child` 报错，只能读写属性和文件\n- 统一导出放在插件里时连 `EditorPlugin.scene_saved`，文件写盘后调用\n\n### 编辑器视口\n\n| 项 | 编辑器里 |\n|---|---|\n| 场景里的 `Camera2D` | 不生效，跟镜头走的视差层、跟随节点停在原点 |\n| `CanvasLayer` 内容 | 跟着编辑器平移缩放 |\n| `SubViewport` 内容 | 按单位变换贴出，只显示子视口尺寸以内 |\n| 单个 `SubViewport` 开的 `Viewport.use_hdr_2d` | 不生效，只按项目设置 `rendering\u002Fviewport\u002Fhdr_2d` |\n| `@tool` 的 `_process` | 低处理器模式下只在重绘时推进 |\n| 切换场景标签页 | 场景根先出树再进树，`_ready` 只跑一次 |\n\n- 材质按 `get_viewport()` 在进树后选\n- `_process` 里每帧 `queue_redraw()` 会让编辑器一直刷新\n- `_exit_tree` 里释放的东西在 `_enter_tree` 里补回\n- 改了全局着色器参数、静态缓存的节点，在 `_exit_tree` 里还原\n- 换场景时先 `remove_child()` 再 `queue_free()`，否则旧节点帧末出树会还原掉新设的值\n- 只在当前编辑场景里做的事，判断 `is_part_of_edited_scene()`，`_ready` 里可用\n\n## 陷阱\n\n| 现象 | 做法 |\n|---|---|\n| 生成节点存进了子场景文件 | 生成节点挂在实例化子场景下且 owner 设为子场景根。生成节点一律不设 owner |\n| 预制场景里多个 ColorRect Label 要统一换材质 | 子节点勾 `CanvasItem.use_parent_material`，代码只给根设 |\n| 只打开存盘也出 diff | 编辑器给旧 tscn 补 `uid`，新版补 `unique_id`，和逻辑改动分开提交 |\n| 提交的导出数据过期 | 导出只在编辑器存盘时写。加无头检查：重新导出并与提交的文件比对 |\n| 美术在编辑器看得到但改了不生效 | 编辑器里只画了一份不存盘的假画面。内容要真的在场景里 |\n| 同一系统里混用摆场景和代码搭 | 先自查，跟随该系统现状 |\n\n## 参考\n\n- [references\u002Fcsharp.md](references\u002Fcsharp.md)：C# 项目先读，本文各节示例的 C# 写法、`[Tool]` 热重载\n- [references\u002Faudit.md](references\u002Faudit.md)：自查清单、搜索命令、无头审计脚本、报告格式\n- [references\u002Fmigration.md](references\u002Fmigration.md)：迁移顺序、坐标换算、无头编辑器验证插件、常见报错\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fbest_practices\u002Fscenes_versus_scripts.html\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fbest_practices\u002Fscene_organization.html\n- https:\u002F\u002Fdocs.godotengine.org\u002Fen\u002Fstable\u002Ftutorials\u002Fplugins\u002Frunning_code_in_the_editor.html\n",{"name":5,"description":7},"master","d9cc24874d2a7b2d0f9fa2382a02c42969a1e092","skills\u002Fgodot-scene-authoring",0,"https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills","https:\u002F\u002Fgithub.com\u002FMindsMaster","Full-stack developer","2026-11-10 12:36:07",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add MindsMaster\u002Fgodot-claude-code-skills --skill godot-scene-authoring",{"tool":38,"command":39},"bunx","bunx skills add MindsMaster\u002Fgodot-claude-code-skills --skill godot-scene-authoring",{"tool":41,"command":42},"pnpm","pnpm dlx skills add MindsMaster\u002Fgodot-claude-code-skills --skill godot-scene-authoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-authoring\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Faudit.md","REFERENCE","参考文档",4378,"https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-authoring\u002Freferences\u002Faudit.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fcsharp.md",5031,"https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-authoring\u002Freferences\u002Fcsharp.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fmigration.md",5992,"https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-authoring\u002Freferences\u002Fmigration.md",[61,68,75,82,89,96],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M7FBP7NJ4NTGA239X15MXQPK","godot-ui","写菜单 HUD 对话框 血条 设置界面 本地化 分辨率适配 UI 导航时用，做设置即时生效 窗口模式 全屏 窗口尺寸确认还原 失焦暂停时也用。Control 布局 Container anchors、项目级 Theme 统一字体、StyleBox、ProgressBar 血条、RichTextLabel、多分辨率 stretch aspect、tr() 本地化、手柄焦点导航、mouse_filter 吃点击、CanvasLayer HUD、弹窗 拖放。UI layout, theme, localization, settings menu, fullscreen, pause on focus loss.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-ui\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7FBP23RTBQ2ZW9SKXE37SFS","godot-shaders-vfx","做受击闪白 受伤变白 命中闪烁 溶解 描边，或从 GDScript 与 C# 改 .gdshader 的 shader 参数 SetInstanceShaderParameter set_shader_parameter 时先用，多个敌人共用一份材质各自闪白也归这里。也管内置材质与 shader 的取舍、instance uniform、屏幕与深度纹理、GPUParticles 粒子、后处理顺序。shaders, hit flash, particles, post-processing.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-shaders-vfx\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7FBNN4WFN0PHM6P7SDH7V0J","godot-scene-architecture","拆分 Godot 4 场景与组织节点时用。PackedScene 组件复用、节点引用 @onready @export %UniqueName、信号与直接调用的选择、分组 call_group、Autoload 与普通节点、组合与继承、状态机、暂停 process_mode、queue_free 与 is_instance_valid、_ready 顺序、场景切换。scene tree architecture, signals, autoload.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-scene-architecture\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7FBNFF1K8A77X45BDBQCA6E","godot-resources-data","定义游戏数据表 配置 存档 资源加载时用。自定义 Resource class_name @export .tres 与 C# [GlobalClass]、JSON 与 Resource 怎么选、导入时把 JSON CSV 转成 Resource、资源共享与 duplicate local_to_scene、load preload 与线程加载进度条、user:\u002F\u002F 存档、导出后读不到 res:\u002F\u002F 目录。game data, custom resource, save game.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-resources-data\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7FBNB7C2A6XE5E48XH5NC5D","godot-performance","排查卡顿 掉帧 帧率低 内存增长时用，也用于几百个怪物 子弹同屏、CharacterBody 拥挤变慢、每帧重建网格、线程池只用上两三个核、C# 跨界开销。先测再改 Profiler Monitors。不降画面与数量的内置解法 管理器统一驱动、MultiMesh、Server、对象池、空间哈希、WorkerThreadPool 分块、网格局部更新、物理插值、线程加载、着色器编译卡顿、每帧分配。Godot performance, stutter, many entities.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-performance\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7FBN56HHKYA7CVERRYTTAFK","godot-multiplayer","写联机 多人 主机权威 同步 后加入 断线重连时用。ENetMultiplayerPeer 建连、@rpc 与 multiplayer_authority、MultiplayerSpawner MultiplayerSynchronizer 与可见性、传输模式与通道、NAT 与端口转发、ENetConnection 自建传输、预测与校正、两进程无头验收。客户端看不到主机的效果、后加入缺状态、奖励只发给主机时也用。multiplayer rpc replication late join netcode client prediction.","https:\u002F\u002Fgithub.com\u002FMindsMaster\u002Fgodot-claude-code-skills\u002Fblob\u002Fmaster\u002Fskills\u002Fgodot-multiplayer\u002FSKILL.md",[],[]]