VarToStat - Custom Stat Allocation System [MZ]

VarToStat v4.2 LITE is a complete, two-scene system for RPG Maker MZ that allows you to manage custom character stats using game variables. It provides a clean, user-friendly interface for players to select a character and allocate points to any stats you create (like Strength, Charisma, or Swordsmanship), with full customization options for the developer.

This plugin is perfect for:

• Allowing players to build their own character stats on level-up.
• Creating skill trees or attribute systems based on variables.
• Managing custom parameters that are not covered by the default engine.

Features

This plugin is packed with features, split into two main scenes:

► Character Selection Scene

• Scrollable Vertical List: A clean, modern list showing all available characters.
• Full Portrait Support: Use standard facesets (with a specific index) or custom 144x144 face images for each character.
• Progressive Unlock System: Hide characters at the start of the game (e.g., party members who haven't joined yet) and unlock them later with a simple Plugin Command.
• Customizable UI: Set your own title and description text for the scene.

► Stat Allocation Scene

• Easy Allocation: Players can use LEFT/RIGHT or the OK button to increase/decrease stats.
• Variable-Based: Each stat is tied directly to a game variable. The "Available Points" are also read from a variable. This makes it incredibly easy to use these stats in your damage formulas, events, and skills.
• Unique Builds: Each character can have their own unique list of stats and their own unique "Stat Points" variable.
• Visual Stat Display: Show an icon, name, description, and the stat's value.
• Maximum Value Caps: Set a maximum value for any stat (e.g., "Strength" caps at 99). If a player tries to exceed it, a custom warning message will appear.
• "Current / Max" Display: Automatically formats the display as 25/99 if a max value is set, or just 25 if there is no limit.
• Custom Sound Effects: Define unique sound effects for increasing a stat, decreasing a stat, confirming changes, and canceling.
• Save/Cancel Confirmation: A built-in confirmation window prevents players from accidentally losing their changes by canceling. All changes are only made permanent when the "Confirm" command is selected.

How to Use (For Developers)

It only takes a few steps to set up your custom stat system!

Step 1: Configure Your Actors

Go to the Plugin Parameters and find Actor Settings. This is where you will add every character who can use the system.

For each actor, set:

• Actor: The actor from your database.
• Visible At Start: Set to NO for characters who join the party later.
• Face Image / Face Index: Choose their portrait for the selection screen.
• Stat Points Variable: The variable that will hold their available points (e.g., Variable #50).
• Stat Scene Portrait: The large picture of the character shown during allocation.
• Stat List: The list of stats this character can upgrade (see Step 2).

Step 2: Configure Your Stats

Inside the Stat List for an actor, you will define all their custom stats.

For each stat, set:

• Stat Name: The name shown in the list (e.g., "Strength", "Intellect").
• Associated Variable: The variable that will store this stat's value (e.g., Variable #51).
• Description: The help text shown when the player selects this stat.
• Icon: The icon index to display.
• Maximum Value: The cap for this stat (set to 0 for no limit).
• Max Value Warning: The text shown if the player tries to go over the cap.

Step 3: Open the Scene in-game

To let the player access the system, use the Plugin Command: Open Actor Selection

You can call this from an event (like a Level Up event) or from a "Stat" button in your main menu using a common event.

Step 4 (Optional): Unlock Characters

If you have a character set to Visible At Start: NO, you can make them appear in the list during the game.

When that character joins the party - or whenever works for you - use the Plugin Command: Unlock Character ...and select the character you want to show.