> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.nodx.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Oyuncu yönetimi

> Oyuncu arama, aksiyonlar, canlı görüntü ve yönetim işlemleri

**Oyuncular** sayfası, sunucudaki aktif oyuncuları görüntülemek ve oyuncu bazlı işlem yapmak için kullanılır.

## Oyuncu listesi

Oyuncu listesinde genelde şu bilgiler görünür:

| Bilgi     | Açıklama                                              |
| --------- | ----------------------------------------------------- |
| ID        | Oyuncunun sunucudaki geçici oyuncu ID'si              |
| İsim      | Oyuncunun görünen adı                                 |
| Kimlikler | Lisans, Discord veya Steam gibi eşleşen bilgiler      |
| Meslek    | Oyuncunun job bilgisi                                 |
| Ping      | Oyuncunun bağlantı gecikmesi                          |
| Durum     | Oyuncunun aktif, izleniyor veya işlem bekliyor olması |

<Tip>
  Oyuncu ID'si sunucu restart sonrası değişebilir. Kalıcı takip için lisans veya karakter bilgilerini kullanman daha doğrudur.
</Tip>

## Arama ve filtreleme

Oyuncuyu şu bilgilerle arayabilirsin:

| Arama türü     | Örnek                             |
| -------------- | --------------------------------- |
| Oyuncu ID      | `12`                              |
| Karakter adı   | `Francesco`                       |
| Discord adı    | `fox`                             |
| Lisans parçası | `license:` ile başlayan kimlik    |
| Meslek         | `police`, `ambulance`, `mechanic` |

## Oyuncu aksiyonları

Oyuncu detayına girdiğinde panelde izinlerine göre aksiyonlar görünür.

| Aksiyon      | Ne yapar?                                        |
| ------------ | ------------------------------------------------ |
| Mesaj gönder | Oyuncuya oyun içinde bildirim gönderir           |
| Işınla       | Oyuncuyu seçilen konuma taşır                    |
| Yanına çek   | Oyuncuyu yetkilinin yanına getirir               |
| Canlandır    | Oyuncuyu revive eder                             |
| Dondur       | Oyuncunun hareketini geçici olarak durdurur      |
| Kick         | Oyuncuyu sunucudan atar                          |
| Ban          | Oyuncuyu belirlenen süreyle veya kalıcı yasaklar |

<Warning>
  Kick, ban, eşya silme ve ışınlama gibi işlemler audit log'a düşer. Paneli ekip içinde kullanıyorsan bu kayıtları düzenli kontrol et.
</Warning>

## Bildirim gönderme

Panelden gönderilen oyuncu bildirimleri, mümkün olduğunda oyun içi üst bildirim olarak çıkar. Böylece chat spam'i oluşmaz.

Örnek kullanım:

| Mesaj                                    | Kullanım                    |
| ---------------------------------------- | --------------------------- |
| `Yetkili seni izlemeye aldı.`            | Canlı takip başlatıldığında |
| `Lütfen roleplay kurallarına dikkat et.` | Uyarı amaçlı                |
| `Destek talebin inceleniyor.`            | Oyuncuya bilgi vermek için  |

## Canlı görüntü

Canlı görüntü, oyuncunun client tarafından alınan ekran görüntüsünün panele aktarılmasıyla çalışır.

Çalışması için:

| Gereken                            | Açıklama                                 |
| ---------------------------------- | ---------------------------------------- |
| Oyuncu online olmalı               | Offline oyuncudan canlı görüntü alınamaz |
| Screenshot desteği aktif olmalı    | Sunucuda screenshot altyapısı çalışmalı  |
| Plugin API'ye erişebilmeli         | Sunucu panel API'sine ulaşabilmeli       |
| Panelde doğru sunucu seçili olmalı | Yanlış sunucuda oyuncu görüntüsü gelmez  |

Canlı görüntü gelmiyorsa **Test ve sorun giderme** sayfasındaki canlı görüntü bölümünü kontrol et.

## Işınlama yetkisi

Copilot veya panel üzerinden “oyuncuyu plaja ışınla” gibi bir işlem yaptığında iki yetki gerekir:

| Yetki             | Neden gerekli?                                                      |
| ----------------- | ------------------------------------------------------------------- |
| Panel yetkisi     | Kullanıcının panelden ışınlama yapabilmesi için                     |
| Sunucu capability | Plugin'in ışınlama aksiyonunu desteklediğini panele bildirmesi için |

Yetki yoksa panel işlemi durdurur ve sana eksik yetkiyi gösterir. Bu, ekipteki herkesin her komutu kullanmasını engellemek için bilinçli bir güvenlik davranışıdır.

## İyi kullanım önerileri

* Ban ve kick işlemlerinde açıklama yaz.
* Oyuncu ID yerine mümkünse karakter veya lisans bilgisini doğrula.
* Canlı görüntü alırken oyuncuya gerekli durumlarda bilgi ver.
* Ekip yetkilerini görev alanına göre sınırla.
* Copilot ile işlem başlatmadan önce doğru sunucunun seçili olduğunu kontrol et.