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

> LeaderOS eklentisi, Hytale sunucunuz ile LeaderOS web sitesi arasında sorunsuz bir entegrasyon sağlar.

* **İndir:**
  [https://www.leaderos.net/plugin/hytale](https://www.leaderos.net/plugin/hytale)

* **Kaynak Kodu:**
  [https://github.com/leaderos-net/hytale-plugin](https://github.com/leaderos-net/hytale-plugin)

### Özellikler

* **AI:** Bu özellik, oyuncuların oyun içinden AI'a sorular sormalarını sağlar. Bu özelliği kullanabilmek için aktif bir LeaderOS AI aboneliğinizin olması gerekir.
* **Doğrulama:** Bu özellik, oyuncuların hesaplarını oyun içinden website ile eşleştirmelerini sağlar.
* **Discord Senkronizasyonu:** Basit bir komutla, bu özellik Discord hesabınızı doğrular ve sunucunuzun web sitesi ile senkronize eder, rol ve isim senkronizasyonunu sağlar. Ayrıca, kullanıcıların Discord kimlik bilgilerini kullanarak web sitesine giriş yapmalarına olanak tanır, kullanıcı yönetimini kolaylaştırır ve sunucunuzun Discord ile entegrasyonunu artırır.
* **Kredi:** Bu özellik, oyuncuların kredilerini yönetmelerini ve görmelerini sağlar, kredi yönetimi için kullanıcı dostu komutlar sunar.
* **LeaderOS Connect:** Bu özellik, web sitenizde bir satın alma işlemi yapıldığında komutları güvenli bir şekilde oyuna gönderir.

### Kurulum

1. LeaderOS eklenti jar dosyasını indirin ve sunucunuzun **/mods** klasörüne yükleyin.
2. Sunucunuzu başlatın ve eklenti yapılandırma dosyalarının oluşturulmasını bekleyin.
3. **config.yml** dosyasını açın ve aşağıdaki alanları doldurun:
   * `url`: Web sitenizin URL'sini giriniz. Örneğin: `https://hytalesunucum.com`
   * `api-key`: API anahtarınızı **Yönetim Paneli > Ayarlar > API** bölümünden bulabilirsiniz.
4. Mağaza alışverişlerinde komutların sunucuya gönderilebilmesi için **Yönetim Paneli > Mağaza > Sunucular** sayfasından bir sunucu ekleyin ve konsol türü olarak **LeaderOS Connect**'i seçin.
5. modules.yml dosyasını açın ve **connect** modülünü etkinleştirin ve sizin için oluşturulan **Konsol Token**'i kopyalayıp **server-token** alanına yapıştırın.
6. Sunucunuzu yeniden başlatın.

### Komutlar

| Komutlar         | Açıklama                                            |
| :--------------- | :-------------------------------------------------- |
| /leaderos        | Tüm komutları gösterir.                             |
| /leaderos reload | Eklenti ayarlarını yeniler.                         |
| /ai \<prompt>    | AI'a soru sorar.                                    |
| /verify \<code>  | Minecraft hesaplarını oyun içerisinden eşler.       |
| /discord-sync    | Discord hesabı senkronizasyon bağlantısı oluşturur. |
| /credits         | Mevcut kredi miktarınızı gösterir.                  |
| /credits show    | Bir oyuncunun kredi miktarını gösterir.             |
| /credits send    | Bir oyuncuya kredi gönderir.                        |
| /credits set     | Bir oyuncunun kredisini belirtilen miktara ayarlar. |
| /credits add     | Bir oyuncuya belirtilen miktarda kredi ekler.       |
| /credits remove  | Bir oyuncudan belirtilen miktarda kredi çıkarır.    |

### İzinler

| Komut            | İzin                        |
| :--------------- | :-------------------------- |
| /leaderos        | `leaderos.help`             |
| /leaderos reload | `leaderos.reload`           |
| /ai \<prompt>    | `leaderos.ai`               |
| /verify \<code>  | `leaderos.verify`           |
| /discord-sync    | `leaderos.discord.sync`     |
| /credits         | `leaderos.credit.see`       |
| /credits show    | `leaderos.credit.see.other` |
| /credits send    | `leaderos.credit.send`      |
| /credits set     | `leaderos.credit.set`       |
| /credits add     | `leaderos.credit.add`       |
| /credits remove  | `leaderos.credit.remove`    |

### API Anahtarımı nasıl bulabilirim?

API anahtarınızı **Yönetim Paneli > Ayarlar > API** bölümünden bulabilirsiniz.

<Tip>
  Bu sayfada herhangi bir API anahtarı görmüyorsanız, **"Sıfırla"** butonuna tıklayarak bir API Anahtarı oluşturabilirsiniz.
</Tip>

### Sunucu Tokenimi nasıl bulabilirim?

**Yönetim Paneli > Mağaza > Sunucular** sayfasından "LeaderOS Connect" türü ile sunucu eklediğinizde oluşan sunucu tokenini görebilirsiniz.

### Yeni bir sunucu oluşturarak nasıl yapılır?

1. **Yönetim Paneli > Mağaza > Sunucular > Ekle**'ye gidin.
2. Konsol türü olarak "LeaderOS Connect"i seçin.
3. Diğer sunucu alanlarını doldurun.
4. "Oluştur" butonuna tıklayın.
5. Eklenti talimatları sayfasına yönlendirileceksiniz.
   <img src="https://mintcdn.com/leaderostrkiye/ZMinDA-XdXubuxpN/images/integrations/connect-token.png?fit=max&auto=format&n=ZMinDA-XdXubuxpN&q=85&s=b6e340e67eab1bdce35adb82f608625f" alt="LeaderOS Connect Sunucusu" width="2206" height="1022" data-path="images/integrations/connect-token.png" />

## Server token nasıl yeniden oluşturulur?

1. **Yönetim Paneli > Mağaza > Sunucular**'a gidin ve bir sunucuyu düzenleyin.
2. "Sıfırla" butonuna tıklayın.
3. "modules.yml" dosyasındaki "server-token" alanını yenisiyle değiştirin.
   <img src="https://mintcdn.com/leaderostrkiye/ZMinDA-XdXubuxpN/images/integrations/connect-regenerate-token.png?fit=max&auto=format&n=ZMinDA-XdXubuxpN&q=85&s=41eb9894a921afa2b7a9c241970fce20" alt="Görseller" width="1902" height="896" data-path="images/integrations/connect-regenerate-token.png" />

## Konsol bağlantımı nasıl kontrol edebilirim?

Öncelikle LeaderOS eklentisini yükleyin, config.yml ve modules.yml'deki connect modülünü yapılandırın. Bu adımları tamamladıktan sonra sunucunuzu çalıştırın. Konsol bağlantısını kontrol edebilirsiniz. Konsol bağlantısı başarılı olduğunda, sunucu konsolunuzda bir log göreceksiniz.

<img src="https://mintcdn.com/leaderostrkiye/ZMinDA-XdXubuxpN/images/integrations/connect-check-connection.png?fit=max&auto=format&n=ZMinDA-XdXubuxpN&q=85&s=2277ce139267e92ad6082ad11d15acdc" alt="Görseller" width="1888" height="492" data-path="images/integrations/connect-check-connection.png" />

## Sunucu tokeni oluşturulmuyor/boş geliyor?

Bu sorun API anahatırınızın LeaderOS sistemleri ile eşleşmemesinden kaynaklanır. Çözüm için aşağıdaki adımları takip ediniz:

* **Yönetim Paneli > Ayarlar > API** sayfasına gidin ve API anahtarınızı sıfırlayın.
* **Yönetim Paneli > Mağaza > Sunucular** sayfasına gidin ve sunucu tokeninizi yeniden oluşturun.

### Cloudflare kullanan siteler için engel kaldırma

Cloudflare kullanıyorsanız API sisteminizi engelleyebilir ve oyuncu girişlerini kapatabilir. Bu durumda aşağıdaki adımları takip ederek API sisteminize Cloudflare tarafında izin verebilirsiniz:

1. Cloudflare panelinize giriş yapın.
2. **Cloudflare > Security > Security Rules > Create Rule > Custom Roles** sayfasına gidiniz. ve aşağıdaki görselin aynısı bir kayıt oluşturun.
   <img src="https://mintcdn.com/leaderostrkiye/ZMinDA-XdXubuxpN/images/plugins/cloudflare-api-whitelist.png?fit=max&auto=format&n=ZMinDA-XdXubuxpN&q=85&s=365afdea849c89f1734816831d01cedc" alt="Cloudflare Custom Role" width="1960" height="1948" data-path="images/plugins/cloudflare-api-whitelist.png" />
