Karakter Seçimi#

Açık ayar dosyası#

Dosya: dxa-multicharacter/config.lua

Karakter seçimi, oyuncu şehre girmeden önce ayrı bir önizleme alanında çalışır. Konum, kamera ve görünüm ayarlarını değiştirmeden önce mutlaka boş bir test karakteriyle giriş, karakter seçme, yeni karakter oluşturma ve oyuna doğma akışını deneyin.

Önizleme alanı#

Ayar	Görevi	Yanlışsa ne olur?
Interior	Önizleme dünyasının yükleneceği iç alan.	Ortam yüklenmez, siyah ekran veya boş dünya görülebilir.
PedCoords	Seçilen karakter modelinin gösterildiği nokta.	Model zemine gömülür ya da sahnenin dışında kalır.
HiddenCoords	Oyuncunun gerçek pedinin seçim sırasında saklandığı nokta.	Gerçek karakter önizleme alanında görünür veya yanlış yerde kalır.
CamCoords	Başlangıç kamera konumu ve yönü.	Karakter görünmez ya da kamera duvara bakar.
DefaultSpawn	Başlangıç dairesi kapalıysa ilk doğma yeri.	Yeni karakter uygun olmayan bir yere doğar.

Bu beş konumu ayrı ayrı taşımayın. Yeni sahne kuracaksanız önce içeriyi yükleyin, PedCoords ile HiddenCoords’un zeminde olduğuna bakın, sonra kamerayı pedin yüzüne hizalayın. İç mekân koordinatını açık dünya koordinatlarıyla karıştırmak en yaygın hatadır.

Karakter sayısı ve silme#

Config.DefaultNumberOfCharacters normal oyuncunun açabileceği karakter sayısıdır; paket varsayılanı 1’dir. PlayersNumberOfCharacters listesi belirli Rockstar lisanslarına istisna tanımlar. Bu listeyi yalnızca kendi personeliniz veya satın alma ödülü gibi kesin ihtiyaçlarda kullanın; lisans değerini veritabanından aynen alın.

EnableDeleteButton false iken oyuncu seçim ekranından karakter silemez. Bu en güvenli varsayılandır. Açmadan önce yanlış silinen karaktere ilişkin destek ve geri yükleme politikanızı belirleyin.

EnableLastCharacter true, son oynanan karakter için hızlı giriş düğmesini gösterir. Hızlı erişimi kapatmak isteyen rol sunucuları false kullanabilir; mevcut karakter verisini silmez.

Tema, müzik ve sunucu bilgisi#

Theme şu hazır seçeneklerden biridir: midnight_aurora, neon_sunset, obsidian_rose ve electric_violet. Listede olmayan isim kullanmayın. AmbientMusic.enabled arka plan müziğini açar; url doğrudan erişilebilir MP3/OGG adresi, volume 0.0–1.0 aralığındadır. Uzun, reklamlı veya erişim izni isteyen bağlantılar yerine kendi güvenilir ses dosyanızı kullanın.

ServerInfo bölümündeki name, tagline, discord, website, motd ve rules yalnızca karşılama ekranında görünür. Discord/website adreslerini değiştirdikten sonra tarayıcıda açıldıklarını kontrol edin. Kural satırları oyuncuya kısa ve anlaşılır biçimde yazılmalıdır.

Kamera ve geçiş ayarları#

CinematicCamera.mouseOrbit oyuncunun fareyle karakter çevresinde dönmesini sağlar. mouseSensitivity fazla yükselirse kontrol zorlaşır. orbitRadius ve orbitHeight kamera mesafesini belirler. defaultFov düşük olduğunda daha sinematik, fakat dar; maxFov yükseldiğinde daha geniş görünüm alınır. minFov, defaultFov ve maxFov sırası mantıklı kalmalıdır.

CinematicFlow süreleri milisaniyedir. minimumLoadingDuration ve introDuration ekrandaki açılış süresini; commitDuration oyun dünyasına geçiş beklemesini belirler. previewModelTimeout, preloadTimeout, collisionTimeout ve stablePositionTimeout hata durumunda sonsuz beklemeyi önleyen sürelerdir. Bunları çok düşürmek yavaş bilgisayarda eksik model/zemin yüklenmesine yol açabilir. requestCooldown karakter seçme isteğinin art arda gönderilmesini sınırlar; 1500 ms güvenli varsayılandır.

Envanter, telefon ve gösterilen bilgiler#

InventorySystem, sunucudaki envanter kaynağıyla aynı olmalıdır: pakette ox_inventory kullanılır. PhoneSystem lb-phone olarak ayarlıdır. PhoneTable içindeki tablo ve sütun adları LB Phone kurulumunuzla uyuşmalıdır; bunları yalnızca telefon veritabanısı özelleştirildiyse değiştirin.

CharacterStats bölümündeki seçenekler seçme ekranında hangi bilgilerin görüneceğini belirler. maxInventoryItems, gösterilen üst eşya sayısıdır; yüksek değer daha ayrıntılı görünür ama ekranı kalabalıklaştırır. showPhone veya showPlaytime veri sağlamayan bir kaynakta açıksa alan boş görünebilir; bu durumda kapatın.

Kısayollar, fotoğraf ve sihirbaz#

Keybinds içindeki tuşlar seçim ekranındayken kullanılır. Başka bir NUI kısayoluyla çakışma olmadığından emin olun. PhotoMode.maxPhotos her oyuncunun tarayıcısında tutulacak üst fotoğraf sayısıdır; yüksek tutmak oyuncunun yerel depolamasını şişirebilir. CharacterWizard.steps kimlik oluşturma adımlarını belirler; tanımlı olmayan adım eklemeyin.

Sorun çözümü#

Belirti	Kontrol
Seçim ekranı siyah veya boş	Interior, PedCoords, HiddenCoords ve CamCoords’un aynı sahneye ait olduğunu doğrulayın.
Karakter doğunca zemine düşüyor	DefaultSpawn veya seçilen doğma noktasında çarpışmanın yüklendiğini test edin; collision sürelerini aşırı azaltmayın.
Telefon numarası görünmüyor	PhoneSystem ve PhoneTable adlarını LB Phone kurulumuyla karşılaştırın.
Müzik çalmıyor	URL’nin doğrudan ve herkesçe erişilebilir bir ses dosyası olduğundan emin olun.
Karakter seçimi gecikiyor	Geçiş sürelerini azaltmadan önce model yükleme ve sahne koordinatlarını kontrol edin.