Bu kılavuz, ilk başlatma ve server.toml yapılandırmasından oyun modu kaynaklarına, CDN kurulumuna, sesli sohbete ve oyuncuların alt:V başlatıcısı üzerinden nasıl bağlandığına kadar, alt:V sunucunuzu Legion Hosting üzerinde çalıştırmak için ihtiyacınız olan her şeyi kapsar. Kaynak geliştirme, veritabanı kurulumu ve yönetici yönetimi için bkz. alt:V Yönetici ve Kaynak Kurulumu.
alt:V Nedir?
alt:V, Grand Theft Auto V için ücretsiz, açık kaynaklı bir çok oyunculu modifikasyondur. Oyuncuların rol yapma (RP), deathmatch, yarış, freeroam ve daha fazlası gibi benzersiz oyun modlarını çalıştıran özel sunuculara bağlanmasını sağlar. Sunucu, JavaScript, TypeScript veya C# ile yazılmış özel kaynaklar çalıştırır ve sunucu sahiplerine oyun mantığı üzerinde tam kontrol verir. Oyuncular, GTA V'yi çok oyunculu bağlanabilirlik için değiştiren alt:V başlatıcısı aracılığıyla bağlanır.
İlk Başlatma
alt:V sunucunuzu ilk aldığınızda, çevrimiçi hale getirmek için şu adımları izleyin:
- GPanel'e giriş yapın ve alt:V sunucunuzu seçin.
- Startup sekmesine gidin ve sunucu adınızı, maksimum oyuncularınızı ve diğer başlatma değişkenlerini yapılandırın.
- Console sekmesine gidin ve Start'a tıklayın.
- Sunucu, ilk açılışta alt:V sunucu dosyalarını indirecektir. Bu birkaç dakika sürebilir.
- Konsol sunucunun dinlediğini ve bağlantılara hazır olduğunu görüntülediğinde, sunucunuz çevrimiçidir.
- Varsayılan olarak, sunucu oyun modu kaynağı olmadan başlar. Oyun oluşturmak için kaynaklar eklemeniz gerekir. Ayrıntılar için bkz. alt:V Yönetici ve Kaynak Kurulumu.
GPanel Başlatma Değişkenleri
alt:V, GPanel'de başlatma değişkenleri olarak çeşitli yapılandırma seçenekleri sunar. Bunları değiştirmek için Startup sekmesine gidin. Değişiklikler bir sunucu yeniden başlatması gerektirir.
| Değişken | Varsayılan | Açıklama |
|---|---|---|
PASSWORD |
ChangeMe |
Sunucuya katılmak için parola. En az 6 karakter. |
SERVER_DESC |
A Pterodactyl Hosted Server |
alt:V sunucu tarayıcısında görüntülenen sunucu açıklaması. |
BUILD |
release |
alt:V sunucu dalı: release (kararlı), rc (yayın adayı) veya dev (geliştirme). |
Sunucu Yapılandırması (server.toml)
alt:V sunucuları için birincil yapılandırma dosyası, sunucu kök dizininde bulunan server.toml'dur. Bu dosyayı GPanel'deki Files sekmesi aracılığıyla veya SFTP üzerinden düzenleyebilirsiniz.
Örnek server.toml
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]
Temel ayarlar: name (tarayıcı görünen adı), host (0.0.0.0 olarak tutun), port (GPanel ile eşleşmeli), players (maksimum sayı), password (genel için boş), announce (tarayıcıda görünmek için true), token (alt:V web sitesinden duyuru jetonu, tarayıcı listelemesi için gerekli), gamemode ("Roleplay" gibi tarayıcı etiketi), modules (komut dosyası modülleri: js-module veya csharp-module), resources (yüklenecek kaynak klasörlerinin dizisi) ve tags (tarayıcı filtre etiketleri).
Duyuru Jetonu
Sunucunuzun alt:V sunucu tarayıcısında görünmesi için alt:V ana sunucusundan bir duyuru jetonuna ihtiyacınız vardır:
- alt:V web sitesini ziyaret edin ve giriş yapın veya bir hesap oluşturun.
- Sunucu yönetimi bölümüne gidin ve yeni bir sunucu jetonu oluşturun.
- Jetonu kopyalayın ve
server.toml'unuzdakitokenalanına yapıştırın. - Yapılandırmanızda
announce = trueolduğundan emin olun. - Sunucuyu yeniden başlatın. Artık genel tarayıcıda görünmelidir.
server.toml'unuzda bulunmalıdır.
Oyun Modu Kaynakları
alt:V sunucuları kaynaklar tarafından desteklenir — tüm oyun mantığını tanımlayan komut dosyaları. Kaynaklar olmadan, bir sunucunun özel işlevselliği yoktur. Kaynaklar resources/ dizinine yerleştirilir.
Kaynak Yapısı
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)
Kaynakları Yükleme
Başlatmada yüklemek için kaynak adlarını server.toml içindeki resources dizisine ekleyin:
resources = ["chat", "freeroam", "spawn"]
Her kaynağın, dizininde türünü, bağımlılıklarını ve komut dosyası giriş noktalarını tanımlayan bir resource.toml dosyası olmalıdır. Kaynak oluşturma ve yönetme hakkında ayrıntılar için bkz. alt:V Yönetici ve Kaynak Kurulumu.
CDN Kurulumu
alt:V, istemci tarafı dosyaları (modeller, dokular, komut dosyaları) bağlanan oyunculara sunmak için bir CDN mekanizması kullanır. Yerleşik CDN, dosyaları ek yapılandırma gerektirmeden doğrudan sunucudan sunar — bu varsayılandır ve çoğu sunucu için iyi çalışır. Çok sayıda özel varlığa sahip büyük ölçekli sunucular için, istemci dosyalarını bir web sunucusuna yükleyerek ve kaynak yapılandırmanızda CDN URL'sini ayarlayarak isteğe bağlı olarak bir harici CDN yapılandırabilir, oyun sunucusu bant genişliği kullanımını azaltabilirsiniz.
Sesli Sohbet
alt:V, oyuncular arasında konumsal (3D) sesli iletişime olanak tanıyan yerleşik bir sesli sohbet sistemi içerir. Sesli sohbet, server.toml içinde etkinleştirilir ve yapılandırılır.
Ses Yapılandırması
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0
bitrate, ses kalitesini kontrol eder (64000 standarttır). external* alanları harici bir ses sunucusunu yapılandırır — çoğu kurulum için önerilen yerleşik ses sunucusunu kullanmak için bunları boş/sıfır bırakın. Harici ses sunucusu seçeneği yalnızca ses işlemenin ayrı bir makineye yüklendiği gelişmiş yapılandırmalar için gereklidir.
Oyuncular Nasıl Bağlanır
Oyuncular, alt:V sunucularına doğrudan GTA V üzerinden değil, alt:V başlatıcısı aracılığıyla bağlanır.
Sunucu Tarayıcısı ile
- alt:V başlatıcısını altvmp.com adresinden indirin ve kurun.
- alt:V başlatıcısını başlatın. GTA V kurulumunu algılayıp doğrulayacaktır.
- Başlatıcıdan Server Browser'a göz atın.
- Sunucunuzu ada göre arayın veya filtreleri (oyun modu, etiketler, oyuncu sayısı) kullanın.
- Sunucunuza tıklayın ve Connect'i seçin.
- Sunucunun bir parolası varsa, oyuncudan parolayı girmesi istenir.
- GTA V, alt:V çok oyunculu modu ile başlatılacak ve sunucunuza bağlanacaktır.
Doğrudan Bağlantı ile
- alt:V başlatıcısında Direct Connect'i seçin.
- Sunucunuzun IP adresini ve portunu
IP:PORTbiçiminde girin (örn.192.168.1.1:7788). - Connect'e tıklayın.
Sunucunuzun IP adresini ve portunu bulmak için bkz. Sunucu IP'nizi ve Portunuzu Nasıl Bulursunuz.
server.toml'unuzda announce = true olduğundan ve geçerli bir duyuru jetonunuz olduğundan emin olun. Sunucu, başlatmadan sonra kaydolmak için bir dakika sürebilir. Ana sunucu bağlantı hataları için konsolu kontrol edin. Özel bir IP'niz olmadığı sürece portunuzun rastgele atandığını unutmayın -- doğru değer için GPanel'i kontrol edin.
Maksimum Oyuncular ve Performans
alt:V sunucuları yüksek oyuncu sayılarını destekleyebilir, ancak performans büyük ölçüde kaynaklarınıza ve sunucu planınıza bağlıdır:
- 32–128 oyuncu: Çoğu sunucu için yaygın bir aralık. Basit oyun modları daha yüksek sayılarda sorunsuz çalışır.
- 128–512+ oyuncu: Verimli kaynaklara sahip optimize edilmiş sunucular için mümkündür. Daha fazla CPU ve RAM gerektirir.
- Kaynak verimliliği: Kötü optimize edilmiş komut dosyaları, performans sorunlarının başlıca nedenidir. Her tick'te ağır işlemler çalıştıran veya bellekte büyük veri yapıları tutan sunucu tarafı komut dosyaları sunucuyu darboğaza sokabilir.
- Veritabanı sorguları: Veritabanları (MySQL, MongoDB) kullanan oyun modları, ana iş parçacığını engellemekten kaçınmak için asenkron sorgular kullanmalıdır.
İlgili Makaleler
- alt:V Yönetici ve Kaynak Kurulumu — Kaynak geliştirme, veritabanı kurulumu, yönetici araçları ve sorun giderme
- 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 ve sorunun açıklamasıyla birlikte bir talep açın.