> For the complete documentation index, see [llms.txt](https://docs.oxygenserv.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oxygenserv.com/en/gta-v/avertissement-server-thread-hitch-warning.md).

# Warning: server thread hitch warning

{% hint style="info" %}
Warnings **server thread hitch** / **sync thread hitch** indicate that a resource is blocking the thread for too long.
{% endhint %}

### Objective

Identify the resource causing the hitch, then reduce its impact (optimize, update, disable).

### Step-by-step guide

{% stepper %}
{% step %}
**Locate the warning in the console**

In the server console, you will often see lines like:

```
server thread hitch warning: timer interval of...
sync thread hitch warning: timer interval...
```

{% endstep %}

{% step %}
**Profile the resources (FiveM tool)**

In the console, start a recording: `record 500`

Then save: `save file_name`

Display the report: `view file_name`

A link is generated. Open it to see the slowest resources.
{% endstep %}

{% step %}
**Fix the identified resource**

Quick options:

* **Update** the resource (or replace it).
* **Reduce** what it does (loops, timers, events).
* **Disable** the resource to confirm the diagnosis.
  {% endstep %}
  {% endstepper %}

### Common issues

#### The hitch only happens at peak times

This is often related to:

* a resource that iterates over all players,
* DB queries that are too slow,
* a script that spams events.

### FAQ

#### Is the warning “serious”?

It depends. An isolated hitch is often OK.\
Repeated hitches affect player-side smoothness.