Casper Gaming Developer Corner
Casper Gaming Developer Corner

Documentation

Back to Plugin


Quick InfoVersion: Alpha R4
Made for RPG Maker MZ 1.9.0

Main FeaturesSKILL LEVELS
Add levels to skills. For the player, this means the more you cast a skill, the higher level it will be and the stronger it will be. This can incentivize some grinding without making it feel like as much of a chore. Enemies can also have skill levels. Enemy skill levels belong to the enemy and will not level up as used. Enemy skill levels are for formula purposes only.

Minor FeaturesSKILL LEVEL SCENE
See the levels of your skills and how close you are to the next level via a skill level scene. This can be called using plugin command or the below JavaScript. This scene supports page up / page down functionality to switch between actors, if not forcing party-wide or actor-specific skills to be shown.

ENEMY SKILL CUSTOMIZATION
Your enemies can also use skill levels. You need to set enemy skills up via the Enemy Skills parameter. Enemies not set up through this parameter will always use level 0 skills. Your enemies can have a fallback min/max if no specific skill levels exist for that enemy. Otherwise, the plugin will use the min/max assigned to the specific skill id being used by the enemy.

EXP CurveThe EXP Curve parameters support multiple different styles of curve based on how many numbers you enter for them.

If your EXP Curve only has 1 number entered, ex: ["100"], it will simply divide the current exp by that number to get the skill level. Ex: Your exp curve is ["100"] and the current exp is 200. The plugin will do 200/100 = 2 for a skill level of 2.

If your EXP Curve has 4 numbers entered, it will use the same formula as actor levels which is visible from Database -> Classes -> EXP Curve. The first value will be treated as the Base Value The second value will be treated as the Extra Value The third value will be treated as Acceleration A The fourth value will be treated as Acceleration B

If your EXP Curve has any other amount of numbers, it will assume each number entered is the amount of exp required for that level. Ex: if you have 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000 entered, it will calculate if the player has 350 exp that the skill is level 3

NotetagsThis plugin supports the following note tags:

In skill note box:
<cgmznoskilllevel> - Will cause the skill to not use skill levels

Text CodesIn the Skill Name parameter, you can use the text codes %icon and %name to display the skill icon and name, respectively.

In the Skill Level parameter, you can use the text codes %level and %percent to display the skill level and percentage to next level, respectively.

JavaScriptTo call the skill level scene via JavaScript, use the following script:
SceneManager.push(CGMZ_Scene_SkillLevel);
Note: By default, this will have page buttons for switching between actors.

Additionally, you can force the scene to show skill levels for a specific actor id by using the following line of js:
SceneManager.prepareNextScene(actorId);
You can also use this to force it to show all skill levels for the entire party by passing in 0. When this additional line is added, the scene will not allow switching actor within the scene.

Integrations[CGMZ] Toast Manager
This plugin can show a toast window when a skill levels up. Set up the toast preset in the Toast Manager, and then enter the id here. You can use %name to be replaced with the skill's name, and %level to be replaced with the skill's new level.

[CGMZ] Scene Backgrounds
Allows you full control over any scene's background, including showing an animated scrolling parallax image or even weather. This works via no-code preset for the Skill Level scene.

[CGMZ] Controls Window
Allows you show keyboard or gamepad controls (depending on player's last input type) for any scene. This works via no-code preset for the Skill Level scene.

[CGMZ] Window Backgrounds
Allows you add an image, including animated scrolling parallax image, to any window's background. This integration works via no-code preset id for the windows in the skill level scene.

[CGMZ] Window Settings
Allows you change any window's windowskin, tone, padding, etc. This integration works via no-code preset id for the windows in the skill level scene.

Plugin CommandsThis plugin supports the following plugin commands:
Call Scene - Call the skill level scene, optionally specify an actor to only show their skill levels.

Change Skill Exp - Change a skill's exp manually.

Create Skill Level - Create initial skill level for a skill. This will cause it to start appearing in the skill level scene.

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_SkillLevels.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.


Version HistoryVersion AlphaR2
  • Added per-skill level min/max for enemies
  • Added enemy min/max fallback skill level
  • Fix bug with skill level variable changing sometimes before action ends
Version AlphaR3
  • Added [CGMZ] Scene Backgrounds integration
  • Added [CGMZ] Controls Window integration
  • Added [CGMZ] Window Backgrounds integration
  • Added [CGMZ] Window Settings integration
  • Fix bug with scene when called via plugin command with actor id set
  • Simplified Skill Level setup
Version AlphaR4
  • Added [CGMZ] Toast Manager integration
  • Fix bug with skill levels resetting after save and reload

Back to Plugin