Bu kılavuz, Legion Hosting üzerindeki alt:V sunucunuz için kaynak geliştirme, veritabanı kurulumu, yönetici araçları, oyuncu yönetimi, araç ve silah yönetimi ile sorun gidermeyi kapsar. İlk sunucu kurulumu, server.toml yapılandırması ve bağlantı talimatları için bkz. alt:V Sunucu Kurulum Kılavuzu.

---

Yönetici Kurulumu

alt:V'nin yerleşik bir yönetici sistemi yoktur. Yönetici işlevselliği, oluşturduğunuz veya kurduğunuz kaynaklar (komut dosyaları) aracılığıyla uygulanır. Çoğu oyun modu, izin seviyeleri, roller ve yönetici komutlarıyla kendi yönetici sistemini uygular.

Yaygın Yönetici Yaklaşımları

• Veritabanı destekli roller: Çoğu rol yapma ve oyun modu çerçevesi yönetici rollerini bir veritabanında saklar. Yöneticilere farklı izin seviyeleri veren roller (örn. moderatör, yönetici, süper yönetici) atanır.
• Yapılandırma tabanlı yöneticiler: Daha basit kurulumlar, yönetici Steam ID'lerini veya alt:V ID'lerini izin seviyeleriyle birlikte listeleyen bir yapılandırma dosyası kullanabilir.
• Konsol komutları: GPanel sunucu konsolu her zaman tam erişime sahiptir. Yönetici işlemleri için konsol girişi kabul eden sunucu tarafı komut dosyaları yazabilirsiniz.

Bir Yönetici Kaynağı Kurma

1. Oyun modunuza uygun bir yönetici kaynağı seçin veya geliştirin.
2. Kaynağı Files sekmesi veya SFTP aracılığıyla resources/ dizinine yükleyin.
3. Kaynak adını server.toml içindeki resources dizisine ekleyin.
4. Yönetici kaynağını yapılandırın (yönetici Steam/alt:V ID'lerinizi, izin seviyelerini vb. ayarlayın).
5. Sunucuyu yeniden başlatın.

---

Kaynak Sistemi

Kaynaklar, alt:V sunucularının temel yapı taşlarıdır. Her kaynak, sunucu tarafı kodu, istemci tarafı kodu veya her ikisini de içerebilen kendi kendine yeten bir modüldür. Kaynaklar JavaScript, TypeScript veya C# ile yazılır.

Kaynak Yapısı

resources/
  my-resource/
    resource.toml         <-- Resource configuration (required)
    server/
      index.js            <-- Server-side entry point
      utils.js            <-- Additional server-side files
    client/
      index.js            <-- Client-side entry point (runs in player's GTA V)
    shared/
      config.js           <-- Shared code accessible by both server and client

resource.toml Yapılandırması

type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]

Alanlar: type (js veya csharp), main (sunucu tarafı giriş noktası), client-main (istemci tarafı giriş noktası, oyuncunun GTA V'sinde çalışır), client-files (istemciye gönderilecek dosyalar, glob'ları destekler), deps (önce yüklenecek diğer kaynaklar).

---

Kaynak Kurma

Sunucunuza önceden hazırlanmış bir kaynak kurmak için:

1. Kaynak dosyalarını indirin (genellikle resource.toml ve komut dosyalarını içeren bir klasör).
2. GPanel'de sunucunuzu durdurun.
3. Kaynak klasörünü Files sekmesi veya SFTP aracılığıyla resources/'a yükleyin.
4. Kaynak klasörü adını server.toml içindeki resources dizisine ekleyin:

resources = ["existing-resource", "new-resource"]

5. Kaynağın bağımlılıkları varsa, bunların da kurulu ve listelenmiş olduğundan emin olun.
6. Kaynağı belgelerine göre yapılandırın (yapılandırma dosyaları, veritabanı kurulumu vb.).
7. Sunucuyu başlatın. Konsolu kaynak yükleme mesajları ve hatalar için kontrol edin.

Bir Kaynağı Kaldırma

1. Sunucunuzu durdurun.
2. Kaynak adını server.toml içindeki resources dizisinden kaldırın.
3. İsteğe bağlı olarak kaynak klasörünü resources/'tan silin.
4. Sunucuyu başlatın.

---

Veritabanı Kurulumu

Çoğu alt:V oyun modu, oyuncu verilerini, araçları, envanterleri ve diğer kalıcı bilgileri saklamak için bir veritabanı gerektirir. alt:V için en yaygın iki veritabanı sistemi MongoDB ve MySQL/MariaDB'dir.

MongoDB

MongoDB, genellikle JavaScript/TypeScript kaynaklarıyla kullanılan bir NoSQL belge veritabanıdır. MongoDB Atlas (ücretsiz katman mevcut) gibi yönetilen bir hizmet veya kendi kendine barındırılan bir örnek kullanın. Bağlantı dizenizi alın (örn. mongodb+srv://user:[email protected]/mydb) ve kaynağınızın yapılandırma dosyasında yapılandırın. Node.js kaynakları mongodb npm paketini kullanır.

MySQL / MariaDB

MySQL, genellikle C# kaynakları ve bazı JavaScript çerçeveleriyle kullanılır. Yönetilen bir hizmetten veya kendi kendine barındırılan bir örnekten bir veritabanı edinin, kaynaklarınızı bağlantı ayrıntılarıyla (ana bilgisayar, port, kullanıcı adı, parola, veritabanı adı) yapılandırın ve gerekli SQL geçiş komut dosyalarını çalıştırın.

---

Oyuncu Yönetimi

alt:V'de oyuncu yönetimi kaynaklarınız aracılığıyla gerçekleştirilir. Yaygın işlemler şunları içerir:

Oyuncuları Tanımlama

alt:V, bağlı her oyuncu için çeşitli tanımlayıcılar sağlar:

Atma ve Yasaklama

Kaynaklarınızda atma ve yasaklama işlevselliğini uygulayın:

import alt from "alt-server";

// Kick a player
player.kick("Reason for kick");

// Ban check on connect (store bans in database)
alt.on("playerConnect", (player) => {
    if (isPlayerBanned(player.socialID)) {
        player.kick("You are banned from this server.");
    }
});

---

Araç ve Silah Yönetimi

Araçlar ve silahlar sunucu tarafı komut dosyaları aracılığıyla yönetilir. alt:V, araçları ve silahları oluşturma, değiştirme ve kaldırma üzerinde size tam kontrol sağlar.

Araç Oluşturma

import alt from "alt-server";

// Spawn a vehicle at a position
const vehicle = new alt.Vehicle(
    "sultan",            // Vehicle model name
    0, 0, 72,           // Position (x, y, z)
    0, 0, 0             // Rotation (rx, ry, rz)
);
vehicle.numberPlateText = "LEGION";

Silah Verme

// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);

// Remove all weapons
player.removeAllWeapons();

Araç Kalıcılığı

Varsayılan olarak, araçlar yalnızca sunucu belleğinde bulunur ve yeniden başlatmada kaybolur. Araçları yeniden başlatmalar arasında kalıcı hale getirmek için verilerini (model, konum, modifikasyonlar, sahip) bir veritabanında saklayın ve sunucu başlangıcında yeniden oluşturun.

---

Sorun Giderme

Kaynaklar Yüklenmiyor

• server.toml içindeki kaynak adının resources/ içindeki klasör adıyla tam olarak eşleştiğini kontrol edin.
• Kaynağın doğru type ve main alanlarına sahip geçerli bir resource.toml dosyasına sahip olduğunu doğrulayın.
• Kaynak yükleme sırasında hata mesajları için konsolu kontrol edin. Komut dosyalarındaki sözdizimi hataları, kaynağın başlamasını engelleyecektir.
• deps içinde listelenen tüm bağımlılıkların kurulu ve yüklü olduğundan emin olun.
• server.toml içinde doğru modülün yüklendiğini doğrulayın (JavaScript için js-module, C# için csharp-module).

Oyuncular Bağlanamıyor

• Sunucunun çalıştığını ve GPanel'de çevrimiçi olarak gösterildiğini doğrulayın.
• Oyuncuların normal GTA V başlatıcısını değil, alt:V başlatıcısını kullandığını kontrol edin.
• alt:V sunucu dalının oyuncuların sahip olduğuyla (release, rc veya dev) eşleştiğinden emin olun. Eşleşmeyen dallar bağlantıları engeller.
• Parola korumalıysa, oyuncuların doğru parolayı girdiğini doğrulayın.
• Oyuncuların IP ve port ile doğrudan bağlanmayı denemesini sağlayın. Bkz. Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz.

Sunucu Çökmeleri

• Çökmeden önceki hata mesajları için konsolu kontrol edin.
• Hatalı kaynaklar çökmelerin en yaygın nedenidir. Sorunu izole etmek için yakın zamanda eklenen kaynakları devre dışı bırakın.
• Sunucu dosyalarınızın güncel olduğundan emin olun. Gerekirse Startup sekmesinden yeniden kurulumu tetikleyin.
• Kaynaklardaki bellek sızıntıları, sunucunun zaman içinde RAM'in tükenmesine neden olabilir. Sürekli artan bellek kullanımı için GPanel kaynak grafiklerini izleyin.

Veritabanı ve Ses Sorunları

• Veritabanı kimlik bilgilerini ve bağlantı dizelerini doğrulayın. MongoDB Atlas için, ağ erişim ayarlarında sunucunuzun IP'sini beyaz listeye alın.
• Veritabanı bağlantı hata mesajları için konsolu kontrol edin.
• Sesli sohbet, server.toml içindeki [voice] bölümünün yanı sıra ses kanalı mantığını uygulayan kaynaklar gerektirir. Yapılandırma tek başına yalnızca altyapıyı kurar.

Performans Sorunları

• Maliyetli işlemler (ağır döngüler, senkron veritabanı çağrıları, aşırı varlık oluşturma) için kaynaklarınızı profilleyin.
• alt.setInterval ve alt.setTimeout'u idareli kullanın. Ağır tick başına işlemler en yaygın performans katilidir.
• CPU ve RAM kullanımı için GPanel kaynak grafiklerini izleyin.
• Yüksek oyuncu sayıları için sunucu planınızı yükseltmeyi düşünün. Seçenekleri görüşmek için bir destek talebi açın.

---

İlgili Makaleler

• alt:V Sunucu Kurulum Kılavuzu — İlk kurulum, server.toml yapılandırması, sesli sohbet ve bağlantı talimatları
• Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz
• SFTP ile Dosyalar Nasıl Yüklenir
• Sunucu Başlatma Kılavuzu — Legion Hosting'de herhangi bir oyun sunucusunu başlatmak için genel kılavuz

---

Daha Fazla Yardıma mı İhtiyacınız Var?

Bu kılavuzda ele alınmayan sorunlar yaşıyorsanız, destek ekibimiz yardıma hazır. legionhosting.net/submitticket.php adresinden sunucu ayrıntılarınız, sorunun açıklaması ve GPanel konsolundaki ilgili hata mesajlarıyla birlikte bir talep açın.