> 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/gta-v/avertissement-server-thread-hitch-warning.md).

# Avertissement : server thread hitch warning

{% hint style="info" %}
Les warnings **server thread hitch** / **sync thread hitch** indiquent qu’une ressource bloque le thread trop longtemps.
{% endhint %}

### Objectif

Identifier la ressource qui provoque le hitch, puis réduire son impact (optimiser, mettre à jour, désactiver).

### Guide pas à pas

{% stepper %}
{% step %}
**Repérer le warning dans la console**

Dans la console serveur, vous verrez souvent des lignes du type :

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

{% endstep %}

{% step %}
**Profiler les ressources (outil FiveM)**

Dans la console, lancez un enregistrement : `record 500`

Puis sauvegardez : `save nom_du_fichier`

Affichez le rapport : `view nom_du_fichier`

Un lien est généré. Ouvrez-le pour voir les ressources les plus lentes.
{% endstep %}

{% step %}
**Corriger la ressource identifiée**

Options rapides :

* **Mettre à jour** la ressource (ou la remplacer).
* **Réduire** ce qu’elle fait (boucles, timers, events).
* **Désactiver** la ressource pour confirmer le diagnostic.
  {% endstep %}
  {% endstepper %}

### Problèmes fréquents

#### Le hitch arrive seulement en heure de pointe

C’est souvent lié à :

* une ressource qui itère sur tous les joueurs,
* des requêtes DB trop lentes,
* un script qui spamme des events.

### FAQ

#### Le warning est-il “grave” ?

Ça dépend. Un hitch isolé est souvent ok.\
Des hitches répétés impactent la fluidité côté joueurs.