Skip to content

Market

Market schema

Since VCMI-1.3 it's possible to create customizable markets on adventure map. Markets can be added as any other object with special handler called "market".

Here is schema describing such object

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
"seafaringAcademy" : //object name
{
    "handler" : "market", //market handler
    "name" : "Seafaring Academy",
    ... //describe any other regular parameters, such as sounds
    "types" : {
        "object" : { //object here is a type name
            ... //describe any other regular parameters, such as aiValue or rmg
            "modes": ["resource-skill"], //modes available for market
            "offer": ["navigation"], //optional parameter - specific items, must be presented on market
            "title": "Seafaring Academy", //optional parameter - title for market window
            "efficiency": 5, //market exchange rate, equivalent to amount of markets of certain type owning by player
            "speech": "", //optional parameter - extra message showing on market
            "resources": [], //optional parameter - resources that can be traded on this market. All resources by default
            "effectiveness": 1.0, //optional parameter - overrides exchange effectiveness that is normally derived from efficiency

            "templates" : {
                ... //describe templates in a common way
            }
        }
    }
}

Modes

Mode parameter defines a way to exchange different entities. Multiple modes can be specified to support several types of exchange. Following options are supported:

  • "resource-resource" - regular resource exchange, like trading post
  • "resource-player" - allows to send resources to another player
  • "creature-resource" - acts like freelance guild
  • "resource-artifact" - black market
  • "artifact-resource" - allows to sell artifacts for resources
  • "artifact-experience" - acts like altar of sacrifice for good factions
  • "creature-experience" - acts like altar of sacrifice for evil factions
  • "creature-undead" - acts like skeleton transformer
  • "resource-skill" - acts like university, where skills can be learned

Examples

Trading post

Trading post allows to exchange resources and send resources to another player, so it shall be configured this way:

1
"modes" : ["resource-resource", "resource-player"]

Black market

1
"modes" : ["resource-artifact"]

Freelance guild

1
"modes" : ["creature-resource"]

Altar of sacrifice

Altar of sacrifice allows exchange creatures for experience for evil factions and artifacts for experience for good factions. So both modes shall be available in the market. Game logic prohibits using modes unavailable for faction

1
"modes" : ["creature-experience", "artifact-experience"]

Resources and exchange rate

By default markets with resource-resource mode trade all resources, at a rate that depends on efficiency and on the price of exchanged resources.

The resources field limits which resources such market trades - resources that are not listed will not be shown in market window and can not be traded.

The effectiveness field replaces the effectiveness that is normally derived from efficiency. Price of the wanted resource is divided by it, so 1.0 means trade at nominal price of resources, and 0.5 means twice as expensive. Regular markets never go above 0.5, so resources of the same price can not be traded better than 2:1 without this field.

Example for Warlock's Lab

Lab that transmutes precious resources into each other at 1:1 rate:

1
2
3
"modes" : ["resource-resource"],
"resources" : ["mercury", "sulfur", "crystal", "gems"],
"effectiveness" : 1.0

Offer

This field allows to configure specific items available in the market. It can be used only for resource-skill mode

See Secondary skills description for more details

Example for University of magic (e.g conflux building)

1
2
"modes" : ["resource-skill"],
"offer" : ["airMagic", "waterMagic", "earthMagic", "fireMagic"]

Example for regular University

1
2
3
4
5
6
7
"modes" : ["resource-skill"],
"offer" : [ //4 random skills except necromancy
    { "noneOf" : ["necromancy"] },
    { "noneOf" : ["necromancy"] },
    { "noneOf" : ["necromancy"] },
    { "noneOf" : ["necromancy"] }
]