Toggle through, and use, items on the game map!

Designed for use alongside Action Battle Systems!

Press a button to toggle backward and/or forward through active items and press a button to use it!

Set up your items in the database as you normally do, giving them all effects you desire including executing a common event on item use!

Includes everything you need to display the Current Active Item, Next Active Item, Previous Active Item and Quantity of active item on a HUD! (HUD not included)

Easy to work with plugin parameters for quick and easy setup!

Easily customize the Pop Up Display position to your needs using Developer Mode!

Use whatever size images you wish for your Pop Up Display Items, or if Icons are more your thing you can use those instead!

 Easily configure toggle buttons & use item button right in plugin parameters!

No script calls required! All script calls are optional. You can find script calls below.

Configure the plugin parameters to your needs and you're good to go!

Script Calls: 

(script calls are 100% optional but may be useful for some users)

Ritter.ActiveItem_System.toggle("forward")

• Cycles through items in a forward direction.

Ritter.ActiveItem_System.toggle("backward")

•  Cycles through items in a backward direction.

 Ritter.ActiveItem_System.useItem()

• Uses the active item.

The following script calls are used to fetch data for purposes such as displaying the data for a HUD created using HUD Maker or other scripts.

Ritter.ActiveItem

• returns the Item Database ID # of the active item.

Ritter.ActiveQuantity

• returns the quantity # of the active item.

Ritter.PrevItem

• returns the ID # of the previous item in cycle.

Ritter.NextItem

• returns the ID # of the next item in cycle.

Developer Mode!

In Developer Mode the developer has access to buttons which adjust the position and scale of the Pop Up Display. Once the desired positioning and scale is found Simply take the values you are given on screen and place them in the plugin parameters for each offset and scale.

Install instructions:

Download the plugin file and place it in your projects js/plugins folder.

Open the plugin manager and add Ritter_ActiveItem_System Plugin.

Configure the plugin parameters to suit your needs. Be sure to read the description of each parameter.

Please take note of the plugin parameter 'Use On/Off Switch'.
This parameter allows for the Active Item System to be tied to a specific Game Switch.
This allows for the system to be enabled or disabled based on whether that switch is set to true or false.
This allows you to turn the system off whenever you want so that the player can not toggle through and use active items.
If 'Use On/Off Switch' is set to true and no switch is assigned, or if a switch is assigned and is set to false, it will appear as if the Active Item System is not functioning.

Optional:

Create Image files to be used for your active items and place them inside your projects img/pictures folder. (48x48 images shown in video).

Be sure to name the images the ID of it's corresponding item as shown below. If any pictures are missing you will be thrown an error.
The ID will be the ID # of the item(s) found within the RPG Maker MZ editors Item Database.

Image files only required if not using Icons from your projects Iconset. Choose Images or Icons in plugin parameters.

That's all you have to do! Now playtest your game and try it out!

Included in this download:

Ritter_ActiveItem_System.js

Gives ability to toggle through and use active items.

Gives ability to have Pop Up Display above characters head. (images not included).

Gives ability to display active, previous, and next item information on hud in addition to the Pop Up Display on item toggle. (hud not included).

License to use in commercial and non-commercial games.

Dependency:

NONE!

Terms of Use:

• You are granted non-exclusive rights to use this plugin for Commercial and Non-Commercial Use in as many projects as you wish to create.
• Do not redistribute this plugin without permission.
• Do not take code from this plugin without permission.
• Do not remove my name from @Author.
• Do not take credit for creating this plugin.
• Editing of code is allowed as long as it's within plugin file.
• I do not offer support for any changes made to plugin code.
• While it's not mandatory please consider crediting me in your game credits:
  • (Something similar to this would be great)
  • Active Item System Plugin
  • Craig "Ritter" Barger
  • https://notritter.itch.io/