Author: Pheonix KageDesu
RPG Maker Versions: MZ, MV
URL: http://kdworkshop.net/plugins/shop
Special thanks to Raffle — the person who gave the idea and commissioned this plugin.
Warning: Map Inventory version 2.0 or higher (BASIC or PRO) is required.
Item description tooltips (on hover) require Map Inventory 2.3+.
- Open Plugin Parameters → All Shops and copy (or add) a new Shop entry.
- Set a unique ID for your shop — this ID is used in script calls to open that specific shop.
- Configure any other parameters as needed, or leave them at their defaults (if copied from an existing shop).
- All parameters have descriptions.
- It is recommended to copy an already-configured shop and then modify only the properties you need.
- Optionally, add items, weapons, and armors to the shop via the Default Goods parameter.
Items can be added to a shop via note tags (in addition to the Default Goods parameter).
Items added this way can be hidden at start, unlocked, or removed during gameplay via script calls.
<pShopConfig:SHOP_ID, CAT_ID, SELL_PRICE, BUY_PRICE [,hidden] [,noSale] [,unique]>
No quotes around values — this is a note tag, not a script call.
| Parameter | Description |
|---|---|
SHOP_ID |
The unique ID of the shop this item belongs to |
CAT_ID |
The category ID within that shop |
SELL_PRICE |
The price at which the shop sells the item to the player |
BUY_PRICE |
The price at which the shop buys the item from the player |
hidden |
(optional) Item is hidden at the start; use PSHOP_Unlock to reveal it |
noSale |
(optional) Player cannot sell this item to the shop (shop sells only) |
unique |
(optional) Player can buy this item only once per shop |
One item can have multiple
<pShopConfig>note tags to register it in different shops.
<pShopConfig:testShop, cat1, 300, 150, hidden, noSale>
These note tags modify item behavior across shops.
| Note Tag | Description |
|---|---|
<pNotForSale> |
Item cannot be sold to any shop |
<pOnlyForSale:SHOP_ID> |
Item can be sold only to the specified shop |
<pItemTrade:X,Y> |
Player must trade item ID X (quantity Y) to acquire this item |
X— the ID of the item to trade (items only, not weapons or armors)Y— the required quantity- You can add up to 5
<pItemTrade>tags to a single item or equipment entry.
<pNotForSale>
<pOnlyForSale:testShop>
<pItemTrade:5,3>
Opens the shop with the given ID (defined in Plugin Parameters → All Shops).
PSHOP_Open("testShop")Returns true if any shop is currently open.
Unlocks a hidden item so it becomes visible in the shop.
TYPE—"item","weapon", or"armor"
PSHOP_Unlock("armor", 2, "testShop")Removes an item from the shop.
Note: Does not work with items added via the Default Goods parameter.
Returns the number of times the player has bought the specified item.
PSHOP_HowManyBought("item", 22)Returns the number of times the player has sold the specified item.
PSHOP_HowManySell("item", 22)Overrides the sell price (shop → player) for a specific item in a specific shop.
PSHOP_SetSellPrice("item", 7, 300, "testShop")Overrides the buy price (player → shop) for a specific item in a specific shop.
PSHOP_SetBuyPrice("item", 7, 300, "testShop")Use
"$all"asSHOP_IDto apply the price change to all shops.PSHOP_SetBuyPrice("item", 7, 300, "$all")
Activates a discount mode for the next shop opening.
PERCENT— discount percentage (1–99)CAT_ID— (optional) category ID to limit the discount to a specific category
Call this script immediately before opening the shop. Discount mode is automatically disabled when the player exits the shop.
PSHOP_SetDiscountMode(30) // 30% off all goods
PSHOP_SetDiscountMode(10, "items") // 10% off items category onlyThis plugin has no plugin commands. All functionality is accessed via script calls (see Section 4).