๐ฐHow monetization works
You can sell items in your game for Silicon without building a payment system, a wallet, or an inventory. Silicon is The Sandbox's platform currency. Players buy it from The Sandbox once and spend it in any game on the platform.
You price each item in Silicon. You decide what the player gets when they own it or use it. Sandbox Studio supplies the store. Xsolla, the commerce partner, keeps balances, inventories, and purchase records through the Sandbox Studio Store API.
What the platform handles
Currency
Selling Silicon to players, checkout, and balances
Pricing your items in Silicon
Store
The default in-game store: Shop and Inventory tabs, sign-in, and Get Silicon
Adding it to your game, and restyling it if you want
Items
Storing items and ownership, draft and live state, and linking each item to you and your game
Creating, describing, and publishing items
Gameplay
Who owns the item
What an item does when a player owns or uses it
Environments
Sandbox payments while you test, and real payments in your published game
Testing before you publish
Key terms
Silicon
The Sandbox's platform currency. Players buy it from The Sandbox and spend it in any game. You price items in Silicon.
Xsolla
The payment and commerce provider behind the store. It holds balances, inventories, and purchase records.
Store Manager
The editor panel where you create your game ID and create, edit, publish, take down, and delete items. Open it from the main menu.
Game ID
Your game's identifier in the store. Created the first time you open Store Manager. Every item is tied to it.
Item
Something a player can buy or claim in your game. Each item has a name, description, price, behaviour, image, and SKU.
SKU
The item's unique code, shown in Store Manager. Your game logic uses it to check whether a player owns the item.
Draft
An item only you can see and buy, and only in the editor. Players never see drafts.
Live
A published item that players can see and buy in your published game.
Inventory
The items a player owns in your game. It persists across play sessions.
Category
What you are selling. The eight categories are on What you can sell.
Behaviour
How the store handles ownership: Permanent or Temporary. Store Manager labels Temporary as Consumable.
Monetization skills
The three agent skills shipped with every new project. They teach your agent how to add the store and manage items.
What your agent already knows
Every new project includes the three monetization skills. There is nothing to install.
monetization-store
The starting point. How the store, sign-in, environments, and payments work, and which specialist skill to use next.
monetization-store-components
The store's source (controller, API client, and UI built on the engine's UI kit) and an install script that adds the store to your game.
monetization-store-items
How to create, price, edit, publish, take down, and delete items, connect them to gameplay, and test without spending Silicon.
Your login stays in the editor. The agent creates and manages items through that signed-in session. It never sees or stores your login token.
What players see
Players can open the store and browse Shop without signing in. To buy or claim, they sign in through a popup. The game stays where it was.
Get Silicon opens Xsolla checkout. The player chooses a pack and pays, then returns to the game. They buy an item in one click. Their Silicon balance goes down, and the item appears in Inventory.
A permanent item takes effect straight away, and again on later visits. A temporary item waits in Inventory until the player uses it. If they do not have enough Silicon, the store offers a top-up.
Open Store Manager before you add a store
The first visit to Store Manager creates your game ID. Your agent cannot create that ID. This is deliberate: a store is never added to a game by accident.
Open Store Manager from the main menu once, then ask your agent to add the store. If the agent reports that your game has no ID, open Store Manager and ask again. The steps are on Add the store to your game.
Practical guidance
Work through the rest of this section in order.
Open
Store Manageronce, then add the store. Add the store to your gameChoose a category for each item. What you can sell
Create each item and give it an image and a Silicon price. Create and manage items
Describe what the item does so your game can respond. Connect items to gameplay
Buy each item in the editor with sandbox Silicon. Test purchases without spending Silicon
Publish your game, then publish each item. Publish, take down, and delete items
Common mistakes
Asking the agent to add the store before Store Manager exists for this game
Open Store Manager once so the game ID exists, then ask again.
Expecting a store item to change gameplay on its own
The store records who owns it. Wire the effect on Connect items to gameplay.
Last updated
Was this helpful?

