Menus modified by Brynner

Brynner — Mon, 20 Feb 2023 05:02:08 -0000

Menus

Menus

The menu command is hardly used anymore, but can be helpful for a few quick
setups.

menu "<menu option>",<label>{,"<menu option>",<label>,...}; // Thanks to Dj-Yhn

This command has two parts to it, the menu option (which is what the users see
to select) and the label (where the menu option takes them if they select it)

menu "Option 1",L_GoToOption1,"Option 2",L_GoToOption2;

L_GoToOption1:
mes "You chose option 1";
close;

L_GoToOption2:
mes "You chose option 2";
close;

While this is nice, there is also a nifty little trick to this command. Notice
that L_GoToOption1 is directly under the menu command itself? We don't need to
use a label for this option, because we can tell the menu command to simply
continue to the line down by replacing the label name in the menu line with a
-.

menu "Option 1",-,"Option 2",L_GoToOption2;

mes "You chose option 1";
close;

L_GoToOption2:
mes "You chose option 2";
close;

Now we have a simplified menu command that only uses one label, rather than
two.

Select Command

The Select command followed by the Prompt command are now usually the top two
contenders for menu selection.

select "Option"{,"Option",...,"Option"}; // Thanks to Dj-Yhn
select "Option 1:Option 2";

Rather than selecting an option and then moving to a label, you get a returned
value for the option selected. @menu is a character variable that is set after
selecting an option.

Example 2.1 - Standard Select Command Setup

select "Option 1","Option 2";

if (@menu == 1) { mes "You chose option 1"; }
else { mes "You chose option 2"; }
close;

This can be further broken down into an even more efficient method.

Example 2.2.1 - Optimizing the Select Command

if (select("Option 1","Option 2") == 1) { mes "You chose option 1"; }
else { mes "You chose option 2"; )
close;

Select also has a different setup than the Menu Command. Notice that there are
no labels anymore? That's because we use values returned rather than going to
different places.

In the second example, you will notice that the select command can run with a
single string separated by a colon for each option. This can be quite handy
with arrays and dynamic menu setups, however that will come in a more later
discussion.

For a simple method, I will demonstrate how to include a GM Option to your
menu that only GM Players can see.

Example 2.2.2 - Optimizing the Select Command

switch(select("Option 1:Option 2")) {
  case 1:
    mes "You chose option 1";
    break;



  case 2:
    mes "You chose option 2";
}
close;

You can also jump right into the switch statement with the Select() command.
Rather than using the predefined @menu variable, you can simply switch the
command itself.

Example 2.3 - Using a Unique Variable for Returning an Option Choice

set .@playerChoice, select("Option 1:Option 2");
set .@myOtherChoice, select("Option 1:Option 2");

By looking at these, if we were to only use the standard @menu, they would
overwrite each other, simply for the fact that each one of them would attempt
to store @menu as the index chosen. By placing a set and a variable before to
the select returned value, we can now distinguish between the two menu options
selected.

set .@menu$, "Player Option 1:Player Option 2";

if (getgmlevel() &gt;= 99) { set .@menu$, .@menu$ + ":GM Menu"; }

switch(select(.@menu$)) {
  case 1:
    mes "Player Option 1";
    close;

  case 2:
    mes "Player Option 2";
    close;

  case 3:
    mes "GM Menu";
    close;
}

Normal players will not be allowed to choose the case 3 option of GM Menu,
because it is not added to the menu list unless they meet the criteria of
being a level 99 GM.

This can be tricky when trying to add more than a single added option based on
criteria due to the fact that the case might not be in order, if you don't add
the options. This will be discussed in the "Advanced Scripting" area later.

Prompt Command

The Prompt command followed by the Select command are now usually the top two
contenders for menu selection.

prompt "Option"{,"Option",...,"Option"}; // Thanks to Dj-Yhn
prompt "Option 1:Option 2";

The prompt command works exactly like the select command however a value of
255 is passed back to the script if the user decides to choose the CANCEL
button that is automatically generated by menus.

Example 3.1 - Quick Example of the Prompt Command

prompt "Click Me:No Click Me";



if (@menu == 255) { mes "You should not have closed the menu... BAD BOY!"; close; }

[Category:Scripting]

Recent changes to Menus

Menus modified by Brynner

Menus

Menu Command

Example 1.1 - Standard Menu Command Setup

Example 1.2 - Optimizing the Menu Command