Random Shop Item List Plugin

This plugin enhances your RPG Maker MZ game by managing multiple shops, each with its own memory of last used shop items. It provides functions to open shops with random items or predefined lists.

Plugin Commands

Plugin commands enable event-based interaction with the shop system:

• SceneManager.openRandomShopWithItems(eventId, itemArray, maxItemsToShow)
  Opens a shop with specified items for the event identified by eventId.
  • eventId: ID of the event calling the shop (defaults to the current event).
  • itemArray: Array of objects specifying items with properties type, id, and price.
  • maxItemsToShow: Maximum number of items to display in the shop window.
• SceneManager.openRandomShopWithLastItems(eventId)
  Reopens the last used shop items for the event identified by eventId.
  • eventId: ID of the event calling the shop (defaults to the current event).

Parameters

Plugin parameters configurable in RPG Maker MZ plugin manager:

• Default Max Items to Show: Default maximum items displayed in a shop.
  • Minimum value is 1.
  • Adjust to control default item display behavior.

Usage Notes

• Ensure correct item formatting for plugin commands.
• Use expandItemRanges function for specifying item ranges.
• Shop memory is event-specific, retaining last used shop items per event.

Examples

Example 1:

SceneManager.openRandomShopWithItems($gameMap._interpreter.eventId(), [
    {type: 1, id: 6, price: 50},
    {type: 1, id: 7, price: 200},
    {type: 2, id: 3, price: 300},
    {type: 0, id: 8, price: 150},
    {type: 1, id: 5, price: 250}
], 3);
    

Example 2:

SceneManager.openRandomShopWithItems($gameMap._interpreter.eventId(), [
    {type: 1, id: '1-10', price: 50},   // Items 1 to 10
    {type: 1, id: '20-30', price: 200}, // Items 20 to 30
    {type: 0, id: '1-20', price: 150}   // Items 1 to 20
], 5);
    

Example 3:

SceneManager.openRandomShopWithLastItems();
    

Example 4:

SceneManager.openRandomShopWithLastItems(1);
    

Example 5:

SceneManager.openRandomShopWithItems([
    {type: 1, id: 6, price: 50},         // Individual item
    {type: 1, id: '1-10', price: 100},   // Items 1 to 10 (range)
    {type: 2, id: 3, price: 200},        // Individual item
    {type: 0, id: '20-30', price: 150},  // Items 20 to 30 (range)
    {type: 1, id: 7, price: 250},        // Individual item
], 5);
    

Compatibility

This plugin is designed for RPG Maker MZ. Ensure compatibility with other plugins that modify or enhance the shop scene.

License

This plugin is provided under the MIT License. You are free to use, modify, and distribute it for commercial or non-commercial projects.