> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roleplay-systems.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Roblox Gruppen API

> In diesem Artikel erfährst du, wie du die Roblox-Gruppen API im Personensystem einrichtest.

Hier erfährst du Schritt für Schritt, wie du die Roblox-Gruppen API im Personensystem verbindest, Ränge zuweist und den automatischen Rangwechsel konfigurierst.

***

## 1. Gruppe verbinden

Um deine Roblox-Gruppe zu verknüpfen, benötigst du lediglich die Gruppen-ID aus der Web-Adresse.

1. Öffne deine Roblox-Gruppenseite im Browser.
2. Kopiere die **ID aus der URL** (z. B. `1234567` aus `roblox.com/groups/1234567/Name`).
3. Füge die ID in das entsprechende Feld im Bot/Dashboard ein.

![Roblox Gruppen ID in URL](https://mintcdn.com/nrwsystems-695dad79/rf7YF0rY9ibCYdlf/images/Roblox-Gruppen_ID.png?fit=max\&auto=format\&n=rf7YF0rY9ibCYdlf\&q=85\&s=8b829fddebf0b673dca0e5f3839e6323)

***

## 2. Ränge zuweist (Mapping)

Es stehen zwei Optionen zur Verfügung, um Roblox-Ränge den System- bzw. Discord-Rollen zuzuordnen:

* **Smart-Auto-Mapping:** Erkennt passende Rollen (z. B. *Polizei*, *Team*, *Fraktion*) automatisch und nimmt die Zuordnung vor.
* **Manuelle Zuweisung (`Recht ↔ Rolle zuweisen`):** Erlaubt das gezielte, manuelle Festlegen von einzelnen Rechte-Paaren.

***

## 3. Automatischer Rangwechsel

Damit Ränge automatisch geändert werden können, musst du **eine der beiden** folgenden Authentifizierungsmethoden einrichten:

### Option A: Open Cloud User API Key (Empfohlen)

**1. Creator Dashboard öffnen**

Navigiere zu den [Roblox Creator Dashboard Credentials](https://create.roblox.com/dashboard/credentials).

**2. Profil auswählen**

> [!WARNING]
>
> **Wichtig:** Wähle oben links dein **persönliches Profil** aus und **nicht** die Gruppe!

**3. API-Key erstellen**

Erstelle einen neuen Key mit folgenden Parametern:

* **Berechtigungen:** `group.membership:read` und `group.membership:write` (zugewiesen an deine Gruppe).

### Option B: Bot-Account Cookie

* Trage das `.ROBLOXSECURITY`-Cookie eines **Bot-Accounts** ein, der in deiner Gruppe über ausreichende Rang-Verwaltungsrechte verfügt.
* Diese Methode ist sofort einsatzbereit.

> [!WARNING]
>
> **Sicherheitshinweis:** Gib dein Cookie niemals an Dritte weiter. Verwendungszweckmäßig sollte hierfür immer ein separater Bot-Account genutzt werden.

***

## 4. Unterstützter 1-Klick Modus

Falls **keine** Authentifizierung (weder API Key noch Cookie) hinterlegt ist, schaltet das System automatisch in den unterstützen manuellen Modus:

* Bei der Annahme eines Antrags generiert der Bot einen **Direktlink zur gefilterten Roblox-Mitgliedersuche**.
* Über diesen Link gelangst du sofort zur entsprechenden Person und kannst den Rang mit einem Klick manuell anpassen.

![Discord-Nachricht des Bots mit dem Direktlink zur gefilterten Mitgliedersuche](https://mintcdn.com/nrwsystems-695dad79/nFtEAEth0Vzyt7lm/images/manuelle_Gruppenzuweisung.png?fit=max\&auto=format\&n=nFtEAEth0Vzyt7lm\&q=85\&s=747342611bdd47de6a6f1faa765154cc)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.