> ## Documentation Index
> Fetch the complete documentation index at: https://destek.leaderos.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# LeaderOS Connect

> LeaderOS eklentisi, Garry's Mod sunucunuz ile LeaderOS web sitesi arasında sorunsuz bir entegrasyon sağlar.

## İndir

[https://www.leaderos.net/plugin/gmod](https://www.leaderos.net/plugin/gmod)

## Kaynak Kodu

[https://github.com/leaderos-net/gmod-leaderos-connect](https://github.com/leaderos-net/gmod-leaderos-connect)

## Kurulum

### 1. Eklentiyi (Addon) indir

Aşağıdaki bağlantıdan en son sürümü ZIP dosyası olarak indirin ve klasöre çıkartın:

[https://www.leaderos.net/plugin/gmod](https://www.leaderos.net/plugin/gmod)

### 2. Eklentiyi sunucuya yükle

Çıkarttığınız ZIP dosyasının içindeki `leaderos_connect` klasörünü sunucunuzun addons (eklentiler) dizinine kopyalayın:

```
garrysmod/addons/leaderos_connect/
```

### 3. Sunucuyu yeniden başlat

Sunucunuzu yeniden başlatın. Bu işlem, yapılandırma (config) dosyasını şu dizinde oluşturacaktır:

```
garrysmod/addons/leaderos_connect/lua/leaderos/config.lua
```

### 4. Eklentiyi yapılandır

`config.lua` dosyasını açın ve bilgilerinizi doldurun:

```lua theme={null}
LeaderOS.Config = {
   WebsiteURL   = "https://siteniz.com",
   APIKey       = "YOUR_API_KEY_HERE",
   ConnectToken = "YOUR_SERVER_TOKEN_HERE",
   DebugMode    = false,
   CheckOnline  = true,
   FreqMinutes  = 2,
}
```

### 5. server.cfg dosyasını düzenle

Şu satırı `garrysmod/cfg/server.cfg` dosyasına ekleyin:

```
sv_hibernate_think 1
```

> **Önemli:** Bu gereklidir. Bu ayar olmadan, sunucuda hiç oyuncu yokken Lua zamanlayıcıları (timers) çalışmaz ve eklenti kuyruğu kontrol etmez.

### 6. Sunucuyu yeniden başlat

Sunucunuzu yeniden başlatın. Eklenti artık aktiftir. Her şeyin çalıştığını doğrulamak için sunucu konsolunda `leaderos_status` komutunu çalıştırın.

## Yapılandırma

| Ayar           | Açıklama                                                                                                                                                |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `WebsiteURL`   | LeaderOS web sitenizin URL'si (örn. `https://siteniz.com`).                                                                                             |
| `APIKey`       | LeaderOS API anahtarınız. `Yönetim Paneli > Ayarlar > API` bölümünde bulabilirsiniz.                                                                    |
| `ConnectToken` | Sunucu tokeniniz. `Yönetim Paneli > Mağaza > Sunucular > Sunucunuz > Sunucu Tokeni` bölümünden bulabilirsiniz.                                          |
| `DebugMode`    | Hata ayıklama (debug) kayıtlarını açmak için `true`, kapatmak için `false` olarak ayarlayın.                                                            |
| `CheckOnline`  | Komutları göndermeden önce oyuncuların oyunda (çevrimiçi) olup olmadığını kontrol etmek için `true`, bu kontrolü atlamak için `false` olarak ayarlayın. |
| `FreqMinutes`  | Eklentinin komut kuyruğunu ne sıklıkla (dakika cinsinden) kontrol edeceği.                                                                              |

## Konsol Komutları

| Komut             | Açıklama                                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| `leaderos_status` | Mevcut yapılandırmayı ve zamanlayıcı (timer) durumunu gösterir.                                                |
| `leaderos_reload` | Yapılandırma (config) dosyasını yeniden yükler, zamanlayıcıyı yeniden başlatır ve kuyruğu anında kontrol eder. |
| `leaderos_poll`   | Zamanlayıcıyı yeniden başlatmadan komut kuyruğunu anında kontrol eder.                                         |
| `leaderos_debug`  | Hata ayıklama modunu (debug mode) açar veya kapatır.                                                           |
