mcpField
G
godot

godot

github.com/alphaonedev开发63 次安装
代码仓库

关于 godot

帮助 AI 使用 GDScript 构建、调试和优化 Godot 游戏项目的技能，涵盖场景与节点工作流、脚本编写，以及通过 Godot 命令行运行或导出项目。

主要功能

  1. 01GDScript 开发指导
  2. 022D 与 3D 场景工作流
  3. 03物理、动画与输入模式
  4. 04通过 Godot 命令行运行项目
  5. 05项目导出指导

适用场景

  1. 01制作 2D 或 3D 游戏原型
  2. 02调试脚本和场景加载
  3. 03自动化导出 Godot 项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill godot

安装后在 Claude Code 中输入/godot确认已加载。

详细介绍

godot

用途

此技能可帮助 AI 执行 Godot 游戏引擎相关任务，专注于使用 GDScript 进行 2D 和 3D 游戏开发。可通过编程方式生成、调试或优化 Godot 项目。

适用场景

在 Godot 中构建或修改游戏时使用此技能，例如创建原型、编写游戏逻辑脚本或导出构建版本。适用于涉及 GDScript、场景管理或与 Godot 基于节点的系统集成的任务，尤其适用于游戏开发工作流。

核心能力

Godot 通过场景树支持 2D/3D 渲染，并使用 GDScript 编写脚本。其主要功能包括物理模拟（例如用于碰撞检测的 RigidBody2D）、动画处理（例如 AnimationPlayer 节点）和资源导入（例如用于 3D 模型的 .gltf）。它通过 InputMap 处理输入，并使用信号实现事件驱动编程。内置导出器支持将项目导出到 HTML5 或 Android 等平台。

使用模式

要有效使用 Godot，可通过 CLI 组织命令以实现自动化，或在项目中嵌入 GDScript。使用 CLI 时，请从项目目录运行脚本；编写代码时，请扩展节点并连接信号。始终在命令中指定项目路径。使用模式：在 GDScript 中动态加载场景，然后在 _process() 或 _physics_process() 中处理更新。进行集成时，将 Godot 函数封装在 try-except 块中，以捕获运行时错误。

常用命令/API

使用 Godot CLI 管理项目。示例：使用 godot --path /path/to/project --run main.gd 执行脚本。导出示例：godot --path . --export "Linux/X11" build/linux.zip --no-window。在 GDScript 中，使用 extends Node2D 等 API 指定基类；使用 signal my_signal(value) 声明信号，并通过 emit_signal("my_signal", 42) 发出信号。配置格式：通过 project.godot 文件编辑项目设置，例如设置 application/config/name="MyGame"。Godot 在本地运行，因此不需要身份验证密钥。

集成说明

将 Godot 与 Git 等工具集成以进行版本控制（提交 project.godot 和场景）。对于外部脚本，可在 GDScript 中通过 load("res://script.gd") 导入。如果要与其他引擎结合使用，请将 Godot 项目导出为独立二进制文件。可使用环境变量指定自定义路径，例如设置 $GODOT_PROJECT_PATH="/user/project"，并在命令中引用它，如 godot --path $GODOT_PROJECT_PATH。避免混用其他引擎的 API；为确保兼容性，请使用 Godot 的节点系统。

错误处理

在 GDScript 中，可使用断言或检查来处理错误，例如使用 if not is_instance_valid(node): print("Node invalid")。对于 CLI，请检查退出代码：如果 godot --run script.gd 执行失败，请解析输出以查找 "Error: Script not found" 等信息。常见问题：资源缺失；请确认 project.godot 中的路径正确。使用模式：将代码封装在 func safe_load(path): var res = load(path); if res == null: printerr("Load failed") 等函数中。使用 Godot 的 OS 类记录错误：OS.alert("Error occurred")。

使用示例

示例 1：创建一个带有移动精灵的简单 2D 场景。使用 CLI 运行：godot --path /path/to/project --editor。在 GDScript 中，将以下代码添加到节点：extends Sprite; func _process(delta): position.x += 50 * delta; if position.x > 500: position.x = 0。此脚本会让精灵水平移动，并在到达边界后绕回。

示例 2：导出适用于 Windows 的项目。命令：godot --path . --export "Windows Desktop" build/win.exe。然后，在 GDScript 中处理输入：func _input(event): if event.is_action_pressed("jump"): velocity.y = -300。这会设置基本的跳跃机制，并自动化构建流程。

图谱关系

  • 相关条目：game-dev 集群（例如用于类似游戏开发任务的 unity 等技能）
  • 通过标签关联：godot（直接匹配）、game-engine（关联到 unreal 等其他引擎）、gdscript（关联到脚本编写技能）
  • 跨集群链接：game-dev 与 git 等用于项目版本控制的工具相关联

评论

支持 Markdown