The merchant has three main values that gets used for the bargain:
the selling item (the item is selling to you),
the currency (the item used as currency),
the price (the item quantity needed for the trade).
For example, the shroom guy in the Philosopher’s Forest wants you to get 9 Shrooms, this speech (sale lines) is usually presented right after the introduction.
While you haven’t collected the wanted amount of shrooms, the merchant will trigger the not-enough-currency lines.
Once you got all the shrooms, the trading speech (selling line) will show up.
Once finished with the selling line, that’s finished you will get the sold lines and your item will be automatically worn on you (if the selling item is wearable).
Adding a new merchant
Navigate to the Content Manager page.
Scroll until you find an header “NPCs”.
Click on the Create a NPC button found on the right side. A prompt will show up asking the necessary details for your merchant. The following image is how it should look like.
Select the appropriate type for your merchant (click on merchant) and write a recognizable name for your merchant, you won’t be able to change it later!
Click on Select sprite.
A new prompt will show up asking you to select a sprite for your merchant.
After selecting your file, click Open.
Make sure the row and column count align with your sprite sheet.
Click Add NPC and you should see your NPC below “Merchants”.
Changing a merchant’ setting
Navigate to the Content Manager page.
Scroll until you find an header “NPCs”.
Click on the merchant you’d like to edit its settings.
A prompt will show up with the merchant’ settings, from here you can modify as you will.
Changing a merchant’ speech
Navigate to the Content Manager page.
Scroll until you find an header “NPCs”.
On the NPC you are looking to modify, click on the blue button that contains a text bubble.
A prompt will show up with the merchant’ quotes, from here you can modify as you will.
Removing a merchant completely
Navigate to the Content Manager page.
Scroll until you find an header “NPCs”.
On the merchant you are looking to modify, click on the red button that contains a trash bin.
A prompt will show up asking for confirmation of your deletion. Click Yes, delete if you are completely sure.
After clicking it, your merchant will be removed completely. And you shouldn’t see it both in the Content Manager and Screens pages.
Steps (without Worldsmith)
Retexturing a merchant NPC
To replace a spritesheet of a NPC:
Convert a new image into a packed XNB file.
Name it as the NPC you want to retexture.
Place the file in props/textures/merchant and replace the file.
If you modified the sprite sheet, you will need to modify the sprite sheets and the animation settings inside your NPC’s configuration file (that you can find in props/textures/old_man/merchant).
Merchant additions
In addition the massive list of settings that the normal NPC brings, the merchant adds even more:
Selling item settings
Setting the merchant’s selling item
Search for the sale_item tag.
Modify the sale_item to the item you want to use give to the user.
Setting the merchant’s selling currency
Search for the currency_type tag.
Modify the currency_type to the item of currency you want to use. It is recommended that you use an item that is stackable.
Setting the merchant’s selling price
Search for the price_increase tag.
Modify the price_increase to the payment value. If it’s higher than 1, make sure your currency item is stackable, otherwise it can not be redeemable.
Sale lines (before payment)
Setting sale lines
Search for the sale_lines tag.
Get rid of all the string tags that could be present.
Copy the following snippet:
<string>YOUR_STRING_HERE</string>
Replace YOUR_STRING_HERE with your “selling this item” string.
You can add as many strings as you want, just copy the snippet in a line after your closing string tag and replace YOUR_STRING_HERE with your second, third… string.
You can even add as many quotes as you want by copying the OldManQuote tag and pasting it below the closing tag of the previous OldManQuote.
Selling line (during payment)
Setting the selling line
Search for the sell_quote tag.
Get rid of all the string tags that could be present.
Copy the following snippet:
<string>YOUR_STRING_HERE</string>
Replace YOUR_STRING_HERE with your “im selling you this item as we speak” string.
You can add as many strings as you want, just copy the snippet in a line after your closing string tag and replace YOUR_STRING_HERE with your second, third… string.
Sold lines (after payment)
Setting sold lines
Search for the sold_lines tag.
Get rid of all the string tags that could be present.
Copy the following snippet:
<string>YOUR_STRING_HERE</string>
Replace YOUR_STRING_HERE with your “sold this item to you” string.
You can add as many strings as you want, just copy the snippet in a line after your closing string tag and replace YOUR_STRING_HERE with your second, third… string.
You can even add as many quotes as you want by copying the OldManQuote tag and pasting it below the closing tag of the previous OldManQuote.
Not-enough-currency lines
Setting not-enough-currency lines
Search for the no_gold_lines tag.
Get rid of all the string tags that could be present.
Copy the following snippet:
<string>YOUR_STRING_HERE</string>
Replace YOUR_STRING_HERE with your “you don’t have enough of this item” string.
You can add as many strings as you want, just copy the snippet in a line after your closing string tag and replace YOUR_STRING_HERE with your second, third… string.
You can even add as many quotes as you want by copying the OldManQuote tag and pasting it below the closing tag of the previous OldManQuote.
Speech extensions
If you want to display the price in-game through a speech, use [gold_count] as the value.
