> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord rolleri kurulumu

> Discord rolüne göre ekstra karakter slot'u verin.

Discord rolüne göre ekstra karakter slot'u verin — örneğin VIP'e 3 karakter, diğerlerine 1. Discord'da küçük bir bot oluşturursunuz, iki ID ve token'ı config'e yapıştırırsınız — Creator karakter seçiminde gerisini halleder.

<Info>
  Slot sayımı (ve birinin iki rolü varsa ne olur) [Karakter slot'ları](/tr/rco-creator/character-slots) sayfasında. Hatırlatma: her rol **toplam** slot verir — "+1 ekstra" değil.
</Info>

## Gerekenler

* Oyuncuların gerçekten girdiği bir Discord sunucusu
* **Sunucuyu yönet** izni (bot daveti için)
* RedM dosyalarına erişim (veya host paneli)
* Beş dakika ve **bot token** için güvenli bir yer (şifre gibi)

Hepsi bu. Veritabanı yok, ekstra resource yok.

## Ne oluyor — sade anlatım

1. Oyuncu Discord bağlı şekilde RedM'e girer.
2. Karakter seçimini açar.
3. Creator Discord'a sorar: "Bu kişinin sunucumuzda hangi rolleri var?"
4. Creator listenizdeki **en iyi** rolü alır ve o kadar slot açar (sunucu max'ına kadar).

Bir şey ters giderse — Discord kapalı, sunucuda değil, config yanlış — tanımladığınız **varsayılan** slot sayısını alır. Kimse kilitlenmez; sadece bonus slot alamaz.

***

## Adım 1 — Geliştirici modu

Discord, bir anahtarı açana kadar ID'leri gizler.

1. Discord'u açın (masaüstü veya tarayıcı).
2. **Kullanıcı ayarları** (dişli) → **Gelişmiş**.
3. **Geliştirici modu**nu açın.

Artık: sunucuya sağ tık → **Sunucu kimliğini kopyala**; role sağ tık → **Rol kimliğini kopyala**.

***

## Adım 2 — Bot oluştur

Her şey resmi sitede: [Discord Developer Portal](https://discord.com/developers/applications).

<Steps>
  <Step title="Yeni uygulama">
    **New Application** → ekibin tanıyacağı isim (ör. `RedM Character Slots`) → oluştur.
  </Step>

  <Step title="Token'ı kopyala">
    **Bot** sekmesi → **Reset Token** → onayla → hemen **Kopyala**.

    Şifre gibi. Yalnızca **oyun sunucusundaki** `rco-creator/config/server.lua` — Discord'a, ticket'a, ekran görüntüsüne veya GitHub'a değil.
  </Step>

  <Step title="Botu Discord'a davet et">
    **OAuth2** → **URL Generator**.

    * Scopes: **`bot`** işaretle
    * İzinler: minimum — bot kanal okumaz veya yazmaz. Sadece **sunucunuzda olması** yeterli.

    Linki kopyala, tarayıcıda aç, **RedM topluluğunuzu** seç, yetkilendir.

    Üye listesinde çevrimdışı mı? **Normal.** Creator bağlanınca kontrol eder; 7/24 "online" olması gerekmez.
  </Step>

  <Step title="'Intents' anahtarları">
    Bot sekmesinde "Server Members Intent" gibi şeyler görürsünüz.

    **Kapalı bırakın.** Creator tek oyuncuyu tek tek arar — herkesi listeleme iznine gerek yok.
  </Step>
</Steps>

***

## Adım 3 — ID'leri not et

Config'den önce küçük bir tablo yapın:

| Rol (sizin için) | Rol ID      | Kaç karakter? |
| ---------------- | ----------- | ------------- |
| Varsayılan       | —           | örn. 1        |
| Supporter        | ID yapıştır | örn. 3        |
| VIP              | ID yapıştır | örn. 5        |

**Sunucu ID** = Discord simgesine sağ tık → **Sunucu kimliğini kopyala**.

**Rol ID** = Sunucu ayarları → Roller → role sağ tık → **Rol kimliğini kopyala**.

***

## Adım 4 — Creator config'e yapıştır

**RedM sunucunuzda** `rco-creator/config/server.lua` düzenleyin:

```lua theme={"dark"}
CreatorServerConfig.Discord = {
    enabled = true,
    guildId = '123456789012345678',
    botToken = 'TOKEN_BURAYA',
    defaultSlots = 1,
    cacheSeconds = 600,
    timeoutMs = 8000,
    roleSlots = {
        ['987654321098765432'] = 3,
        ['876543210987654321'] = 5,
    },
}
```

**`rco-creator`** yeniden başlatın. Discord açık ama ID veya token boş → resource **başlamaz**. Yarım config ile çalışmamanız için.

<Warning>
  Discord açıkken license ile manuel slot (`PlayerSlots`) **sayılmaz**. İkisi de lazım mı? [Karakter slot'ları](/tr/rco-creator/character-slots)'nda `ResolveCustomSlots`.
</Warning>

***

## Adım 5 — Oyunculara ne söyleyin

Kurallarda veya onboarding'de şöyle bir şey:

1. RedM açarken **Discord açık** (masaüstü uygulama iyi).
2. İstendiğinde **RedM / Cfx.re** yetkisi — veya **Ayarlar → Yetkilendirilmiş uygulamalar**.
3. **Discord sunucumuza katılın** ve tier rolünü alın.

Bir oyuncu hep varsayılan mı görüyor? Bağlantıda sunucu konsoluna bakın: identifiers'da `discord:` olmalı. Yoksa oyun Discord ID almadı — genelde yeniden yetkilendirme ve RedM restart çözer.

<Note>
  Discord + RedM bağlantısı bazılarında tutarsız (Discord kapalı, auth atlandı, limitler). Platform sınırı, Creator bug'u değil. Bağlayamayanlar için `defaultSlots` adil olsun.
</Note>

***

## Adım 6 — Test et

1. Discord'da test rolü.
2. `roleSlots`'ta o ID ile belirgin bir sayı (ör. 3).
3. Resource restart, bağlan, seçimi aç.
4. Açılan slot'ları say.

Hâlâ sorun mu? Geçici `Config.Debug = true` — **sunucu** konsoluna bakın. Log'ları paylaşmayın.

***

## Sık sorunlar

| Gördüğünüz                  | Olası neden          | Ne yapın                                    |
| --------------------------- | -------------------- | ------------------------------------------- |
| Başlamıyor                  | Boş ID veya token    | `server.lua`'da ikisini doldurun            |
| Herkes varsayılan           | Bot Discord'da yok   | Davet linkini tekrar (Adım 2)               |
| Herkes varsayılan           | Yanlış sunucu ID     | Tekrar kopyalayın                           |
| Bir oyuncu hep varsayılan   | Discord bağlı değil  | RedM yetkisini yenileyin, oyunu restart     |
| Bir oyuncu hep varsayılan   | Discord'unuzda değil | Katılmalı veya manuel                       |
| Rol slot değiştirmiyor      | Yanlış rol ID        | ID'yi tekrar kopyala — tırnak içinde string |
| VIP + Supporter toplanmıyor | Böyle çalışmaz       | Creator **yüksek** rolü alır                |
| Rol değişti, aynı           | \~10 dk önbellek     | Bekleyin veya yeniden bağlanın              |
| Debug'da "geçersiz token"   | Token sıfırlandı     | Portalda reset, config güncelle             |

***

## Token güvenliği

* Yalnızca oyun sunucusunda, `server.lua`.
* Gerçek token'ı GitHub'a koymayın.
* Sızdı mı? Portaldan hemen **Reset Token**.

Bota Administrator **gerekmez**.

***

## Ayrıca bakın

* [Karakter slot'ları](/tr/rco-creator/character-slots)
* [Discord Developer Portal](https://discord.com/developers/applications)