> 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

```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="/files/jbj915cMPU0JEDzsRYW4" 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="/files/7Ii4ofZnIDbxAk3dDFK4" 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="/files/zHT7jiV2EtkdCj9NealQ" 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="/files/Y0mR56fM7hIkWX0ifW2n" alt=""><figcaption><p>Preview of full</p></figcaption></figure></div>
