# Game Screen

{% hint style="warning" %}
**NEW GAME MAKER 0.12 INFO COMING SOON!**\
The new release has a lot of amazing features, some of which impact the details on this page. Check back soon for an update, and in the meantime you can see a summary of all the updates in the [Changelog](https://docs.sandbox.game/en/creator/game-maker/version-notes-and-changelogs/game-maker-0.12).
{% endhint %}

## Use Cases:

* Showing items or money obtained for use as a game mechanic
* Displaying health/life count
* Displaying timers, stopwatches, laps, etc
* Displaying player status, progression, achievements, etc.
* Displaying warnings/clues
* Displaying important information for the player such as location, event announcements, etc.

{% hint style="warning" %}
Set **Broadcast Type** to *All* or *Rules* to send messages from objects to the Rules System.
{% endhint %}

## HUD

{% tabs %}
{% tab title="About" %}

<table data-card-size="large" data-column-title-hidden data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Share important information with players as needed via the HUD</strong></td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FOp6SN1n5mlEi4NnXqZpd%2FGM%20Rules%20top%20slot%20and%20dynamically%20show%20slots%20sm%20opt.gif?alt=media&#x26;token=444c8454-6618-4d9d-a835-7a9c129e6523">GM Rules top slot and dynamically show slots sm opt.gif</a></td></tr><tr><td>HUD slots appear when triggered.<br><br>Use multiple HUD rules to change HUD slots dynamically with your gameplay.<br><br>Customize slot color, size, style, icon, and format type for a unique feel.</td><td></td></tr></tbody></table>

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FX79CSVlVWB7TGnDPgKNY%2Fimage.png?alt=media&#x26;token=4d59c5fc-1fbd-4bda-83de-60278e0a7508" alt=""><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F6xCfuDjae5lnqIM2nwSz%2Fimage.png?alt=media&#x26;token=0fe195ff-88dd-49f3-83a0-cade5c397ace" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Details: Unlock Options " %}

#### Required Message

Add a custom **Required message** to unlock the HUD rule's options.

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FEo40vEkHCRWweXsnF1OP%2Fimage.png?alt=media&#x26;token=6207563b-ac10-42c4-980e-7cb564b7da64" alt="" width="306"><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FzICd5EEnOGt5RSj2RCdR%2Fimage.png?alt=media&#x26;token=5cf1a61b-24ec-4775-b1e1-8c89819449da" alt="" width="305"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Details: Style, Variable " %}

#### Style

Select a square or diamond HUD style to apply to all slots.

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FPoP5BKe49w9gHZZpv3HR%2Fimage.png?alt=media&#x26;token=4212aa80-2a13-486b-a352-c81d8f9a79ec" alt="" width="312"><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FUmfTtomiqx8fjFM1YPuH%2Fimage.png?alt=media&#x26;token=990bcfc9-02b9-453a-a9c8-b1cda9cbc82a" alt="" width="243"><figcaption><p>Square style</p></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FucIxcy0N5EMX02B2HIDM%2Fimage.png?alt=media&#x26;token=ba48f5e2-714e-4cc5-abe6-0ea1ea73f2ca" alt="" width="240"><figcaption><p>Diamond style</p></figcaption></figure></div>

#### Select Slot, Mode & Variable

<table data-card-size="large" data-view="cards"><thead><tr><th></th></tr></thead><tbody><tr><td><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FkQAhq3WXDgy0zIgYkGLU%2Fimage.png?alt=media&#x26;token=d0618ef0-ae9e-4e0e-a6de-e5e7e3586756" alt=""></td></tr><tr><td><p><strong>Select Slot:</strong><br>Click on a slot, click the <img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FeWllLgC43VIQKiwYSRLb%2Fimage.png?alt=media&#x26;token=b76d0beb-80f4-479f-a52e-e9213c31d54b" alt=""> pencil icon, and select a variable to display it on the HUD.<br></p><p><strong>Modes:</strong></p><ul><li><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2Fd4KnI0JbQ9AcfQJgxZMa%2Fimage.png?alt=media&#x26;token=f391383d-42f2-4f9c-b9ae-939861de4e0e" alt=""> - Unknown (a variable may or may not be assigned to the slot with another HUD rule)</li><li><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FeWllLgC43VIQKiwYSRLb%2Fimage.png?alt=media&#x26;token=b76d0beb-80f4-479f-a52e-e9213c31d54b" alt=""> - A selected variable will show</li><li><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2Fgyzzdc7Pj3S3jqoNtWy5%2Fimage.png?alt=media&#x26;token=3acf3018-99b2-44dd-ab22-8d2cb6df4615" alt=""> - The slot will not show</li></ul><p></p><p><strong>Variable:</strong> <br>Select a variable or create one.</p></td></tr></tbody></table>

#### Name, Icon & Size

Type a name for the variable to appear in the HUD, select an icon if desired, and select a size (small, medium, or large).

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F4MwtqdgodNa4iTN1KwNl%2Fimage.png?alt=media&#x26;token=17eecc29-2c28-4941-a1fe-f61fb1b40d91" alt="" width="224"><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FrRyNHMYua1dtQ4OthkCW%2Fhud%20slot%20sizes.gif?alt=media&#x26;token=d6320c73-766a-488f-ae84-4c3c998ce899" alt="" width="183"><figcaption><p>S, M &#x26; L slot sizes to emphasize <br>variables by importance</p></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FmdgHTpRTB7fkZhDqoXhq%2Fhude%20examples2.gif?alt=media&#x26;token=149189dc-253b-41df-b36e-31d202407595" alt=""><figcaption><p>Slot icons represent <br>custom game information</p></figcaption></figure></div>
{% endtab %}

{% tab title="Details: Value Formatting" %}

#### Progress Bar, Value, Type & Soft Limits

If you toggle the **Progress bar** to *Show*, you can enter soft limits for the variable. This only affects what values appear on the HUD. It is possible for other rules to modify the variable outside of these values.

If **Value** is set to *Show*, you can choose a **Type** to display it four possible ways: Value only, Value/max, Percentage, and Value (Percentage).

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F5WIdaUY2PbVN0rG2QM3p%2Fhud%20slot%20types.gif?alt=media&#x26;token=78136335-3440-4cad-980e-a4a7d3f30091" alt=""><figcaption><p>Slot types format variables in custom ways</p></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FwX8o4snLdj2i9nFGjzgB%2Fimage.png?alt=media&#x26;token=4bf72bf1-5dc7-41f8-bdfc-1d00aea01200" alt=""><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FJVquhDSx4KkPCcrvdZyM%2Fimage.png?alt=media&#x26;token=a0d0b7f5-3160-47ab-9f2f-db96846d2bd4" alt=""><figcaption></figcaption></figure></div>

#### Value State

Select a value state to change the color of the HUD slot. You can set the **Critical** state to animate with the **Animate** toggle.

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FlT8V5VcerdJpBLqdtLGU%2Fimage.png?alt=media&#x26;token=fa447a1b-aa7e-4813-9ce6-298a6d226240" alt="" width="222"><figcaption></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F2LdwAMMhBBj3zq1eo9VZ%2Fimage.png?alt=media&#x26;token=71b7c4e2-611b-4e25-9138-9be1355ad87c" alt="" width="255"><figcaption></figcaption></figure></div>

**Advanced:** You may set up a more dynamic HUD where slots change colours based on variable values. This setup requires a **HUD** rule and **Check if Number is in Range** rule for each coloured value state you want to display.

<div><figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FfKFinCH39YYxWl4SBv9R%2Fimage.png?alt=media&#x26;token=08e29811-920c-4a79-ad66-2e903f8e2893" alt=""><figcaption><p>Positive value state</p></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FlBzr4I48mOBKA0nQU9xv%2Fimage.png?alt=media&#x26;token=e257c178-7d1b-45ba-b095-b56a69fba19f" alt=""><figcaption><p>Warning value state</p></figcaption></figure> <figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FYqTav5IA8VBf3Cot9D0R%2Fimage.png?alt=media&#x26;token=cc382d4c-6319-44cc-a038-a2c816364950" alt=""><figcaption><p>Critical value state</p></figcaption></figure></div>
{% endtab %}
{% endtabs %}

## Show/Hide HUD

{% tabs %}
{% tab title="About" %}
This rule shows or hides the HUD depending on the true/false value.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FDzTPxOwGJLRnDqUb5kxS%2Fimage.png?alt=media&#x26;token=e9c44399-fed7-491f-ae3a-12555b9edf8e" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Details" %}

#### Required Message

Select the incoming message to trigger the rule.

#### New True/False Value

Select the source to get the true/false value to determine if the HUD should be shown or hidden:

* Variable - Select a true/false variable or create one.
* Message Argument - If the Required Message includes a true/false message argument, it will be applied here.
* Fixed Value - Enter a true/false value via a toggle.
  {% endtab %}
  {% endtabs %}

## Banner

{% tabs %}
{% tab title="Banner" %}

#### **Inform players about important events in your experience!**

The **Banner** rule is a handy way to inform your players about anything happening in your experience. You can set up individual texts that are displayed in the banner. It is also possible to show numerical values in the banner.

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2Fz2Qs5PFLAv6ArR4qRlgb%2FGM%20Rules%20banner%20popup%20window%20update%20sm%20opt.gif?alt=media&#x26;token=3687d2f1-6bcc-4c10-8419-b08a330ee5e1" alt=""><figcaption><p>Updated banner and popup window in Game Maker 0.10</p></figcaption></figure>

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FZ5JzQ3yrYiuLnpMeqlJK%2Fimage.png?alt=media&#x26;token=ea7cacf6-65fb-4bdc-a7a8-c17b713d8371" alt="" width="309"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Details" %}
**Required Message**&#x20;

The message to activate this tree. Every time this message is broadcast the tree will be triggered.

**Displayed variable**&#x20;

The variable set in the dropdown menu will be displayed on the banner. The variable’s display name will be shown on the left side while its value is shown on the right side of the banner. By using a text variable it is possible to display longer texts.

**Duration**&#x20;

There are three modes to define the time the banner is shown:

* **Variable** will allow you to define an existing variable to modify the number. This variable can be modified elsewhere using the **Roll a Random Number, Add/Subtract number** or **Set number value** Rules. A dropdown menu will appear to select a variable.
* **Fix value** will allow you to set up a constant value. An input field will appear to enter the number value.
* **Message Argument** will allow you to use an argument sent within the message. The message has to be created with an argument of the number type for it to be selectable here. A dropdown menu will appear to select the message argument.

**Message to send on close**

This message is sent after the Banner has disappeared.
{% endtab %}
{% endtabs %}

## Popup window

{% tabs %}
{% tab title="About" %}

#### Make it a teaching moment!

If you are using more complex gameplay in your experience you may need text elements to give the player the information he needs. For this you can use the **Show Popup** rule. It will show a small popup that has to be manually closed by the player by clicking the OK or Close Button. This will grab the player’s attention!

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2Fz2Qs5PFLAv6ArR4qRlgb%2FGM%20Rules%20banner%20popup%20window%20update%20sm%20opt.gif?alt=media&#x26;token=3687d2f1-6bcc-4c10-8419-b08a330ee5e1" alt=""><figcaption><p>Updated banner and popup window in Game Maker 0.10</p></figcaption></figure>

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FmfjQDOKudhdOxlnXIU8V%2Fimage.png?alt=media&#x26;token=dd8b4d70-2773-4358-9e09-419c589d3c72" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Details" %}
**Required message**&#x20;

The message to activate this tree. Every time this message is broadcast the tree will be triggered.

**Title**&#x20;

This will be displayed as the title of your text box to the player

**Description**&#x20;

This is the main body of your message to the player. It can contain a maximum of \~500 letters.

**Message to send on close**

This message is sent after the Popup has closed.
{% endtab %}
{% endtabs %}
