PLK_ClassSkills

1) What This Plugin Does

• Adds a system where characters gain Skill Points (SP) when they level up or use certain items.
• Allows you to set Skill Point costs for learning specific skills.
• Displays a list of recently leveled-up characters in a dedicated window, featuring their SV Battler sprites in an animated victory pose.
• Offers a scene where the player can choose a class or specific actor to spend Skill Points on. They can also perform a “mass upgrade” for the whole party.

2) Basic Setup

1. Copy the .js plugin file into the js/plugins/ folder of your RPG Maker MZ project.
2. Open Plugin Manager in RPG Maker MZ.
3. Add the plugin and configure the parameters according to your preferences.
4. Make sure to provide any required images (for example, custom windowskins or background images) in the appropriate folders, such as img/system or img/pictures.

3) Core Plugin Parameters

• classListWindowSkin The window skin file for certain windows like the Actor List or Class List. Default is Window.
• skillUpgradeBackground The background image (filename without “.png”) used in the Skill Upgrade scene. Default is Nature_7. (Place the image in img/pictures.)
• classSelectBackground The background image (filename without “.png”) for the Class Selection scene. Default is Actor3_4. (Place the image in img/pictures.)
• defaultLevelUpSkillPoints The base amount of Skill Points each class receives when leveling up (used if no specific class data overrides it). Default is 5.
• defaultItemSkillPoints The base amount of Skill Points gained from item usage (used if no specific class data overrides it). Default is 10.
• classUpgrades Lets you configure values for each class individually (e.g., how many Skill Points they gain on level-up, or how many they receive from certain items).
• classCompletionIcons If you want to show a special icon in the Class List when an actor finishes learning every skill for a class, you can set those icons here.

4) Setting Skill Point Costs for Skills

To specify how many Skill Points a skill needs to be learned, add a Note Tag in the skill’s “Note” box like so:

<skillPointCost: X>

Replace X with the desired number. If a skill has no tag, the cost defaults to 1.

5) How It Works in Gameplay

1. When a Character Levels Up
   • The plugin gives them a certain number of Skill Points (based on either the default or a class-specific value).
   • The plugin also tracks that actor by adding them to a “recently leveled-up” list.
2. Using Items for Extra SP
   • Some items can grant Skill Points. Their amount can be defined globally or by class.
   • If you want to show these actors in the “recently leveled-up” window after using an item, you can edit the plugin code to also place them on that list (for example, by calling $gameSystem.addLevelUpActor(actor)).
3. Window Display for Recently Leveled Actors
   • The plugin has a Window_LevelUpActorsClassSkills that shows any actors in the “recently leveled-up” list who still have unlearned skills. They appear with an SV Battler sprite.
4. Learn Skills via the Menu
   • The plugin adds a new command called “Learn skills” to the main menu.
   • Selecting it opens a scene where you can choose a class or an actor.
   • You can choose to upgrade all eligible skills for every party member at once, or pick an individual actor to go into the Skill Upgrade screen.
5. Skill Upgrade Scene
   • In the upgrade screen, the plugin shows which skills are available (based on level requirements and SP cost).
   • If the actor has enough Skill Points and meets the required level, they can learn the skill.
   • It deducts the Skill Points accordingly and marks the skill as learned.

6) Additional Notes

• Background Scrolling: The background images in the Class Selection and Skill Upgrade scenes scroll at a defined speed. You can change the scroll speeds in the code (_scrollSpeedX and _scrollSpeedY).
• Window Appearance: The plugin uses custom windowskins for various windows, which you can change by updating the parameter or by manually editing the windowskin = ImageManager.loadSystem(...) lines in the code.
• Pending Skills Check: The plugin only displays an actor’s SV Battler if that actor still has learnable (pending) skills. An actor with no unlearned skills won’t appear in the “recently leveled-up” window.

7) Using Plugin Commands

Inside your Event page in RPG Maker MZ, you can use the Plugin Command:

• Open Upgrade Skill This immediately opens the Class Selection scene from anywhere in the game.

8) Common Troubleshooting

1. Actor Doesn’t Appear in the SV Battler Window
   • Check if they actually have any skills left to learn (pending skills).
   • Confirm that they’re added to the “recently leveled-up” list (which happens automatically on level-up, but for items, you may need a code tweak).
2. Skill Point Cost Doesn’t Work
   • Make sure you typed the Note Tag exactly as <skillPointCost: X> in the skill’s Note.
3. Scene Crashes or Freezes
   • Check the console for errors (press F8). You might have missing parameters or missing images in the plugin settings.
4. Item Doesn’t Give SP
   • See if you set classUpgrades properly. Otherwise, the plugin might fall back on defaultItemSkillPoints.
   • Ensure the item’s ID matches what you defined in the plugin parameters.

9) Final Tips

• To fully utilize the system, configure both the default and class-specific parameters under classUpgrades. That way, each class can have a unique progression.
• For bigger projects, you can easily add your own conditions or graphical changes by modifying the relevant windows (e.g., Window_PLK_ActorList, Window_ClassList).
• If you want newly earned SP from items to trigger the actor’s appearance in the SV Battler window, remember to call the same method the plugin uses for leveling up (e.g., $gameSystem.addLevelUpActor(target)).

Enjoy building a skill progression system for your game with PLK_ClassSkills!