Steam API for the Godot game engine

Project maintained by Gramps Hosted on GitHub Pages — Theme by mattgraham


Current build: v1.1.0, availabled as pre-compiles here: https://github.com/Gramps/GodotSteam/releases.

This is the documentation page for GodotSteam, a Steamworks module for Godot Engine, and GodotSteam for GDNative (more on GDNative for Godot 3.0 here). It was initially forked from Kermer's excellent fork.

There are a few things you'll need to start working with the module:

Those are the basics to working with the wrapper. How, to get the most out of it, you'll need these too:

  • Logged into your Steam client if testing your game or any scenes.

From here either navigate to the Module How-To or GDNative How-To.

To-Do List

Here is a short-list of additional things still needed for the wrapper:

  • Fix signals, leaderboards, and callbacks in GDNative version
  • Add in more features from the Steamworks SDK.
  • Optimize C++ code by someone better at C++.
  • Test, test, test!

How To Get Started: GodotSteam module

  1. Download the module repository and unpack it.
  2. Download and unpack the Steamworks SDK.
  3. Download and unpack the Godot Engine source.
  4. Move the following to godotsteam/sdk/:
  5. The repo's directory contents should now look like this:
  6. Now move the "godotsteam" directory into the "modules" directory of the unpacked Godot Engine source.
  7. Recompile for your platform:
  8. When recompiling the engine is finished, copy the shared library (steam_api) from sdk/redistributable_bin/ folders to the Godot binary location (by default in the godot source /bin/ file but you can move them to a new folder). It should look like this:
    • Linux 32/64-bit
      ./godot.linux.tools.32 or ./godot.linux.tools.64
    • OSX
      ./godot.osx.tools.32 or ./godot.osx.tools.64
    • Windows 32-bit
    • Windows 64-bit
  9. Your game must ship with the executable, Steam API DLL/SO/DyLIB, and steam_appid.txt to function. Lack of the Steam API DLL/SO/DyLib (for your respective OS) or the steam_appid.txt will cause it fail and crash.
    • NOTE: For OSX, the libsteam_api.dylib and steam_appid.txt must be in the Content/MacOS/ folder in your application zip or the game will crash.

From here you should be able to call various functions of Steamworks. You should be able to look up the functions in Godot itself under the search section. In addition, you should be able to read the Steamworks API documentation to see what all is available and cross-reference with GodotSteam.

You may notice that achievements and stats do not work properly if the game is tested outside of Steam (as in running it from the Steam client itself). This behavior seems to be new within the last few weeks and is most likely a changed on Valve's end.

How To Get Started: GodotSteam For GDNative

  1. Download the GodotNative GDNative repository and unpack it.
  2. Download and unpack the Steamworks SDK.
  3. Download and unpack the Godot Engine 3.0 binary.
  4. Download the GDNative starter pack.
  5. Recommended you compile the bindings as the GDNative Starter kit may not be up to date.
    1. Download the CPP bindings and Godot headers.
    2. Follow their instructions for proper layout, you may need to change the Scon file to the right directories
    3. Compile the core first:
      scons platform=[your platform] target=core
    4. The compile the bindings:
      scons platform=[your platform] target=bindings generate_bindings=yes
  6. Alternately, download the GDNative Starter kit.
  7. Unpack the starter kit into your project's root folder or place the bindings into your lib/ folder, depending on which previous step you took.
  8. Unpack the Steamworks SDK then copy the public and redistributable_bin** to /include/sdk folder.
  9. Unpack this repo and place it into your project's root folder.
    • Allow the folders to merge.
    • Nothing should overwrite unless you are updating to a new version of this repo.
  10. You should end up with a project folder that looks something like this:
    lib/libgodot_cpp_bindings.so (for Linux)
    lib/libgodot_cpp_core.so (for Linux)
    lib/godot_cpp_bindings.dll (for Windows)
    lib/godot_cpp_core.dll (for Windows)
  11. Navigate to the src directory in your project and run:
    scons platform=[your platform]
  12. You can enter the bit architecture with **bits** or **b** arguments or not. There is a fallback to automatically find this. However, I recommend you use one.

OPTIONAL: if you choose not to use the included steam.tscn file, follow these steps. Otherwise, continue on to the next section.

  1. Create a new scene with one node as a, well, Node.
    1. Name it Steam.
    2. Save the scene as steam.tscn in your project.
    3. On Inspector tab for this node, select a new script.
    4. Name it Steam.
    5. Set language as Native.
    6. Set path: built-in script to On.
    7. Press create.
  2. Under newly created script settings in Inspector tab.
    1. Click next to Library and select New GDNativeLibrary.
    2. Click the right arrow and it should show a list of platforms.
    3. Select the platforms you built for.
      • You could dump multiple platform files (SO, DLL, Dylib) into your folder to select more than one.
    4. For each selected platform, link the right file by clicking the folder icon next to them.
      • Example: x11 would link libgodotsteam.so, Windows would link godotsteam.dll, Mac would link libgodotsteam.dylib
    5. Then press the save icon and save this as godotsteam.tres in your lib folder.

The last step after doing the above optional steps or just using the supplied steam.tscn file in /lib.

  1. Add the steam.tscn to your project as a singelton in the AutoLoad section under Project Settings.
  2. Done!

Now you should be able to call functions from GodotSteam like you would normally with the GodotSteam module:


Functions and Features

Here is a list of all the functions and features available in the GodotSteam module. Many will reference appID or steamID. AppID always references to a game, applications, or DLC's ID number in Steam. The steamID, however, can reference a user, lobby session, server, or such.


  • steamInit()
    - Starts up the Steam API.
  • isSteamRunning()
    - Returns true/false if Steam is running
  • run_callbacks()
    - From my understanding, this should be run often if you are expecting them. Should be called in the _process(true) function.


  • hasOtherApp(appID)
    - Does the user own the given application/game for this appID?
  • getDLCCount()
    - Get the total number of DLC installed for this application/game.
  • isDLCInstalled(appID)
    - Is the given DLC appID installed for this application/game?
  • requestAppProofOfPurchaseKey(appID)
    - Returns purchase key for given application/game in a callback (currently not working).
  • isAppInstalled(appID)
    - Check if given application/game is installed, not necessarily owned.
  • getCurrentGameLanguage()
    - Get the user's current game language (ie. english, russian, french).
  • isVACBanned()
    - Does the user have a VAC ban for this game.
  • getEarliestPurchaseUnixTime(value)
    - Returns the Unix time of the purchase of the app.
  • isSubscribedFromFreeWeekend()
    - Checks if the user is subscribed to the current app through a free weekend.
  • installDLC(value)
    - Install control for optional DLC.
  • uninstallDLC(value)
    - Uninstall control for optional DLC.


  • getFriendCount()
    - Get the number of friends the user has.
  • getPersonaName()
    - Get the user's Steam username.
  • getFriendPersonaName(steamID)
    - Get the given user's Steam username.
  • setGameInfo(serverKey, serverValue)
    - Set the game information in Steam; used in 'View Game Info'. Must be set as a key/value pair; multiple may be set.
  • clearGameInfo()
    - Clear the game information in Steam; used in 'View Game Info'.
  • inviteFriend(steamID, connection)
    - Invite friend ot current game/lobby.
  • setPlayedWith(steamID)
    - Set player as 'Played With' for current game.
  • getRecentPlayers()
    - Get list of players user has recently played game with.
  • getFriendAvatar(size)
    - Get player's avatar.
  • ActivateGameOverlay(dialog)
    - Activates the overlay with optional dialog to open the following: "Friends", "Community", "Players", "Settings", "OfficialGameGroup", "Stats", "Achievements", "LobbyInvite".
  • ActivateGameOverlayToUser(url, steamID)
    - Activates the overlay to the following: "steamid", "chat", "jointrade", "stats", "achievements", "friendadd", "friendremove", "friendrequestaccept", "friendrequestignore".
  • ActivateGameOverlayToWebPage(url)
    - Activates the overlay with specified web address.
  • ActivateGameOverlayToStore(appID)
    - Activates the overlay with the application/game Steam store page.
  • ActivateGameOverlayInviteDialog(steamID)
    - Activates game overlay to open the invite dialog. Invitations will be sent for the provided lobby.
  • getUserSteamGroups()
    - Get list of user's Steam groups; a mix of different Steamworks API group functions.
  • getUserSteamFriends()
    - Get a list of user's Steam friends; a mix of different Steamworks API friend functions.
  • activateGameOverlayInviteDialog(steamID)
    - Activates game overlay to open the invite dialog. Invitations will be sent for the provided lobby.


  • createLobby(lobbyType, maxMembers)
    - Create a lobby on the Steam servers, if private the lobby will not be returned by any RequestLobbyList() call.
  • joinLobby(lobbyID)
    - Join an existing lobby.
  • leaveLobby(lobbyID)
    - Leave a lobby, this will take effect immediately on the client side, other users will be notified by LobbyChatUpdate_t callback.
  • inviteUserToLobby(lobbyID, steamID)
    - Invite another user to the lobby, the target user will receive a LobbyInvite_t callback, will return true if the invite is successfully sent, whether or not the target responds.


  • musicIsEnabled()
    - Is Steam music enabled?
  • musicIsPlaying()
    - Is Steam music playing something?
  • musicGetVolume()
    - Get the volume level of the music. Returned as a float.
  • musicPause()
    - Pause whatever Steam music is playing.
  • musicPlay()
    - Play current track/album.
  • musicPlayNext()
    - Play next track/album.
  • musicPlayPrev()
    - Play previous track/album.
  • musicSetVolume(value)
    - Set the volume of Steam music. Must pass a float between 0.0 and 1.0.


  • triggerScreenshot()
    - Causes the Steam overlay to take a screenshot.


  • _lobby_created
    - Signal the lobby has been created.
  • _lobby_joined
    - Signal that lobby has been joined.
  • _lobby_invite
    - Signal that a lobby invite was sent.
  • _join_requested
    - Signal a game/lobby join has been requested.
  • _avatar_loaded
    - Signal that the avatar has been loaded.
  • _leaderboard_loaded
    - Signal a leaderboard has been loaded or has failed.
  • _leaderboard_entries_loaded
    - Signal leaderboard entries are downloaded.
  • _overlay_toggled
    - Signal when overlay is triggered.
  • _low_power
    - Signal when battery power is running low, less than 10 minutes left.
  • _server_connected
    - When connected to a server.
  • _server_disconnected
    - When disconnected from a server.
  • _dlc_installed
    - Posted after the user gains ownership of DLC & that DLC is installed.

UGC (User Generated Content) / Workshop

  • getNumSubscribedItems()
    - Number of subscribed items.
  • getItemState(fileID)
    - Get EItemState flags about item on this client.
  • downloadItem(fileID, highPriority)
    - Download new or update already installed item. If returns true, wait for DownloadItemResult_t. If item is already installed, then files on disk should not be used until callback received.
  • suspendDownloads(suspend)
    - SuspendDownloads( true ) will suspend all workshop downloads until SuspendDownloads( false ) is called or the game ends.


  • getSteamID()
    - Get the user's Steam ID (ID3).
  • loggedOn()
    - Check, true/false, if user is logged into Steam currently.
  • getPlayerSteamLevel()
    - Get the user's Steam level.
  • getUserDataFolder()
    - Get the user's Steam installation path.
  • advertiseGame(serverIP, port)
    - (LEGACY FUNCTION) Set data to be replicated to friends so that they can join your game.
  • getGameBadgeLevel(series, foil)
    - Trading Card badges data access, if you only have one set of cards, the series will be 1.

User Statistics

  • getAchievement(name)
    -Return true/false if use has given achievement.
  • getStatInt(name)
    - Get the value of an integer statistic.
  • getStatFloat(name)
    - Get the value of a float statistic.
  • resetAllStats(achievesToo)
    - Reset all Steam statistics; optional to reset achievements.
  • requestCurrentStats()
    - Request all statistics and achievements from Steam servers.
  • setAchievement(name)
    - Set a given achievement.
  • setStatFloat(name, value)
    - Set a statistic.
  • setStatInt(name, value)
    - Set a statistic.
  • storeStats()
    - Store all statistics, and achievements, on Steam servers; must be called to "pop" achievements.
  • clearAchievement(name)
    - Clears a given achievement.
  • findLeaderboard(name)
    - Find a given leaderboard, by name.
  • getLeaderboardName()
    - Get the name of a leaderboard.
  • getLeaderboardEntryCount()
    - Get the total number of entries in a leaderboard, as of the last request.
  • downloadLeaderboardEntries(start, end, type)
    - Request all rows for friends of user.
  • downloadLeaderboardEntriesForUsers(usersID)
    - Request a maximum of 100 users with only one outstanding call at a time.
  • uploadLeaderboardScore(score, keepBest)
    - Upload a leaderboard score for the user.
  • getDownloadedLeaderboardEntry(handle, entryCount)
    - Once all entries are accessed, the data will be freed up and the handle will become invalid, use this to store it.
  • updateLeaderboardHandle(handle)
    - Update the currently used leaderboard handle.
  • getLeaderboardHandle()
    - Get the currently used leaderboard handle.
  • getLeaderboardEntries()
    - Get the currently used leaderboard entries.
  • getAchievementAndUnlockTime(name, achieved, unlockTime)
    - Get the achievement status, and the time it was unlocked if unlocked (in seconds since January 1, 19).
  • indicateAchievementProgress(name, curProgress, maxProgress)
    - Achievement progress, triggers an AchievementProgress callback, that is all.


  • getCurrentBatteryPower()
    - Get the amount of battery power, clearly for laptops.
  • getIPCountry()
    - Get the user's country by IP.
  • getSecondsSinceAppActive()
    - Returns seconds since application/game was started.
  • getServerRealTime()
    - Get the actual time.
  • isOverlayEnabled()
    - Returns true/false if Steam overlay is enabled.
  • isSteamRunningInVR()
    - Is Steam running in VR?.
  • getSteamUILanguage()
    - Get the Steam user interface language.
  • getAppID()
    - Get the Steam ID of the running application/game.
  • setOverlayNotificationPosition(pos)
    - Set the position where overlay shows notifications. Accepts integers 0-3 (top left, top right, bottom left, bottom right).
  • isSteamInBigPictureMode()
    - Returns true if Steam & the Steam Overlay are running in Big Picture mode.
  • startVRDashboard()
    - Ask SteamUI to create and render its OpenVR dashboard.

Change Log

The change log for the repo. Since the change log stars well after the project had been going, versioning will start a 1.1.0, sorry.

  • Added: getCurrentGameLanguage
  • Added: Pre-compiled engines and templates for Windows
  • Added: change log to documentation
  • Changed: minor things in godotsteam.cpp