Settings and Setup file

The different customization options this plugin offers.

---

Settings

Below are the links to each of the customizable features available in this plugin:

• Item Categories
• Badges for Items
• Discounts
• Bonus Items
• Item Limits
• Item Purchase Counter
• Seller Classes
• Shelf Classes

---

Setup

Since v1.4.0, the way you provide settings to a Mart or Shelf event has changed — and improved!

• You no longer need to worry about the order of arguments (except for the item list, which should always come first).
• Here's how you'd define a Mart event:

Each optional argument is explained below and in more detail on its corresponding Settings page.

---

speech: "string"

This lets you assign a specific Seller Class to the event.

➡️See Seller Class for more info.

---

useCat: true / false

This enables or disables Item Categories.

---

Discount: number

Use this to apply a discount by refering a Game Variable ID:

---

currency: "string"

Sets which currency the Mart or Shelf should use. Valid default values:

• "money" or "gold"
• "coins"
• "bp" or "battle points"
• :Item (new v1.7.0)

Using a Default Currency (none Item)

Using an Item Currency

If you want to use an Item as the currency for a mart store, this is not possible since v1.7.0.

The one thing you need to keep in mind when using an Item as the Currency is that you still need to define the price for each item. Because otherwise the default price will be 1.

If you're familiar with the item limit system in this plugin then understanding the little code below should not be a problem.

The Script sees the last element in the array for an Item slot as the Price. But only when the Currency is set to an Item. Otherwise this will be the limit for Poke balls if a Refresh Rate was given, if not this number will be ignored.

So now 1 Poke ball will cost 5 Heart scales. But what if you want 1 Poke ball to cost 5 Red Shards. Well then you can do it like this:

Once you did this for the other Items you should get a similar result to this:

Or when you're using the Item Limit System as well:

Attention

Very important is that first comes the Price and then the Currency. If you only put the Currency then this will be ignored. You can also not set the Item specific Currency to a none Item Currency, this will give you a warning in the console and will be ignored to prevent issues.

---

cantSell: true / false

Disables the ability to sell items in this event. This is optional and defaults to false (meaning selling is allowed).

---

billEnd: true / false

If enabled, the Mart event will end after paying the bill.

---

random: ["string", number]

Use this to select a specific or random amount of items from the given item list.

• The first element is the refresh time for items to be repicked randomly.
• The second element is the amount of items you want to be selected randomly.

Allowed refresh times are the same as the Refresh Rate for Item Limits with exception for "random" not being supported.

• select a fixed amount.

• select a random amount.

---

Attention

Note: The only options not supported for pbShelfMart (Shelf events) are useCat, cantSell and billEnd. All other options are shared between Shelf and Mart events.

Attention

Note: The only options supported for pbSpeciesMart (Species events) are speech, discount, currency and random. All other options are not supported.