Öğe etiketleri Steam'in kullanıcılara, içerisinde envanter ve pazar arama görünümleri dahil öğeler için olan "Gelişmiş Filtre"
diyaloglarını göstermesine olanak sağlar. Oyuncular hızlı bir şekilde öğeleri görüntülerken istediği nadirlikte öğeleri veya sadece onların karakter sınıfına uyumlu olan öğeleri sıralayabilir.
Etiketleri kullanmak için ilk olarak kategorileri ve etiketleri direkt olarak Öğe Tanımlamalarında belirleyin, daha sonra
kullanıcı tarafından görülebilen yerelleştirilmiş dizeleri İngilizce olarak veya desteklemek istediğiniz diğer dillerde sağlayın. En az bir İngilizce yerelleştirme dizesine sahip olmayan etiketler
envanter özellikleri tarafından yok sayılacaklardır.
Öğe tanımı içerisinde kullanılacak olan değerler kısa ve basit metin belirteçleri olmalıdır. Bu belirteçler her dil için yerelleştirilmiş dizeleri belirlemek için bir anahtar olarak kullanılırlar. Bu belirteçler kullanıcıya direkt olarak asla gösterilmez.
Öğe Etiketi Yerelleştirmesi
Öğeleriniz için etiketleri tanımladıktan sonra, onları kullanıcılara görülebilir yapmak için onlara en azından İngilizce ama tercihen bütün desteklenen diller için de
kullanıcı tarafından görülen çeviriler sağlamalısınız. Bu, SteamWorks ayarlamanızın bir parçası olarak, uygulamanızın
Envanter Hizmeti sayfasından da ayarlanabilir.
Öğe Etiket Formatı
tag
alanı kategorileştirilmiş belirteçlerin bir listesi olarak, ";" karakteri ile ayrılmış bir şekilde sunulmalıdır.
Her belirteç, ";" karakteri ile ayrılmış bir şekilde bir kategori belirteci ve bir değer belirteci içermelidir.
<tag_list>: <tag_pair> { ";" <tag_pair> }
<tag_pair>: <category_token> ":" <tag_token>
Öğe Etiketi Örneği
"tags":"class:elf;farms:potato;rarity:legendary;type:character;handed:ambi"
...
"tags":"class:troll;farms:gold;rarity:common;type:character;handed:left"
Öğe Başına Etiketler
Ne zaman bir öğe bir
generator
,
playtimegenerator
veya
bundle
tarafından oluşturulsa, o öğeye hayatı boyunca saklayacağı ve sahiplik değişiklikleri boyunca devam edecek etiketler verebilirsiniz.
Bu etiketler diğer öğe özellikleri ile birlikte otomatik olarak Steam İstemcisine gönderilir ve özellik ismi "tags" ile birlikte ISteamInventory::GetResultItemProperty() çağrısı ile çağrılabilir. Etiketler sağlanan dize alanında getirilecektir ve
;
karakteri ile sınırlanır.
Etiketleri atamanın basit bir yolu, oluşturulan öğe tanımlamasında onları tanımlamak olabilir. Basitçe
tags
alanı içerisindeki herhangi bir
generator
veya
playtimegenerator
öğe tanımlamaları, oluşturulan herhangi bir öğeye kopyalanacaktır.
Örnek
Oluşturucu A'nın %10'luk bir şans ile Efsanevi Oluşturucu'dan bir öğeyi oluşturma şansı vardır. Ve %90'lık bir şans ile de Yaygın Oluşturucu'dan bir öğe oluşturma şansı vardır. Oluşturucu A aynı zamanda
color:red
etiketini uyguluyor olsun. Efsanevi Oluşturucu
quality:legendary
etiketini uygular ve bir kılıç veya kalkan öğesi oluşturur. Öte yandan Yaygın Oluşturucu
quality:common
etiketini uygular ve bir kılıç veya kalkan öğesi oluşturur.
itemdefid: 10
type: item
name: Kılıç
itemdefid: 11
type: item
name: Kalkan
itemdefid: 100
type: generator
name: Oluşturucu A
bundle: 101x1;102x9
tags: color:red
itemdef: 101
type: generator
name: Efsanevi Oluşturucu
bundle: 10;11
tags: quality:legendary
itemdef: 102
type: generator
name: Yaygın Oluşturucu
bundle: 10;11
tags: quality:common
Etiketleri atmanın başka bir yolu,
tag_generator
öğe tanımı türünü kullanmaktır. Bu özel öğe tanımında (aslında öğe oluşturmaz) seçilecek belirli bir etiket seti ve onların olasılıklarını tanımlamalısınız. Bir
generator
,
playtimegenerator
veya
bundle
öğe tanımı içerisindeki
tag_generators
alanını, bütün etiket oluşturucuların öğe tanım kimlikleri ile ayarlamanız gerekli. Bu etiket oluşturucular bütün alt öğelere uygulanacaktır.
Etiket Oluşturucu Örneği
Oluşturucu A ya bir kılıç ya da bir kalkan oluşturur, ona
color:red
etiketini uygular ve daha sonra Etiket Oluşturucu Kalitesini ve Etiket Oluşturucu Efektlerini yeni öğeye uygular. Etiket Oluşturucu Kalitesinin %10'luk bir şans ile
quality:legendary
etiketini ekleme şansı varken %90'lık bir şans ile
quality:common
etiketini uygulama şansı vardır. Etiket Oluşturucu Efektleri
fx:flames
,
fx:sparks
veya
fx:lasers
etiketlerinden herhangi birisini uygulamak için eşit şansa sahiptir. İşlem bir "Efsanevi Kırmızı Alevli Kalkan" veya bir "Yaygın Kırmızı Lazerli Kılıç" ile sonuçlanabilir.
itemdefid: 10
type: item
name: Kılıç
itemdefid: 11
type: item
name: Kalkan
itemdefid: 100
type: generator
name: Oluşturucu A
bundle: 10;11
tags: color:red
tag_generators: 101;102
itemdefid: 101
type: tag_generator
name: Etiket Oluşturucu Kalitesi
tag_generator_name: quality
tag_generator_values: legendary:1;common:9
itemdefid: 102
type: tag_generator
name: Etkiket Oluşturucu Efektleri
tag_generator_name: fx
tag_generator_values: flames;sparks;lasers
tag_generators
alanı için olan format, uygulanmasını istediğiniz etiket oluşturucularının bütün öğe tanımı kimliklerinin ";" karakteri ile ayrılmış bir listesidir.
tag_generator
öğe tanımları için hem
tag_generator_name
alanını hem de
tag_generator_values
alanını tanımlamanız gerekmekte.
tag_generator_name
alanı yukarıda belirtilen kategori belirteci ile aynıdır.
tag_generator_values
alanı, ";" karakteri ile ayrılmış
tag_token:chance
listesidir. Eğer şans verilmez ise varsayılan değeri 1'dir.