> For the complete documentation index, see [llms.txt](https://rtx-dev.gitbook.io/rtxdev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rtx-dev.gitbook.io/rtxdev/rtx-minigolf/guides/playing-minigolf.md).

# Playing Minigolf

Open the menu, step up to the ball and putt.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FGSr9559CGPFPKfPPMzLo%2Frtx-minigolf-course-menu.webp?alt=media" alt="The minigolf course menu"><figcaption><p>The course menu - the course record, your best, the game modes and the match settings.</p></figcaption></figure>

{% hint style="info" %}
**Watch it:** [A full round - 1:17](https://www.youtube.com/watch?v=A3XYeAEIR8A\&t=77s)
{% endhint %}

Everything a player needs to know to play a round of minigolf.

{% stepper %}
{% step %}

### Find a course

Every course has a blip on the map. Type `/minigolf` for the **course finder** - every course by distance, its record, your best and a waypoint.
{% endstep %}

{% step %}

### Open the menu

Walk to the start of the course, behind the first tee, and press **E**. The menu has three tabs:

* **Play** - the course record, your best, the game modes and the match settings
* **Leaderboard** - all time, this month and this week, and the record of every hole
* **Manage** - only for the job that runs the course and admins
  {% endstep %}

{% step %}

### Pick a game

Choose **Turns**, **Together**, **Solo** or **Practice**, the ball, the stroke limit and the aim guide, then **Start the round**. See [Game Modes & Matches](/rtxdev/rtx-minigolf/guides/game-modes-and-matches.md).
{% endstep %}

{% step %}

### Watch the hole

Every hole opens with a short fly-over from the cup to the tee, and a card with the name of the hole, its par and its length. Any key skips it.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2Flc3awicf9ixiu8AesYpV%2Frtx-minigolf-hole-fly-over.webp?alt=media" alt="Hole fly-over with the hole card"><figcaption><p>The fly-over ends at the tee with the card of the hole.</p></figcaption></figure>
{% endstep %}

{% step %}

### Putt

Walk to your ball and press **E** to step up to it. Aim, pull back for power and let go. See [Putting, Aim & Cameras](/rtxdev/rtx-minigolf/guides/putting-aim-and-cameras.md).
{% endstep %}

{% step %}

### Finish the round

After the last hole every player gets the full scorecard - every hole, every player, the total and the score to par. A new personal best or course record is shown right on it, and the host can start a **rematch** with one click.

<figure><img src="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FDEKlPvrkZWLNxY3329ZC%2Frtx-minigolf-scorecard.webp?alt=media" alt="Minigolf scorecard after the round"><figcaption><p>The scorecard after the last hole.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Keys

| Key          | Action                                                          |
| ------------ | --------------------------------------------------------------- |
| `E`          | Open the menu, step up to your ball                             |
| `G`          | Match menu - score card, power control, give up the hole, leave |
| `TAB` (hold) | Score card of all players                                       |
| `C`          | Switch the camera - your view, follow the ball, the whole hole  |
| `Y` / `N`    | Accept / decline an invite                                      |

`E`, `G`, `TAB`, `C`, `Y` and `N` can be rebound in **Settings → Key Bindings → FiveM**.

***

## The Hole Card

During a match the card in the top left corner shows:

* the hole, its par and its name
* your strokes, your total and your score to par
* the distance from your ball to the cup
* who is on turn and the shot clock

Players standing next to a course that is playing see the card of the player on turn too.

***

## Banners

Every player of the match sees a banner for:

* **Hole in one**, **Albatross**, **Eagle**, **Birdie**, **Par**, **Bogey**, **Double bogey**
* **Lip out** - the ball was too fast and jumped out of the cup
* **Your turn**

A hole under par plays a cheer animation, a hole two over par a face palm.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Birdie</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FliFre0DBwktq625JnWn9%2Frtx-minigolf-birdie-banner.webp?alt=media">rtx-minigolf-birdie-banner.webp</a></td></tr><tr><td><strong>Lip out</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2FR234KAzO3rQe64IYMTYh%2Frtx-minigolf-lip-out.webp?alt=media">rtx-minigolf-lip-out.webp</a></td></tr><tr><td><strong>Your turn</strong></td><td><a href="https://1804361591-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCGSsnvBAI11nCFRWfpsr%2Fuploads%2F8fbRqCpP45dOL3jk8BTs%2Frtx-minigolf-your-turn.webp?alt=media">rtx-minigolf-your-turn.webp</a></td></tr></tbody></table>

***

## Penalties

| What                                       | Penalty                                                  |
| ------------------------------------------ | -------------------------------------------------------- |
| The ball leaves the course                 | +1 stroke, the ball is put back where it was putted from |
| The stroke limit is reached without holing | +1 stroke, the hole ends                                 |
| The shot clock runs out                    | Counts as one stroke                                     |
| Out of time three putts in a row           | The player leaves the match                              |

All of them are set in `Config.Match`.

***

## Leaving a Match

* `G` → **Leave**, or type `/minigolfleave`
* Walking away from the course, leaving the city or going down also leaves the match
* The others play on