İçeriğe geç
CXGdocs.KILAVUZLAR
Mağazaya dön
cxg-tattoosYapılandırma
CXG DOCUMENTATION

Yapılandırma

Bu sayfadaki ayarlar config.lua dosyasındadır. Mevcut tabloların alanlarını düzenleyin ve değişiklikleri uygulamak için kaynağı yeniden başlatın.

Başlangıç değerleri ve kaydedilmiş ayarlar

Dosyadaki mağazalar ve ilerleme kuralları başlangıç yapılandırması olarak kullanılır. Yönetici panelinden kaydedildikten sonra geçerli değerleri yeniden başlatmalar arasında korunur. Dosyada yapılan değişiklikler kaydedilmiş ayarların yerini otomatik olarak almaz: ilk yapılandırması yapılmış mağazaları, kuralları ve sistem seçeneklerini güncellemek için paneli kullanın.

Dil, provider'lar, bridge'ler, kamera ve önizleme kıyafetleri dosyada yapılandırılır. Kaynaklar ve dövmeler katalog bölümünde açıklanır.

Genel dil

Kod
Config.Locale = 'es'
Config.LocaleFallback = 'en'

Locale, tüm oyuncular için arayüzün ve mesajların dilini belirler. Değiştirdikten sonra kaynağı yeniden başlatın; oyuncu bunu NUI içinden değiştiremez. LocaleFallback yedek dildir.

Dahil edilen diller: en, es, pt-BR, fr, de, it, pl, ru, tr, th ve ar. Arapça arayüz sağdan sola okuma yönünü kullanır.

Kimlik sistemi

Config.Identity, sunucunun kimlik sistemiyle entegrasyonu yapılandırır. Kaynağın dövmeleri, XP'yi ve blueprint'leri kaydetmek ve geri almak için kullanacağı karakter veya hesap tanımlayıcısının nasıl elde edileceğini belirler.

Kod
Config.Identity.mode = 'auto'
Config.Identity.qbxResource = 'qbx_core'
ModKullanım
autoQbox'ta etkin karakterin tanımlayıcısını (citizenid) kullanır. Diğer sunucularda FiveM'in kalıcı tanımlayıcısını kullanır.
qbx_characterQbox karakter tanımlayıcısını (citizenid) açıkça kullanır.
licenseHesap tanımlayıcısı olarak FiveM lisansını kullanır. Bu hesaptaki karakterler dövmeleri, XP'yi ve blueprint'leri paylaşır.

Kaynağı oyunculara açmadan önce modu seçin. Sonradan değiştirmeniz, verilerin sorgulandığı kimliği değiştirir; verileri modlar arasında otomatik olarak taşımaz. Dövmeleri aynı hesaptaki karakterler arasında ayırmak istiyorsanız license seçmeyin.

Etkileşim bildirimi

Kod
Config.HelpText.enabled = true
Config.HelpText.provider = 'auto'
Config.HelpText.position = 'left-center'
AlanDeğerler veya etkisi
enabledİşaretçili mağazaların etkileşim bildirimini gösterir veya gizler.
providerauto, ox_lib veya native. auto, kullanılabilir durumdaysa TextUI'ı; değilse yerel bildirimi kullanır.
positionTextUI için left-center, right-center, top-center veya bottom-center.
styleTextUI renkleri, kenarlığı, gölgesi, yazı tipi ve iç boşluğu.

Stil örneği:

Kod
Config.HelpText.style.backgroundColor = '#172328'
Config.HelpText.style.color = '#eef3f3'
Config.HelpText.style.fontSize = '15px'

Başlangıç mağazaları

Config.Shops altı konum içerir. Başlangıç girdisini değiştirmek için yapısını koruyun:

Kod
{
    label = 'Tattoo Studio',
    coords = vector3(322.62, 180.34, 103.59),
    heading = 156.2,
    drawDistance = 10.0,
    interactDistance = 1.5,
    shopRadius = 4.0,
    marker = {
        type = 1,
        scale = vector3(1.0, 1.0, 1.0),
        color = { r = 255, g = 100, b = 0, a = 100 },
    },
},
AlanKullanım
labelMağazanın adı.
coords, headingKonum ve yön.
drawDistanceİşaretçinin görüntülenme mesafesi.
interactDistanceEtkileşim mesafesi.
shopRadiusMağaza işlemlerine izin verilen yarıçap.
marker.type, scale, colorİşaretçinin görünümü.

interactDistance değerini shopRadius içinde tutun. Önceden oluşturulmuş mağazalarda yönetici panelinin mağazalar bölümünü kullanın; dosyayı düzenlemenin mevcut mağazaları yeniden oluşturmasını veya değiştirmesini beklemeyin.

Seviyeler ve XP

Config.Levels ayarıBaşlangıç değeriKullanım
enabledtrueİlerlemeyi, gereksinimleri ve indirimleri etkinleştirir.
maxLevel10Seviye üst sınırı.
defaultXpPerTattoo10Xp belirtmeyen bir dövmenin XP değeri.
thresholds1–10. seviyelerHer seviyeye ulaşmak için gereken toplam XP.
formula.base, formula.exponent100, 1.5Alternatif eşik formülünün parametreleri.
zoneRequirementsHer bölge için 1Tekil bir gereksinim tanımlı değilse bölge gereksinimi.
discountsEtkin, seviye başına 3, en fazla 25Yüzde cinsinden indirim.
blueprintSlotsBaşlangıç 5, artış 3Seviyeye göre blueprint yuvası sayısı.

Eşikler 1. seviyede 0 XP ile başlamalı, seviyeleri atlamadan ilerlemeli ve gereken XP artmalıdır:

Kod
Config.Levels.thresholds = {
    { level = 1, xpRequired = 0 },
    { level = 2, xpRequired = 100 },
    { level = 3, xpRequired = 250 },
}
Config.Levels.maxLevel = 3

İndirim, seviye × perLevel olarak hesaplanır ve maxDiscount ile sınırlandırılır. Başlangıç değerleriyle 5. seviye %15 indirim alır; üst sınır %25'tir.

Yuva sayısı base + (seviye - 1) × perLevel olarak hesaplanır. Başlangıç yapılandırmasında 1. seviyede 5, 5. seviyede 17 yuva bulunur.

Katalogdaki tekil bir RequiredLevel, bölge gereksiniminden önceliklidir. Katalog alanları bölümüne bakın.

Seviyeler devre dışı bırakıldığında seviye engelleri, XP veya indirim uygulanmaz; blueprint sınırı Config.Blueprints.maxPerPlayer değerini kullanır. Sistemi devre dışı bırakmak kaydedilmiş XP'yi silmez. İlk yapılandırması yapılmış kurulumlarda etkin durumu panelden de güncelleyin.

Blueprint'ler

Blueprint'ler dövme gruplarını kaydeder ve bunları kodlarla paylaşmaya olanak tanır. Başlangıç sınırları Config.Blueprints içindedir:

AlanBaşlangıç değeriKullanım
enabledtrueSistemi etkinleştirir.
codePrefixINKKodların öneki; örneğin INK-A3X9.
codeLength4Önekten sonraki karakter sayısı.
maxPerPlayerİlerleme etkin değilken kullanılan 20 yuvaOyuncu başına sınır.
maxTattoosPerBlueprint50Bir gruptaki en fazla dövme sayısı.
nameMaxLength60İsim için en fazla karakter sayısı.

Bir kodu kullanmak dövmeleri satın alma akışına hazırlar; ücretsiz satın alma sağlamaz. Ekonomi entegrasyonlar bölümünde yapılandırılır.

Kamera

TabloDenetlediği ayarlar
CameraOffsetsHer bölge için hedef kemik, mesafe, ofsetler ve görüş alanı.
CameraFramingGenel kadraj ve odak noktasının kaydırılması.
CameraFramingBySideÖn ve arka görünümler için ek ayarlar.
CameraManualControlsElle denetimler, hareket adımları, dönüş, yakınlaştırma ve sınırlar.

Yapılandırılmış bölgeler ZONE_HEAD, ZONE_TORSO, ZONE_LEFT_ARM, ZONE_RIGHT_ARM, ZONE_LEFT_LEG ve ZONE_RIGHT_LEG şeklindedir.

Belirli ayarları değiştirme örnekleri:

Kod
Config.CameraOffsets['ZONE_TORSO'].fov = 50.0
Config.CameraFraming.screenOffset = 0.35
Config.CameraManualControls.enabled = true
Config.CameraManualControls.step = 0.035
Config.CameraManualControls.zoomStep = 0.08

Pozitif screenOffset, sağdaki menüye yer açmak için karakteri sola kaydırır. lookAtOffsetX/Y/Z odak noktasını değiştirir; tarafa göre ayarlardaki camOffsetX/Y/Z kamera konumunu değiştirir.

Elle denetimlerde horizontalDegrees ve rotationStepDegrees dönüşü ayarlar. ranges.y/z, radialClamp ve maxDistance hareketleri sınırlar. zoomCompositionMinBias, yakınlaştırırken merkezlemeyi ayarlar. Her seferinde bir değeri değiştirin ve altı bölgenin tümünü erkek ve kadın karakterlerle deneyin.

Önizleme kıyafetleri

Config.PreviewOutfit, arayüz açıkken dövme bölgelerinin görünür olmasını sağlar:

Kod
Config.PreviewOutfit.enabled = true
Config.PreviewOutfit.useDefaultVariation = false
Config.PreviewOutfit.presets['mp_m_freemode_01'].components[11] = {
    drawable = 15,
    texture = 0,
}

Dahil edilen hazır ayarlar mp_m_freemode_01 ve mp_f_freemode_01 için ayrıdır. Her bileşen drawable ve texture belirtir; clearProps, önizleme sırasında aksesuarları kaldırır. İndeksleri sunucunuzda kurulu kıyafetlere göre ayarlayın. Görünümü genel olarak sıfırlamadan yalnızca hazır ayardaki bileşenleri uygulamak istiyorsanız useDefaultVariation = false değerini koruyun.

İzinler, ekonomi ve Qbox

Config.Permissions, Config.AdminCommand, Config.Purchases ve Config.QbxMulticharacterPreview entegrasyonlar bölümünde açıklanır. Kaynak adları varsayılanlardan farklıysa gerçek adları yapılandırın.

Sorun giderme

Config.Debug genel tanılamayı etkinleştirir. Config.Permissions.debug erişim kararlarını incelemeyi sağlar. İşiniz bitince ikisini de devre dışı bırakın.

Config.DebugCommands.clientTattooCommand başlangıçta devre dışıdır. Bu görsel komutu yalnızca test için etkinleştirin: dövmeleri kaydetmez ve satın alma işleminin yerini tutmaz.

Kataloğa devam edin.

CXG · Dokümantasyonİyi bir temel. Sonsuz olasılıklar.
Yapılandırma · cxg-tattoos · CXG Docs