Switchable Text Plugin v1.0 for RPG Maker MZ

Hey RPG Makers!

This Switchable Text plugin by McKathlin allows you to change text dynamically depending on switches, self switches, and variables!

Download Switchable Text Plugin MZ

Visit Store to Download

How to Install

  1. Download the file, and unzip it.
  2. Make sure the unzipped file is named McKathlin_SwitchableText.js and is saved as a .js file.
  3. Open the file folder of your project. Place the file in your project’s “js” folder, within the “plugins” folder.
  4. Open your project in RPG Maker MZ, then go to the Tools menu and select Plugin Manager. Use the Plugin Manager to add and activate the plugin.
  5. I recommend you place this plugin toward the bottom of your plugin list, so it has high priority.

Further Explanation

Modify text depending on the player’s decisions!

Depending on values of switches, self switches, and variables, you can dynamically change the text that is shown in any of the following:

  • Show Text
  • Name Window (of Show Text)
  • Show Choices
Dynamically change the choices that appear in the Show Choices window!

Depending on values of switches, self switches, and variables, you can change which choices are visible in the Show Choices window! You can make a choice be present or absent! Using this, you can make new choices appear based on the player’s decisions, or you can make a previously available choice disappear!

Dynamically modifying which choices are shown is one of the most powerful features of this plugin!

Text that Feels Tailored to the Player

With the Switchable Text plugin, your events will feel so much more personal to the player’s choices in the game! The messages will feel tailored to the player! All while saving yourself from the messy event contents that occur when trying to make dynamic messages without the Switchable Text plugin!

Once you use the Switchable Text plugin for your project, you will wonder how you ever lived without it!

Example uses:
  • Change an event’s name in the Show Text Name Window, depending on whether the player knows the event’s name yet or not.
  • Depending on the values of switches, self switches, or variables, dynamically modify which choices appear in a Show Choices command!
  • Put an event’s dialogue on a loop, then make the event say something different depending on whether it is first time or a subsequent time through the loop.
  • Modify the text, depending on the number of characters in the player’s party. (This can be done by storing the party size in a variable.)
  • Modify the text depending on whether a specific character is in the player’s party. (This can be done by using a variable or switch to track whether a specific character is in the player’s party.)

Example: Using Switchable Text, we make an event that has text the first time a loop occurs, then different text when repeating the loop! Also, if the player has learned the event’s name, the event name window text changes, and a new option appears in the Show Choices command!

Help Documentation

McKathlin Switchable Text for RPG Maker MZ
v1.0, released 9/3/2020

Desciption of Plugin:
This plugin enables text codes for use in messages or dialogue choices. Text is inserted in place at runtime based on state of the referenced switch or variable.

How to use this plugin:
To start a switch-based snippet, use one of the following text codes:
- ON[ID]{text} Show the contained text if the switch is ON (true).
- OFF[ID]{text} Show the contained text if the switch is OFF (false).
- ON[ID]{foo}{bar} Show "foo" if switch is on; otherwise show "bar".
- OFF[ID]{blue}{red} Show "blue" if switch is off; otherwise show "red".
An integer ID will check the corresponding game-wide switch. If the ID is the letter A, B, C, or D, then the calling event's self switch is checked.
Start a variable-based snippet with a statement like this:
- OV[vID>=N]{text} Show the text if the variable with the given ID has a value greater than or equal to N.
- OV[vID==N]{foo}{bar} Show "foo" if the variable's value is equal to N; Otherwise, show "bar".
The following comparison operators are valid for variable-based snippets:
  == Equal
  != Not equal
  >= Greater or equal
  > Greater than
  <= Less or equal
  < Less than
If a dialogue choice ends up empty for a given Switchable state, it will not appear in the player's list of dialogue choices. This allows available choices to vary dynamically based on game state.
Due to Switchable Text's use of curly braces as delimiters, any text in which switchable snippets and literal curly braces both occur will need to escape the literal curly braces thus:
- BO Opening brace {
- BC Closing brace }
- Good ON[21]{evening}{day}, OFF[A]{stranger}{friend}. Go safely. OV[143<=10]{Watch out for wolves.}
This plugin does not use any parameters or plugin commands.

Terms of Use:

1. You joined Tyruswoo.com as a paying member when you downloaded this plugin. You do not have to remain a paying member to use the plugin you downloaded. However, your support is greatly appreciated, and allows me to continue improving and updating plugins.
2. You agree to not redistribute this plugin. You agree to direct others to Tyruswoo.com if they want the plugin.
3. You may use this for any game for which you are one of the main developers. This includes any commercial or non-commercial game you are creating.
4. Adding "McKathlin" to your game's credits is greatly appreciated, but not required.
5. Likewise, listing which Tyruswoo Team plugins you used is appreciated, but not required.
6. A free copy of your game is awesome, but not required.

Enjoy the Switchable Text plugin by McKathlin! Remember, only you can build your dreams!



  • Software Engineer
  • Pixel Artist
  • Music Composer
  • Sound Engineer

Indie Game Designer creating game content!

Articles: 267

Leave a Reply