Custom Item Categories

How to create Custom Item Categories.


Custom Item Categories are where the real flexibility kicks in!
They allow you to group specific items into their own custom-defined categories, making your shop menus cleaner and more personalized.


Here's how you define them:


How it works

  • The key("Evolution Stones", etc.) is the display name of the category.
  • The :items array defines which items go to that category.
  • The optional :order sets the position of the category in the list.

If you don't assign an :order, the custom category will appear after all default categories.



Understand the Order

Default categories use the formula: pocket ID * 10.
This helps place your custom categories exactly where you want them.
Here's a reference:


CategoryOrder
Items10
Medicine20
Poké Balls30
TMs & HMs40
Berries50
Mail60
Battle Items70
Key Items80

For example:

  • If you assign your custom category an :order of 11, it will appear after "items" but before "Medicine".
  • :order => 35 would place it between "Poké Balls" and "TMs".


Image not found
Custom Item Categories

In the example shown above:

  • "Evolution Stones" appears first because its :order is 11.
  • Followed by "Type Plates" (:order = 12)
  • Then "Type Gems" (:order = 13)
  • Finally, "Medicine" appears if any item belongs to that category.
Hint

If no items in a Mart event match a given category (default or custom), that category will not be shown in the UI.