Town. Mercantile

Table of Contents:

• General
• Purchasing
• Storage
  • Shop Matrix
  • Prices
  • Extra Items
  • Finite Quantity Items
  • Internal Array
  • Initial Values
• Items
  • Basic List
  • Extended Description
    • Food
    • Tools
      • Fish Hooks
      • Lantern and Matches
      • Revolver and Bullets
• Assets
  • Inner
  • Outer
    • Main
    • Doors

Table of contents generated with markdown-toc.

General

As in every other shop, player can use mercantile's internal screen to turn dollars into food or tools.

As in real life, purchasing items increases possessions list, but reduces cash holdings.

Purchasing

Player purchase up to 10 food items and 10 tools only i.e. only until filling up everything that he carries with him. If his own "pocket" is full he sees the following error message instead:

This happens even, if player has previously purchased a donkey at the stable. This is because purchasing directly to phoneys is not possible. Player must first use point-and-move feature of Food Inventory or Tools Inventory, to make up some space in his "pocket" before he can purchase more things.

Storage

Shop Matrix

Mercantile offers 28 different food items and goods located in 7x4 matrix:

1 Bread	2 Eggs	3 Beacon	4 Steak	5 Coffee	6 Chicken	7 Hash
8 Beans	9 Whiskey	10 Cheese	11 Anti-Venom	12 Skillet	13 Fish Hooks	14 Coffee Pot
15 Knife	16 Pan	17 Gloves	18 Rope	19 Lantern	20 Blanket	21 Matches
22 Pick	23 Shovel	24 Map	25 Revolver	26 Bullets	27 Long Johns	28 Empty Canteen

The 00 are suggested internal IDs for products offered at Mercantile or obtained in the other way.

Prices

Here is the list of all items that can be purchased in our game along with proposed internal ID and item's price.

ID	Name	Price ($)	ID	Name	Price ($)
1	Bread	10	15	Knife	20
2	Eggs	5	16	Pan	35
3	Beacon	10	17	Gloves	10
4	Steak	25	18	Rope	30
5	Coffee	25	19	Lantern	20
6	Chicken	35	20	Blanket	30
7	Hash	15	21	Matches	5
5	Coffee	25	19	Lantern	20
6	Chicken	35	20	Blanket	30
7	Hash	15	21	Matches	5
8	Beans	15	22	Pick	65
9	Whiskey	20	23	Shovel	50
10	Cheese	10	24	Map	10
11	Anti-Venom	150	25	Revolver	200
12	Skillet	25	26	Bullets	50
13	Fish Hooks	20	27	Long Johns	20
14	Coffee Pot	35	28	Empty Canteen	15

Items' function and descriptions are given below.

Extra Items

In addition to above list we also need other IDs for some extra items.

These items cannot be purchased at the shop, but can be carried in Food Inventory or Tools Inventory:

• 29 Full Canteen -- to denote changed states of canteen
• 30 Snake -- when you shot one
• 31 Small Fish -- caught at the river
• 32 Big Fish -- (same as above)

These items are stored internally in the same items array, but without (or with zeroed) price.

Finite Quantity Items

Last group of IDs are bags of gold that can be panned at the river or picked at the mine or in the cave.

• 33 Small Bag of Gold Grade 0
• 34 Small Bag of Gold Grade 1
• 35 Small Bag of Gold Grade 2
• 36 Small Bag of Gold Grade 3
• 37 Small Bag of Gold Grade 4
• 38 Big Bag of Gold Grade 0
• 39 Big Bag of Gold Grade 1
• 40 Big Bag of Gold Grade 2
• 41 Big Bag of Gold Grade 3
• 42 Big Bag of Gold Grade 4

Bags of gold and bullets (and in the future possibly matches as well) are the only in-game items that can have more than 1 count when stored in Tools Inventory, for example:

That's why we are using multi-dimensional array to store them in player's tools inventory.

Internal Array

Implemented in: #126.

The above can be represented internally using an array like this one:

let items = [
    [1, 'Bread', 10],
    [2, 'Eggs', 5],
    [3, 'Beacon', 10],
    [4, 'Steak', 25],
    [5, 'Coffee', 25],
    [6, 'Chicken', 35],
    [7, 'Hash', 15],
    [5, 'Coffee', 25],
    [6, 'Chicken', 35],
    [7, 'Hash', 15],
    [8, 'Beans', 15],
    [9, 'Whiskey', 20],
    [10, 'Cheese', 10],
    [11, 'Anti-Venom', 150],
    [12, 'Skillet', 25],
    [13, 'Fish Hooks', 20],
    [14, 'Coffee Pot', 35],
    [15, 'Knife', 20],
    [16, 'Pan', 35],
    [17, 'Gloves', 10],
    [18, 'Rope', 30],
    [19, 'Lantern', 20],
    [20, 'Blanket', 30],
    [21, 'Matches', 5],
    [19, 'Lantern', 20],
    [20, 'Blanket', 30],
    [21, 'Matches', 5],
    [22, 'Pick', 65],
    [23, 'Shovel', 50],
    [24, 'Map', 10],
    [25, 'Revolver', 200],
    [26, 'Bullets', 50],
    [27, 'Long Johns', 20],
    [28, 'Empty Canteen', 15],
    [29, 'Full Canteen', 0],
    [30, 'Snake', 0],
    [31, 'Small Fish', 0],
    [32, 'Big Fish', 0],
    [33, 'Small Bag of Gold Grade 0', 0],
    [34, 'Small Bag of Gold Grade 1', 0],
    [35, 'Small Bag of Gold Grade 2', 0],
    [36, 'Small Bag of Gold Grade 3', 0],
    [37, 'Small Bag of Gold Grade 4', 0],
    [38, 'Big Bag of Gold Grade 0', 0],
    [39, 'Big Bag of Gold Grade 1', 0],
    [40, 'Big Bag of Gold Grade 2', 0],
    [41, 'Big Bag of Gold Grade 3', 0],
    [42, 'Big Bag of Gold Grade 4', 0]
];

Initial Values

When starting a new game price (last element) of the arrayshould be set to:

• For IDs from 1 to 28 to match food or tool item price
• For IDs from 29 to 32 to 0 and this value never changes throughout entire game for these items (as above)
• For IDs from 33 to 42 to match actual bag of gold's value (equal to grade * 10)

Items

Basic List

Here is the same list as below only this time with description of given item -- for what or how it is used, which properties and how does having, eating or using it changes etc. If some items has a complex influence to the gameplay, it was further explained below this table:

ID	Name	Description or Properties' Modifier
1	Bread
2	Eggs
3	Beacon
4	Steak
5	Coffee
6	Chicken
7	Hash
8	Beans
9	Whiskey
10	Cheese
11	Anti-Venom
12	Skillet
13	Fish Hooks	Needed for fishing; see below
14	Coffee Pot
15	Knife
16	Pan
17	Gloves
18	Rope
19	Lantern	Absolutely crucial to enter (see anything inside) caves or mines; see below
20	Blanket
21	Matches	Absolutely necessary to enter (see anything inside) caves or mines; see below
22	Pick
23	Shovel
24	Map
25	Revolver	Needed in fight; see below
26	Bullets	Needed in fight; see below
27	Long Johns
28	Empty Canteen

Extended Description

Here you'll find descriptions for only those items that has "see below" note in the above list.

Food

Tools

Fish Hooks

Internal ID: 13.

Needed for fishing. It is enough that you carry one piece. It doesn't matter if you have it with you or on one of your donkeys.

Lantern and Matches

Internal IDs: 19 and 21.

You need both to enter cave or mine and see something inside.

Since mines and caves are only place where you go without your phoneys, you must carry your lamp with you. Having it on one of your donkeys doesn't solve the problem.

Matches are different story. We assume that you can light up your lantern before going into the hole in mountain. Therefore you can carry your matches with you or with your donkey.

Revolver and Bullets

Internal IDs: 25 and 26.

You need it when dealing with Indians, outlaws or snakes.

It is enough that you carry one piece. It doesn't matter whether you have it with you or with on one of your phoneys.

See here for details on how to use it in fight.

Assets

Inner

Outer

Main

Doors

Location (in the above base image): 355 x 324 px.

Dimensions (in the 4K / 3840x2160 px resolution): 356 x 410 px.

	Day	Dusk Opened	Dusk Closed	Night
Image
Period	07:00 -- 16:55	17:00 -- 17:55	18:00 -- 18:55 05:00 -- 06:55	19:00 -- 04:55

The above images are given as an example and for visualisation purposes only. In reality there will be only two images:

• Open that will be switch to closed at 18:00
• Closed that will be switched back to open at 07:00

And the graphical/color effects of day, dusk, night and dawn will be achieved using color filter.