From e7d873d3b611c29ef242c429128c129d69832894 Mon Sep 17 00:00:00 2001 From: Persson-dev Date: Sun, 11 Aug 2024 19:15:56 +0200 Subject: [PATCH] update README --- README.md | 50 +++++++++++--------------------------------------- 1 file changed, 11 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index eabe994..cfd006e 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,6 @@ +# Blitz3 -This project is used to compile a GDExtension (godot engine cpp extension), and try to use xmake to manage the project. - -Forked from [Github](https://github.com/chaosddp/gdextension-cpp-xmake-template) +The best FPS you've ever seen ! ## Install xmake @@ -9,54 +8,27 @@ Install xmake from [here](https://xmake.io/#/guide/installation). ## How to use -You must have godot in your path - -First modify the *xmake.lua* to change the project name, and other configurations as needed. - -```lua - --- project name, this will be the output shared library name -PROJECT_NAME = "gdexample" - --- project version -VERSION = "0.0.1" - --- where is the godot project saved, default is "demo" -GODOT_PROJECT_FOLDER = "demo" - --- where to save the export project, default is "publish" -PUBLISH_FOLDER = "publish" - -``` - -After change the configurations, you can run the following commands to build, run and export. +You must have [godot](https://godotengine.org/) in your path ```sh -# 1. gen gdextension file (only once) -xmake gengdextension +# 1. build the project +xmake f -m debug && xmake -# 2. build the project -xmake - -# 3. open the editor at least once (works only in debug mode) +# 2. open the editor at least once xmake run Editor -# 4. run the demo (works only in debug mode) +# 3. run the demo xmake run -# 5. export the project, the executable will be under "publish" folder by default +# 4. export the project, the executable will be under "publish" folder by default xmake p -# 6. clean the build and publish +# 5. clean the build and publish xmake clean -# 7. generate a class that inherits from godot class, like Sprite2D +# 6. generate a class that inherits from godot class, like Sprite2D # by default the generated files will save under "src" folder, you can change it by -d folder/under/src xmake ext-class -n MySprite2D -b Sprite2D -s myexample1 -d sample -``` - -For better support in vscode, you can use command "Xmake: UpdateIntellisense" to generate *compile_commands.json*, then update "compileCommands" field in *c_cpp_properties.json* to point to the file. - -NOTE: not tested on other platforms except windows and linux. \ No newline at end of file +``` \ No newline at end of file