Item Limits

How to enable and use Item Limits.

This plugin allows you to limit how many of a specific item can be purchased from a Mart — and define how often that stock refreshes.


You can control the restock frequency using one of these options (case-insensitive):


SettingTime
"daily"every day
"2daily"every 2 days
"weekly"every week
"random"between 1 and 7 days
"never"no restocking

Example Setup

Here's a Mart event that uses various item limits:

1
def pbSomeMart
2
pbPokemonMart(["Daily",
3
[:POKEBALL, 15, 20], [:GREATBALL, 10, 15], [:ULTRABALL, 5, 10],
4
[:POTION, 10, 15], [:SUPERPOTION, 8, 12], [:HYPERPOTION, 5, 8], [:MAXPOTION, 2, 5],
5
:FULLRESTORE, [:REVIVE, 1, 4],
6
[:ANTIDOTE, 5], :PARALYZEHEAL, :AWAKENING, :BURNHEAL, :ICEHEAL,
7
:FULLHEAL,
8
:REPEL, :SUPERREPEL, :MAXREPEL,
9
:ESCAPEROPE
10
], useCat: true)
11
end

How it works

  • Each limited item must be wrapped in an array: [itemID, min, max (optional)].
  • If you give both min and max, the available quantity is chosen randomly between those numbers.
  • If you only give min, then the limit (for that item) is always exactly that number.
  • If you want an unlimited item, just list it normally (like :FULLRESTORE or :ESCAPEROPE).

Visual Example

Image not found
Item Limit Max Buyable

The Screenshot above shows the maximum we can buy — in this case, 11.
Once you reach this number...

Image not found
Item Limit Out of Stock

...the item becomes unavailable and shows an "Out of Stock" message:

Image not found
Item Limit Out of Stock Message

The message tells the player how long to wait for a restock, depending on the refresh setting you used ("daily", "2daily", etc.).

Hint

To instantly restock all Marts (useful for testing), run this in a script: forcePokemonMartRefresh