Steamworks-dokumentaatio
Steam-tavaraluettelon malli

Yleiskatsaus ItemDef-rakenteeseen

Ydinmalli ja esinetyypit

Nämä ovat ydinominaisuuksia, jotka Steam ymmärtää ja tulkitsee. Ne ovat välttämättömiä Talous-, Vaihto- ja Tavaraluettelo-näkymien oikeille toiminnoille. Monet näistä ominaisuuksista ovat samoja kuin ISteamEconomy/GetAssetClassInfo-verkko-ohjelmointirajapinnan palauttamat ominaisuudet.

Itemdef-määrityksen on oltava jokin seuraavista tyypeistä:

NimiKuvaus
itemEsinetyyppi, joka sijaitsee pelaajan tavaraluettelossa.
bundleMyyntipaketti edustaa ItemDef-esinemäärityskokoelmaa sekä kunkin tyypin määrää. Kun tämä esine myönnetään, se on automaattisesti laajempi myyntipaketin bundle esinejoukko.
generatorGeneraattori edustaa satunnaista esinettä. Kun tämä esine myönnetään, yksi esinetyyppi valitaan satunnaisesti bundle-myyntipaketista, minkä jälkeen se luodaan. (Kuvittele esimerkiksi laatikkoa. Kun se avataan, jokin mahdollisista esineistä luodaan.)
playtimegeneratorTämä on generator-määrityksen erityismuoto, joka voidaan myöntää kutsumall ISteamInventory::TriggerItemDrop sovelluksesta.
tag_generatorTämä on erityinen esinemääritysmuoto, joka lisää tunnisteita esineisiin. Katso lisätietoja Steamin tavaraluettelon esinetunnisteet) -dokumentaatiosta.
Lisätietoja monimutkaisten esinetyyppien määrittämisestä täältä.

ItemDef-ominaisuudet

NimiKuvaus
appidSovelluksen tunnus
nameEsineen englanninkielinen nimi. Voit lisätä esineesi nimen lokalisoidun version seuraavan esimerkin mukaisesti:
name_english: "Hat" name_finnish: "Hattu"
Lokalisointi ja kielet -dokumentaatiossa on lisätietoja kielten loppuliitteistä.
descriptionEsineen englanninkielinen kuvaus
Voit lisätä esineen kuvauksen lokalisoituja versioita seuraavan esimerkin mukaisesti:
description_english: "This is a tall hat" description_finnish: "Tämä on silinterihattu"
Lokalisointi ja kielet -dokumentaatiossa on lisätietoja kielten nimien loppuliitteistä.
display_typeEsineen "tyypin" englanninkielinen kuvaus
Voit lisätä esinetyypin lokalisoituja versioita seuraavan esimerkin mukaisesti:
display_type_english: "Weapon" display_type_finnish: "Ase"
Lokalisointi ja kielet -dokumentaatiossa on lisätietoja kielten loppuliitteistä.
itemdefidTämän Itemdef-määrityksen tunnus. Sen tulee olla pienempi kuin 1 000 000 niille esineille, jotka eivät ole workshop-esineitä.
typeSisäinen arvo. ('item' | 'bundle' | 'generator' | 'playtimegenerator' | 'tag_generator')
bundleKatso kohta myyntipaketti- tai generoitavat esineet alempana tässä dokumentaatiossa.
promoKatso kohta promoesineiden muoto alempana tässä dokumentaatiossa.
drop_start_timeUTC-aikaleima – estää promotarjouksen myöntämisen ennen tätä määritettyä aikaa ja on käytettävissä vain kun promo = manual (katso kohta promoesineiden muoto alempana tässä dokumentaatiossa).
exchangeKatso kohta vaihtamisen muoto alempana tässä dokumentaatiossa.
priceKatso kohta hinnan määritys alempana tässä dokumentaatiossa.
price_categoryEsimääritetty hinta, jonka eri valuutta-arvoista huolehdimme puolestasi. Katso kohta hinnan määritys alempana tässä dokumentaatiossa.
background_colorTavaraluettelon taustan väri heksadesimaalijärjestelmän 6-merkkisenä tunnuksena.
name_colorTavaraluettelon nimen väri heksadesimaalijärjestelmän 6-merkkisenä tunnuksena.
icon_urlEsineen pienoiskuvakkeen URL-osoite. URL-osoitteen on oltava julkinen, koska Steam-palvelimet lataavat ja tallentavat sen välimuistiin. Suositeltava koko on 200 x 200.
icon_url_largeEsineen ison kuvakkeen URL-osoite. URL-osoitteen on oltava julkinen, koska Steam-palvelimet lataavat ja tallentavat sen välimuistiin. Suositeltava koko on 2 048 x 2 048.
marketableFalse/true (epätosi tai tosi). Määrittää, voidaanko esine myydä muille käyttäjille Steam-yhteisön kauppapaikalla.
tradableFalse/true (epätosi tai tosi). Määrittää, voiko esineen vaihtaa muiden käyttäjien kanssa Steam-vaihdoissa.
tagsKatso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet.
tag_generatorsLista tunnistegeneraattorin tag_generator-esinemääritystunnuksista, joita voi käyttää (katso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet).
tag_generator_nameTunnisteluokan nimen tunnus (katso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet).
tag_generator_valuesLista tunnisteiden arvoista ja niiden valintojen todennäköisyydestä (katso Steamin tavaraluettelon esinetunnisteet).
store_tagsMerkkijono, joka sisältää puolipisteellä (;) erotetut tunnisteet, "tags". Näitä tunnisteita käytetään sovelluksen esineiden luokitteluun/suodatukseen Steamin kaupassa.
store_imagesKuvien URL-osoitteet, eroteltu ";"-merkillä. Kuvat tallennetaan välityspalvelimelle. Niitä käytetään sovelluksen Steamin esinekaupan lisätietosivulla.
game_onlyFalse/true (epätosi tai tosi). Jos true, esineitä tai ilmoituksia uusista esineistä ei näytetä käyttäjän Steam-tavaraluettelossa. Käytetään tavallisesti myöntämiesi, kerran käytettävien esineiden yhteydessä.
hiddenFalse/true (epätosi tai tosi). Jos true, esinekuvausta ei näytetä asiakkaille eikä se ole ostettavissa. Tällä parametrillä voidaan piilottaa käyttämättömät tai kehitteillä olevat itemdef-määritykset.
store_hiddenFalse/true (epätosi tai tosi). Jos true, esine piilotetaan sovelluksen osalta Steamin esinekaupassa. Hinnoitellut esineet näytetään oletusarvoisesti kaupassa.
use_drop_limitFalse/true (epätosi tai tosi). Jos true, drop_limit-parametriä käytetään rajoittamaan esineiden myöntämistä ISteamInventory::TriggerItemDrop-kutsulla. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
drop_limitInteger (kokonaisluku). Määrittää ISteamInventory::TriggerItemDrop-kutsulla tietylle käyttäjälle rajoituksen, kuinka monta kertaa esine on mahdollista löytää. Jos arvoksi määritetään nolla, esinettä ei enää löydy tulevaisuudessa. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
drop_intervalInteger (kokonaisluku). Vaadittu peliaika minuuteissa, ennen kuin esine voidaan myöntää käyttäjälle. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
use_drop_windowFalse/true (epätosi tai tosi). Jos true, tähän itemdef-määritykseen käytetään drop_window-parametriä. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
drop_windowInteger (kokonaisluku). Vaaditun jäähyajan pituus minuuteissa, ennen kuin käyttäjälle voi myöntää esinettä. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
drop_max_per_windowInteger (kokonaisluku). Kuinka monta kertaa esine on mahdollista myöntää tietyn ajan kuluessa ennen jäähyn alkamista. Oletusarvo on 1. Katso kohta Pelin esinelöydöt alempana tässä dokumentaatiossa.
granted_manuallyFalse/true (epätosi tai tosi). Jos true, esine myönnetään ainoastaan, kun AddPromoItem()- tai AddPromoItems()-kutsua käytetään nimenomaisten esinemääritystunnusten yhteydessä. Muussa tapauksessa esine voidaan myöntää GrantPromoItems()-kutsulla. Oletusarvo on false.
use_bundle_priceFalse/true (epätosi tai tosi). Katso kohta Myyntipakettien myynti alempana tässä dokumentaatiossa. Oletusarvo on false.
auto_stackFalse/true (epätosi tai tosi). Jos true, myönnetyt esineet lisätään automaattisesti määritetyn tyypin yksittäiseen pinoon. Myönnetyt esineet näkyvät esineluettelon takaisinkutsufunktioissa määrän vaihtumisena. Oletusarvo on false.

Laajennettu malli

Voit myös määrittää lisäominaisuuksia, jotka ovat ominaisia pelissäsi.

Monitahoisten esinemääritysten käyttö

Myyntipaketin ja generaattorin esinetyypit

Myyntipaketin, generaattorin ja peliaikageneraattorin säännöt määritetään bundle-kentässä.

Määritämme myyntipaketteihin sisältyvien esineiden tyypin ja määrän.

Jos kyse on generaattorista tai peliaikageneraattorista, määrittelemme mahdollisesti generoitavien esineiden tyypit ja kunkin suhteellisen painon. Huomaa, että painon yhteismäärän ei tarvitse olla 100, vaikka se olisi kätevää.

Myyntipakettien bundle-kenttä sisältää sarjan koontiohjeita, jotka on erotettu puolipisteellä. Jokaisessa koontiohjeessa on itemdef-tunnus, jota seuraa vaihtoehtoisesti x-erotin ja toivottu lukumäärä.

Oletusarvona on "1", jos lukumäärää ei ole erikseen määritetty.

Myyntipaketin muoto

bundle_def : item_recipe , { ";" , item_recipe } item_recipe : item_def , []

Esimerkkejä myyntipaketeista

  • Myöntää yhden itemdef 201-, itemdef 202- tai itemdef 203 -esineen:
    type: bundle bundle: 201;202;203
  • Myöntää yhden itemdef 101- ja viisi itemdef 102 -esinettä:
    type: bundle bundle: 101x1;102x5
  • Myönnetään satunnainen itemdef 501 -esine 90 % todennäköisyydellä, itemdef 502 -esine 9 % todennäköisyydellä ja item 503 -esine 1 % todennäköisyydellä:
    type: generator bundle: 501x90;502x9;503x1
  • Myönnetään 90 % todennäköisyydellä yleinen esine; 10 % todennäköisyydellä erikoisesine.
    itemdefid: 600 name: Common generator type: generator bundle: 601;602;603;604;605 itemdefid: 700 name: Special generator type: generator bundle: 701;702;703;704;705 itemdefid: 800 name: Master generator type: generator bundle: 600x9;700x1

Huomaa edellisen esimerkin tavoin se, että paketti- ja generaattorimäärityksiä voi ketjuttaa. Monitahoisia esinetyyppejä kasvatetaan myöntämishetkellä siihen asti, kunnes vain yksinkertaisia itemdef-määrityksiä on jäljellä.

Vaihtokaavat

Voit määrittää ExchangeItems-ohjelmointirajapinnan avulla esineiden luomisen/muuttamisen koontiohjeet, joita voidaan kutsua turvallisesti asiakasohjelmasta. Steam-palvelimet tarkistavat pelaajan tavaraluettelon, kuluttavat annetun materiaalin atomisesti ja myöntävät esineen, jos vaatimukset täyttyvät.

Kohde-esine voi olla myyntipaketti tai generaattorityyppi.

Kaava on annettu kohde-esineen exchange-kentässä. Kaava on määritetty yhden tai useamman koontiohjeen kokoelmana, jotka on erotettu toisistaan puolipisteellä.

Jokaisessa koontiohjeessa on kokoelma vaadittuja materiaaliesineitä pilkulla erotettuna.

Vaaditut materiaalit voidaan antaa yksiselitteisesti itemdefid-määritteellä tai tunnisteella. Jos määrää ei ole annettu, oletus on 1.

Käytettäessä ExchangeItems, kutsuja antaa listan materiaaliesineistä, jotka vaihdetaan kohde-esineisiin. Palvelin tarkistaa jokaisen koontiohjeen ja valitsee niistä ensimmäisen, joka vastaa annettuja materiaaleja.

Vaihdot ovat joustavia: avaimen käyttö laatikon avaamiseen, erityisen hienon esineen teko osista, esineen kierrätys ja päivitys voidaan kaikki suorittaa näiden kaavojen avulla.

Vaihdon muoto

<exchange>: <recipe> { ";" <recipe> } <recipe>: <material> { "," <material> } <material>: <item_def_descriptor> / <item_tag_descriptor> <item_def_descriptor>: <itemdefid> [] <item_tag_descriptor>: <tag_name> ":" <tag_value> []
Vaadittava määrä on 1, ellei sitä ole erityisesti määritelty.

Esimerkki vaihdosta

// vaadi yksi seuraavista: // - yksi item#100 ja yksi item#101 tai, // - viisi item#102-esinettä tai // - kolme item#103-esinettä ja kolme and item#104 -esinettä. "exchange":"100,101;102x5;103x3,104x3" // vaatii yhden vasemman ja yhden oikean hanskan: "exchange":"handed:left,handed:right" // vaadi kolme puuta ja jotain erityisen hienoa ("fancy"): "exchange":"type:tree*3,quality:fancy" // vaadi joko: // - item#201 ja item#202 tai // - banananilla maustettu esine ja raskas esine "exchange":"201x1,202x1;flavor:banana,mass:heavy" // kierrätä viisi yleistä ("common") artefaktia yhteen erikoisartefaktiin ("special"): { "name":"special_generator", "type":"generator", "tags":"rarity:special", "bundle":...., "exchange":"rarity:common*5", ... }i

Promoesineet

Promoesineitä voi myöntää pelaajille, jos heillä on

  • sovellustunnuksen omistajuus (mukaan lukien lisämateriaalin sovellustunnus)
  • saavutus
  • peliaikaa sovellustunnuksella
  • manuaalisesti myönnetty esine, jolloin sovelluksen tulee kutsua AddPromoItem tietyllä itemdef-tunnuksella.

Steam tekee promoesineiden tarkistukset, joten niitä voi kysellä turvallisesti asiakasohjelmasta. Katso ISteamInventory::AddPromoItem. Voit määritellä promoesineet määrittämällä yhden tai useamman myöntämissäännön esinemäärityksen "promo"-ominaisuudessa.

Huomaa, että myyntipaketti voi myös olla promoesine.

Manuaalisesti myönnettäviä promoesineitä voi jakaa tietyn ajan välein. Pelaaja voi esimerkiksi saada muutaman esineen kerran viikossa, kun hän suorittaa tiettyjä tehtäviä loppuun (esimerkiksi pelinsisäiset tehtävät). Voit käyttää tätä ominaisuutta määrittämällä myöntöjen aikavälien drop_start_time- ja drop_interval-arvot itemdef-määrityksessä.

Promoesineitä ei myönnetä ilmaisen tuotteen väliaikaisesta omistamisesta (esimerkiksi ilmaisen viikonlopun tai perhekirjaston vuoksi).

Promosäännön muoto

<promo>: <rule> { ";" <rule> } <rule>: app_rule / ach_rule / played_rule / manual_rule <app_rule>: "owns:" <appid> <ach_rule>: "ach:" <achievement name> <played_rule>: "played:" <appid>/<minutes played, defaults to 1> <manual>: "manual"

Promoesimerkkejä

// yksinkertaiset promosääntömääritykset: "promo":"owns:440;owns:480" // pelannut vähintään 15 minuuttia sovellustunnuksella 570: "promo":"played:570/15" // kertakäyttöesine voidaan myöntää kerran viikossa: "itemdefid": 404, "type": "item", "name": "Weekly Quest Item", "promo": "manual", "drop_start_time": "20170801T120000Z", "drop_interval": 10080, ...

Esinemyönnön aloitusaika

Kun määrität promoesineen myöntämisen aloitusajan, esinettä ei myönnetä ennen määritettyä aikaa. Erityiskoodia käyttämällä voit kuitenkin myöntää esineen ennen aloitusajankohtaa. Aikaleima on määritettävä ISO 8601 -muodossa käyttämällä UTC-aikavyöhykettä: YYYYMMDDTHHMMSSZ. Esimerkki: 20050515T171151Z.

Pelin esinelöydöt

Peliajan esinelöytöjen toiminnon avulla Steam-palvelimet voivat seurata ja hallita esinelöytöjä pelaajan peliajan perusteella. Pelisi pitää vain kutsua funktiota ISteamInventory::TriggerItemDrop, kun löydön on aika tapahtua. Sinun tulee luoda "playtypegenerator"-tyyppisiä esineitä, jotta esineen voi myöntää.
Sovelluksesi hallinnoi pelinaikaista esinemyöntöä. Ohjelmisto ei tue automaattisia myöntöjä, jotka perustuvat pelkästään käyttäjän peliaikaan. Toisin sanoen peliaika on myöntämisen ehto, mutta sovellus käynnistää myönnön arvioinnin.

Esinelöytötiheyttä voi hallita sovellustasolla kohdassa Yhteisö -> Tavaraluettelopalvelu -> Peliajan perusteella myönnetyt esineet. Työkalussa on kolme määritystä, joilla voit tehdä seuraavat mukautukset:
(1) Miten paljon aikaa on kulunut ennen esinelöytöä?
(2) Kuinka monta esinelöytöä voi olla aikaikkunan sisällä?
(3) Miten pitkä jäähyn aikaikkuna on, ennen kuin seuraava esinelöytö voidaan myöntää?

Samat määritysvaihtoehdot on jokaisessa itemdef-esinemäärityksessä. Esineelle määritetyt arvot ohittavat tietyn esineen mitkä tahansa sovellusasetukset. Tämä mahdollistaa oman pudotustiheyden jokaiselle esineelle, aikaikkunakohtaisen enimmäismäärän ja jäähyn aikaikkunan.

Jokaista peliaikageneraattorin esinemyöntöä seurataan erikseen, jos jokin seuraavista myöntämisen asetuksista on määritetty: ("drop_interval", "use_drop_window", "drop_window", "drop_max_per_window" ). Eli jos itemdef EI määritä löytöasetuksia, löydöt jaetaan muiden peliaikageneraattorien kanssa ilman löytöasetuksia ja niitä kaikkia rajoittaa sovelluksen löytöväli. Jos itemdef määrittää löytöasetukset erikseen, löydöt myönnetään ja niitä seurataan erikseen generaattoritasolla riippumatta sovelluksesta tai muista itemdef-peliaikageneraattoreista.

Esimerkki pelinaikaisesta ItemDef-myönnöstä

  1. Käyttäjälle myönnetään esine 30 minuutin peliajan jälkeen. Tämän asetuksen huono puoli on, että se sallii
    kyseisen esineen keräilyn, koska niitä voidaan myöntää 30 minuutin välein. Suosittelemme, että lisäät löydön aikaikkunan asetuksen:
    "drop_interval" : 30
  2. Rajoita yhteen löytöön päivässä 30 minuutin peliajan jälkeen. Näin pelaaja saa palkinnon joka päivä, kun hän palaa pelaamaan peliäsi.
    "drop_interval" : 30,
    "use_drop_window" : "true",
    "drop_window" : "1440"

  3. Pelaaja voi saada kolme esinettä joka päivä, jos hän pelaa vähintään 90 minuuttia. Pelaajan ei tarvitse pelata 90 minuuttia yhteen putkeen. Tällä palkitaan pidempi peliaika.
    "drop_interval" : 30,
    "use_drop_window" : "true",
    "drop_window" : "1440",
    "drop_max_per_window" : "3"
Jos jokin itemdef-asetus puuttuu, oletusarvona on sovellukselle määritetty asetus.

Löytörajoitukset

drop_limit-muuttuja sallii enimmäismäärän peliaikaan pohjautuvia myöntöjä tietylle generaattorille.
Voit sen avulla rajoittaa esineen generointikertoja (esimerkiksi: se myönnetään vain ensimmäisellä kerralla, kun pelaaja voittaa legendaarisen vaikea -tasolla).
Jos taas arvo on 0, voit estää käytöstä poistetun esineen tulevat löydöt. Hyväksymme tämän asetuksen vain, jos use_drop_limit-arvona on "true" (tosi).

Esineiden myynti

Jotta voit asettaa pelin esineitä myyntiin, määritä hinnat tai hintaluokat niitä vastaavissa itemdefs-esinemäärityksissä.
Lisätietoja kauppasivun käyttöönotosta ja muokkauksesta löytyy Esinekauppa-dokumentaatiosta.

Hintojen määrittely

Esineiden hinnat voi määrittää jommassakummassa seuraavista kentistä, muttei molemmissa.
NimiKuvaus
priceMääritä hinta jokaisessa valuutassa. Jos valuuttaa ei ole määritetty, se muunnetaan automaattisesti ostohetkellä.
price_categoryMääritä yksi hinta, joka ilmoitetaan kaikissa tuetuissa, Valven hintataulukon mukaisissa, valuutoissa.

price_category-kenttä on määritetty Valven erityisessä "VLV"-valuutassa. VLV100 on yhtä kuin 0,99 USD. Se muunnetaan kaikkiin tuettuihin valuuttoihin Valven vaihtokurssien mukaisesti.

Valven VLV-vaihtokurssit seuraavat valuuttakursseja ja mukautuvat valuuttakurssien muutoksiin ajan myötä. Päivitämme hintoja tarpeen mukaan, mutta emme seuraa vähäisiä muutoksia, jotta asiakkaat voivat käyttää vakaata hinnoittelua ja heidän käyttäjäkokemuksensa säilyvät miellyttävinä.

Hintojen muoto

Price: <version>;<pricelist> Version: "1" <pricelist> : <originalprice>(;<price>)* <originalprice>: <currency><integer>(,<currency><integer)* <price>: (<daterange>)<currency><integer>(,<currency><integer)* <currency> 3 kirjainta, kuten. "USD" <integer> määrä kyseisessä valuutassa <daterange>: YYYYMMDDTHHMMSSZ-YYYYMMDDTHHMMSSZ
<daterange> – tämän tulee olla tarkalleen 33 merkkiä.

Päivämääräluettelo järjestetään laskevasti (tulevat päivämäärät ensin).

Hintaesimerkkejä

  • price_category: 1;VLV100
    Esimääritetty hintaluokka, jossa käytetään Valven ylläpitämää hintataulukkoa.
  • price: 1;USD100
    (1,00 USD)
  • price: 1;USD100,EUR080
    (1,00 USD tai 0,80 EUR)
  • price: 1;USD100,EUR080;20130606T080000Z-20130607T080000ZUSD50,EUR40
    (1,00 USD tai 0,80 EUR paitsi 6.6.2013 alkaen, jolloin voimassa on alennushinta 0,50 USD / 0,40 EUR)
  • price: 1;USD100,EUR080;20130606T080000Z-20130609T080000ZUSD50,EUR40
    (1,00 USD tai 0,80 EUR paitsi aikavälillä 6.6.2013–6.9.2013, jolloin voimassa on alennushinta 0,50 / 0,40)

Myyntipakettien myynti


Myyntipaketteihin kuuluvia esineitä voi listata myyntiin esinekauppaan. Myyntipaketti näytetään tarkemmin maksutapahtuman yhteydessä, jotta käyttäjä voi tarkastella myönnettyjen esineiden listaa. Steamin hyvityskäytännön mukaan osto voidaan hyvittää tietyn ajan sisällä, jos kaikki pakettiin kuuluvat esineet ovat edelleen muokkaamattomina pelaajan tavaraluettelossa.

Myyntipakettien hinnat

Kun hinnoittelet myyntipaketteja, ota huomioon muutama asia. Steam käyttää yksittäisten esineiden hintoja määritellessään myyntipaketin hinnan ja allokoidessaan myyntipaketin tuoton suhteessa sen sisältöön. Allokoinnilla määritetään maksut workshop-kehittäjille. Yhdessä myyntipaketissa voi olla workshop-sisältöä usealta eri tekijältä tai vain myyjän omaa sisältöä.

Myyntipaketin esineen hinnoittelu:
  • Määritä jokaisen myyntipakettiin kuuluvan esineen hintatiedot.
  • Jos jotain myyntipaketin esinettä ei tulisi myydä erikseen, määritä näiden esineiden store_hidden
    -arvoksi "true" (tosi).
  • Määritä myyntipaketin price- tai price_category -kenttään yksinkertainen hinta (kuten VLV0).
    Määritettyä hintaa ei käytetä kaupassa, mutta se lähettää esinekaupalle viestin siitä, että esine on myytävissä.
  • Myyntipaketin purchase_bundle_discount-kenttään voi vaihtoehtoisesti määrittää alennuksen prosenttiosuuden.

Voit halutessasi määrittää myyntipaketille tarkan hinnan joka valuutassa. Myyntipakettihintojen ohitus hylkää kaikki määrittämäsi purchase_bundle_discount-arvot. Yksittäisiä esinehintoja käytetään myyntipakettituoton suhteellisessa allokoinnissa, joten ne on määritettävä.

Automaattisen myyntipakettihinnan ohitus:
  • Määritä haluamasi hinta myyntipaketin price- tai price_category -kentässä.
  • Määritä myyntipaketin esineen use_bundle_price-arvoksi true (tosi).

Generaattoriesineiden myynti

Älä yritä myydä generator-tyyppisiä esineitä suoraan esinekaupassa.

Jotta voit myydä esineen, jolla on satunnainen komponentti (kuten arkku), määritä arkku yksinkertaiseksi item-tyypiksi Luo sen jälkeen generaattoriesine, joka hyväksyy arkun vaihdon syötteen koontiohjeena.

Oston jälkeen pelaaja voi avata arkun, jolloin voit kutsua ISteamInventory::ExchangeItems suorittamaan generaattoritoiminnon. Arkun ostoa ei voida hyvittää arkun avaamisen jälkeen.

Valven esimääritetty hintataulukko

Tässä ovat nykyiset arvot, joiden avulla voit määrittää esineen price_category-arvon.
NimiHinta Yhdysvaltain dollareissa
VLV250,25 USD
VLV500,49 USD
VLV750,75 USD
VLV1000,99 USD
VLV1501,49 USD
VLV2001,99 USD
VLV2502,49 USD
VLV3002,99 USD
VLV3503,49 USD
VLV4003,99 USD
VLV4504,49 USD
VLV5004,99 USD
VLV5505,49 USD
VLV6005,99 USD
VLV6506,49 USD
VLV7006,99 USD
VLV7507,49 USD
VLV8007,99 USD
VLV8508,49 USD
VLV9008,99 USD
VLV9509,49 USD
VLV10009,99 USD
VLV110010,99 USD
VLV120011,99 USD
VLV130012,99 USD
VLV140013,99 USD
VLV150014,99 USD
VLV160015,99 USD
VLV170016,99 USD
VLV180017,99 USD
VLV190018,99 USD
VLV200019,99 USD
VLV250024,99 USD
VLV300029,99 USD
VLV350034,99 USD
VLV400039,99 USD
VLV450044,99 USD
VLV500049,99 USD
VLV600059,99 USD
VLV700069,99 USD
VLV800079,99 USD
VLV900089,99 USD
VLV1000099,99 USD

Esimerkki ItemDef-mallista:

{ "appid": 480, "items": [ { "itemdefid": 10, "type": "playtimegenerator", "bundle": "100x100;101x50;102x25;103x2;110x20;111x20;120x5;121x3", "name": "Drop Generator", "name_color": "7D6D00", "background_color": "3C352E", "item_slot": "generator", "icon_url": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "icon_url_large": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "tradable": false, "marketable": false }, { "itemdefid": 100, "type": "item", "name": "Hat decoration", "description": "Hat decoration description", "price": "1;USD99", "name_color": "7D6D00", "background_color": "3C352E", "item_slot": "decoration", "icon_url": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "icon_url_large": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "tradable": true, "marketable": true }, { "itemdefid": 200, "type": "item", "price": "1;VLV100", "name_english": "Red Hat", "name_german": "Roter Hut", "description_english": "Red Hat", "description_german": "Roter Hut", "store_tags": "hat;featured", "icon_url": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "icon_url_large": "http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png", "tradable": true, "marketable": true } ] }