? Lua in C++ with Sol2 - That One Game Dev

img.lazy{min-height:1px} ? Lua in C++ with Sol2 - 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/introduction-to-lua-in-c-with-sol2/#primaryimage","inLanguage":"en-US","url":"https://thatonegamedev.com/wp-content/uploads/2021/02/lua-language.gif","width":128,"height":128},{"@type":"WebPage","@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#webpage","url":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/","name":"\ud83c\udf13 Lua in C++ with Sol2 - That One Game Dev","isPartOf":{"@id":"https://thatonegamedev.com/#website"},"primaryImageOfPage":{"@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#primaryimage"},"datePublished":"2021-02-26T22:38:12+00:00","dateModified":"2021-02-26T22:38:15+00:00","description":"This article explains how to easily embed Lua into your C++ project. Lua is an useful scripting language, it is fast and it is not compiled.","breadcrumb":{"@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/"]}]},{"@type":"BreadcrumbList","@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#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/introduction-to-lua-in-c-with-sol2/","url":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/","name":"Introduction to Lua in C++ with Sol2"}}]},{"@type":"Article","@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#article","isPartOf":{"@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#webpage"},"author":{"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135"},"headline":"Introduction to Lua in C++ with Sol2","datePublished":"2021-02-26T22:38:12+00:00","dateModified":"2021-02-26T22:38:15+00:00","mainEntityOfPage":{"@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#webpage"},"commentCount":0,"publisher":{"@id":"https://thatonegamedev.com/#/schema/person/030220d8c03d9f299453e718c74ee135"},"image":{"@id":"https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#primaryimage"},"keywords":"C++,GameDev,Lua","articleSection":"C++,Lua","inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https://thatonegamedev.com/cpp/introduction-to-lua-in-c-with-sol2/#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.6.2"}}; !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}); (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(); }); } Skip to Content About Me Programming C++ ANSI C CMake Please accept terms & condition Menu Share Home / C++ / Introduction to Lua in C++ with Sol2 Introduction to Lua in C++ with Sol2 by Hristo Stamenov | Last Updated: 2021-02-27 C++, Lua Save Share Tweet Print If you are working on a custom engine or a batebones game you would probably want to include a less time-consuming coding language than C++. Lua is one such great option. Lua is a language standard that can be implemented easily in many languages and executed from them. In this article we will explore how to use Lua in C++. The Lua standard is maintained by https://www.lua.org/. Table of Contents Lua language Raw Lua code in C++ Lua code using Sol2 Conclusion Lua language The lua language is quite simple and has most of the concepts that can be found in other script languages like python, ruby, php, etc. You will have your standard IFs and LOOPs as well as variables, functions, objects, etc. Because Lua is embedable you will also have something called an user type which is a type of data that comes from the language that Lua is being embeded in. For the case of C++ if you define your own class you will be able to use this class in Lua and lua will refer to it as an user type data. So here is some example lua code: -- Single line comment with two dashes -- Defining a variable and assigning a value answer_to_universe = 42 -- Loops while answer_to_universe > 0 do answer_to_universe = answer_to_universe - 1 end -- If clause if answer_to_universe == 0 then -- prints to console using print print("answer_to_universe is 0") elseif answer_to_universe == 42 then print("answer_to_universe is 0") else pritn("answer_to_universe is anything else") end -- Booleans x = true opposite_of_x = not x if opposite_of_x == false then print("x = true") end -- Functions function speed(distance, time) speed = distance / time return speed end -- Etc. I will not get more into details about the lua code. If you want to learn more about lua you can check out Learn Lua in Y minutes. You can also use the repl below to test out some syntaxis and rules from the lua language: As you may have noticed already Lua is a scripting language. Scripting languages are evaluated at runtime and are converted into instructions then. This is different compared to C++ where the application has to be compiled first. The compilation process in bigger C++ applications can take a lot of time ranging from seconds to hours. This is why you would like to separate some of your gameplay logic and code that can change a lot into Lua scripts. Raw Lua code in C++ Lua is based on a stack machine. What this means is that it will read the script and execute line by line. It will put the result of each line on top of each other and you can then read the value that is on top. You will need to define your Lua stack machine by creating a new Lua state: // Creates our lua state machine lua_State * L = lua_open(); // Includes some default libraries like for math to our state luaL_openlibs(L); //...other code... // Don't forget to clean the state in the end lua_close(L); After we have the state created we would like to execute code inside it. We would essentially fetch some Lua code from a file and pass it on the Lua state. To do this we write the following lines: // Our script in lua const char* lua_script = "print('Hello World!')"; // Load buffer will load the lua text into the lua state int load_stat = luaL_loadbuffer(L, lua_script, strlen(lua_script), lua_script); // Will call the buffer code that we just loaded lua_pcall(L, 0, 0, 0); This approach though useful is actually quite hard to scale easily. You would have to keep track of the Lua state object and also pass it around so that you can call other functions on it. There is also the inconvenience that you have to fully understand the stack operations that Lua does because you are loading your operations and providing values to that stack and then getting your results back from it. To explain this better I will give you an example of creating a simple add function in Lua and then calling it from C++. You will notice that we need to push manually using a C++ command each argument for the function and then also get the result back ourselves after we execute it. const char* lua_function_script = R"LUA( function add(x, y) return x + y end )LUA"; // execute script int load_stat = luaL_loadbuffer(L, lua_function_script, strlen(lua_function_script), lua_function_script); lua_pcall(L, 0, 0, 0); int a = 5; int b = 6; int sum; // fetch the function lua_getglobal(L, "add"); // pass two numbers to lua as arguemnt 1 and 2 lua_pushnumber(L, a); lua_pushnumber(L, b); // call the function with 2 arguments and receive 1 result lua_call(L, 2, 1); // read the restul from the top of the stack and cast to int sum = (int)lua_tointeger(L, -1); lua_pop(L, 1); std::cout << "Result: " << sum << std::endl; You can take a look of the full example in the Repl below. The project below is configured using CMake and manages the Lua dependency as I’ve described in other articles in this blog. I’ve downloaded Lua from its official github repository which is only a mirror of their real source control system. Lua code using Sol2 You can of course make it easier by using a library called sol2. This library makes it extremely easy to create and manage lua states, push new code to execute, query functions defined in lua and execute them from C++ and register your own C++ types and functions inside of Lua What sol2 will do is wrap all Lua calls into handy functions that you will better understand. You will also be able to go deeper if needed as sol2 will expose the lua_State* object to you. That way you will be able to call the raw lua functions if needed. To provide an example compared to the raw version of Lua in C++ you would write the following code using sol2: // Create the state sol::state lua; // Our script in lua const char* lua_script = "print('Hello World!')"; // ...we just execute it lua.script(lua_script); // ...and the real magic... const char* lua_function_script = R"LUA( function add(x, y) return x + y end )LUA"; lua.script(lua_script); sol::function addFunction = lua["add"]; int sum = addFunction(5, 6); std::cout << "Result: " << sum << std::endl; As you can see the approach with using the library produces much cleaner and simpler code. Sol2 is a lot more powerful than that but that is a topic for another article. Conclusion Now you yield the power to embed Lua in your C++ application. I am using this approach extensively in my own private engines to simplify scene setups and settings where I don’t always want to wait for compile times. It is much simpler and faster to write Lua code than C++ code. There are some minor drawback though and that is that you would have to register every class defined in C++ that you would like to use in Lua. There is no easy reflection in C++ which results in you having to implement some design patterns to allow every class to register its members to the Lua state. Even with this drawback in mind Lua is an extremely simple and fast option that will improve the quality of life of every game developer that is working in custom C++ code. Save Share Tweet Print 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( '' ); ( 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! 🎉

? Lua in C++ with Sol2 - That One Game Dev

Comments

Recommended Tutorials

Other Tutorials by object71

🎉 Celebrating 25 Years of GameDev.net! 🎉

? Lua in C++ with Sol2 - That One Game Dev

Comments

Recommended Tutorials

Other Tutorials by object71

Reticulating splines