---
description: Section 7.A.2
---

# UI: Poke Ball Shortcut

This UI allows you to quickly use a Poke Ball in battle, without having to go through the Bag menu to select a ball. The design and function of this UI emulates the Poke Ball UI used in _Pokemon Scarlet & Violet_, which allows you to scroll left and right through your entire Poke Ball inventory, as well as pressing a button to view details about each ball.

***

<mark style="background-color:orange;">**Accessing the UI**</mark>

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FHPrLeyQH917zQSyBmGOC%2F%5B2024-05-02%5D%2009_33_06.295.png?alt=media&#x26;token=d8ea4a97-3ee3-4da0-a4bb-78b9f9973720" alt="" width="384"><figcaption><p>Ball (S) key prompt.</p></figcaption></figure>

A "Ball" prompt will appear in the bottom left hand corner of the battle screen to indicate that you can open the Poke Ball Shortcut UI with the press of the `JUMPDOWN` (S) key. This prompt will not display if `UI_PROMPT_DISPLAY` is set to zero.&#x20;

This prompt will also be hidden if any of the following is true:

* The battle is a Trainer battle.
* The battle is a Battle Tower or PvP-style battle where items cannot be used.
* The disablePokeBalls Battle Rule is enabled for this battle.
* The battle is a wild Safari Zone encounter, or the player is in the Bug Catching contest.
* There are more than one wild Pokemon targets, preventing a ball from being thrown.

***

<mark style="background-color:orange;">**Navigating the UI**</mark>

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FwvU729uBAEHYj0KLT5WS%2F%5B2024-05-02%5D%2010_38_36.640.png?alt=media&#x26;token=cd95ea21-a446-45e7-91e6-5264a2246b63" alt="" width="384"><figcaption><p>Shortcut UI display.</p></figcaption></figure>

When accessed, a window will appear above the Command Menu displaying your inventory of usable Poke Balls. The specific ball that your cursor highlights by default when you open this UI will be whichever ball you last previously used or viewed in your Bag. Below the icon of each ball, there will be a number which reflects how many of that specific ball you have left in your inventory.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2Fo0pUQi0Y3Lxx1ilqgpRn%2Fpokeball.gif?alt=media&#x26;token=660aa0b8-7702-46f9-bea2-319a19c86af8" alt="" width="381"><figcaption><p>UI controls and navigation.</p></figcaption></figure>

You can scroll through each ball in the list with the Left/Right keys. Holding either of these keys will quickly scroll in that respective direction instead. Pressing the `JUMPUP` (A) and `JUMPDOWN` (S) keys will instead automatically scroll you to the start or end of the list, respectively. Pressing the `ACTION` (Z) key will open an additional window in this UI that will display the description of your currently highlighted ball, allowing you to view details about its specific properties.

<figure><img src="https://2153694798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvzqYxbzoSOVtGkOgfRUQ%2Fuploads%2FRVQmmwOkk06Au0tTZdmM%2Fpokeball2.gif?alt=media&#x26;token=b582adc6-346f-4e98-b78a-552a2b133e3a" alt="" width="381"><figcaption><p>Throwing a selected ball.</p></figcaption></figure>

Once you've decided on a Poke Ball you wish to use, simply press the `USE` key to immediately use that Poke Ball. Note that if for some reason a Poke Ball cannot be used on the wild Pokemon (the target is out of range due to Fly/Dig, for example), then a message will display to inform you of this instead, and the ball will not be thrown.
