ED5 Character Creator

Version 2.0 • RPG Maker MZ

Overview

The ED5 Character Creator allows players to customize their actor's appearance in-game. It automatically scans your project's folders to build a library of parts (Hair, Eyes, Clothes, etc.) without requiring complex database setup.

• Auto-Discovery: Just drop images into img/generator/.
• Gender Support: Male, Female, and Kid base templates.
• Class Integration: Link specific appearances or stats to RPG Maker Classes.
• Live Preview: See changes instantly on a composite character sprite.

Installation

1. Download ED5_CharacterCreator.js and place it in your js/plugins/ folder.
2. Open Plugin Manager and enable the plugin.
3. Create the following folder structure in your project:
   img/generator/TV/Male/
   img/generator/TV/Female/
   img/generator/TV/Kid/
   img/generator/SV/ (Optional for Battlers)
   img/generator/TVD/ (Optional for Downed Poses)

Adding Assets

Files must accept the standard naming convention to be detected:

Example: TV_FrontHair_p01.png, TV_Clothing_p05.png

Supported Categories: Rear Hair, Front Hair, Ears, Eyes, Eyebrows, Nose, Mouth, Facial Mark, Beast Ears, Tail, Wing, Clothing, Cloak, Glasses.

Plugin Commands

Advanced: Custom SV Battlers (chargene.json)

To link your walking sprites (TV) to Side-View Battlers (SV) or Dead Poses (TVD), you must create a configuration file at data/chargene.json.

This maps a specific part ID (e.g., "Clothing 1") to a specific SV battler sheet.

Configuration Structure

[
  {
    "gender": "Male",
    "parts": {
      "Clothing": {
        "p01": {
          "sv": "SV_Clothing_p01",
          "tvd": "TVD_Clothing_p01",
          "face": "Face_Clothing_p01"
        },
        "p02": {
          "sv": "SV_SpecialArmor_B",
          "tvd": "TVD_SpecialArmor_B"
        }
      },
      "Rear Hair": {
        "p05": { "sv": "SV_RearHair_p05" }
      }
    }
  },
  {
    "gender": "Female",
    "parts": {
       ...
    }
  }
]
        

Key Fields

• sv: The filename of the Side-View battler sheet in img/generator/SV/ (Do not include .png).
• tvd: The filename of the Downed/Dead pose in img/generator/TVD/ (Do not include .png).
• face: (Optional) The filename for face generator parts.

UI Customization

The plugin offers extensive parameters to tailor the look and feel of the character creator to your game's theme.

Key Settings

• Background Images: Set custom background images (img/pictures/) for the Menu, Preview area, Stats window, and Hue slider.
• Custom Fonts: Define a specific font face and size used exclusively within the creator scene.
• Category Order: Reorder or remove categories (e.g., move "Gender" to the top or hide "Beard").
• Variable Bindings: Bind specific part selections directly to RPG Maker Variables (e.g., store "Front Hair ID" in Variable #5).
• Hidden Categories: Hide specific categories (like "Wings" or "Tail") if they don't fit your game setting.

🎮 Gameplay Options & Origins

Beyond appearance, you can allow players to make Gameplay Choices (Origins, Starting Gifts, Horoscope, etc.) directly in the creator. These choices can grant items, equipment, or trigger switches/variables.

Step 1: Create the Option Category

In Plugin Parameters > Gameplay Options, create a new entry:

• Option Name: The title shown in the category list (e.g., "Birth Sign" or "Starting Gift").
• Icon Index: The icon displayed next to the category name.

Step 2: Add Choices

Inside the Option, add multiple Choices. Each choice can have specific rewards:

Option: "Starting Gift"
  Choice 1:
    Name: "Old Coin"
    Description: "A lucky coin from your grandfather."
    Script: $gameVariables.setValue(10, "Coin"); $gameParty.gainGold(100);

  Choice 2:
    Name: "Dagger"
    Description: "A rusty blade, better than nothing."
    Weapon ID: 5
    Weapon Quantity: 1