> For the complete documentation index, see [llms.txt](https://docs.alphacloud.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphacloud.pro/module-game-integrationen/fivem.md).

# FiveM Integration

Deinen FiveM Server mit Discord verbinden, Rollen Sync, Whitelist, RCON und Ingame Benachrichtigungen.

**Im Panel unter:** Game Integrationen, Game Integrationen

{% hint style="info" %}
Dieses Modul ist als **Beta** markiert. Weitere Spiele folgen.
{% endhint %}

Verbindet deinen FiveM Server mit AlphaCloud. Discord Rollen werden zu FiveM Gruppen, Gewinnspiele erscheinen im Spiel, und dein Team kann Serverbefehle aus Discord absetzen.

## Voraussetzung: das Script

Die Verbindung läuft über ein Resource, das auf deinem FiveM Server laufen muss. Du bekommst es über unseren Tebex Shop, fügst es dem Server hinzu und trägst das API Secret in die `config.lua` ein.

## API Secret

{% stepper %}
{% step %}

### FiveM Integration aktivieren

{% endstep %}

{% step %}

### Secret generieren

Über **Secret generieren**.
{% endstep %}

{% step %}

### Sofort kopieren

{% hint style="danger" %}
Das Secret wird **nur einmal** angezeigt. Verlässt du die Seite, siehst du es nie wieder und musst es zurücksetzen.
{% endhint %}
{% endstep %}

{% step %}

### In die config.lua eintragen und Resource neu starten

{% endstep %}
{% endstepper %}

Über **Secret zurücksetzen** erzeugst du ein neues. Das alte wird damit ungültig, dein Server verliert also die Verbindung, bis du das neue eingetragen hast.

## Ingame Sprache

Legt die Sprache der FiveM Ingame Oberflächen fest. Unabhängig von der Bot Sprache in [Setup](/das-panel/setup.md).

## Die Funktionen

{% tabs %}
{% tab title="Rollen Sync" %}
Synchronisiert Discord Rollen mit FiveM Gruppen, sobald ein Spieler sich verbindet. Die Fallback Gruppe ist `user`.

Du legst Zuordnungen an, jeweils **Discord Rolle** zu **FiveM Gruppe**, zum Beispiel `admin` oder `moderator`.

{% hint style="info" %}
Die Zuordnungen werden **von oben nach unten** geprüft, die erste Übereinstimmung gewinnt. Sortier deine höchste Rolle also nach oben, sonst landet dein Administrator in der Supporter Gruppe.
{% endhint %}
{% endtab %}

{% tab title="Whitelist" %}
Nur Spieler mit einer der gewählten Discord Rollen dürfen sich verbinden.

| Einstellung             | Bedeutung                                  |
| ----------------------- | ------------------------------------------ |
| **Pflichtrollen**       | Der Spieler braucht mindestens eine davon  |
| **Ablehnungsnachricht** | Wird im FiveM Verbindungsfenster angezeigt |

Schreib in die Ablehnungsnachricht, wie man die Rolle bekommt. Sonst steht der Spieler vor einer Absage ohne Weg nach vorn.
{% endtab %}

{% tab title="Discord RCON" %}
Registriert `/fivemrcon` auf deinem Discord Server, womit dein Team Serverbefehle direkt aus Discord absetzen kann.

| Einstellung                | Bedeutung                                      |
| -------------------------- | ---------------------------------------------- |
| **Erlaubte FiveM Gruppen** | Kommagetrennt, zum Beispiel `admin,superadmin` |
| **Log Kanal**              | Dort werden alle RCON Befehle protokolliert    |

{% hint style="danger" %}
RCON gibt Zugriff auf Serverbefehle. Gib nur Gruppen frei, denen du wirklich vertraust, und setz den Log Kanal, damit nachvollziehbar bleibt, wer was getan hat.
{% endhint %}
{% endtab %}

{% tab title="Giveaway Benachrichtigungen" %}
Startet ein Discord [Gewinnspiel](/module-community/gewinnspiele.md), sehen Spieler eine Minute lang eine Oberfläche zum Beitreten. Gewinner werden ebenfalls im Spiel angezeigt.
{% endtab %}

{% tab title="Ingame Support Benachrichtigung" %}
Teammitglieder bekommen im Spiel eine Benachrichtigung, wenn jemand einem Support Sprachkanal beitritt.

| Einstellung              | Bedeutung                                                            |
| ------------------------ | -------------------------------------------------------------------- |
| **Team Rolle**           | Spieler mit dieser Discord Rolle bekommen die Benachrichtigung       |
| **Support Sprachkanäle** | Ein Beitritt hier löst aus                                           |
| **Cooldown (Sekunden)**  | Mindestabstand zwischen zwei Benachrichtigungen für denselben Nutzer |

{% hint style="info" %}
Dafür muss zuerst ein API Secret erzeugt sein, sonst kann das Script die Benachrichtigungen gar nicht empfangen.
{% endhint %}
{% endtab %}
{% endtabs %}

## Verwandt

{% content-ref url="/pages/8RfIgGfZ5bDeKIrrONEn" %}
[Aufnahmepflicht](/module-team/aufnahmepflicht.md)
{% endcontent-ref %}

{% content-ref url="/pages/6idjdjcVoNzcn7kJvDRm" %}
[Fraktionen](/module-tools/fraktionen.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.alphacloud.pro/module-game-integrationen/fivem.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.