|
@@ -2,11 +2,15 @@
|
|
|
|
|
|
> **Warning**
|
|
|
>
|
|
|
-> This repository's `master` branch is only usable with the latest version of
|
|
|
-> Godot's ([GDExtension](https://godotengine.org/article/introducing-gd-extensions))
|
|
|
-> API (Godot 4.1 and later).
|
|
|
+> This repository's `master` branch is only usable with
|
|
|
+> [GDExtension](https://godotengine.org/article/introducing-gd-extensions)
|
|
|
+> from Godot's `master` branch.
|
|
|
>
|
|
|
-> For users of Godot 4.0.x, switch to the [`4.0`](https://github.com/godotengine/godot-cpp/tree/4.0) branch.
|
|
|
+> For users of stable branches, switch to the branch matching your target Godot version:
|
|
|
+> - [`4.0`](https://github.com/godotengine/godot-cpp/tree/4.0)
|
|
|
+> - [`4.1`](https://github.com/godotengine/godot-cpp/tree/4.1)
|
|
|
+>
|
|
|
+> Or check out the Git tag matching your Godot version (e.g. `godot-4.1.1-stable`).
|
|
|
>
|
|
|
> For GDNative users (Godot 3.x), switch to the [`3.x`](https://github.com/godotengine/godot-cpp/tree/3.x)
|
|
|
> or the [`3.5`](https://github.com/godotengine/godot-cpp/tree/3.5) branch.
|
|
@@ -52,9 +56,10 @@ first-party `godot-cpp` extension.
|
|
|
|
|
|
Some compatibility breakage is to be expected as GDExtension and `godot-cpp`
|
|
|
get more used, documented, and critical issues get resolved. See the
|
|
|
-[issue tracker](https://github.com/godotengine/godot/issues) for a list of known
|
|
|
-issues, and be sure to provide feedback on issues and PRs which affect your use
|
|
|
-of this extension.
|
|
|
+[Godot issue tracker](https://github.com/godotengine/godot/issues?q=is%3Aissue+is%3Aopen+label%3Atopic%3Agdextension)
|
|
|
+and the [godot-cpp issue tracker](https://github.com/godotengine/godot/issues)
|
|
|
+for a list of known issues, and be sure to provide feedback on issues and PRs
|
|
|
+which affect your use of this extension.
|
|
|
|
|
|
## Contributing
|
|
|
|
|
@@ -76,7 +81,7 @@ just like before.
|
|
|
|
|
|
To use the shared lib in your Godot project you'll need a `.gdextension`
|
|
|
file, which replaces what was the `.gdnlib` before.
|
|
|
-Follow [the example](test/project/example.gdextension):
|
|
|
+See [example.gdextension](test/project/example.gdextension) used in the test project:
|
|
|
|
|
|
```ini
|
|
|
[configuration]
|
|
@@ -129,6 +134,10 @@ void initialize_example_module(ModuleInitializationLevel p_level) {
|
|
|
|
|
|
Any node and resource you register will be available in the corresponding `Create...` dialog. Any class will be available to scripting as well.
|
|
|
|
|
|
-## Included example
|
|
|
+## Examples and templates
|
|
|
+
|
|
|
+See the [godot-cpp-template](https://github.com/godotengine/godot-cpp-template) project for a
|
|
|
+generic reusable template.
|
|
|
|
|
|
-Check the project in the `test` folder for an example on how to use and register different things.
|
|
|
+Or checkout the code for the [Summator example](https://github.com/paddy-exe/GDExtensionSummator)
|
|
|
+as shown in the [official documentation](https://docs.godotengine.org/en/latest/tutorials/scripting/gdextension/gdextension_cpp_example.html).
|