HUD Maker – MV Plugin

      147 Comments on HUD Maker – MV Plugin

This plugin allows developers to create their own map-based HUD through an in-game GUI window!

Look at the code or download the Plugin:

HUD Maker

This plugin allows developers to create their own map-based HUD through
an in-game GUI window!

Image Installation

All HUD images must be placed in:


They need to be segmented into four folders:
– pictures
– numbers
– gauge_images
– gauge_backs

Each folder will be used to hold images for the corresponding pieces:
– Picture
– Image Numbers
– Image Gauge


147 thoughts on “HUD Maker – MV Plugin

    1. WiiTehNeko

      Make sure you have the latest version of Super Tools Engine, all the files are in the right location, and- of course- that the plugins are turned on in your plugin manager. I hope this helped! =D
      (The SRD_HUDMaker.js file should be in /js/plugins
      and the 4 image files (guage_backs, guage_images, numbers, pictures) should be in img/SumRndDde/hud (Im pretty sure it has to be exact same capitalization for both the SumRndmDde and hud files, tho im not sure.))

    1. dongki

      Hello producer

      I am a beginner in Korea.

      The HUD Maker plug-in is really good

      I have questions and write.

      If there is no party member 2, will not the HUD be shown, and if there is a party member 2, is there a command to show the HUD?

      It’s too complicated to create a condition with a switch.

  1. serbyk

    I want to show how many items of a specific potion I have in my inventory to show on the HUD … anyone got any idea how to do that ??? please help me.

      1. Johnnie

        and so you don’t have a bunch of zeroes showing… you can also make a condition that the number only shows up under the condition of $gameParty.hasItem(x) – That way it shows the number if its there, and if it isn’t it doesn’t

        1. stray

          hey i’ve been trying to use this script but it isn’t working, is the exact phrasing you’d put into the condition field or am i doing something wrong. i’ve set the item number and everything so i’m not sure what’s going on…


    This is awesome. Can you provide a step by step on how to make a ATB gauge using Yanfly’s ATB Battle system script for each character? Been trying to figure that out for awhile now.

      1. starsavior506

        For some reason, it says 1.3.5 on RPG Maker on Steam, I have ‘update when I activate the app’ on, and yet apparently I still don’t have 1.3.0. Any ideas why, if you can help?

            1. kaede

              Hey,I just found a way to solve it.First,open the”SRD_HUDMaker.js”and locate the line 1240,and delete”if(!Utils.RPGMAKER_VERSION || Utils.RPGMAKER_VERSION < '1.3.0') {alert("HUD Maker requires your project to be at v1.3.0 or greater!");else ".done!
              But I cant make sure it wont happen any other problem,make sure"HUD Maker requires your project to be at v1.3.0 or greater!".^_^

      1. Idlemage

        I fixed the issue hide the hud during events and just to be sure I put it below my Yanfly plugins
        Thank you for the work on hud maker!!

  3. Kimberly

    does anyone have a place where someone like me could visit to see a sort of library of javascript codes that function with this plugin?

    For instance:
    In the “condition” box will make your HUD element appear only when a specific switch is active. But what if I wanted to have something display only when a specific variable is at a specific value?

    Another example:
    In the “value” box of the “text” element will make the text display the name of the actor in the leader slot, but what code might I use to make a text element display the name of whatever actor is in the second party slot?

    A final example:
    In the “Image” box under the “picture EX” element will make the HUD maker display a specific picture file that has the same name as the actor in the leader slot, but again, what if I wanted to have a specific picture display that changes based on whatever actor happens to be in the second party slot?

    I find this plugin to be absolutely amazing and super powerful! And honestly, even as someone with absolutely no javascript coding knowledge at all I can do so much! But If I could just find some place that had a list of codes that described what each does, I feel like I could do virtually anything I can imagine with this plug in!

    1. Zakaria

      first for variables i believe u use $gameVariables.value(id);
      and for the 2nd and 3rd questions $gameParty.members()[id].name() since u want the second party member then id=1 (u start from 0)

    2. Logan

      I rather use ${$gameParty.battleMembers()[x].name()}, because if you remove a party member using the PartySystem of Yanfly the hud will still show that member data, and you should use this for the condition too.

      example for the text:

      value: ${$gameParty.battleMembers()[x].name()}

      condition : $gameParty.battleMembers()[x] && $gameSwitches.value(z)

      where “x” is the member id and ” z” the switch that has to be ON (both conditions should be met)

      I use this because i linked that switch to a common event and i use the button common events plugin, that way you can show/hide
      the hud pressing a key.

      Hope this have been useful.

      1. Abtract The Origin

        For those that are looking for the actual rate value in Yanfly’s ATB, you can get the current value by placing the following:

        $gameParty.members()[X].atbRate() (replace “X” with the number of the party Member, such as “0” for the leader).

        Ensure that the max value is “1”.

  4. Kevin Frost

    Hey SRDude, this script is awesome! However, there seems to be a huge bug with it. When deploying a project for web, this script no longer works (no errors come up, just none of the huds display anymore.) Just thought I’d give you a heads up 🙂

  5. Railgun

    Ask, I try to save my hud but it says:

    Uncaught Error: Cannot read ‘property’ value of null

    I try to make one of HP bar

  6. Maxi

    Sum. It not fully compatible with the last rpg maker update 1.5.0 it’s not drawing the texts, or bars, only the custom images.
    Can you please help me? Thanks

    1. Perrotius

      Hey, I had the same problem, I had to goto the plugin manager and change the settings for Map Global Condition to “true”. after this everything popped up just fine. (Remember to click apply when exiting as well!)

        1. Zach

          I actually fixed the issue and it is very stupid. If you have the Js file named SRD_HUDMaker(#) where # is any number it will not read it properly which is what I did it must be named SRD_HUDMaker

  7. Yorae Rasante

    I just downloaded the plugin, and it only shows the first four options to add. And the pictures aren’t being added either.
    Also, is it compatible with the faces of the Character Creator Ex yet?

    1. Yorae Rasante

      (the “just downloaded” is to say that it is as updated as the site right now. The maker is on version 1.5.0)

    1. Lost Raven

      i figured out to move the pieces by cursor; needed to doubleclick before dragging around and it works fine. but arrow keys and ctrl are still not working, as are the other hotkeys

  8. Navy Goku

    First that all, i need to say this: my english is not too good

    How i can show a actor alternate state

    1. Dabide A.

      I tried that:

      – Creates a new ‘Text’ and set in ‘value’ –> ${$gameParty.leader().allIcons()}

      But… I don’t know how to show the icons of states 🙁

  9. Benji-Ninja

    Hey SumRndmDde!

    I’ve build a script where you press a button to summon a common event to swap characters (effectively a character is just removed and then readded).

    I’ve set the HUD to update when the Party Leader takes over and text updates straight away, however the character’s face doesn’t seem to update unless a menu is opened? It wills remain the old face until the menu is opened, then it will update. Do you know a way around this or a script to force refresh of the face graphics?

  10. Lili

    Hmm could i ask you if you could tell me who i can make a condition on click, i mean like on the image leftklick and something happens.

  11. Light Ain

    Just a suggestion that I thought you might find fun and many of us useful. That being somehow combining this with your Blinking Faces. Maybe a replace image with this said image at certain intervals?

  12. alex

    Hi, i got a tiny little problem with the ACTOR FACE, every time i create a new Actor Face – Element, i get the message, “uncaught Error: undefined ist not a function.”
    i tried different things but it never worked.. what can i do ? …
    btw i really love ur videos …

  13. Owen

    I am probably not thinking but pressing f12 doesn’t work for me i’m using a mac and have pressed the function key while pressing

  14. Ken

    How can I show the value of variable as text?
    For example: the Variable 1 in my game is 123123
    How can i show the text as 123123
    and when i change Variable 1 to 456456
    the text show 456456

  15. Johnnie


    Any chance that you can ALSO have… Custom Character EX face graphics on there as an element as well?

  16. LordPhoenixMH

    This is a really great plugin with loads of features. I just have a question that I can’t find an answer to on Google. I want to display an Exp gauge and I know I need to use ” $ ” for the Cur. Value, but I can’t find out what to use for the Max Value. I can find script calls for the players current EXP but not a script call for the Max EXP for the next level.

      1. Jeff

        I’ve got another plugin by SRD with a similar issue, but it was fixed by replacing
        [old code]
        var nre = actor.nextRequiredExp();
        var ce = actor.currentExp() – actor.currentLevelExp();

        with [new code]
        var alv = actor.level;
        if (alv === actor.maxLevel()) return 1.0;
        var nre = actor.expForLevel(alv + 1) – actor.expForLevel(alv);
        var ce = actor.currentExp() – actor.expForLevel(alv);

        I’m struggling to do this myself, still experimenting with the exp gauge. hopefully this helps put you in the right direction though, maybe someone will solve it before me.

  17. Brandon

    Hello, I’m using this plug in to create a custom battle hud.
    I’m also using yanflys Absorbtion barrier plugin.
    Is there a way to display the barrier portion in the hud maker’s hp gauges? Every time I activate a barrier the default hp bar appears during battle.

  18. ini_kun(form South Korea)

    Actually, this Engine and Plug-in is so cool. (Such a good point like easy to learn and use)

    By the way, In my case, I use Condition blank as to display time hud on the map.
    However, in this plugin note and video guide, there is no plug-in command and guide about
    enable/disable control for hud.
    (Such like disable hud in to specific map ID, or plugin command for disable hud in event situation)

    I hope to know how to control for this.

    1. Johnnie

      Hi ini_kun,
      A great way to take care of this is to actually make the elements have a condition on each element that the HUD has that you don’t want to be visible on certain maps… so for those maps, you may simply have an event that turns on a switch, and destroys the event. Each map can then have that type of event. If the switch is ‘ON’, the hud and all its elements turn on, if the switch is ‘OFF’, the hud and elements turn off.

    1. Johnnie

      Yes, using the SuperTools plugin, you can set conditions for each element, and can be as whether or not…
      Get the item number of the Watering Can… and i think you place that in item, as per the Script Call.


  19. Servidion

    How would one show state icons for states applied to the actor?
    Also how would you tie a picture to an actor? Like if I didn’t want to display the full faces for an actor, but a picture based on that actor.

    1. Johnnie

      well, what CAN be an easy way to do this is to take advantage of the Nickname for the actor. if you don’t need it elsewhere, you can do an image based on the nickname, OR if you know the actor ID, you can do something like this…

      – or –
      $ like in the HudMaker video 5 for text… and images… just choose IMAGE EX instead of ACTOR FACE at that point… and have the picture for the actor in the SumRndmDde Hud Image folders

      1. Servidion

        I wound up utilizing that to create my UI here:
        But there still doesn’t seem to be a way to display State Icons. I have an empty space to the left of the portraits to display the state icons, but TextEx doesn’t seem to process evals, so I don’t think there’s actually a way to display state icons.

        1. Servidion

          Apparently I can’t edit my post and I had the wrong link copied.
          My UI is here:

    1. Grunwave

      I really need help with this. My project has been corrupted with a fatal error that I need to resolve.

      Thanks to anyone who can help.

  20. Jon D.

    Like others, I seem to be having trouble getting the HUD maker to show the complete list of elements that can be created and if I try to create a new picture element, nothing happens.

  21. Sammie

    I really need help! I have looked at numerous tutorials and I have installed both HUD Maker and Super Tools Engine and I cannot find the SumRndmDde anywhere!

  22. Sardonic

    I am requesting a simple add-on to your excellent Hud-maker plugin.

    The plugin currently has an option that allows one to change whether the Hud is shown during events.

    I would like the ability to change this setting mid-game. If there is some script or code that would make this possible, I would find it extremely useful.

    Thanks to anyone who takes the time to read this request.

  23. DivaProtocol

    I’m having trouble with this plugin… the option to add a gauge image in the “create new element” section does not appear.
    How can I fix this?

  24. Zach

    Hey SumRndmDde I am having an issue with the new update of this plugin. When I edit my Hud everything shows up and it’s fine, but when I exit the hud menu the hud disappears and does not show up during game play could you please help . thanks.

    1. Zach

      I actually fixed the issue and it is very stupid. If you have the Js file named SRD_HUDMaker(#) where # is any number it will not read it properly which is what I did it must be named SRD_HUDMaker

  25. Flufflet

    Could you please release documentation for this plugin (like a .txt file or PDF ) and if there already is could you please leave a link to it?

  26. Tinkerer


    I’m trying to have HUD maker displaying different images/icons by using the picture EX option.
    I’ve named each picture 1, 2, 3, etc. And stored them in the img\SumRndmDde\hud\pictures folder of my project.
    A variable with ID 3 holds number values 1,2,3, etc.
    I’ve tried adding ${$gameVariables.value(3)} to the image value field in HUD maker, but don’t show.
    If I manually enter ‘1’ in the image value field the image does show….
    What am I doing wrong??

    1. Tinkerer

      Never mind! It decided to work after all….
      By the way, the correct input for the image field is not to use ${ }, in this case. So it should be $gameVariables.value(3). Where 3 is the ID nr for the variable you want to use.

        1. Hi_I'm_daft

          Ah, no edit feature…
          So, question about this, do you have to do something in particular to force the HUD to refresh the icons? It seems to not pick it up immediately when that variable value changes, so I’d imagine you have to do something to force it to switch images.

          1. BibleSalesman

            I’m having a similar issue. My game uses an event-based battle system, but the HUD only update once the events have run. Is there a way to increase the refresh rate so that it updates as variables change?

  27. Hugo

    When I use the “force action” in the troop all the HUD change opacity and the gauge bar stops to change, even if I receive damage. The gauge bars changes when the “force actions” ends.

  28. Virage

    First of all, I wanted to say how fantastic your plugin is. I managed to make my menu and all the battle hud. My project has my face and it’s because of you.

    Now, I have two questions:
    1. Do you have any documentation with the commands to use in the conditions of the images (for show / not show)?

    2. I have two projects, one where I test the compatibility of the plugins and the definitive one. If I want to export the changes I made in the test project, what do I care? Just the plugin or something else?

  29. Brad Fuentes

    I feel like this will be a fun thing to use, it reminds me of persona and it’s hud where you can see your team and their HP and SP

  30. Ashley

    This is Stelllarrrr. Now I can make the HUD I want without it jacking up anything! I’m in love. What would the conditional statement be though if I wanted to change the battle text colors in crisis mode or death?

  31. Johan

    Hud maker dont work on full screen? When I press f12 nothing happend, and I’m using GameUpgrade to leave the game at 1920×1080 and even then when I press f12 the HUD tab does not open, but when I open the project at 816×624 it works. Anyone else with this problem?

    1. asdasd

      Hud maker turn on at right side of your rpg screen.

      so, when fullscreen mode, you can find Hud maker window out of your monitor 🙁

  32. Deathwalker459

    I keep getting an error when I tried to pull it up with f12. It used to work perfectly.
    Uncaught Error: Invalid value for argument 2. Property ‘toolbar’: Unexpected property

  33. dongki

    Hello producer

    I am a beginner in Korea.

    The HUD Maker plug-in is really good

    I have questions and write.

    If there is no party member 2, will not the HUD be shown, and if there is a party member 2, is there a command to show the HUD?

    It’s too complicated to create a condition with a switch.

  34. Mike Leonard Cabagnot

    I have a plugin problem due to some errors of pre-title events and intro scenes. Since my games (‘Crisis of Bituin High’ and ‘Project: UpTimmyStic’) using Hime’s Pre-title Events, there is a one-second appearance of HUD’s appeared before entering the event, also appeared on introductory scenes. Maybe you just created a switch to disappear the HUD before the game starts.

  35. JDizzle383

    I can’t seem to get the “Gauge” images to appear at all. they are not even listed in the HUD maker drop down menu…
    Has ANYONE solved this issue?

    1. JDizzle383

      I figured it out. apparently you have to have the “Supertools Plugin Updater” Plugin in the project before the HUD Maker works properly even if the HUD Maker doesn’t need an update.

      weird right?

  36. Elanor

    I really wish this was compatible with the Character Creator EX Plugin! I tried to use them together but whenever a custom face is used it comes up with an undefined error. D: But other than that, great plugin! ^_^

  37. Tryce Hyman

    I’m trying to set a condition in the Battle Hud that will display elements only during a specific actor’s turn, and it’s been giving me no end of trouble. I’ve had limited success with === 1, for example, but it’ll throw an error out at me after a single turn and stop displaying the elements thereafter. I’d appreciate any insight to be had on this problem.

    1. ShdwRCK


      You have to first set the parameter in the plugin “Battle Global Condition”
      You had a switch for condition like $gameSwitches.value(1)
      (here is the switch is #1)
      Then, when your switch 1 is on, the Battle HUD is enable.
      You can configure your system of seeing and disabling the Battle HUD in your troop options battle events, making the switch 1 off everytime it is the actor’s turn.

      Hope it will help,

  38. Minositu

    Hello I have a error in the script Warning my english level is very poor Sorry! I put the actor face in the hud maker and a salvage error apears Says “cannot read property 0 of undefyned” please help!

  39. ZSF2004

    I’m wondering if it’s possible to enable the HUD at a certain time in the game. If it is, then that’s what I need right now.

  40. MurderHobo

    I was wondering if this could be used to make an enemy hp hud? That is, have it show up only during a battle and it has the enemy’s HP bar somewhere towards the upper right or left corner on the screen.

  41. Psychotica

    Hey I was wondering, I downloaded the plugin but when i use the HUD MAKER it only shows 4 options to choose from instead of image or actor faces etc. I cant use anything else so I was wondering if there was a fix for this.

  42. Sup3rfly

    so i am having variables that constantly change for time and date and i use hudmaker to show the date/time…
    first, a little annoying, when i display minutes and hours the text window with the variables will show 6:7 instead of 6:07. any idea how to fix this?
    second, is there a way to make my month variable which is a number from 1-12 display as Jan-Dec?
    any help would be great.

  43. Kristhor

    So now when I press F12 the Google Chrome Develop Tool opens… very annoying. I can’t set that on another key. Any way to set the HUB on another key? Or any other fix?

    1. Jbeun

      if you open SRD_SuperToolsEngine.js you have the folowing code:
      if(_.isPlaytest) {

      _.SceneManager_onKeyDown = SceneManager.onKeyDown;
      SceneManager.onKeyDown = function(event) {
      _.SceneManager_onKeyDown.apply(this, arguments);
      if(event.keyCode === 123) {

      The keycode == 123 is F12 button.
      To assign another one just change this value (ex 122 to F11). You can just google javascript keycode to get the one you want to use.

  44. Daniel Olsén

    So, yeah. This is great but its broken on me and won’t work again no matter what I do. Tried making so that a face showed the second actor in the party and the refresh crashed Supertools and now the game crashes with HUDMaker running. Removing and readding, pasting over and refereshing it doesn’t work. I have no idea where the face info is saved so I can’t manually scrub it either. Error in question: “cannot read property ‘faceName’ of Null”.

  45. Tryce Hyman

    More generally, from what I have figured out, if you want to use HUD Maker and SuperTools you are going to need to roll back RMMV to version 1.5

  46. Coffee_Zombie

    I’m trying to display variables in hud maker. I’ve read through the comments, watched the tutorials and used the google but no help so far. I have limited scripting skills. Is their a list of commands that I can use with hudmaker?

  47. Rise

    All I see are four elements in the “create element section.” Text, Text EX, Shape, and Picture. Text only shows the number of gold, shape only shows a circle, and text ex and picture show nothing. I made an image -> SumRndm -> hud folder to put the sample picture in but nothing happens. I want to know what I did wrong, please and thank you.

  48. Caluio

    Question: I noticed that the HUD pieces color get a bit darker when a message is being displayed. Is it possible to change that?

  49. Falko303

    Hey, was just wondering if someone could be me with making a conditional on a picture so that it only displays when a certain
    menu is active, for example

    I have a skill bar that I want to show up ONLY if the skill window is open and along with that, a picture that only shows up when the HELP window is open.
    That kind of thing, if anyone has a solution to this, I’d love to hear from you.

  50. yoda

    The game version works fine but no hud or images shows when you export to use on a web browser. Can I get some help? It doesn’t work when you pull up your game through a web browser. It needs to be configured for web browsers. Great plug in though, just need web browser support as our game is run through a web browser.

  51. Alby

    I have a question regarding the faces when placing them in the battle hud. I would like to have the face used change to a different emotion in the faceset during different circumstances. Mainly, when a character falls in battle. Is there a way to do this? If so, would you mind helping me out?

  52. Jazmine Cruthers

    Excellent post. I used to be checking constantly this blog and I’m inspired! Extremely useful info particularly the closing section 🙂 I handle such info much. I used to be seeking this certain information for a long time. Thank you and best of luck. |

  53. OML

    Hi folks. I’ve been up all night trying to figure this out to no avail. Could someone inform me of the HUD Maker property value I would need to use in order to get the equipped weapon for an actor ( say ID 150 in the actor database) displaying on the HUD? Is it possible? It would have to change automatically when equipped weapon is changed. Also, can the associated weapon icon be displayed along with it? Many thanks in anticipation.

    1. OML

      Managed to solve this issue:

      Assuming we’re dealing with actor1 in the database, the following will allow for display of the equipped weapon’s name.
      ${$[0] ? $[0].name : ”}.



Leave a Reply

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