Instance Actors

By default, RPG Maker does not support the creation of new actors during the game. When you create your game, you would set up actors in the database, and then during the game, those actors will be used.

With this plugin, the possibility of creating completely new actors during the game is open for you.

For example, you could create a mechanic where you capture enemies during battle, which are converted to actors before they are added to the party. These actors did not exist when you first created your project, nor do they exist in other save files.

This plugin provides the functionality for managing custom actors that are generated at run-time.


Plugin: download here (right-click, save as)


Download the plugin and place it in the “plugins” folder in your project’s “js” folder. Then open your Plugin Manager (F10), double-click an empty row, and select the HIME_InstanceActors plugin.

Once it is in your list of plugins, turn the plugin on.



In the plugin parameters, choose the “Template Actor ID”. This is the “default” actor that all newly created actors will be based on.

Then set the “Start ID”, which represents how the custom actors will be identified. Once the game starts, you have no way to change these ID’s, so if you are expecting to add more actors to your project, you should take that into consideration when choosing the the start ID. I would go with something like 1000 just to be safe.

Creating Actors

To create a new actor, use the script call

var newActor = InstanceManager.addActor()

The game would create a new actor for you, using the template actor as the base.
It would basically be a copy of it with a new ID.

If you wanted to base it on a different template, you can specify that in the script call like this

var newActor = InstanceManager.addActor( 2 )

Which will use actor 2 as the template.

The actor creation process simply creates an actor. It doesn’t automatically add it to your party, because you might not want to do that. If you want to add it to your party, you could write

var newActor = InstanceManager.addActor()

Deleting Actors

This plugin does not provide support for deleting actors, because that actor might be in use by other objects. It is safer to simply not use the actor.

You may also like...

63 Responses

  1. Kurochan says:

    Hello Hime Sensei,

    I noticed you said you weren’t going to add a remove/delete actor feature to this plugin. Would you be willing to add a method like this:

    replaceActor([this ActorID Number], [replacement ActorID Number]);

    If you don’t want to do it, may I have permission to edit your plugin and add it myself? I won’t share the update unless you give me permission and I’ll follow your “Sharing Rules” for it too.

    Thanks for your great plugins and your time.

    ~ Kurochan from KuroyukiDev Games

  2. Anonymous says:

    I am trying to make a “Child system” and I am trying to make it so that the stats of the “kid” are half of the stats of both parents (“P1 MHP=”10 + “P2 MHP=”15 = “Child MHP=”25 / 2 ) and the other stats.
    It somewhat works for the MHP and MMP for the first child but it starts adding some weard numbers on every other child after that.
    And I can’t make it work for any other Stats. it just converts them to NaN

    ATK = NaN
    DEF = NaN

    And crashes if I use YEP. Profile… plugin

    So my question is:
    Is it possible to specify their stats with variables or do I need some other plugin to do that?

  3. Minakill says:

    Sorry not sure but can I choose with what id I create new actor?
    And do thins plugin work together with Party Manager plugin you made?
    I prefer to prefer spawn Actor with specific id so I can Easily remove him from party.

  4. Sam says:

    Gday Hime, firstly thankyou for putting together these amazing plugins, they are fantastic. I have a couple of questions. in regards to name input processing, the script doesnt seem to be working for me, im very new to programming so it”s most likely an obvious mistake I have made, but, do i paste the script
    SceneManager.prepareNextScene( ACTOR_ID , MAX_LETTERS );
    directly after the actor add script? or is it implemented somewhere else?
    My Second question, is how does the system behave exactly? what happens when you make multiple characters using the script, does it keep adding one to the Start ID that was specified? how do you keep track of the ID’s so you can name process etc for each one

  5. Vanderson says:

    Is there a way to store the Actor ID in a variable?

  6. Coninuumg says:

    I made the following snippet so I could easily make summoning spells:
    Game_Party.prototype.summon = function(id,level) {
    var newActor = InstanceManager.addActor(id)
    $, false);
    But whenever I use it, instead of getting one new actor, I get a number equal to the number of actors already in the party. I really don’t feel like summoning exponential slimes.

  7. User says:

    Has there been any further development in this plugin? A RemoveActor function is sorely needed.

    • Hime says:

      Removing actor is not planned to be implemented.
      It would be better to simply replace an actor with a new one if needed.

  8. En says:

    var newActor = InstanceManager.addActor()

    When I type that I get the error:

    Cannot read property ‘0’ of undefined

  9. Anonymous says:

    how to remove them from party? >___<

    • Hime says:

      You would need to use plugins or techniques that allow you to manage actors without knowing who they are beforehand.
      What are you trying to do?

      • Vazad says:

        I don’t know about the original poster but I would very much like a functionality similar to the Box from Pokemon or the Farm from Dragon Quest Monsters where you can store unused actors with the ability to switch them in and out of the party and delete unwanted actors.

        I came here from your [Dev] Capturing enemies, recruit them as actors! from the forums and am curious if you ever made headway on that, it looks like it would be quite useful.

        • Hime says:

          You can sort of create one using the Party Switching Scene plugin, where you would move actors to a separate party if you do not wish to use them.

          • Vazad says:

            Alright, that might work. Hmmm, I’ll see what I can Kludge together, thanks for making all these wonderful mods.

          • Hime says:

            If you need something specific or would like to know how to build something specific, let me know.
            A lot of things could be evented, but if you want a dedicated scene for it that could be done as well.

          • Vazad says:

            (Can’t reply to your latest comment for some reason)

            Well, I’m trying to work on a Monster tamer ala Pokemon. I think I can see how to create a “box” for storage so I’ll just work on getting things set up the best I can for now. The big wall I’m going to run into are functionality as I’m still rather new to programming at all.

            The main thing that would be useful would be allowing people to somehow remove actors they don’t need. Do you think it would be possible to add a menu event that deletes by slot in the second party that is acting as the “box”?

            I can think of workarounds for everything else I need using the tools created already but that is a big sticking point to me as I can imagine players getting annoyed without the functionality.

  10. Grilled Mormons says:

    Thank you for this, without this script i would have to completely change my vision.
    One question though,
    How would i go about name input for the instanced actor?

    • Hime says:

      You have a few options when it comes to name input.
      If you are setting up names directly after creation, you will be able to use the ID.
      SceneManager.prepareNextScene( ACTOR_ID , MAX_LETTERS );

      If you would like to rename them afterwards, when you don’t have access to the ID, you would need to reference them somehow.
      For example, you might need to produce a list of actors for the player to choose, and then given a reference to the actor, you can then grab the ID.

      • Hi Hime-san. I’m still in RPG Maker MV.
        And use this plugin for build my game.
        but i have problem with naming charactor.
        I try this and still not work.

        SceneManager.prepareNextScene( ACTOR_ID, 16);
        var newActor = InstanceManager.addActor(ACTOR_ID);
        var party = $gameSystem.reserveParty();
        party.addActor( ;

        but it still use name on Actors list?
        Do you have some advice that i miss something?
        This is my simple project
        I draw sprites myself. the charactor still nude becuase my Clip studio license run out(LOL).

Leave a Reply

Your email address will not be published. Required fields are marked *