# Generate Items

{% hint style="success" %}
#### Like what you're seeing?

Support us as a [GitHub Sponsor](../../../../where-to-buy/become-a-sponsor) and get instant access to all our assets, exclusive tools and assets, escalated support and issue tracking and our gratitude.\
\
These articles are made possible by our [GitHub Sponsors](../../../../where-to-buy/become-a-sponsor) ... become a sponsor today!
{% endhint %}

## Introduction

{% hint style="danger" %}
For Developers Only
{% endhint %}

Grants specific items to the current user, for developers only.

This API is only intended for prototyping - it is only usable by Steam accounts that belong to the publisher group for your game.

## Options

Heathen provides two options when working with this endpoint.

### Simple

Our Simple variant will save you a lot of effort by handling the result-ready event for you, processing any requested properties and handing you a completed collection of item details when it's all done.

With the simple method, you should provide the item you wish to add as well as any properties you would like us to read from the resulting item. In most cases you won't need additional properties read however if your items have generators on them that create custom properties on creation then you may want to have us read those for you

#### Items (input)

The array of item def IDs you want to generate

#### Read Properties (input)

The array of strings representing the keys for each property to be read from the results.&#x20;

#### Callback (input)

The callback is an event that will contain the [UEResult](../enumerators/ueresult) of the request and an array of [Item Detail With Properties](../types/item-detail-with-properties)

#### Return Value

Always true when called by a regular user, and always false when called by a Steam Game Server.

### Example

<figure><img src="https://4053370152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZWu8yFOWhCYCMkJFmR%2Fuploads%2FAZpA9q6Am7bThX4gAmGO%2Fimage.png?alt=media&#x26;token=d4b213fb-8852-4347-add7-d4c003ca8c09" alt=""><figcaption></figcaption></figure>

Note that we never return the result handle to you, we track this handle, process the items, read the requested properties and destroy the handle for you returning to you the resulting data in an array.

### Native

The native Steam API works by issuing the request and returning an Item Request Handle when the request is filled Steam will execute the Result Ready callback. You must then read the details, properties and other aspects you desire from the result and then destroy the result handle.

#### Items (input)

An array of Item Def IDs you want to generate

### Example

To get the handle you make your request, and check if the request was successful, if so store that request ... you'll need the handle from it later. This will prompt Steam to execute the Result Ready event when the results have been read.

<figure><img src="https://4053370152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZWu8yFOWhCYCMkJFmR%2Fuploads%2Fy8pU3X44Jqk0CgsrNzHH%2Fimage.png?alt=media&#x26;token=60f1ac46-f062-4b6b-b416-52948d6e9b87" alt=""><figcaption></figcaption></figure>

When the Result Ready is executed you will need to check if it matches your result handle, fetch the items contained in that result, and for each item fetch whatever additional properties you may need.

<figure><img src="https://4053370152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZWu8yFOWhCYCMkJFmR%2Fuploads%2FqVUdOKCIlEbRwMC7bhKI%2Fimage.png?alt=media&#x26;token=2fb48a69-e09a-440b-8e3e-372e3046f327" alt=""><figcaption></figcaption></figure>

Importantly when you are done reading the data returned by that result you need to destroy the handle.

<figure><img src="https://4053370152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZWu8yFOWhCYCMkJFmR%2Fuploads%2Fecpo9z5YpP42F1wNi7ik%2Fimage.png?alt=media&#x26;token=42fda534-10ab-48ad-84a3-f71fa55c5cb8" alt=""><figcaption></figcaption></figure>
