Documentation
Quick InfoVersion: Alpha
Made for RPG Maker MZ 1.10.0
REQUIRED: All [CGMZ] Plugins require [CGMZ] Core placed above them in the Plugin Manager.
Quick Start GuideTo get started using this plugin, follow the below steps:
1. Set up skill equip mechanics
2. Change actor skill equip parameters as needed throughout your game via Plugin Commands
3. The plugin handles the rest
Skill EquipThis plugin allows actors to equip or unequip skills in the menu -> skill scene (Scene_Skill). A new command gets added to the Skill Type window, which shows all skills the actor has and allows them to equip or unequip skills as desired. As the game developer, you have control over when this command shows up / is enabled. There are 2 switch parameters you can set up which can make the command only display if the switch is ON, allowing you to restrict the player from always being able to switch equipped skills in the menu. This may be useful if you only want the player to be able to swap their skills in safe parts of your game, such as a town. Enable does the same thing, but instead of totally hiding the command it will cause it to display but be unselectable (greyed out).
Text CodesIn the Equip Command Name parameter, you can use the text %current which will be replaced by the current number of equipped skills and %max which will be replaced by the maxiumum number of equipped skills for that actor.
Plugin CommandsThis plugin supports the following plugin commands:
Change Max Skills
Changes an actor's maximum skills, so they will either be able to equip more or fewer skills. If the max skill amount goes down, equipped skills beyond the new (lower) maximum will be unequipped until the actor is at the new maximum.
Equip Skill
Equips a skill on the given actor. You can optionally also cause the actor to learn the skill if they do not already have the skill here, otherwise this operation will do nothing if the actor does not already know the skill. Additionally, you can forcibly equip a skill. This will remove a skill if the actor already has the maximum amount of skills equipped to make room for this skill to be equipped, otherwise the operation will do nothing if the actor is already at maximum skills.
Skill List ModesRight now, parameters exist to change if skill lists show equipped, unequipped, or both skills in the skill list. This should stay as equipped for now in most cases, but is provided in case it is required for any compatibility issues you might encounter between this plugin and any other plugins. In a future update, this functionality will be expanded on.
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_SkillEquip.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.