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ä:
Nimi | Kuvaus |
item | Esinetyyppi, joka sijaitsee pelaajan tavaraluettelossa. |
bundle | Myyntipaketti edustaa ItemDef-esinemäärityskokoelmaa sekä kunkin tyypin määrää. Kun tämä esine myönnetään, se on automaattisesti laajempi myyntipaketin bundle esinejoukko. |
generator | Generaattori 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.) |
playtimegenerator | Tämä on generator -määrityksen erityismuoto, joka voidaan myöntää kutsumall ISteamInventory::TriggerItemDrop sovelluksesta. |
tag_generator | Tä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
Nimi | Kuvaus |
appid | Sovelluksen tunnus |
name | Esineen 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ä. |
description | Esineen 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_type | Esineen "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ä. |
itemdefid | Tämän Itemdef-määrityksen tunnus. Sen tulee olla pienempi kuin 1 000 000 niille esineille, jotka eivät ole workshop-esineitä. |
type | Sisäinen arvo. ('item' | 'bundle' | 'generator' | 'playtimegenerator' | 'tag_generator') |
bundle | Katso kohta myyntipaketti- tai generoitavat esineet alempana tässä dokumentaatiossa. |
promo | Katso kohta promoesineiden muoto alempana tässä dokumentaatiossa. |
drop_start_time | UTC-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). |
exchange | Katso kohta vaihtamisen muoto alempana tässä dokumentaatiossa. |
price | Katso kohta hinnan määritys alempana tässä dokumentaatiossa. |
price_category | Esimääritetty hinta, jonka eri valuutta-arvoista huolehdimme puolestasi. Katso kohta hinnan määritys alempana tässä dokumentaatiossa. |
background_color | Tavaraluettelon taustan väri heksadesimaalijärjestelmän 6-merkkisenä tunnuksena. |
name_color | Tavaraluettelon nimen väri heksadesimaalijärjestelmän 6-merkkisenä tunnuksena. |
icon_url | Esineen 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_large | Esineen 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. |
marketable | False/true (epätosi tai tosi). Määrittää, voidaanko esine myydä muille käyttäjille Steam-yhteisön kauppapaikalla. |
tradable | False/true (epätosi tai tosi). Määrittää, voiko esineen vaihtaa muiden käyttäjien kanssa Steam-vaihdoissa. |
tags | Katso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet. |
tag_generators | Lista tunnistegeneraattorin tag_generator-esinemääritystunnuksista, joita voi käyttää (katso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet). |
tag_generator_name | Tunnisteluokan nimen tunnus (katso lisätietoa täältä: Steamin tavaraluettelon esinetunnisteet). |
tag_generator_values | Lista tunnisteiden arvoista ja niiden valintojen todennäköisyydestä (katso Steamin tavaraluettelon esinetunnisteet). |
store_tags | Merkkijono, joka sisältää puolipisteellä (;) erotetut tunnisteet, "tags". Näitä tunnisteita käytetään sovelluksen esineiden luokitteluun/suodatukseen Steamin kaupassa. |
store_images | Kuvien URL-osoitteet, eroteltu ";"-merkillä. Kuvat tallennetaan välityspalvelimelle. Niitä käytetään sovelluksen Steamin esinekaupan lisätietosivulla. |
game_only | False/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ä. |
hidden | False/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_hidden | False/true (epätosi tai tosi). Jos true, esine piilotetaan sovelluksen osalta Steamin esinekaupassa. Hinnoitellut esineet näytetään oletusarvoisesti kaupassa. |
use_drop_limit | False/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_limit | Integer (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_interval | Integer (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_window | False/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_window | Integer (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_window | Integer (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_manually | False/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_price | False/true (epätosi tai tosi). Katso kohta Myyntipakettien myynti alempana tässä dokumentaatiossa. Oletusarvo on false. |
auto_stack | False/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ä
- 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
- 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"
- 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.
Nimi | Kuvaus |
price | Määritä hinta jokaisessa valuutassa. Jos valuuttaa ei ole määritetty, se muunnetaan automaattisesti ostohetkellä. |
price_category | Mää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.
Nimi | Hinta Yhdysvaltain dollareissa |
VLV25 | 0,25 USD |
VLV50 | 0,49 USD |
VLV75 | 0,75 USD |
VLV100 | 0,99 USD |
VLV150 | 1,49 USD |
VLV200 | 1,99 USD |
VLV250 | 2,49 USD |
VLV300 | 2,99 USD |
VLV350 | 3,49 USD |
VLV400 | 3,99 USD |
VLV450 | 4,49 USD |
VLV500 | 4,99 USD |
VLV550 | 5,49 USD |
VLV600 | 5,99 USD |
VLV650 | 6,49 USD |
VLV700 | 6,99 USD |
VLV750 | 7,49 USD |
VLV800 | 7,99 USD |
VLV850 | 8,49 USD |
VLV900 | 8,99 USD |
VLV950 | 9,49 USD |
VLV1000 | 9,99 USD |
VLV1100 | 10,99 USD |
VLV1200 | 11,99 USD |
VLV1300 | 12,99 USD |
VLV1400 | 13,99 USD |
VLV1500 | 14,99 USD |
VLV1600 | 15,99 USD |
VLV1700 | 16,99 USD |
VLV1800 | 17,99 USD |
VLV1900 | 18,99 USD |
VLV2000 | 19,99 USD |
VLV2500 | 24,99 USD |
VLV3000 | 29,99 USD |
VLV3500 | 34,99 USD |
VLV4000 | 39,99 USD |
VLV4500 | 44,99 USD |
VLV5000 | 49,99 USD |
VLV6000 | 59,99 USD |
VLV7000 | 69,99 USD |
VLV8000 | 79,99 USD |
VLV9000 | 89,99 USD |
VLV10000 | 99,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
}
]
}