> ## 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.

# Yapılandırma

> Her RCO Creator seçeneği, açıkça anlatılmış.

Creator'ın iki config dosyası var, ikisi de `rco-creator/config/` içinde:

| Dosya        | İçerik                                                                                       | Kim okur                |
| ------------ | -------------------------------------------------------------------------------------------- | ----------------------- |
| `config.lua` | Oyun seçenekleri: slotlar, yaş kuralları, seçim sahnesi, spawn davranışı                     | İstemcilerle paylaşılır |
| `server.lua` | Hassas her şey: oyuncu başına slot override, Discord bot token, admin izni, başlangıç paketi | Yalnızca sunucu         |

Bu iki dosyanın dışına dokunmanız gerekmez. Düzenledikten sonra resource'u yeniden başlatın (`restart rco-creator`).

## Genel

```lua theme={"dark"}
Config.Framework = 'auto'  -- auto | rsg | vorp
Config.Debug = false
Config.Locale = 'en'       -- en | pt-BR
```

* **Framework** – `auto`'da bırakın. Yalnızca konsol algılamanın başarısız olduğunu veya iki core bulduğunu söylerse açıkça ayarlayın.
* **Debug** – konsola ekstra tanılama yazar. Canlı sunucuda kapalı tutun.
* **Locale** – ekrandaki UI dili. Metin dosyaları `rco-creator/locales/` içinde; kendi dilinizi `en.json` kopyalayarak ekleyin.

## Karakterler ve slotlar

```lua theme={"dark"}
Config.MaxCharacters = 5
Config.DefaultCharacterSlots = 4
Config.AllowCharacterDelete = true
Config.AllowLogoutCommand = true
Config.LogoutCommand = 'logout'
```

* **MaxCharacters** – sert üst sınır. Override ne olursa olsun kimse bundan fazlasını alamaz.
* **DefaultCharacterSlots** – varsayılan olarak her oyuncunun kaç slotu var.
* **AllowCharacterDelete** – oyuncular seçim ekranından kendi karakterlerini silebilir mi.
* **AllowLogoutCommand / LogoutCommand** – `/logout` ile yeniden bağlanmadan seçime dönmeyi sağlar.

Belirli oyunculara veya Discord rollerine daha fazla slot mu? [Karakter slotları](/tr/rco-creator/character-slots) sayfasına bakın.

## Kimlik kuralları

```lua theme={"dark"}
Config.CharacterNameMaxLength = 24
Config.NationalityMaxLength = 32
Config.IdentityReferenceDate = '1899-01-01'
Config.MinimumAge = 18
Config.MaximumAge = 100
Config.BirthYearMin = nil
Config.BirthYearMax = nil
```

Yaş **IdentityReferenceDate**'e göre hesaplanır — roleplay dünyanızın "bugünü". Varsayılanlarla bir karakter 1799 ile 1881 arasında doğmuş olmalı.

Sunucunuz daha sonraki bir dönemdeyse referans tarihini kaydırın ve isteğe bağlı doğum yılını sınırlayın:

```lua theme={"dark"}
Config.IdentityReferenceDate = '1940-01-01'
Config.BirthYearMax = 1920
```

Creator'ın yaş aralığından hesaplaması için `BirthYearMin` / `BirthYearMax`'i `nil` bırakın.

**Nationalities** oluşturma formunda gösterilen düz string listesidir. Girişleri özgürce ekleyin, kaldırın veya çevirin:

```lua theme={"dark"}
Config.Nationalities = {
    'American',
    'Mexican',
    -- ...
}
```

Tüm kurallar sunucuda uygulanır. Değiştirilmiş istemci bunları atlayamaz.

## Seçim sahnesi

```lua theme={"dark"}
Config.Selection = {
    period = 'night',              -- night | day
    hideLockedSlotGhosts = false,
    snapPedsToGround = true,
    idleAnimation = { ... },
    focusCamera = { ... },
}
```

* **period** – seçim sahnesinde günün saati. Hava override yalnızca RSG `weathersync` resource'u çalışırken uygulanır.
* **hideLockedSlotGhosts** – varsayılan olarak henüz kullanılamayan slotlar soluk siluet olarak görünür. Tamamen gizlemek için `true`.
* **snapPedsToGround** – karakter pedlerini sahne zemininde tutar.
* **idleAnimation / focusCamera** – karakterlerin duruşu ve kameranın seçileni çerçevelemesi. Varsayılanlar iyidir; yalnızca sahneyi özelleştiriyorsanız değiştirin.

## Spawn

```lua theme={"dark"}
Config.Spawn = {
    selectorMode = 'always',
    useLastLocation = true,
    fallback = vec4(-301.48, 783.20, 118.75, 14.43),
    preview = { ... },
    locations = { ... },
}
```

### Oyuncular spawn seçiciyi ne zaman görür

| `selectorMode`                | Davranış                                                                                |
| ----------------------------- | --------------------------------------------------------------------------------------- |
| `'always'`                    | Karakter seçildiğinde her seferinde.                                                    |
| `'first_login_after_restart'` | Sunucu restart başına karakter başına bir kez. Sonrasında çıkış yaptıkları yerde spawn. |
| `'new_character_only'`        | Yalnızca karakter oluşturduktan hemen sonra. Mevcut karakterler her zaman son konumda.  |

**useLastLocation** seçiciye "Last location" ekler — oyuncular kaldıkları yerden devam edebilir. **fallback** başka bir şey uygulanmazsa karakterin gideceği yer, örneğin son konum yokken ilk spawn.

### Konumlar

`locations` listesi **başlangıç** spawn noktalarıdır. İlk başlangıçta veritabanına kopyalanır; sonrasında oyun veritabanını kullanır. Sonradan eklemek veya taşımak için bu dosya yerine oyun içi editörü kullanın. Her şey [Spawn konumları](/tr/rco-creator/spawn-locations) sayfasında.

## Yalnızca sunucu seçenekleri (`server.lua`)

### Başlangıç paketi

Yeni karakterler ilk spawn'da küçük bir kit alabilir:

```lua theme={"dark"}
CreatorServerConfig.Starter = {
    enabled = true,
    items = {
        { name = 'bread', amount = 5 },
        { name = 'water', amount = 5 },
    },
    rsgHorse = {
        enabled = true,
        model = 'a_c_horse_mp_mangy_backup',
        stable = 'valentine',
        name = 'Starter Horse',
    },
}
```

Eşya adları framework envanterinizde olmalı. Başlangıç atı yalnızca RSG'de; VORP'ta o blok yok sayılır.

Paket **karakter başına bir kez** verilir ve veritabanına kaydedilir — relog veya spawn sırasında bağlantı kopmasıyla iki kez alınamaz.

### Zorunlu son konum

```lua theme={"dark"}
CreatorServerConfig.ForceLastPosition = function(source, character)
    return character.isJailed == true
end
```

Spawn seçiciyi atlayıp karakteri tam olduğu yere koymak için `true` döndürün — varsayılan hapisli karakterleri hapishanede tutar. Kendi durumlarınız için genişletin.

### Slot override'ları ve Discord

`PlayerSlots`, `Discord` ve `ResolveCustomSlots` [Karakter slotları](/tr/rco-creator/character-slots) sayfasında.

### Spawn editör izni

`CanManageSpawns` `/rcospawns` kullanabilecekleri belirler. [Spawn konumları](/tr/rco-creator/spawn-locations) sayfasına bakın.