Casper Gaming Developer Corner
Casper Gaming Developer Corner

Documentation

Back to Plugin


Quick InfoVersion: Alpha
Made for RPG Maker MZ 1.9.0

Quick Start GuideAfter importing this plugin into the Plugin Manager, you need to set up your conditions via the plugin parameters for Weapon or Armor Conditions. Select the weapon / armor you want to add conditions to, add your condition, and then save the your project and the conditions will be active. Read below for conditions available to you.

ConditionsThis plugin supports the following conditions on gear:

Actor-based conditions:

Min & Max Level
Allow your actors to equip gear if they are over or under (or both) a min/ max level. This can be used to prevent actors from equipping gear that is too strong for their current level, or to cycle out old equipment.

Actor IDs
You can make equipment only available for certain actors by actor id. Maybe your main character gets special equipment, or a hidden character is the only one who can equip the ultimate sword.

Class IDs
Just like actors, you can make equipment only available for certain classes. If you want your Dragon sword to be a sword type but only available to actors with the Dragon Knight class even though other classes can also use swords in your game, now you can do that.

Gold-based conditions:

Min & Max Gold
I don't expect this to be used too often, but it was easy to provide, so now you can make it so only rich actors can equip certain gear, or maybe provide a boost to actors with little money to their name. I am sure someone out there can find a use for this.

Other conditions:

Switches
You can prevent equipment from being used while certain switches are OFF. Switches (and variables) are pretty unlimited in how they can be used, but one use case might be to turn a switch ON when a quest is accepted, and then allow the player to use special quest equipment, then turn the switch OFF when your quest is completed and the player will no longer be able to use that equipment.

Variables
Like switches, these are pretty unlimited in what they can be used for since just about everything can interact with a variable.

Map
Prevent the player from using equipment unless they are on certain maps. You could make some safari area where the player can use much more powerful gear than normal, but only in that area. Or maybe your player cannot use certain gear in enemy territory to avoid giving themselves away as an outsider. There are many uses for location-based gear.

Plugin CommandsThis plugin supports the following plugin commands:

Remove Unequippables - By default, not all equip conditions changing will cause the game to check each actor's equipment. This means you could equip gear while possible, and still have it equipped if a condition turns to false. This plugin command will check for any currently equipped gear that is no longer valid for that actor and send it back to the inventory.

Saved GamesThis plugin is fully compatible with saved games. This means you can:

✓ Add this plugin to a saved game and it will work as expected.
✓ Change any plugin params and changes will be reflected in saved games.
✓ Remove the plugin with no issue to save data.

Filename

The filename for this plugin MUST remain CGMZ_EquipConditions.js. This is what it comes as when downloaded. The filename is used to load parameters and execute plugin commands. If you change it, things will begin behaving incorrectly and your game will probably crash. Please do not rename the js file.


Known Issues

This plugin currently has no known issues that need to be fixed. If you believe you have encountered a bug, please report it to Casper Gaming.


Compatibility

This plugin currently has no known compatibility issues with other RMMZ plugins. If you believe you have encountered a conflict, please report it to Casper Gaming.

Back to Plugin