[CGMZ] Item Popup (Patreon)

Show a brief information window the first time a player obtains an item in your game. Plugin commands for additional control are provided.

! SEE BOTTOM OF POST FOR UPDATES !

Hi all, introducing [CGMZ] Item Popup!

This plugin shows an item window with information about an item the first time the player obtains an item. Subsequent times the player obtains the item, the window will no longer display automatically. See below gif for how it can look:

 Of course, you can control this feature including always showing the item popup if desired, or telling the game to "forget" that an item popup has been displayed before.

You can also disable adding items to the queue to display, or disable items from displaying but still add them to the queue to display later once displaying is turned back on. These options can help out when your player gains items in cutscenes, where you may not want the popup to occur.

You can also manually display an item's popup via plugin command.

Want additional features not already present/listed above? Make suggestions in the comments below or in my discord under the #suggestions channel!

This version adds the much requested feature of being able to display a picture instead of an icon for each item. The image size is still expected to conform to the icon width / height settings, but if there is a lot of demand for custom sizes I can look into adding that in a future update.

This update also added some better handling for the item popup scene, as you can now choose to also allow ok input to exit the scene. Further, you can now set a minimum amount of frames for which the scene must display before input can exit the scene.

Some bugs were also fixed. Previously, an item could queue multiple times if it was gained multiple times before its item popup displayed, this is now fixed. It will also no longer attempt to queue the item popup when losing items. A crash was fixed that could have occurred if trying to display an item popup for an invalid item.

This version adds some quality of life changes. The plugin commands for enable / disable of popup display and queueing have been converted into using game switches instead. Set up the display or queue switch parameter, then turn that switch on/off in game to enable or disable item popup display or queue ability temporarily.

The item popup window now displays a brief opening animation. You can now add a custom space to the item popup window.

Some integrations were also added. The window style, tone, windowskin, etc. are now handled by [CGMZ] Window Settings. The item popup window can also show a background image through [CGMZ] Window Backgrounds.

This version splits the settings for scene customization into separate settings for items, weapons, and armors. You can now show different info for each type of object. Previously, they were all the same, which limited customization. You can also now opt to not show items, weapons, or armors at all. This can be useful if you want to only show popups for items but not armors or weapons.

Each item can now have a custom sound effect that plays for that item only. If this is not set up, it will fall back to the global sound effect. Each item can also have a custom scene background, window background, and window setting id. If those are not provided, the default will be used.

You can now change the x/y coordinate of the item popup window.

This version adds the option to never show automatic item popups for items, weapons, or armors by id. Simply set their id up and you will not see the item popup for those objects. This does not affect manual display on item popups, so you can still manually show popups for those items if desired.

This update also adds an integration with [CGMZ] Rumble, allowing you to cause the player's controller to rumble when an item popup displays.