# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hamer.gitbook.io/hamer/scripts/darkrp_racing/scoreboard-text-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
