Character Creator EX – MV Plugin

This is a plugin that allows players to create their own custom characters in game (+more!).

Look at the code or download the Plugin:

Character Creator EX

This is a plugin that allows players to create their own custom characters
in game.

A menu system in which the player can create a character can be called
upon at any time and assigned to an Actor. Once an Actor has been assigned
a custom character, that character will be used on the map and in side-
view battles.

In order to modify the properties of the sections and pieces, one must
use the Super Tools Engine. Simply go to:

Database EX BAK Custom Editors BAK Character Creator Editor

With this, you’ll be able to easily customize the various properties
that exist within the sections!

Setting up Files

In order to set up the “generator” pieces, you need to create a new
folder in the “img” folder called “character-creator”.

So the file location should be:


Within this folder, you need a folder for each section, for example:


Within each of these folders, you’ll also need 4 more folders:


As you can probably guess, each of those folders will contain the
corresponding walking, dead, face, and side-view parts of the
parent folder.

For example, in order to store the “Face” parts of the “Body” section
you would place them in:


Other Images

Finally, you’re also going to need a couple required images placed in:


These images are:


The “Background” image will be used as a background for the character
creator if you choose to use it.

The “CustomCharacter” and “CustomFace” will be used in scenarios where
a custom character’s Character or Face image cannot be loaded.

The “____-Background” images are used as piece backgrounds in the
editor itself.

Opening the Character Creator

In order to set up the Character Creator, use the Plugin Command:

OpenCharacterCreator [actorId]

Set “actorId” to the Actor ID of the Actor you wish to create images for.

For example:

OpenCharacterCreator 3
OpenCharacterCreator 7
OpenCharacterCreator 26

Showing Dead Custom Character

Use the following Plugin Command to make an Actor use their “dead”
custom character image:

SetDeadCustomCharacter [actorId] [true/false]

This will set it so the Actor defind by “actorId” will have their
dead image turned on or off.

For example:

SetDeadCustomCharacter 3 true
SetDeadCustomCharacter 8 false
SetDeadCustomCharacter 12 true

Setting Event to use Custom Character

If you wish for an event to use a custom character image, simply use
the event notetag:

<CustomCharacter: [actorId]>

This will set the event to use the custom image of the actor specified
through the “actorId” input.

You can also set an event to use a dead custom character using:

<CustomDeadCharacter: [actorId]>


<CustomCharacter: 3>
<CustomDeadCharacter: 23>

Showing Custom Face in Show Text

If you wish to have a character’s custom face used in a “Show Text”,
here’s what you need to do:

1) Make sure there is a face image selected for the “Show Text” event.
It can be any face image, it just needs to be there.

2) Use the following notetag in the “Show Text” box:

<CC Face: [id]>

Set “id” to the ID of the Actor who has the Custom Face you wish to use.

Disabling the Custom Images

In order temporarily distable the custom images set up for an Actor, use
the Plugin Command:

DisableCharacterCreatorImages [actorId]

Of course, simply set “actorId” to the Actor ID you wish to disable
custom character images for.

EnableCharacterCreatorImages [actorId]

This would enable the character creator images again.

For example:

DisableCharacterCreatorImages 12
EnableCharacterCreatorImages 8

Custom Colors

While most of the properties that can be manipulated in the
“Character Creator Editor” in the Super Tools Engine are pretty
self explanatory, the color-customization section… is a bit more

The colors are set up using JSON arrays, meaning:

[info for color 1],
[info for color 2],

[info for last color]

As you can see, each “color” is separated into its own brackets.
Every color is followed by a comma except for the last one.

Now within these colors, you may customize the:

– Name
– Hue
– Saturation
– Brightness
– Grayscale

For example:

[“Blue”, 100, 0, 1, 0.5]

This would set:

– Name: Blue
– Hue: 100
– Saturation: 0
– Brightness: 1
– Grayscale: 0.5

You are not forced to fill out all of the properties however. In fact,
the less you fill out, the better. For a simple Hue shift, all one
needs to do is:

[“Green”, 200]

This will create a simple color called Green that shifts the hue by 200.

The limits that may be defined through the properties are as follows:

– Hue [0 ~ 360] – Saturation [-1 ~ 1] – Brightness [0 ~ 1] – Grayscale [0 ~ 1]


40 thoughts on “Character Creator EX – MV Plugin

  1. Gundorf The Blu

    Hey SRDude! Once again, awesome plugin.
    I’ve encountered an odd error, I’ve added a folder with each of the sub-folders and titled the pieces appropriately as “Custom”.
    When I go into the Super Tools Editor in-game I am able to fiddle around with the details but however it will not save anything.
    I did also go into the plugin manager and filled out the sections as necessary, I have no idea how to resolve this issue, as the STE still updates the changes to the other character creator folders but not my added folders.

    1. YoraeRasante

      I did the thing that worked on the older version to separate in male and female clothing too, and got the same problem…

      I figured out the problem was in the json file the creator creates. To be able to save the editions in the folders it has to already be in the json file, at least until SRD updates it. So my solution was to add a small copy of the folders I made in the json by hand and then editting them how I liked.

      Not the best solution, but it should work for now.

  2. Jackson

    When i open the character creator i get an error that reads
    “TypeError: Cannot read property ‘name’ of undefined”

    1. Jackson

      My console reads

      TypeError: Cannot read property ‘name’ of undefined
      at Window_CharacterCreator_FolderList.currentFolder (SRD_CharacterCreatorEX.js:2088)
      at Window_CharacterCreator_FileList.initialize (SRD_CharacterCreatorEX.js:2172)
      at new Window_CharacterCreator_FileList (SRD_CharacterCreatorEX.js:384)
      at Scene_CharacterCreator.createFileList (SRD_CharacterCreatorEX.js:1315)
      at Scene_CharacterCreator.create (SRD_CharacterCreatorEX.js:1251)
      at Function.SceneManager.changeScene (rpg_managers.js:1810)
      at Function.SceneManager.updateMain (rpg_managers.js:1789)
      at Function.SceneManager.updateMain (SRD_SuperToolsEngine.js:381)
      at Function.SceneManager.updateMain (YEP_FpsSynchOption.js:119)
      at Function.SceneManager.update (rpg_managers.js:1714)rpg_managers.js:1756 SceneManager.catchExceptionrpg_managers.js:1717 SceneManager.update

      1. YoraeRasante

        “at Window_CharacterCreator_FolderList.currentFolder”… maybe the error is in the folders.

        I didn’t check for errors, but when I put my folder inside /img/character-creator-ex/ that SRD said in the beginning the creator refused to open for the plugin command, It did work when saved on /img/SumRndmDde/character-creator-ex/ as mentioned later though.

        1. Fi

          Thanks so much!!! I had this error too! So strange, in the plugin help it tells you to put the images in a separate folder, but doing so causes it not to work… I think that really needs to be updated. Normally you would just expect it to say ‘could not find image’ but it caused a game ending error so I thought there was something really wrong, like Jackson I hadn’t considered this XD

  3. tigrean

    Cool I have been wanting something like this forever. Quick question though SRD is there a way you can default the parts based on a race select? For example if the player picks to be an elf can you set it where they can only have pointed ears but able to edit the rest of the items?

    1. Johnnie

      You can by creating two layers, ears and elf ears. Set one to a condition of $gameVariables(5).value===1, and other to 2, and more if say you need Furry Ears…

      Then just set up a menu that changes variable 5 (or whatever you choose) and there you go.

  4. Riley

    Hi there, this is an awesome plugin that I NEED in my game! Thanks so much for making this.
    I think I’ve done everything right, but when I load the game it comes up with a black screen that says:
    Cannot read property ‘hasInfo’ of undefined.”

    I’m not sure what to do here. Thanks for any help

    1. Levon

      I get a TypeError “_needCustomUpdate is Undefined” and I don’t know how to fix it, it happens after I create a character

  5. Mphi

    Hey SumRndmDde! Looks like an amazing plugin!
    For some reason nothing happens though, I seem to have everything in the folders set up right but when I run it with a plugin command nothing happens and it just goes to the next thing in the event… Help please?

    1. Maire

      I’m having the exact same problem! Even though I have the supertools plugin like it asks it still won’t do anything ;-;!

      1. Maire

        So I think I figured out my problem, I had to put the super tools plugin above the character creator plugin and it worked!

        1. Mphi

          I tried that too but I’m afraid mine still didn’t work :/
          My super tools wad always on the top of the list top 🙁
          Glad yours is working tho 😀
          Good luck on your game!

          1. Fi

            What version of SuperTools are using?

            I had it working before but udpating to SuperTools 1.24 gave the same problem where nothing happened and then this kind of error;
            index.html:1 Uncaught SyntaxError: Unexpected token u
            /C:/Users/Fi/Documents/Games/Project3/js/plugins/SRD_CharacterCreatorEX.js:630 Uncaught TypeError: undefined is not a function

            When you load your game, press F8 and see if this happens to you.

            The solution that worked for me was to delete all the Supertools data, make a new project, and copy the index.html, and all the data in the .js folder. (Like how when you’re trying to update an old project to a new version of MV.) Normally they tell you not to replace plugins.js, but that’s what solved the error for me. I have to go re set all my plugins now which is a huge pain but it’s working for now at least ^^””

  6. rekuze

    I would like to create a game where men and women are selected and the scenario changes, we are using Character Creator EX of SumRndmDde.
    Can I change variables when changing people or other women, such as changing the folder of Character Creator EX?

    Though it may be impossible, thank you.

    It may be wrong because it is a literal translation.

  7. xLioneth

    Hey Dude, I have error when try use it, when installed the plugins (the two plugins SuperTool and CharacterCreatorEx). When execute the program said “I need the SuperTool” when i have it already. Now i have the CharacterCreator the older but the menu to choose the character the images is very slowly for charger and the new doesn’t work. plis help me (i am sorry for my bad english)


  8. AnnoyingDog

    I have installed everything as you said, but when I try to enter the Creator, I have this error in the console:
    ReferenceError: CacheMap is not defined, and nothing happens in-game. I have installed SuperTools above Character Creator, but I still have the error. Any help will be appreciated!

    1. SumRndmDde Post author

      It seems like you’re using an MV project that is below version 1.3.0.
      Please update it!

  9. Skunk

    So I followed the steps and for some reason when I try to trigger the plugin command, literally nothing happens :S

    1. Mphi

      Same here 🙁
      Try putting super tools above this plugin
      Works for some people
      Not for me tho but it might for you!
      Best of luck 🙂

      1. Skunk

        Ya that was the first thing I double checked…
        Everything is as it should be from what I can tell and ive been doin this for years lol
        Im stumped.

        1. Rhino

          Try setting it up in a blank project, it’s possible there are some plugin conflicts. Make sure you’ve got the latest versions of SuperTools (1.25) and CCEX (1.02), and MV of 1.3.0 +

          Also, you need to ignore the part of the plugin help where it says to add the generator pieces into “/img/character-creator-ex/”, as it’ll give you an error. Put everything in “/img/SumRndmDde/character-creator-ex/”

          1. Mphi

            I tried the blank project
            Didn’t work

            Never tried the putting it in the SumRndmDde folder tho! Gonna try that now thanks!

  10. Levon

    I guess my other comment was a response to someone else, whoops! I just really need help if possible, I get a TypeError “Cannot set property ‘_neededCustomUpdate’ of undefined” Any help would be amazing please and thank you!!!

  11. Nicholas DeLeon

    So far I’m enjoying this plugin, however I noticed that you forgot (or intentionally left out) “Ears”.
    I tried adding them in myself, but I’m unable to actually edit them through the Super Tools. They appear in game, but I can’t change the hue or how they are to be displayed during selection. If possible, could you make it to where this plugin has about 2 or 3, maybe more, “Custom” labels that are just automatically conditioned to “false” so devs won’t see them in the playtest but can easily adjust them if they want to?

    1. Nicholas DeLeon

      Also is there a way to make a custom character for one Actor ID, and then have those same parts be selected for a different actor ID?
      For example what I’m trying to do is make multiple different emotions for the character, telling the player to create the character and then make the various emotions for it. I want to have everything available to them from the first selection, ID[4], but then only allow Eyebrow, eye, and mouth changes for ID[5, 6, 7], etc. while keeping the selected face, hair, clothing, etc, from ID[4].

  12. EckaSoftware

    I feel like this plugin would be awesome to use but I’m getting a CacheMap Is not defined error. I read the previous comment pertaining to updating the project but the project I’m working on was created in the most up to date version of the Engine. (I’m assuming. I downloaded MV about 6 days ago from the official site and am using the trial version. Project was created using that release of the software.)

    Any ideas? All the folders are set up using the guide provided.

  13. RuneFactoryGuy

    I seem to be having a problem when it comes to the battles with this plugin. the character won’t show up is the side view battles and I don’t know why. If you could help me with this issue that would be great.

  14. Jacob

    Is there a way to get a .zip file download? Or some other type of file that i can open it up and view all the data folders and such so i can add my custom sprites and change things.

  15. Tester

    I really like your plugin. Everything works great when testing through rpg maker.
    I had some problems using it with the chrome browser though.
    It breaks when trying to load _.loadSaveInfoFile.

  16. Splendora Gaming

    Deprecation Warning: PIXI.GC_MODES.DEFAULT has been deprecated, please use PIXI.settings.GC_MODE
    fs.js:803 Uncaught Error: ENOENT: no such file or directory, scandir ‘C:\Users\jon\Documents\Games\RWBY Game\img\SumRndmDde\hud\pictures’
    fs.js:803 Uncaught Error: ENOENT: no such file or directory, scandir ‘C:\Users\jon\Documents\Games\RWBY Game\img\SumRndmDde\character-creator-ex’
    Pixi.js 4.4.1 – ✰ WebGL ✰ ♥♥♥

    Getting a couple odd errors related to two of your java scripts, character creator ex and hud maker.. They do not stop me from running my game, but it is nevertheless an issue I don’t feel I should ignore. For all I know they may turn into a greater issue later if they are ignored, so hoping to fond a way to clear them up. do you have any suggestions?

  17. Johnnie

    Ok, here’s my TINY critique and brainstorm.

    What I’d like is the ability to say if a menu option is chosen, you’d have the ability to designate that choice to a game variable.

    If it’s doable, like choose a folder in the SuperTools. Each folder by default is “null” or allows to choose a variable to pass your choice to.

    This way, if you choose black hair, a variable can be passed to help with dialog for immersion.


Leave a Reply

Don't worry. Your email will not be shown. :)
Also, I would recommend a leaving comment on the YouTube video in order to receive a faster reply.