steam_ugc_create_item

This function is used to prepare the Workshop API and generate a published file ID for the item to be added. The function must be called before doing anything else with the item to be uploaded, as you will be required to use the unique published ID value that it returns in the Steam Async Event for updating. To use this function, you need to supply the Steam App ID for your game, and the use one of the following constants for the file_type argument:

When using this function it will return an async ID value which can then be parsed when the Steam Asynchronous event is triggered to report the creation of the item. The event will contain the following key/map values in the async_load ds_map:

• "id" - The async ID returned by the calling function
• "result" - The result of the operation (a real value). This will either be the GML constant ugc_result_success or some other real number. So you should check for this constant to ensure that the call was successful, and if otherwise somthing has not worked correctly. The rest of the possible values returned are shown as the result of the Steam "EResult" value and you should see steamclientpublic.h in the SDK headers for all 89 possible values.
• "event_type" - This key will hold the value "ugc_create_item"
• "legal_agreement_required" - Will be true or false (see the Steam docs for more details)
• "published_file_id" - This key holds the unique published ID for the item, which is an int64 (and you may need to cast it as such when using it in subsequent functions using the int64() function)

Syntax:

steam_ugc_create_item(consumer_app_id, file_type);

Returns:

Async ID

Extended Example:

In this example we first call the function and store the async ID value in a variable:

var app_id = steam_get_app_id();
new_item = steam_ugc_create_item(app_id, ugc_filetype_community);

This would then send off a request to the Steam API to create the new Worksop item, generating an async event which we would deal with as follows:

var event_id = async_load[? "id"];
if event_id == new_item
    {
    var type = async_load[? "event_type"];
    if type == "ugc_create_item"
        {
        global.Publish_ID = async_load[? "published_file_id"];
        }
    }

The above code checks the event type and if it is "ugc_create_item" then it retrieves the published file ID and stores it in a global variable for future reference.