User Tools

Site Tools


4rpl:commands:showgamemessage

Index

ShowGameMessage

ShowGameMessage(<-messageID <-button0Text <-button1Text <-pauseGame <-messageChannel)

Description

Shows a game message by message key. A game message is a popup message that appears at the top of the screen.

messageID
the ADA message ID to show. Create a message using the ADA message editor, and reference it via it's ID.
button0Text
and
button1Text
show one or two buttons. If you don't want button(s), set them to “”. Otherwise buttons will be shown and the specified text will be on the buttons.
pauseGame
true to auto pause the game.
messageChannel
the name of the message channel to broadcast on when a button is pressed.

If a button is shown, a message will be sent when the button is pressed. A variable named '_DATA' will contain either a 0 or 1 to indicate which button was pressed.

In order to allow the player to close the message, a script must be registered for the message channel specified using RegisterforMsg and contain a CloseGameMessage instruction in the callback function, with the parameter set to “True” The callback function need not be the same script as the script making the call.

If a message is already showing, then calling this function will do nothing. If you want to replace the message, you must first call CloseGameMessage if there is already a message showing.

Note: You can use “\n” to create a line break in the button text.

Examples

ShowGameMessage("MyMessage" "Yes" "No" true "GameMessageCallback")
 
:Once
RegisterForMsg("GameMessageCallback" "GameMessageCallbackFunction")
 
:GameMessageCallbackFunction
   <-_DATA ->result
   if (<-result eq0)
      print("Button 0 Pressed")
   else
      print("Button 1 Pressed")
   endif
   CloseGameMessage(true)	

See also

4rpl/commands/showgamemessage.txt · Last modified: 2024/01/27 15:10 by durikkan