Godot development using Godot Native and CMake

img.lazy{min-height:1px} Godot development using Godot Native and CMake - That One Game Dev {"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://thatonegamedev.com/#website","url":"https://thatonegamedev.com/","name":"That One Game Dev","description":"A blog about game programming","publisher":{"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135"},"potentialAction":[{"@type":"SearchAction","target":"https://thatonegamedev.com/?s={search_term_string}","query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"ImageObject","@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#primaryimage","inLanguage":"en-US","url":"https://thatonegamedev.com/wp-content/uploads/2021/03/godot-logo.png","width":2500,"height":1250,"caption":"Godot Logo"},{"@type":"WebPage","@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#webpage","url":"https://thatonegamedev.com/cpp/godot-native-using-cmake/","name":"Godot development using Godot Native and CMake - That One Game Dev","isPartOf":{"@id":"https://thatonegamedev.com/#website"},"primaryImageOfPage":{"@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#primaryimage"},"datePublished":"2021-03-26T10:53:29+00:00","dateModified":"2021-03-26T12:40:01+00:00","description":"In this article, you will learn how to create your own Godot Native (GDNative) project and compile it for any platform using CMake.","breadcrumb":{"@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https://thatonegamedev.com/cpp/godot-native-using-cmake/"]}]},{"@type":"BreadcrumbList","@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"item":{"@type":"WebPage","@id":"https://thatonegamedev.com/","url":"https://thatonegamedev.com/","name":"Home"}},{"@type":"ListItem","position":2,"item":{"@type":"WebPage","@id":"https://thatonegamedev.com/posts/","url":"https://thatonegamedev.com/posts/","name":"Posts"}},{"@type":"ListItem","position":3,"item":{"@type":"WebPage","@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/","url":"https://thatonegamedev.com/cpp/godot-native-using-cmake/","name":"Godot Native using CMake"}}]},{"@type":"Article","@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#article","isPartOf":{"@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#webpage"},"author":{"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135"},"headline":"Godot Native using CMake","datePublished":"2021-03-26T10:53:29+00:00","dateModified":"2021-03-26T12:40:01+00:00","mainEntityOfPage":{"@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#webpage"},"commentCount":0,"publisher":{"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135"},"image":{"@id":"https://thatonegamedev.com/cpp/godot-native-using-cmake/#primaryimage"},"keywords":"CMake,Godot","articleSection":"C++","inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https://thatonegamedev.com/cpp/godot-native-using-cmake/#respond"]}]},{"@type":["Person","Organization"],"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135","name":"Hristo Stamenov","image":{"@type":"ImageObject","@id":"https://thatonegamedev.com/#personlogo","inLanguage":"en-US","url":"https://secure.gravatar.com/avatar/4e22e524c10f6f3361a0c93f879f81c3?s=96&d=retro&r=g","caption":"Hristo Stamenov"},"logo":{"@id":"https://thatonegamedev.com/#personlogo"},"description":"I am a gameplay programmer and a game developer. Games are my hobby and my work and I love programming so both combine very well :)","sameAs":["http://thatonegamedev.com/WordPress"]}]} window._wpemojiSettings = {"baseUrl":"https:\/\/s.w.org\/images\/core\/emoji\/13.0.1\/72x72\/","ext":".png","svgUrl":"https:\/\/s.w.org\/images\/core\/emoji\/13.0.1\/svg\/","svgExt":".svg","source":{"concatemoji":"https:\/\/thatonegamedev.com\/WordPress\/wp-includes\/js\/wp-emoji-release.min.js?ver=5.7"}}; !function(e,a,t){var n,r,o,i=a.createElement("canvas"),p=i.getContext&&i.getContext("2d");function s(e,t){var a=String.fromCharCode;p.clearRect(0,0,i.width,i.height),p.fillText(a.apply(this,e),0,0);e=i.toDataURL();return p.clearRect(0,0,i.width,i.height),p.fillText(a.apply(this,t),0,0),e===i.toDataURL()}function c(e){var t=a.createElement("script");t.src=e,t.defer=t.type="text/javascript",a.getElementsByTagName("head")[0].appendChild(t)}for(o=Array("flag","emoji"),t.supports={everything:!0,everythingExceptFlag:!0},r=0;r img.wp-smiley, img.emoji { display: inline !important; border: none !important; box-shadow: none !important; height: 1em !important; width: 1em !important; margin: 0 .07em !important; vertical-align: -0.1em !important; background: none !important; padding: 0 !important; } /* */ window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);} gtag("js", new Date()); gtag("set", "developer_id.dZTNiMT", true); gtag("config", "UA-184317485-1", {"anonymize_ip":true}); window.a2a_config=window.a2a_config||{};a2a_config.callbacks=[];a2a_config.overlays=[];a2a_config.templates={}; (function(d,s,a,b){a=d.createElement(s);b=d.getElementsByTagName(s)[0];a.async=1;a.src="https://static.addtoany.com/menu/page.js";b.parentNode.insertBefore(a,b);})(document,"script"); (function(c,l,a,r,i,t,y){ c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};t=l.createElement(r);t.async=1; t.src="https://www.clarity.ms/tag/"+i;y=l.getElementsByTagName(r)[0];y.parentNode.insertBefore(t,y); })(window, document, "clarity", "script", "4z37nxzl9w"); window.OneSignal = window.OneSignal || []; OneSignal.push( function() { OneSignal.SERVICE_WORKER_UPDATER_PATH = "OneSignalSDKUpdaterWorker.js.php"; OneSignal.SERVICE_WORKER_PATH = "OneSignalSDKWorker.js.php"; OneSignal.SERVICE_WORKER_PARAM = { scope: '/' }; OneSignal.setDefaultNotificationUrl("https://thatonegamedev.com/WordPress"); var oneSignal_options = {}; window._oneSignalInitOptions = oneSignal_options; oneSignal_options['wordpress'] = true; oneSignal_options['appId'] = 'afbf872d-e77d-483b-a481-5329cb145aa7'; oneSignal_options['allowLocalhostAsSecureOrigin'] = true; oneSignal_options['welcomeNotification'] = { }; oneSignal_options['welcomeNotification']['title'] = ""; oneSignal_options['welcomeNotification']['message'] = ""; oneSignal_options['path'] = "https://thatonegamedev.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/"; oneSignal_options['safari_web_id'] = "web.onesignal.auto.00b75e31-4d41-4106-ab79-a5c68121f393"; oneSignal_options['promptOptions'] = { }; oneSignal_options['notifyButton'] = { }; oneSignal_options['notifyButton']['enable'] = true; oneSignal_options['notifyButton']['position'] = 'bottom-right'; oneSignal_options['notifyButton']['theme'] = 'default'; oneSignal_options['notifyButton']['size'] = 'medium'; oneSignal_options['notifyButton']['showCredit'] = true; oneSignal_options['notifyButton']['text'] = {}; OneSignal.init(window._oneSignalInitOptions); }); function documentInitOneSignal() { var oneSignal_elements = document.getElementsByClassName("OneSignal-prompt"); var oneSignalLinkClickHandler = function(event) { OneSignal.push(['registerForPushNotifications']); event.preventDefault(); }; for(var i = 0; i < oneSignal_elements.length; i++) oneSignal_elements[i].addEventListener('click', oneSignalLinkClickHandler, false); } if (document.readyState === 'complete') { documentInitOneSignal(); } else { window.addEventListener("load", function(event){ documentInitOneSignal(); }); } ( function( w, d, s, l, i ) { w[l] = w[l] || []; w[l].push( {'gtm.start': new Date().getTime(), event: 'gtm.js'} ); var f = d.getElementsByTagName( s )[0], j = d.createElement( s ), dl = l != 'dataLayer' ? '&l=' + l : ''; j.async = true; j.src = 'https://www.googletagmanager.com/gtm.js?id=' + i + dl; f.parentNode.insertBefore( j, f ); } )( window, document, 'script', 'dataLayer', 'GTM-NSFB2BC' ); Skip to Content About Me Programming C++ ANSI C Math CMake Please accept terms & condition Menu Share Home / C++ / Godot Native using CMake Godot Native using CMake by Hristo Stamenov | Last Updated: 2021-03-26 C++ Godot is one of the top engines by popularity and usage. It is also completely free without any hidden cost. The one thing that mostly stops me from developing in Godot was that I don’t like the idea of the provided GDScript language. This is mostly a personal preference but I love static languages. Also writing code in GDScript made me feel more like a modder or a designer and less like the programmer that I am. This is why in this article I will explore how to create a project and use Godot Native to power up the scripts. Table of Contents Why GDNative Project setup Creating a Godot project Godot headers CMake setup Creating the library Binding with Godot Creating a library interface Creating a GDNative script Conclusion Why GDNative In this article, I will present to you how you can develop in Godot using fully featured C++ code. I will do that by utilizing the power of Godot Native (or GDNative). I will also set up the projects using CMake for cross-platform compilation. You can learn more about how to compile and work with CMake in this blog. I like C++ but developing a custom engine is a long and a continious process. If you still want to create games using C++ as your favourite language you can usually go for a bunch of frameworks or Unreal. Frameworks though just provide a solid foundation and you still have to extend them to create your own tools. Unreal Engine on the other hand doesn’t provide good 2D tooling and for 3D it may be an overkill of an engine for a small indie project. Here comes Godot Native code. Godot is a perfect lightweight engine for small projects. The good news is that you can still bring the full power of C++ to it and develop your game that way. GDNative is more verbose though and will require you to write additional code to register classes, properties, and functions. This is not present in the built-in GDScript. You will also have to compile your project for every platform that you want to ship to. Of course, CMake will take care of most of the heavy lifting in this regard. Project setup Setting up the project will be similar to how I set up every other project in CMake. You will find some articles in this blog on how to set it up and how to manage dependencies. The difference here is that we would like to make have our library under some Godot project. Even if you are developing to later distribute a library and not build a Godot Native powered game – you would benefit from testing directly and not copy DLLs on every compilation. For the sake of the example, I will call my project MyLibrary. The project structure initially should look something like this: Godot project folder ├── MyLibrary │ ├── godot-cpp/ │ │ └── …godot headers… │ ├── MyLibrary/ │ │ ├── src/ │ │ │ └── …source files… │ │ ├── include/ │ │ │ └── …include files… │ │ └── CMakeLists.txt │ └── CMakeLists.txt └── …Godot project files… Creating a Godot project To start I will open up my Godot executable. You can download Godot from the official engine site: https://godotengine.org/download. On the project select screen, I select a new project, set a name, create a directory and click on create. After that, I minimize/close Godot for now. We will need it again at the end. Next up I open up the newly created project directory and create a new folder underneath called MyLibrary. The first thing I want to do is to create an empty “.gdignore” file in this newly created folder. This file will prevent Godot from trying to import files from this folder into the project. This folder will be strictly for building the C++ shared libraries so I am currently OK with that. Godot headers Next up I would like to download https://github.com/godotengine/godot-cpp this project and put it into a folder: “GDProject/MyLibrary/godot-cpp”. This can be done in a few ways and I will let you pick your preferred way of doing that – download zip, git clone, git submodule, git subtree, etc. This godot-cpp project will provide you with some headers and registration functions that you will need to create the bond between Godot and your native library. We will add the godot-cpp project by listing it as a subdirectory in CMake. There is also the alternative approach to add a custom target (add_custom_target) and use the SConstruct build system for godot-cpp. Godot prefers SConstruct as the developers consider it a “real” scripting language for defining your builds instead of CMake. I don’t personally care too much I just use what is convenient for me. You can do this by checking out how to build godot-cpp files using SCons and adding the commands as COMMAND on your custom target. You will have to also find and reference the include directories and library for linking in your project. Note: at the time of writing of this article there was a bug with godot-cpp on the CMake front for Windows. I submitted a pull request but it was not yet approved. You can apply the fix from that commit or look up if the issue wasn’t resolved for you. https://github.com/godotengine/godot-cpp/pull/536 CMake setup Next we need to create our core CMakeLists.txt file. It will be located under “GDProject/MyLibrary/CMakeLists.txt” and will contain the following: cmake_minimum_required(VERSION 3.17) project(MyLibrary) option(ARCHITECTURE "x64 or x86 CPU Architecture" "x64") set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/${CMAKE_BUILD_TYPE}/${ARCHITECTURE}") set(CMAKE_CXX_STANDARD 17) # Feel free to use whatever standard you want add_subdirectory(godot-cpp) add_subdirectory(MyLibrary) There isn’t a reliable way to get the architecture we are building for. On Windows, some compilers may return x64 even when building for an x32 application. This is why we add the option for the architecture. We also want to output all the library files in a more convenient directory, so we set the CMAKE_RUNTIME_OUTPUT_DIRECTORY. Simple enough we would also add another folder named MyLibrary under MyLibrary where we would keep our source files. There will be another CMakeLists.txt there which will define our target (GDProject/MyLibrary/MyLibrary/CMakeLists.txt): project(MyLibrary CXX) add_library(MyLibrary SHARED src/GodotLibrary.cpp include/Controller.h src/Controller.cpp ) target_link_libraries(MyLibrary PUBLIC godot-cpp) target_include_directories(MyLibrary PUBLIC $ $ PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/src ) We will be adding three files. GodotLibrary will be a source file that will register the newly written godot native module and classes with Godot. The other two are just an example class for a script controlling a sprite. Creating the library Let’s start with creating the controller. Some things are very similar to how they are done in GDScript but translated to their C++ equivalent. The main difference here is that you will have to manually declare your member fields and methods to Godot so that they are available in the node-inspector or to be used in signals. The declaration (header) file will look something similar to this: #ifndef GDNATIVEEXPLORATION_CONTROLLER_H #define GDNATIVEEXPLORATION_CONTROLLER_H #include #include #include namespace godot { class Controller : public KinematicBody2D { private: // We need to register some information to Godot GODOT_CLASS(Controller, KinematicBody2D) public: static void _register_methods(); void _init(); void _process(); Controller() {} ~Controller() {} // Member fields int speed = 200; Vector2 motion; // Member functions void UpdateMotionFromInput(); }; } #endif //GDNATIVEEXPLORATION_CONTROLLER_H It is required from your class that will be used as a script to have the GODOT_CLASS macro, as well as the “_init” and “_register_methods” methods. The “_init” and “_register_methods” method will automatically be picked up by Godot. You may recognize the “_init” and “_process” methods. You may actually call the _process method differently but it is advised that you keep the consistency with GDScript. All the other member fields and methods you can define as you wish. Next up is the implementation file for this class: #include "Controller.h" void godot::Controller::_init() { motion = Vector2(0, 0); } void godot::Controller::_register_methods() { register_method((char*)"_process", &Controller::_process); register_method((char*)"UpdateMotionFromInput", &Controller::UpdateMotionFromInput); register_property((char*)"speed", &Controller::speed, 200); } void godot::Controller::_process() { UpdateMotionFromInput(); move_and_slide(motion); } void godot::Controller::UpdateMotionFromInput() { motion = Vector2(0, 0); Input* input = Input::get_singleton(); if(input->is_action_pressed("ui_up")) { motion.y -= speed; } if(input->is_action_pressed("ui_down")) { motion.y += speed; } if(input->is_action_pressed("ui_left")) { motion.x -= speed; } if(input->is_action_pressed("ui_right")) { motion.x += speed; } } As I already mentioned the “_init” and “_register_methods” will be located and called automatically. For every other method, you have to register yourself in “_register_methods” using the provided “register_method” function. There you have to give it a name that will be available and callable in Godot and a function pointer for the function. Any member fields that you want to expose You also have to register using the “register_property” where you will provide a name and a pointer, but also a default value. Other than that there is nothing more specific for C++ that is not available in GDScript. You can get the input singleton and then query if the action is pressed or not. You can also apply speed and use the inherited “move_and_slide” method from the “KinematicBody2D”. The last part is setting up some mandatory configurations for your library. I’ve created a separate source file for that called “GodotLibrary.cpp”: #include #include "Controller.h" using namespace godot; extern "C" void GDN_EXPORT godot_gdnative_init(godot_gdnative_init_options* o) { Godot::gdnative_init(o); } extern "C" void GDN_EXPORT godot_gdnative_terminate(godot_gdnative_terminate_options* o) { Godot::gdnative_terminate(o); } extern "C" void GDN_EXPORT godot_nativescript_init(void* handle) { Godot::nativescript_init(handle); register_class (); } I’ve taken most of this from Godot’s official documentation and I didn’t delve deep into what they each do. Similarly how you have to define each method and public field in your class – you also have to register each class you want exposed to Godot using the register_class template function. That is pretty much all of it for now. You just build your application and you should get your shared libraries starting from the root of your CMake project inside “/Debug/x64” or similar. Binding with Godot Next step is to setup and use our library in Godot. So we reopen our project and we need to create some assets to reflect our Godot Native scripts. Creating a library interface The first thing is we need to interface with our library. In Godot, you would have to create a resource in which you define your library shared files. You will use this resource later in GDNative scripts to tell them where to look for certain classes. So we locate the file system inspector, right-click in a folder that we want to put our library interface in. Keep in mind You cannot use MyLibrary as it is ignored. We need to create a new resource: You will get a popup window to select the type of resource you are creating. Search for “GDNativeLibrary” and select it: A new popup window will appear where we will choose a name for our interface file. I named it “MyLibrary.gdnlib” but you can use .tres as well for the extension. Next up we double click the newly created library file and it will open up a custom inspector on the bottom. I am using Windows so I locate the Windows section and click on the little folder icon in the middle to provide the path to the Windows DLL file: It will open up a window for me so I go to the output directory for my build which is “res://MyLibrary/Debug/x64/MyLibrary.dll” and select it. This concludes our library interface setups. If you want to provide more platforms you would have to build the relevant shared libraries for those platforms using CMake. I would suggest not ignore and always commit the output libraries in your source control system. Creating a GDNative script Next up is creating the data for our C++ script. This can be done by choosing a folder where we will keep the script in the file system browser in the engine. We right-click the folder and click on the create script option: On the new popup window, we fill in the data. Inherits must be the same as it is in C++. The class name should be the same class name you defined in C++ too. The path or file name you can choose yourself. Also, make sure to uncheck “built-in script”. When we create the script, we also need to specify the library interface to use for finding this class. We double-click on the script and in the inspector we can drag and drop our library created in the previous section. Next, I create a small scene by adding a KinematicBody2D, a collision shape (for the kinematic body), and a sprite. I also drag and drop my new native script on top of the kinematic body. If you followed all the steps up until now you can start the scene and you should be able to control the simple character using the arrow keys. Conclusion This is just an introduction to using Godot Native code for your Godot game. You can do so much more in C++ than this of course. As I mentioned Godot is a an especially good engine to start with. It has better support for small games and 2D games than Unreal and you will have a smaller entry barrier compared to what you have to do to learn Unreal. Given that you want to program in C++ of course. Leave a comment Cancel reply Name * Email * Save my name, email, and website in this browser for the next time I comment. We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy OK Back to Top About Me Privacy Policy Terms and Conditions Attributions Copyright - 2021 /* */ ( 'fetch' in window ) || document.write( '' );( document.contains ) || document.write( '' );( window.DOMRect ) || document.write( '' );( window.URL && window.URL.prototype && window.URLSearchParams ) || document.write( '' );( window.FormData && window.FormData.prototype.keys ) || document.write( '' );( Element.prototype.matches && Element.prototype.closest ) || document.write( '' );( 'objectFit' in document.documentElement.style ) || document.write( '' ); wp.i18n.setLocaleData( { 'text direction\u0004ltr': [ 'ltr' ] } ); ( function( domain, translations ) { var localeData = translations.locale_data[ domain ] || translations.locale_data.messages; localeData[""].domain = domain; wp.i18n.setLocaleData( localeData, domain ); } )( "default", { "locale_data": { "messages": { "": {} } } } ); /* */ /* */ tinyMCEPreInit = { baseURL: "https://thatonegamedev.com/WordPress/wp-includes/js/tinymce", suffix: ".min", mceInit: {}, qtInit: {'comment':{id:"comment",buttons:"strong,em,link,block,code,close"}}, ref: {plugins:"",theme:"modern",language:""}, load_ext: function(url,lang){var sl=tinymce.ScriptLoader;sl.markDone(url+'/langs/'+lang+'.js');sl.markDone(url+'/langs/'+lang+'_dlg.js');} }; var ajaxurl = "/WordPress/wp-admin/admin-ajax.php"; ( function() { var init, id, $wrap; if ( typeof tinymce !== 'undefined' ) { if ( tinymce.Env.ie && tinymce.Env.ie < 11 ) { tinymce.$( '.wp-editor-wrap ' ).removeClass( 'tmce-active' ).addClass( 'html-active' ); return; } for ( id in tinyMCEPreInit.mceInit ) { init = tinyMCEPreInit.mceInit[id]; $wrap = tinymce.$( '#wp-' + id + '-wrap' ); if ( ( $wrap.hasClass( 'tmce-active' ) || ! tinyMCEPreInit.qtInit.hasOwnProperty( id ) ) && ! init.wp_skip_init ) { tinymce.init( init ); if ( ! window.wpActiveEditor ) { window.wpActiveEditor = id; } } } } if ( typeof quicktags !== 'undefined' ) { for ( id in tinyMCEPreInit.qtInit ) { quicktags( tinyMCEPreInit.qtInit[id] ); if ( ! window.wpActiveEditor ) { window.wpActiveEditor = id; } } } }()); Insert/edit link Close Enter the destination URL URL Link Text Open link in a new tab Or link to existing content Search No search term specified. Showing recent items. Search or use up and down arrow keys to select an item. Cancel window.w3tc_lazyload=1,window.lazyLoadOptions={elements_selector:".lazy",callback_loaded:function(t){var e;try{e=new CustomEvent("w3tc_lazyload_loaded",{detail:{e:t}})}catch(a){(e=document.createEvent("CustomEvent")).initCustomEvent("w3tc_lazyload_loaded",!1,!1,{e:t})}window.dispatchEvent(e)}}

🎉 Celebrating 25 Years of GameDev.net! 🎉

Godot development using Godot Native and CMake

Comments

Recommended Tutorials

Other Tutorials by object71

🎉 Celebrating 25 Years of GameDev.net! 🎉

Godot development using Godot Native and CMake

Comments

Recommended Tutorials

Other Tutorials by object71

Reticulating splines