Scene Interpreter


This script allows you to execute common events in the current scene. For example, by default, if you use an item that executes a common event from the item menu, the menu will close and you will be taken to the map scene where the event will be executed.

With the scene interpreter, you can execute the common events right in the menu scene.

Furthermore, the scene interpreter allows you to create all sorts of complex behaviour such as switching between scenes or executing custom logic without having to do any scripting yourself. Previously, any of these mechanics would need to be scripted. Now, all you need is a common event to handle all of it.


Script: download here



  • Patch for Yanfly’s Ace Menu Engine


Place this below Materials and above Main. You should place this above other custom scripts


If you would like a common event to run in the current scene, create a comment in the common event command list with this string

<run scene: current>


You may also like...

104 Responses

  1. vpn special says:

    I am truly grateful to the owner of this web page who has shared
    this fantastic article at at this time.

    Here is my website … vpn special

  2. Roqgeg says:

    azithromycin 500mg over the counter – order flagyl 200mg oral ciplox

  3. Neywjk says:

    cleocin order online – purchase vibra-tabs generic chloramphenicol pills

  4. Peculiar article, exactly what I needed.

    my blog vpn special code

  5. Hey there! I know this is kind of off topic but I was wondering which
    blog platform are you using for this site? I’m getting sick and tired of WordPress because
    I’ve had issues with hackers and I’m looking at
    alternatives for another platform. I would be fantastic if you could point me in the direction of a good platform.

    Feel free to visit my web page vpn special code

  6. GSA List says:

    Hey there! Do you know if they make any plugins to help with SEO?
    I’m trying to get my site to rank for some targeted keywords but I’m not seeing very good gains.
    If you know of any please share. Thank you! You can read similar article here: Scrapebox List

  7. Good day! Do you know if they make any plugins to assist with SEO?

    I’m trying to get my website to rank for some targeted keywords but
    I’m not seeing very good results. If you know of any please share.
    Thank you! I saw similar text here: Backlink Portfolio

  8. Ivzlca says:

    purchase amoxil for sale – erythromycin 500mg pill generic ciprofloxacin

  9. Mcbdll says:

    amoxiclav without prescription – zyvox 600 mg ca cipro uk

  10. vpn special says:

    Does your website have a contact page? I’m having problems
    locating it but, I’d like to shoot you an email. I’ve got some creative ideas for your blog you
    might be interested in hearing. Either way,
    great website and I look forward to seeing
    it improve over time.

    My blog post: vpn special

  11. Vodmnn says:

    brand hydroxyzine 10mg – order amitriptyline pill endep 10mg ca

  12. Very good article. I’m going through many of
    these issues as well..

    Here is my homepage … vpn special code

  13. Nyyxop says:

    order clomipramine 50mg generic – pill tofranil sinequan 75mg pill

  14. Zhrneq says:

    order quetiapine 50mg generic – cheap ziprasidone 80mg oral eskalith

  15. Xagwwp says:

    clozapine pill – frumil 5mg pills brand pepcid

  16. e-commerce says:

    Hi! Do you know if they make any plugins to assist with Search
    Engine Optimization? I’m trying to get my blog to rank
    for some targeted keywords but I’m not seeing very good success.
    If you know of any please share. Many thanks! You can read similar blog here: Najlepszy sklep

  17. Jsjufp says:

    buy cheap pill generic zidovudine – rulide ca zyloprim 100mg without prescription

  18. Raezme says:

    metformin for sale online – lincomycin ca lincocin price

  19. Rdkhbs says:

    lasix ca – candesartan sale captopril 25mg brand

  20. Xivjbp says:

    ampicillin cost buy generic ampicillin generic amoxil

  21. Ccgfos says:

    buy flagyl 200mg generic – order flagyl 200mg pill cheap azithromycin 500mg

  22. Vnzhjv says:

    ivermectin 6mg tablets for humans – order ceftin sumycin 250mg pill

  23. Rhjwnh says:

    valacyclovir 500mg canada – nemasole sale zovirax 800mg brand

  24. Ywhfcq says:

    buy generic ciprofloxacin – buy generic amoxicillin over the counter
    buy erythromycin sale

  25. Botrjl says:

    order flagyl sale – buy flagyl 200mg without prescription purchase zithromax online cheap

  26. IsmaelGop says:

    Hey there! I’m at work browsing your blog from my new iphone! Just wanted to say I love reading through your blog and look forward to all your posts! Carry on the outstanding work!

  27. Ebcztf says:

    buy baycip pills for sale – buy augmentin online augmentin brand

  28. Hwftpa says:

    cipro oral – buy myambutol 1000mg for sale order generic augmentin 375mg

  29. Stephentom says:

    Наша организация осуществляет услугу Сдать медь в Алматы с профессионализмом и вниманием к потребностям клиентов. Мы специализируемся на выкупе различных видов меди, включая медный лом, отходы, изделия и сплавы. Наш опытный персонал обеспечивает качественную оценку и честные цены за сданный материал.

  30. DichaelShery says:

    I’m gone to say to my little brother, that he should also pay a quick visit this weblog on regular basis to obtain updated from most recent reports.
    is cloudbet ban on canada

  31. ecommerce says:

    you are in reality a excellent webmaster.
    The site loading pace is amazing. It kind of
    feels that you’re doing any distinctive trick. Also, The contents are masterpiece.
    you have performed a magnificent activity on this

  32. SDichaelShery says:

    Cialis Vs Levitra
    Cialis 5 mg prezzo prezzo cialis 5 mg originale in farmacia cialis 5 mg prezzo

  33. Health says:

    The articles you write help me a lot and I like the topic

  34. RoVerehr says:

    Hi Hime,
    I just found out when using both Scene Interpreter and Common Equip Events, equipment optimize option will cause game freeze, by setting a common event as interpreter and with a equip event.
    I tried some tests, when character does not have that armor(with the event interpreter) equiped, optimize works fine.
    Could you please look into it?

    Thank you!

  35. GuiltyAxer says:

    Hey Hime,
    I have a tiny problem :
    First, when I make a choice appear right after a message box, the latter disappears so I end up with just the choice list. I’m not really bothered by this but I noticed that on your screen shot, the message box AND the choices where together.

    Second, the real problem here…
    The choice list does appear, but it appears “behind” the menu, like this

    I’m using your large choices script and the Scene event animation add-on, they’re all above Yanfly’s Ace Menu, and the patch is below all of these scripts.
    I also removed them one by one and it didn’t solved the problem.
    I have a lot of other scripts but I don’t think they touch something that would change how your script behaves.
    If you think that’s a script compatibility issue however, I’ll test in a new project and add my scripts one by one to see if there’s a culprit, but I wanted your thought on this first.
    Thanks for reading and for all your scripting o/

  36. Xarabyss says:

    I would really love to see this script converted to MV. Its perfect for making in game tutorials.

  37. waynee95 says:

    Any plans porting this to MV?

  38. kevin eontrainer says:

    Hime, please make a compatibility patch with your Splash Screen Map script.. Thanks

  39. SweetMeltyLove says:

    On a brand new project, I just made the potion item call a common event, and in that event all I have is the script calling <run scene: current> getting this error when I use the potion:

    Script 'Game_Interpreter' line 1414: SyntaxError occurred.

    unexpected '<'
    <run scene: current>

    The scene interpreter is right above Main

  40. WH says:

    How would I make the game change scene to map mid-event? I have items that affect the map after a choice but I’m not entirely sure how to do so.

    • Hime says:

      You can use the script call
      To go to the map.
      Using “call” allows you to “return” to the previous scene (assuming the previous scene is not necessarily known beforehand)

      You can return to the previous scene using

  41. Resinate says:

    i dont know if ur still updating, but when i applied a common event to change chars actor/face image
    it doesnt work on equip until i back out of the equip menu then it shows correctly. is there a way to make it refresh or update on equip?

    • Resinate says:

      common event on an equip to change chars actor/face image***

    • Hime says:

      The problem here is that the windows are not updated.
      When you exit and open the scene again, it redraws the face.

      I am not sure what would be a good way to refresh the current windows. See if someone on the forums can give a recommendation.

  42. Disponi says:

    I seem to be running into a bit of a bug: whenever I call a common event through the menu but not using the scene interpreter, and then call a common event with the scene interpreter, I get a game crash. Any idea how to fix it?

    • Hime says:

      How are you calling the event through the menu?

      • Disponi says:

        Through items. I even tested it out in a clean project. One item calls a common event with the scene interpreter, the other does not. Both work the way they should by themselves, but if you use the item that calls a common event WITHOUT the scene interpreter, and then use the item that calls a common even WITH the interpreter, the game crashes.

  43. Tedj says:

    can I play common event on battle with this….? thanks..!

  44. John says:

    This script doesn’t seem to be compatible with your Effect: Common Event script. When I use a skill form the menu that has a common event effect, the menu closes and the common event runs on the map scene as it normally would.

  45. Hikomarukun says:

    Thank you for this script, and sorry to necro – but I might have found an incompatibility (?). I added the scene interpreter to my game, but got this error:

    Script ‘Scene Interpreter’ line 104: NameError occurred.
    undefined method ‘run’ for the class ‘Module’

    Any ideas?

    Thanks again!

  46. Ninkoro says:

    your script use to work for me, but I recently updated it and now I get
    “undefined method ‘run_scene’ for nil:NilClass” for line 182…
    Could you take a look at it?

    • Ninkoro says:

      Sorry, line 217

    • Hime says:

      I created a common event that runs in the current scene and simply displays are a message. I then used an item that called the common event, and it worked. Can you provide more information on the issue?

  47. Ash says:

    Nice script , tsuki,……………
    anyway can I use this on battle, so that I can play movie on my skill via common event,…….?

  48. Trace says:

    hey tsukihime . . .
    i have a question . . .
    i create a custom menu command that access common event

    def create_party_window
    @party_window.set_handler(:common_event_9, method(:command_common_event_9))

    def command_common_event_9
    SceneManager.goto(Scene_Map) if $game_temp.common_event_reserved?

    and i don’t get the message in the common event 9 running in the menu
    any help ?

  49. Sixth says:

    I just wanted to check up on this script, as it is useful.
    But the last time I checked it, it created serious memory leaks endlessly, which is not something I would like to do in a game for sure.
    I debugged it with Mithran’s GOBJ scripter’s tool, and it kept reporting hell of a lot memory leaks after each scene changes.
    Is this fixed yet, or not? Thanks for the answer in advance!

    • Hime says:

      I missed this message completely. When I looked at the fix, it’s pretty obvious there’s a memory leak.

      I will see if there is a better way around the issue, since anyone that’s creating their own message windows for their scenes would have this problem.

      For now, your fix will handle the default scenes.

  50. KanaX says:

    Is there a way to execute the common event when you press the B button to enter the menu? I have made my own menu and I want the rest of the events to stop updating when It’s active.

    • Hime says:

      You will need to modify the menu-calling logic in the map scene to call the common event rather than opening the menu.

      • KanaX says:

        Ok, I completely disabled the command menu and left only the bitmap. The thing is that now when I try to use script calls like “” etc etc they both operate and often the event is over the new command. Is there a way to fix this?

  51. RJ says:

    This is what I got:
    <run scene: current>
    Show Choices:
    [ Option 1]
    (some stuff, heal HP, etc.)
    [Option 2]
    Show Picture […]

    I suppose this is a bug: the Show Picture command seems to not work at all?
    Or maybe show picture was never intended to work with another scene active, anyways.

    Hope that gets fixed if it can.

  52. this is brilliant. I have weapons that change a character’s class, but the events handling the class changes were not being called until the ENTIRE main menu was left. this script fixes that problem, making the class changes immediate! thanks 🙂

  53. Justin M says:

    Is there a way to refresh the screen after you perform the common event? Because as it stands, I convert an item into a new one with your awesome script but you can’t see the new item until after you perform the action again, or change menus / screens.

  54. Mark McKeich says:

    Well that’s odd, the disposed window error is gone but now the common event command still takes you to the map, instead of running it in the menu scene.

    • Hime says:

      I’m not sure how to set up the menu script but looking at the common event menu commands, it explicitly makes calls to return to the map, which should explain why it’s going back to the map.

  55. Mark McKeich says:

    I’m having an issue with this script.

    I’m trying to create a really simple in-menu crafting system through a common event. The common event is activated using Yanfly’s Ace Menu script, whereby selecting said command in the main menu will run a common event. Anyway, I’m testing this out, and when said common event is run (and this event has the tag), I get a disposed window error.

  56. RogueDeus says:

    Do you prefer that I post issues on the blog like this? Or should I tell you some other way?

    I am completing my script compilation testing, to make sure they do not clash with each other at this moment, and am about to begin creating the content, so I may run into several more in the long process.

    I am beginning to think I am cluttering up your blog with bug/issue reports. :p

    I look forward to the update to your Scene Interpreter.

  57. RogueDeus says:

    Anomaly found. 🙂

    I am not sure if the interpreter is clashing with Yanfly Battle System, or if its a genuine bug, but when I change equipment (using Yanfly Command Equip) and your ‘Equip Events’ script fires off a text msg, I exit the equip menu at that moment, before the text msg completes, and re-enter the combat scene, the text msg ends up completing in the combat scene and the battle menu never shows up. Just a battle scene with no options, or way to exit. (Game Breaking)

    If its a compatibility issue I will understand if you don’t tackle it. 🙂

    Your scripts have become invaluable to my project.
    Thank you!

    • Tsukihime says:

      Another dev mentioned that there were issues with my scene interpreter and message windows, where the focus is not given to the message window if it’s active. It sounds like the issue only occurs if the message does not finish before you exit the screen, so I will look into forcing the message to finish before you can do anything else.

  58. RogueDeus says:

    Another anomaly to report!

    For some reason, when running a ‘fade-screen’ or ‘wait’ command from a common event, when invoked from an item or skill use (such as from an item used to simulate a rest) neither command ever finishes to move onto the next command in the event. It doesn’t freeze the game, it just seems to never finish the event.

    I tested this in clean events with a text msg, a wait, and a second text msg. The second text never shows. Ditto with fade-out and fade-in screen events (minus the wait), no fade-in occurs. The screen is blank, but otherwise completely playable; activating triggers, etc…

    I can only guess there are more commands this occurs on, but I only ran into those as I have yet to try others from item use.

    • Tsukihime says:

      I have reproduced the issue. This script introduces a bug where activating a common event from an item/skill and returning to the map causes the common event to just stop running after the first command.

      I have updated the script to address this bug. However, note that you are unable to fadein or fadeout unless you’re on the map or battle. I have played around with ways to get the fadein/fadeout to work in any scene, but it is still under consideration.

  59. RogueDeus says:

    This script is one of the most useful, little, scripts I have used so far. Thanks!

  60. amicable says:

    when I found this script, I did a little dance. thank you so much for it!

  61. Psylau says:

    I have a problem with this script.
    When i try a Skill with User-Target (for example a healing spell from the menu) I get a error in line 132. “undefined method ‘run_scene’ for nil:NilClass”
    I just copied the script, what do I do wrong?

  62. Tsukihime says:

    Script updated with new usage.

  1. October 13, 2014

    […] fixes have been implemented for the Scene Interpreter. One has been an outstanding issue for a long time, and the other was recently reported to […]

Leave a Reply

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