イベントの各選択肢にテキストを動的に設定できるプラグイン – HIME_ConditionalChoiceText.js

-------------------------------------------------------------------------
== Description ==

RPG Maker allows you to offer your players choice selection, and
depending on which choice they pick, your events will behave differently.

However, what happens if you wanted to have a particular choice display
a different text, depending on whether certain conditions have been met?
Maybe if you haven't found an item that allows you to understand what the
locals are saying in a foreign language, all of the text that is shown
will be garbled.

In particular, if you combine it with a plugin that allows you to disable
choices, you could show question marks instead of the actual text.

With this plugin, you can easily change a choice's text using events.

== Terms of Use ==

- Free for use in non-commercial projects with credits
- Contact me for commercial use

== Change Log ==

1.1 - Dec 27, 2015
choice text is now evaluated in the interpreter
game message returns choices with updated text
1.0 - Nov 6, 2015
initial release

== Usage ==

There are two ways to set the choice text.

1. Using a plugin command.

Create a plugin command and write

choice_text choiceNumber customText

Where the `choiceNumber` is the number of the choice that the text
will apply to, and `customText` is the text that you want to change
to. You can include spaces in your text.

For example, if you want to change the second choice's text to
"???" you can write

choice_text 2 ???

It is up to you to set up the conditional branches appropriately.

2. Using a script call

Create a script call and write

this.choice_text(choiceNumber, customText, condition)

Where the `choiceNumber` is the number of the choice that the text
will apply to, and `customText` is the text that you want to change
to.

The `condition` is a valid formula that evaluates to true or false.
The specified choice's text will only be changed if the condition
is true.

To change the second choice's text to ??? assuming switch 3 is OFF,
you can write

this.choice_text(2, "???", "$gameSwitches.value(3) === false")

-------------------------------------------------------------------------