# CXG-GTFAT yapılandırması

`config.lua` dosyasını düzenleyip `CXG_GTFAT` kaynağını yeniden başlatın. Ağırlık değerleri kilogram cinsindendir ve yapılandırılmış adım aralığına uymalıdır.

## Dil ve ağırlık

```lua
Config.Locale = 'tr'

Config.Weight = {
    minKg = 50,
    maxKg = 180,
    defaultKg = 75,
    fatThresholdKg = 100,
    stepKg = 0.5,
}
```

Kullanılabilir diller: en, es, `pt-BR`, fr, de, it, pl, ru, tr, th, ar, sv ve br. br eski Brezilya Portekizcesi metinlerini içerir; normal kullanım için `pt-BR` önerilir.

Başlangıç aralığı 50–180 kg, varsayılan 75 kg'dır; Fat görünümü 100 kg'dan itibaren etkinleşir (100 kg dahil). `minKg` en az sıfır, `stepKg` pozitif olmalı ve `minKg` <= `defaultKg` <= `maxKg` koşulu sağlanmalıdır. Eşik minimumdan büyük ve maksimumdan küçük veya eşit olmalıdır. Varsayılan, eşik ve maksimum değerleri `minKg` ile başlayan adıma uymalıdır; örneğin minimum 50 kg ve adım 0,5 kg ise 75 ve 100 kg geçerlidir. Geçersiz yapılandırma ağırlık işlemlerini devre dışı bırakır.

LB yalnızca görüntülenen değeri dönüştürür. Sunucu değerleri kg cinsinden saklar ve doğrular.

## Komutlar ve izinler

```lua
Config.Commands = {
    enabled = true,
    access = 'ace',
    ace = 'cxg_gtfat.use',
    job = nil,
    group = nil,
    custom = nil,
    open = 'fatweight',
    control = 'fatdecal',
}
```

Etkinleştirildiğinde yapılandırılmış komutlar kaydedilir. Varsayılan açma komutu `/fatweight`, kontrol komutu `/fatdecal` şeklindedir. Kontrol komutu on, off, status veya ui kabul eder. on ağırlığı en az Fat eşiğine çıkarır; off eşiğin en fazla bir adım altına indirir. Bunlar ayrı görünüm anahtarları değildir.

| access | Davranış |
| --- | --- |
| ace | ace alanında belirtilen `ACE` iznini gerektirir. Varsayılan budur. |
| everyone | Sunucu kontrollerinden geçen her oyuncunun kullanmasına izin verir. |
| jobs, groups, custom | `bridge/server.lua` içinde bir politika uygulanmalıdır; framework'e otomatik bağlanmaz. |

Yöneticilere `ACE` erişimi vermek için:

```cfg
add_ace group.admin cxg_gtfat.use allow
```

Menü veya target arayüzü açmayı isteyebilir, ancak sunucu yetkiyi yine kontrol eder. Komut kaydını kapatmak, başka bir sunucu kaynağının `OpenWeightUI` export'unu çağırmasını engellemez.

## İstasyonlar

Kurulumdan sonra hiçbir fiziksel terazi etkin değildir. `Config.Stations` içine bir istasyon kaydı ekleyin, benzersiz bir anahtar kullanın, gerçek koordinatları girin ve etkinleştirin.

```lua
Config.Interaction = {
    key = 'E',
    streamDistance = 60.0,
}

Config.Stations = {
    gimnasio = {
        enabled = true,
        coords = { x = 0.0, y = 0.0, z = 0.0 },
        heading = 0.0,
        distance = 1.8,
        bucket = 0,
        access = 'ace',
        ace = 'cxg_gtfat.use',
        job = nil,
        group = nil,
        custom = nil,
        model = false,
        spawnProp = false,
    },
}
```

Örnek koordinatları gerçek değerlerle değiştirin. `distance` en fazla 5 metre olabilir. `bucket`, istasyonun routing bucket değeriyle aynı olmalıdır; genellikle 0'dır. Her istasyonun kendi `access` politikası vardır.

| Tür | Ayarlar | Sonuç |
| --- | --- | --- |
| Nesnesiz nokta | model = false, `spawnProp` = false | Yapılandırılan koordinatlarda görünmez etkileşim. |
| Mevcut nesne | model = 'model_adı', `spawnProp` = false | Nesnenin koordinatların 1 metre yakınında bulunması gerekir. Kaynak nesneyi kaldırmaz. |
| Yerel oluşturulan nesne | model = 'model_adı', `spawnProp` = true | Yaklaşınca donmuş yerel nesne oluşturur; uzaklaşınca veya kaynak durunca kaldırır. |

Etkileşim noktası nesneyi otomatik olarak yere yerleştirmez. `coords` değerini nesnenin gerçek başlangıç konumuna, `heading` değerini yönüne ayarlayın. Bildirim varsayılan olarak E kullanır; oyuncu bunu FiveM Ayarları > Tuş Atamaları bölümünden yeniden atayabilir.

Varsayılan adaptör ace ve everyone erişimini destekler. Diğer türler sunucu tarafı uygulama gerektirir. Bildirim ya da prop göstermek izin vermez; sunucu erişimi ve yakınlığı yeniden doğrular.

## Karakter başına kalıcılık

```lua
Config.Persistence = { framework = 'none' }
```

| Mod | Kullanım |
| --- | --- |
| none | Varsayılan. Yalnızca oturumluk; yeniden bağlanma veya yeniden başlatmada `defaultKg` kullanılır. |
| qb | Karakteri qb-core ve citizenid üzerinden bulur. |
| esx | Karakteri es_extended ve tanımlayıcısı üzerinden bulur. |
| custom | `identity.lua` içindeki `GTFatCustomCharacterId(source)` işlevini kullanır. |

Kaynak Qbox'ı otomatik algılamaz. Çoklu karakter sunucularında uyumlu bir seçenek veya kendi adaptörünüzle her karakter için kararlı ve benzersiz bir tanımlayıcı ayarlayın. Tanımlayıcıları karakterler arasında paylaşmayın ve istemciden gönderilen kimliği kabul etmeyin. custom modunda karakter yüklenene kadar nil döndürün.

Kalıcı ağırlık kıyafetlerden ve kombinlerden ayrı saklanır. `CXG_GTFAT` kaynak adını koruyun ve sunucunun `KVP` depolamasını diğer kalıcı verilerle birlikte yedekleyin.