> For the complete documentation index, see [llms.txt](https://hamer.gitbook.io/hamer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hamer.gitbook.io/hamer/scripts/darkrp_racing/scoreboard-text-format.md).

# Scoreboard Text Format

Scoreboard left and right text format example in config/client/config.lua

```lua
Config.Game.Scoreboard.LeftTextFormat = "player_name" -- Default Z scoreboard display text format left.
Config.Game.Scoreboard.RightTextFormat = "player_checkpoint + / + player_totalcheckpoint" -- ult Z scoreboard display text format right.
```

**Custom format:**

```lua
player_name -- Player name of current player row
player_bestlap -- Best lap of current player row
player_checkpoint -- Current checkpoint of current player row
player_totalcheckpoint -- Total checkpoint count of current session
player_lap -- Current lap of current player row
player_vehiclename -- Current vehicle name of current player row
size_small -- Text format font size small
size_normal -- Text format font size normal
size_big -- Text format font size big
string_space -- Text format one spacebar
```

{% hint style="info" %}
Support [**Rockstar Text Formatting**](https://docs.fivem.net/docs/game-references/text-formatting/)
{% endhint %}

{% hint style="info" %}
Support [**C Escape Sequences**](https://www.lua.org/pil/2.4.html)
{% endhint %}

* Spacebar not work in text format just use **string\_space** insert.
* If display text is very long, display text size will be smaller to fit scaleform bounding box.
* If you have a very long display text try to newline it with escape sequences .

**Color:**

```lua
"~r~ + player_checkpoint + / + ~b~ + player_totalcheckpoint"
```

<div align="left"><figure><img src="https://432492714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4Soh4qWe7dU0JKeI9bp%2Fuploads%2FFYmL3OqZ4VIIO8fnv2cJ%2Fimage.png?alt=media&amp;token=9e17abcc-80af-4e8f-91a4-6093e3afc32c" alt="Preview of color format"><figcaption><p>Preview of color format</p></figcaption></figure></div>

**Font size:**

```lua
"size_small + player_checkpoint + size_normal + / + size_big + player_totalcheckpoint"
```

<div align="left"><figure><img src="https://432492714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4Soh4qWe7dU0JKeI9bp%2Fuploads%2Fdv28AT1MOZdWmnwl0H0V%2Fimage.png?alt=media&amp;token=e084787f-f82c-45a9-be0e-e72eff211c62" alt="Preview of font size"><figcaption><p>Preview of font size</p></figcaption></figure></div>

**Escape Sequences:**

```lua
"~y~CP: + player_checkpoint + \n + ~g~LAP: + player_lap + \n~b~ + player_vehiclename"
```

<div align="left"><figure><img src="https://432492714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4Soh4qWe7dU0JKeI9bp%2Fuploads%2FSUQbKGKrHAc913uclxT6%2Fimage.png?alt=media&amp;token=393e5b1b-b3e5-485d-aae3-76ca61041ccc" alt=""><figcaption><p>Preview of <strong>escape sequences</strong></p></figcaption></figure></div>

**Combine:**

```lua
"size_small + ~r~Checkpoint: + string_space + player_checkpoint + size_normal + \n~g~Lap: + string_space + player_lap + \n ~b~~h~ + player_vehiclename"
```

<div align="left" data-full-width="false"><figure><img src="https://432492714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw4Soh4qWe7dU0JKeI9bp%2Fuploads%2FSZBJQOlMm1mOZddMGug8%2Fimage.png?alt=media&amp;token=4782fe6a-33c4-474b-8b04-549fcfde09ba" alt=""><figcaption><p>Preview of full</p></figcaption></figure></div>
