diff --git a/docs/changelog/gdextension.md b/docs/changelog/gdextension.md index 44b33a66..38ebeb32 100644 --- a/docs/changelog/gdextension.md +++ b/docs/changelog/gdextension.md @@ -4,6 +4,19 @@ --- +**Version 4.5 Changes** + +- Added: two new arguments to `steamInit` and `steamInitEx` to set your app ID and run_callbacks interally, thanks to _GreenFox_ +- Added: two Music class callbacks +- Changed: `generateItems`, `exchangeItems`, `getItemsByID`, and `startPurchase` all list-based arguments are now PoolIntArrays +- Changed: `getItemsByID` now takes one argument, counts the elements in the passed array instead +- Changed: `getItemsWithPrices` no longer requires any arguments passed to it +- Changed: in-editor docs have been updated +- Fixed: `getResultItems` now returns all item data +- Fixed: missing DEFVAL for `steamInitEx` +- Fixed: Joy Con name in `getInputTypeForHandle` +- Removed: `getNumItemsWithPrices` as it was unnecessary + **Version 4.4.3 Changes** - Fixed: `requestEquippedProfileItems` was missing method bind, thanks to _BOTLANNER_ diff --git a/docs/changelog/gdnative.md b/docs/changelog/gdnative.md index b8548562..e56db9d4 100644 --- a/docs/changelog/gdnative.md +++ b/docs/changelog/gdnative.md @@ -4,6 +4,23 @@ www# GDNative Change-Log ------ +**Version 3.22.1 Changes** + +- Added: two new arguments to `steamInit` and `steamInitEx` to set your app ID and run_callbacks interally, thanks to _GreenFox_ +- Fixed: issue with callback that caused compiling failure in Linux + +**Version 3.22 Changes** + +- Added: two Music class callbacks +- Changed: `generateItems`, `exchangeItems`, `getItemsByID`, and `startPurchase` all list-based arguments are now PoolIntArrays +- Changed: `getItemsByID` now takes one argument, counts the elements in the passed array instead +- Changed: `getItemsWithPrices` no longer requires any arguments passed to it +- Changed: in-editor docs have been updated +- Fixed: `getResultItems` now returns all item data +- Fixed: missing DEFVAL for `steamInitEx` +- Fixed: Joy Con name in `getInputTypeForHandle` +- Removed: `getNumItemsWithPrices` as it was unnecessary + **Version 3.21.3 Changes** - Fixed: `requestEquippedProfileItems` was missing method bind, thanks to _BOTLANNER_ diff --git a/docs/changelog/godot3.md b/docs/changelog/godot3.md index b71c34dc..525bf053 100644 --- a/docs/changelog/godot3.md +++ b/docs/changelog/godot3.md @@ -4,6 +4,11 @@ --- +**Version 3.22.1 Changes** + +- Added: two new arguments to `steamInit` and `steamInitEx` to set your app ID and run_callbacks interally, thanks to _GreenFox_ +- Fixed: issue with callback that caused compiling failure in Linux + **Version 3.22 Changes** - Added: two Music class callbacks diff --git a/docs/changelog/godot4.md b/docs/changelog/godot4.md index f2bc2e84..956f53cc 100644 --- a/docs/changelog/godot4.md +++ b/docs/changelog/godot4.md @@ -4,6 +4,19 @@ --- +**Version 4.5 Changes** + +- Added: two new arguments to `steamInit` and `steamInitEx` to set your app ID and run_callbacks interally, thanks to _GreenFox_ +- Added: two Music class callbacks +- Changed: `generateItems`, `exchangeItems`, `getItemsByID`, and `startPurchase` all list-based arguments are now PoolIntArrays +- Changed: `getItemsByID` now takes one argument, counts the elements in the passed array instead +- Changed: `getItemsWithPrices` no longer requires any arguments passed to it +- Changed: in-editor docs have been updated +- Fixed: `getResultItems` now returns all item data +- Fixed: missing DEFVAL for `steamInitEx` +- Fixed: Joy Con name in `getInputTypeForHandle` +- Removed: `getNumItemsWithPrices` as it was unnecessary + **Version 4.4.2 Changes** - Fixed: `requestEquippedProfileItems` was missing method bind, thanks to _BOTLANNER_ diff --git a/docs/classes/main.md b/docs/classes/main.md index 645df123..4904ac2c 100644 --- a/docs/classes/main.md +++ b/docs/classes/main.md @@ -40,7 +40,7 @@ These are only available in the main [GodotSteam branches](https://github.com/Co ### steamInit -!!! function "steamInit( ```bool``` retrieve_stats = true )" +!!! function "steamInit( ```bool``` retrieve_stats = true, ```uint32_t``` app_id, ```bool``` embed_callbacks )" Starts up the Steam API. **Return:** dictionary @@ -55,12 +55,16 @@ These are only available in the main [GodotSteam branches](https://github.com/Co * 20 / "Steam not running" * 79 / "Invalid app ID or app not installed" + You can pass your app ID to the second argument and GodotSteam will set the OS environment for you so you do not have to do this manually anymore. By default, it sets your game's app ID to 480. + + You can pass true to the third argument to have GodotSteam connect and use run_callbacks internally so you do not have to do this manually anymore. By default, it does not do this. + ------ [:fontawesome-brands-steam: Read more in the official Steamworks SDK documentation](https://partner.steamgames.com/doc/api/steam_api#SteamAPI_Init){ .md-button .md-button--store target="_blank" } ### steamInitEx -!!! function "steamInitEx( ```bool``` retrieve_stats = true )" +!!! function "steamInitEx( ```bool``` retrieve_stats = true, ```uint32_t``` app_id, ```bool``` embed_callbacks )" Initialize the Steamworks SDK. On success **STEAM_API_INIT_RESULT_OK** is returned. Otherwise, if **error_message** is non-NULL, it will receive a non-localized message that explains the reason for the failure. **Returns:** dictionary @@ -75,6 +79,10 @@ These are only available in the main [GodotSteam branches](https://github.com/Co * 2 / "Cannot connect to Steam, client probably isn't running" * 3 / "Steam client appears to be out of date" + You can pass your app ID to the second argument and GodotSteam will set the OS environment for you so you do not have to do this manually anymore. By default, it sets your game's app ID to 480. + + You can pass true to the third argument to have GodotSteam connect and use run_callbacks internally so you do not have to do this manually anymore. By default, it does not do this. + ### steamShutdown !!! function "steamShutdown" diff --git a/docs/tutorials/initializing.md b/docs/tutorials/initializing.md index 377a6b21..c249d21c 100644 --- a/docs/tutorials/initializing.md +++ b/docs/tutorials/initializing.md @@ -126,6 +126,24 @@ func _process(_delta: float) -> void: I highly suggest, much like the initialization process, you put this `_process()` function with the `Steam.run_callbacks()` in a global (singleton) script so it is always checking for callbacks. Though, if you want, you can put it in any `_process()` function in any given script that might be using callback information. +## New Shortcuts + +We recently introduced some new shortcuts by way of extra arguments to send to `steamInit` and `steamInitEx`. These exist in GodotSteam 3.22 and GodotSteam 4.5 or newer. + +First, you can pass your app ID as the second argument and GodotSteam will internally set your OS enviroment variable. This will tell Steam what game you are playing. By default this is set as 480 so if you are using the newer versions, you no longer have to set your app ID in your code; just pass it to the initialization function. + +Second, you can pass **true** as the third argument and GodotSteam will internally hook up your `run_callbacks()` function. You will no longer have to add this to your `_process()` function as it will already be present and running. + +**Please note:** if you want to use these, you must set the prior arguments too or you may have some weird issues. You can use the full range of options like so: + +``` +# This asks for stats upon success, sets the app ID as 480, then embeds run_callbacks() automatically. + +steamInit( true, 480, true ) + +steamInitEx( true, 480, true ) +``` + --- ## Altogether Now