Equip Items - Rpg Maker MZ plugin

This plugin for Rpg Maker MZ allows you to give item slots to actors.

Items must be equipped in order to use them in battle.

Features

• New scene for equipping items.
• Visuals in menu to see occupied and max slots per actor.
• Choose between separate each actor inventory or combine them together (in battle).
• Equipment can add or substract extra slots.
• Item equip limit per actor.
• Item stacks to be more flexible with the slots (items that occupies one slot per stack, so you can have more of that item).
• Item exceptions that will be shown for everyone.
• Several parameters for have some customization.
• Automaticaly (if wanted) hides key items from scene.
• Automaticaly (if wanted) shows if the item has limit or stack size at help window.
• Command in menu or equip scene to enter the scene.
• Several tags to customize these features.
• Some plugin commands and script calls to equip/unequip items.
•  Autorefill option -> Save a list of items per actor that will try to equip/refill  automatically post every battle.
• Add a custom background for the scene.
• Disable the background blur.
• Customization of thw visibility of frames and backgrounds of the windows.

Pressing shift will save the actual equipped item list to the autorefill list.

At the end of every battle it will try to automatically refill equipped items slots with that list. If the party inventory doesn't have enough items to fullfill the task, the item will be gray (for info purposes).

Notetags

Item notetags

<Always show>  Makes that item to be always shown in battle and to be hidden in the scene.

<Always show: x>  Like before but for only the actors you want

<Equipped limit: x>  Gives that item a maximum quantity to be allowed to equip

<Stack size: x>  This makes that item to be able to ocuppy just one slot per stack (better explanation in guide link)

<Hide item: b>  Hides the item from item equip scene 

Actor and class notetags

<Base item slots: x>  Makes that actor or class to have an overriden value for slots, if both are used the actor one will override class

<Item slots: +-x>  Add or substract slots

Weapon and armor notetags

<Item slots: +-x>  Add or substract slots

Plugin commands

• SetActorBaseSlots actorId amount
• ChangeActorBaseSlots actorId amount
• ForceEquipBattleItem actorId itemId amount
• UnequipAllBattleItems actorId
• UnequipBattleItem actorId itemId amount
• ShowEquipBattleItemsMenuCommand bool
• OpenEquipItemsScene

Script calls

• $gameActors.actor(id).equipBattleItem(item)
• $gameActors.actor(id).unequipBattleItem(item)
• $gameActors.actor(id).getEquippedBattleItems()

Compatibility

Tested and made for Rpg Maker MZ 1.9.1; this plugin may not work in older versions

Terms of Use

• These plugins may be used in free or commercial games.
• ‘Lheku Qhukyaru’ must be given credit in your games.
• You must link this website https://lhekussanctuary.wordpress.com/.
• Do NOT change the filename, parameters, and information of the plugin.
• You are NOT allowed to redistribute these plugins.
• You may NOT take code for your own released plugins without credit.
• You are allowed to edit the code as long as it’s for your own project.
• You CANNOT use any of these resources for NFT or any related or similar type of games.

You can also check them at:

https://lhekussanctuary.wordpress.com/tos

Changelog

V1.24 (27/05/2025) -> If the background is disabled, now the opacity will be 0. Fixed autorefill window issues.
V1.23 (24/05/2025) -> If there's only one party member, the command will open the scene directly
V1.22 (24/05/2025) -> Added configuration for the windows and custom background
V1.21 (02/12/2024) -> Autorefill fix
V1.2 (19/08/2023) -> Release

MV version