skills.rest
godot-go
godot-goOFFICIAL
Explore all skills by this author →
GitHub

update-godot-gdextension-interface

Update Godot GDExtension C headers and JSON API metadata from a Godot binary.

747|30|Updated Jul 28, 2020
Search Tags:#code generation#godot#game engine#cgo#gdextension#go bindings#header sync
One-click install
npx skills add https://github.com/godot-go/godot-go --skill update-godot-gdextension-interface-godot-go
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-godot-gdextension-interface
Source: https://github.com/godot-go/godot-go/tree/main/.pi/skills/update-godot-gdextension-interface
Command: npx skills add https://github.com/godot-go/godot-go --skill update-godot-gdextension-interface-godot-go

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping the godot_headers directory in sync with the installed Godot binary is error-prone when done manually, and version mismatches between gdextension_interface.h, extension_api.json, and the engine cause broken Go bindings. ## Core Features & Use Cases - Version Detection: Runs godot --version and compares it against the version header inside extension_api.json to detect drift. - Header Synchronization: Runs make update_godot_headers_from_binary to export gdextension_interface.h and extension_api.json directly from the Godot binary. - Go Code Generation: Runs make generate to regenerate Go code wrapping the updated godot_headers files. - Use Case: After upgrading from Godot 4.5 to 4.7, use this Skill to re-export the GDExtension interface and regenerate the Go bindings so the project builds against the new engine version. ## Quick Start Check my Godot version and update the GDExtension headers and regenerate the Go bindings if they are out of sync.

Frequently Asked Questions about update-godot-gdextension-interface

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update Godot GDExtension headers in godot-go?▼

Run make update_godot_headers_from_binary with the GODOT environment variable pointing to your Godot binary. This exports gdextension_interface.h and extension_api.json from the binary into the godot_headers directory.

How to regenerate Go bindings after updating extension_api.json?▼

Run make generate after updating the headers. This generates the Go code that wraps gdextension_interface.h and extension_api.json so the bindings reflect the current Godot API.

How do I check if extension_api.json matches my Godot version?▼

Run godot --version and compare the output with the header block inside extension_api.json, which records version_major, version_minor, version_patch, and version_status. If they differ, re-export the headers from the binary.

Why do godot-go builds fail after upgrading Godot?▼

Builds fail when gdextension_interface.h and extension_api.json were generated from an older Godot binary than the one in use. Re-run make update_godot_headers_from_binary followed by make generate to resynchronize.

Which Godot versions does godot-go support?▼

godot-go requires a minimum of Godot 4.7 and is developed and tested against the Godot 4.7 stable release. The headers must be exported from the exact binary you intend to build against.

Related Skills

Explore More Software Engineering Skills→
ZearainZearain

godot-live-edit

Control a running Godot 4.x editor via the AI Bridge for live editing.

Community
Intermediate
jame581jame581
657

gdextension

Build native C++ or Rust extensions for Godot 4.x using GDExtension bindings.

Community
Advanced
shiaho777shiaho777
5.5k

go-app

Build small Go HTTP services that compile and run locally on-device.

Community
Intermediate
plurigridplurigrid
60

specter-navigator-gadget

Compile bidirectional navigation paths for nested data structures with 3-MATCH constraints.

Official
Advanced