View source for Pause

The '''pause''' command pauses the game until the player presses ENTER or ESC key.

== Syntax ==

pause();

== Remarks ==

A message box is displayed that says "Game paused. Press Enter to continue." Pressing ENTER or ESC will dismiss the window and the game will continue.
[[Reserved flag]] [[f15 (no pause windows)]] and [[reserved variable]] [[v21 (window close time)]] affect the pause window the same as any other message box. This means if you set f15 and then use '''pause''', the message box will be displayed, but the game won't actually pause.

== Possible Errors ==

None.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
pause();
[ equivalent print command:
print("      Game paused.\n"
      "Press Enter to continue.");
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 136 (0x88 hex)
|}

== See Also ==

[[System Commands]]<br />
[[Category:Commands]]<br />