Store

Purpose

This page manages the products players buy in the game. Products are divided into showcases: a showcase is a store screen in your game (for example Garage or Armory). Each product sells an item for game money or real money; you set its price, stock, badge and when it will be on sale from here.

When to use

To add a new store screen (showcase) to your game.
To put a product in a showcase and change its price or stock (the Product page).
To filter products by status and to sort showcases and products.

Step by step

Preparation

To sell a product you first need a currency you can price in and an item to sell (under Content or Character templates). If something is missing, the page says so in a warning box and links to the related page.

Create a showcase

Press Yeni vitrin (New showcase), or İlk vitrini oluştur (Create the first showcase) if there is no showcase. Only admins with store write permission see the button.
Write the name; the key is suggested from the name. The key is the ID the game uses when opening the showcase.
If you wish, add a description and a banner, and choose the status and the sale time.
Write a reason (the panel fills in a suggestion) and press Vitrini oluştur (Create showcase).

To edit a showcase, choose the showcase tab and press Vitrini düzenle (Edit showcase). You can delete the showcase from the edit window; when it is deleted, the products in it are deleted too, past sales are kept.

View and sort products

Choose the showcase from the showcase tabs at the top.
Change the view with the Izgara (Grid) and Liste (List) buttons. The list view searches and filters the table with its own toolbar.
While Sırala (Sort) is on, you can move a product up or down with the buttons next to it, and move the showcase itself with Vitrini sola/sağa taşı (Move showcase left/right). Filters are disabled while sorting is on.
To go to a product’s detail, click its card or row; for a new product press Yeni ürün (New product).

Field	Required	Description
Name	Yes	At most 120 characters
Key	Yes	Lowercase letters, digits, hyphens, underscores; at most 64 characters
Description	No	At most 500 characters
Showcase banner	No	PNG, JPEG or WebP image
Status	Yes	Draft or Live
When on sale?	Yes	Immediately or a date range
Start, End	In a range	An empty end is unlimited
Action reason	Yes	8-500 characters

Filters

Search, Status and (on a narrow screen) Showcase. Statuses: Live, Draft, Scheduled, Expired, Sold out.

Sections

Ürünler (Products): Showcases and products.
NPC tüccarları (NPC traders): A read-only list. Store products use the automatic “Store” trader in the background; you do not need to do anything here.
Uygulama içi ürünler (In-app products): A read-only list; App Store and Google Play products. You can bind a store product to one of them.

Common situations

Situation	What to do
“Mağaza bu ortamda kapalı” (The store is off in this environment)	The Store module is off; turn it on from the Modules tab in Game settings.
“Fiyat vermek için önce bir para birimi oluşturun” (Create a currency first to set prices)	Add a currency from the Currencies page.
“Satacak bir eşya yok” (There is no item to sell)	First add an item from the Content page.
The product is not visible in the game	Check that the product’s and the showcase’s status is Yayında (Live) and that the sale time has come.
“Bu sırada başka biri mağazayı değiştirdi” (Someone else changed the store in the meantime)	The store catalog is written with version checking; press Yeniden yükle (Reload) and make the change again.
I changed the showcase key and the game cannot find the showcase	The game opens the showcase with its key; update the call in the game with the new key too.

Open Play developer documentation