PrivateconstructorOptional ReadonlycancelationThis property can't be read in early-execution mode.
import { Player, system } from "@minecraft/server";
import { ActionFormData, FormCancelationReason } from "@minecraft/server-ui";
// Run `/scriptevent example:whyshopclosed` in chat to open the form.
system.afterEvents.scriptEventReceive.subscribe(({ id, sourceEntity }) => {
if (id !== "example:whyshopclosed" || !(sourceEntity instanceof Player)) return;
const form = new ActionFormData();
form.title("Item Shop");
form.button("Buy Apple");
form.show(sourceEntity).then((response) => {
if (!response.canceled) {
sourceEntity.sendMessage("Purchased an apple.");
return;
}
// `cancelationReason` explains why the form closed without a selection.
if (response.cancelationReason === FormCancelationReason.UserBusy) {
sourceEntity.sendMessage("Could not open shop because you were busy.");
} else if (response.cancelationReason === FormCancelationReason.UserClosed) {
sourceEntity.sendMessage("You dismissed the shop menu.");
}
});
});
ReadonlycanceledIf true, the form was canceled by the player (e.g., they selected the pop-up X close button).
This property can't be read in early-execution mode.
import { Player, system } from "@minecraft/server";
import { ActionFormData } from "@minecraft/server-ui";
// Run `/scriptevent example:questboard` in chat to open the form.
system.afterEvents.scriptEventReceive.subscribe(({ id, sourceEntity }) => {
if (id !== "example:questboard" || !(sourceEntity instanceof Player)) return;
const form = new ActionFormData();
form.title("Quest Board");
form.button("Accept Quest");
form.show(sourceEntity).then((response) => {
// `canceled` is true when the player closed the dialog without choosing an action.
if (response.canceled) {
sourceEntity.sendMessage("You closed the quest board without accepting.");
return;
}
sourceEntity.sendMessage("You accepted the quest.");
});
});
Optional ReadonlyselectionThis property can't be read in early-execution mode.
import { Player, system } from "@minecraft/server";
import { MessageFormData } from "@minecraft/server-ui";
// Run `/scriptevent example:pickdifficulty` in chat to open the form.
system.afterEvents.scriptEventReceive.subscribe(({ id, sourceEntity }) => {
if (id !== "example:pickdifficulty" || !(sourceEntity instanceof Player)) return;
const form = new MessageFormData();
form.title("Difficulty Prompt");
form.body("Increase monster spawn rate for extra loot?");
form.button1("Yes, Increase");
form.button2("No, Keep Normal");
form.show(sourceEntity).then((response) => {
if (response.canceled) return;
// `selection` is 0 when the player presses `button1` and 1 for `button2`.
if (response.selection === 0) {
sourceEntity.sendMessage("Harder difficulty selected.");
} else {
sourceEntity.sendMessage("Normal difficulty kept.");
}
});
});
Returns data about the player results from a modal message form.
Example: showBasicMessageForm.ts
Example: showTranslatedMessageForm.ts
Source