Ürün ve Komut Değişkenleri

Ürün komutlarının içine {ad} biçiminde yer tutucular yazabilirsiniz; teslimat anında bunların yerine gerçek değerler konur. Bu yer tutucuların iki ayrı kaynağı vardır ve panelde iki ayrı sayfadan yönetilir.

	Ürün Değişkenleri	Komut Değişkenleri
Değeri kim verir	Müşteri, satın alırken bir forma yazar veya seçer	Siz, bir kez tanımlarsınız
Kapsam	Yalnız tanımlandığı ürün	Bütün ürünlerin komutları
Örnek	`kit_adi`, `hedef_oyuncu`	`vip_sure`, `sunucu_adi`
Menü	Mağaza > Katalog > Ürün Değişkenleri	Mağaza > Katalog > Komut Değişkenleri

Ürün Değişkenleri (müşteriden alınan bilgi)

Bir ürüne alan eklersiniz; müşteri o ürünü alırken alanı doldurur ve cevabı komutta {degisken_adi} olarak kullanılır. Örneğin bir kit ürününde müşteri “Savaşçı”, “Okçu” ya da “Büyücü” seçer, komut kit give {player} {kit_adi} olarak çalışır.

Sayfada önce bir ürün seçilir, sonra o ürünün alanları listelenir. Yeni Alan formunun alanları:

Alan	Ne işe yarar
Etiket	Müşterinin gördüğü soru (örn. Kit Adı).
Değişken Adı	Komutta `{...}` içine yazılacak ad (örn. `kit_adi`). Küçük harfle başlamalı; yalnız küçük harf, rakam ve alt çizgi; 2 ile 31 karakter.
Tür	Kısa Metin, Sayı ya da Seçim Listesi.
Seçenekler	Seçim listesinde virgülle ayrılmış seçenekler (örn. Savaşçı, Okçu, Büyücü). Seçim listesi için zorunludur.
Placeholder, Yardım Metni	Müşteriye gösterilen ipucu ve açıklama.
Zorunlu alan	Varsayılan açık. Kapalıysa ZORUNLU yerine İSTEĞE BAĞLI rozeti görünür.

Seçim listelerinde Seçenek fiyatlarını düzenle ile her seçeneğe fiyat farkı verebilirsiniz. Boş ya da 0 fark yok demektir; eksi değer indirim anlamına gelir ve ürün fiyatı sıfırın altına inmez. Fiyat farkı sunucuda yeniden hesaplanır.

Kurallar: player, username, order_id, product_name ve price yerleşik adlardır, alan adı olarak kullanılamaz. Müşteri cevabı en çok 100 karakter olabilir; sayı alanına sayı yazılmalıdır. Güvenlik için komutu bozabilecek özel karakterler (noktalı virgül, dikey çizgi, ve işareti, tırnaklar, ters eğik çizgi, süslü parantez, yüzde işareti vb.), satır sonu ve tire ya da eğik çizgi ile başlayan cevaplar reddedilir.

Komut Değişkenleri (ortak değerler)

Birçok üründe geçen bir değeri (örneğin VIP süresi) tek yerden değiştirmek için tanımlanır. Bu sayfa yalnızca yönetici (ADMIN) tarafından değiştirilebilir.

Alan	Ne işe yarar
Tanımlayıcı	Komutlarda `{tanimlayici}` olarak kullanılır (örn. `vip_sure`). Küçük harf, rakam ve alt çizgiye çevrilir. Oluşturulduktan sonra değiştirilemez, çünkü mevcut komutlar bu isme bağlıdır.
Ad, Açıklama	Yalnız panelde görünür.
Tür	Metin, Sayı ya da Evet / Hayır (değer `true` ya da `false` olarak yazılır). Sayı türünde geçerli bir sayı gerekir.
Değer	Komuta konacak değer.

Listedeki kopyala düğmesi komut etiketini panoya alır.

Yerleşik değişkenler

Tanımlamadan kullanabileceğiniz yer tutucular:

{player} ya da {username}: oyuncunun Minecraft adı.
{order_id}: sipariş numarası.
{product_name}: ürün adı.
{price}: ürün fiyatı.
Hesabını bağlamış oyuncular için {uuid} ve bağlı hesap değişkenleri (örn. {steam_id}, {steam_username}). Bağlı hesabı olmayan oyuncuda yer tutucu çözülmeden kalır; ayrıntı aşağıdaki Değişkenler penceresi bölümünde.

Yerleşik ad her zaman önceliklidir; aynı adda bir komut değişkeni onu gölgeleyemez. Aynı adda hem komut değişkeni hem ürün değişkeni varsa ürün değişkenindeki müşteri cevabı kullanılır, bu yüzden adları birbirinden farklı seçin.

Bilinmeyen bir yer tutucu (ör. PlaceholderAPI’nin kendi %player_name% yazısı) olduğu gibi bırakılır; böylece o eklentilerin yer tutucuları bozulmaz. %player% ve %username% biçimleri de {player} ve {username} gibi çözülür.

Değişkenler penceresi

Komut yazdığınız her yerde, komut alanının yanında bir Değişkenler düğmesi bulunur. Düğme, o komut türünde teslimat sırasında gerçekten çözülen yer tutucuların tablosunu açar; her satırın yanındaki düğmeyle {...} yazısını panoya kopyalarsınız. Pencere şu yerlerde vardır:

Nerede	Listelenenler
Ürün formu (Komutlar sekmesi, hem satın alma hem süre sonu komutları)	Yerleşik adlar (`player`, `username`, `order_id`, `product_name`, `price`), bağlı hesap değişkenleri, Komut Değişkenleri ve ürüne tanımlı ürün değişkenleri.
Bağlama ödülleri (Mağaza > Kampanyalar)	Yalnız `player` ve `username` ile Komut Değişkenleri; ödülde sipariş ve ürün bilgisi olmadığı için diğerleri çıkmaz.
Topluluk hedefleri	`product_name` (hedefin başlığı) ile Komut Değişkenleri; hedef tüm topluluğun olduğundan oyuncu değişkenleri yoktur ve içeren komut kaydedilmez.

Adım adım: kit seçtiren ürün

Alan ekleyin
Ürün Değişkenleri sayfasında ürünü seçin, Yeni Alan’a basın. Etiket “Kit Adı”, değişken adı kit_adi, tür Seçim Listesi, seçenekler “Savaşçı, Okçu, Büyücü” olsun.
Komutu yazın
Ürünler sayfasında ürünün Komutlar sekmesine kit give {player} {kit_adi} yazın.
Deneyin
Mağazada ürünü sepete eklerken kit seçimi istenmeli, teslimatta seçilen ad komuta konmalıdır.