​
Step 1: Define Items

Define the items in your game. Items can be as simple or complex as your game requires.

​
Optional: Add Classifiers

Classifiers categorize items for easier filtering and organization:
  • Rarity (e.g., “Common”, “Rare”, “Legendary”)
  • Type (e.g., “Weapon”, “Armor”, “Consumable”)
Skip classifiers if your items don’t need categorization.

​
Optional: Add Attributes

Attributes define item properties or stats:
  • Attack Power (e.g., “+10”)
  • Health Restoration (e.g., “Restore 50 HP”)
If your game doesn’t require detailed item properties, you can leave attributes out.

​
Step 2: Define Spaces

Spaces are areas where items are stored. Create spaces for player inventories, stashes, or other storage systems. Examples:
  • Inventory: A general storage space for all collected items.
  • Stash: A special storage space for rare or extra items.

​
Step 3: Create the Forge Client

Connect your game to Forge using your credentials. The client securely interacts with Forge’s API. 
// Initialize the Forge client with your credentials
const client = new Forge({
  username: process.env['FORGE_CLIENT_ID'], // Your client ID
  password: process.env['FORGE_CLIENT_SECRET'], // Your client secret
});

​
Step 4: Add a User

Players in your game are represented as users in Forge. When a player logs in or selects a character, create a user. 
// Create a new user in Forge
const user = await client.users.create();
  • What does this do?
    Creates a user profile in Forge, which can be linked to items and spaces.

​
Step 5: Create a Space for the User

Assign the user a storage space for their collected items, such as an inventory or stash. 
// Create a user space for the player's stash
const userSpace = await client.users.spaces.create(user.id, {
  spaceId: process.env['FORGE_STASH_SPACE_ID'], // ID of the defined space
  externalId: user.id, // Optional: Link to your game’s user ID
});
  • What does this do?
    Creates a unique storage space for the user, enabling item collection and organization.

​
Step 6: Create an Item Instance

Add an item instance to the user’s space. For example, if a player defeats a monster and collects a legendary sword, you can add it to their stash. 
// Add an item instance to the user's stash
await client.itemInstances.create({
  userSpaceId: userSpace.id, // The user's stash space
  itemId: <<DEFINED_ITEM_ID>>, // The item the user collects
});
  • What does this do?
    Creates a unique instance of the item (e.g., a specific sword) and places it in the user’s space.