Dövme kataloğu

Katalog, CXG Base dövmelerini ve kurduğunuz paketlerdeki dövmeleri bir araya getirir. Harici paketler isteğe bağlıdır: hiçbirini etkinleştirmeyebilir, birini veya birkaçını etkinleştirebilirsiniz. Bir paket yoksa ya da durdurulmuşsa dövmeleri mağazada gizlenir ve CXG Base kataloğu kullanılabilir kalır.

Giriş, Kurulum, Yapılandırma, Entegrasyonlar ve Arayüz bölümlerine de bakın.

İsteğe bağlı paketler

Başlangıç yapılandırması şu isteğe bağlı kaynakları içerir:

Yalnızca sahip olduğunuz paketleri kurun ve cxg-tattoos kaynağından önce başlatın. Kaynak adını ve yolu sunucunuzda bulunduğu şekilde, büyük/küçük harfleri koruyarak kullanın. Bir kaynağı geçici olarak gizlemek için enabled değerini false yapın; yeniden göstermek için true yapın ve kaynağın başlatılmış olduğundan emin olun.

CXG Base, kaynağın içindeki shared/tattoos.json dosyasını kullanır. native-game kaynağı oyunun yerleşik dövme tasarımlarını alır ve başlangıçta devre dışıdır. Bunu kullanmak için doğrulama kaynaklarını da native.serverMetas içinde sunucunuzdaki gerçek kaynak ve dosyalarla yapılandırın. Örnek girdi tatto kaynağını ve shop_tattoo.meta dosyasını gösterir; bu kaynağın kurulu olduğunu varsaymaz. Yalnızca enabled değerini açmak, bu tasarımların satın alınabilmesini sağlamaz.

JSON kaynağı ekleme

Config.TattooCatalog.sources içindeki her nesne bir kaynağı yapılandırır. Bu örnek paket kaynaklarının yapısını izler; gerçek kaynak adı ve dosyasıyla uyarlanabilir:

{
    id = 'mi-pack',
    label = 'Mi Pack',
    color = '#62b6cb',
    enabled = true,
    resource = 'mi_pack',
    path = 'tattoos.json',
    thumbnailPattern = 'miniatures/{Name}.webp',
    root = { mode = 'auto', field = 'Overlays' },
    defaults = {
        collection = 'mi_pack_overlays',
        zone = 'ZONE_TORSO',
        price = 5000,
        requiredLevel = 1,
        overlayTarget = 'male',
    },
}

id, kaynağı kalıcı biçimde tanımlamalıdır; arayüzde tanımak için label ve color kullanılır. resource ve path JSON dosyasını gösterir. Dosya, kullanılabilir bir kaynağın içinde bulunmalıdır. Tasarımın iki kez görünmesini istemiyorsanız aynı tasarımı iki kaynağa eklemeyin; deduplicateAcrossSources kaynaklar arasındaki kopyaları kaldırmayı sağlar.

Genel ayarlar Config.TattooCatalog içindedir:

Okuma için fallback, durdurulmuş bir paketi kullanılabilir hale getirmez.

Her dövmenin biçimi

Dosya bir JSON dizisi veya bu diziyi içeren bir özelliğe sahip nesne olabilir. root.mode = 'auto' ile okuyucu her iki biçimi de kabul eder; root.mode = 'field' olduğunda liste konumunu root.field belirtir. root.mode = 'array', kök düzeyinde dizi kullanılmasını zorunlu kılar.

Bu dizi JSON biçimini gösterir. Örnekteki koleksiyon ve hash değerleri temsilidir; bunları kurulu paketin gerçek adlarıyla değiştirin. Bir JSON girdisi eklemek grafik overlay dosyalarını kurmaz.

[
  {
    "Collection": "mi_pack_overlays",
    "Name": "Rosa del desierto",
    "HashNameMale": "MP_MI_PACK_ROSE_M",
    "HashNameFemale": "MP_MI_PACK_ROSE_F",
    "Zone": "ZONE_TORSO",
    "Price": 5000,
    "Xp": 15,
    "RequiredLevel": 2
  }
]

Tasarımı tanımlamak için Collection ve en az bir overlay hash'i gerekir. Dövmenin her karakter için bir çeşidi varsa HashNameMale ile HashNameFemale alanlarını ekleyin. Şu bölgelerden birini kullanın: ZONE_HEAD, ZONE_TORSO, ZONE_LEFT_ARM, ZONE_RIGHT_ARM, ZONE_LEFT_LEG veya ZONE_RIGHT_LEG. Name, alıcının göreceği addır. Price belirtilmezse kaynağın varsayılan fiyatı; RequiredLevel belirtilmezse başlangıç değeri 1 olan defaults.requiredLevel kullanılır. XP, dövmeden veya seviye yapılandırmasından gelebilir.

Alan adları farklı olan dosyalarda Config.TattooCatalog içindeki fields değerini ayarlayın. Bu tablodaki her girdi, ilgili değeri bulmak için kontrol edilecek takma adların listesidir. Örneğin OverlayHash, Cost ve BodyZone kullanan bir dosya şöyle eşlenebilir:

fields = {
    collection = { 'Collection', 'CollectionName' },
    name = { 'Name', 'DisplayName' },
    overlay = { 'OverlayHash' },
    hashNameMale = { 'MaleOverlay' },
    hashNameFemale = { 'FemaleOverlay' },
    zone = { 'BodyZone' },
    price = { 'Cost' },
    xp = { 'Xp', 'Experience' },
    requiredLevel = { 'RequiredLevel' },
}

Ortak değerleri de rootFields ile atayabilirsiniz; örneğin koleksiyon adını veya kök nesnede bir kez tanımlanan bölgeyi. Her kaynağın defaults ayarları eksik değerleri tamamlar. JSON'unuzda OverlayHash gibi tek bir genel alan varsa defaults.overlayTarget, bunun erkek (male) veya kadın (female) dövmesi olarak yorumlanacağını belirler.

Çok farklı biçimler, yapılandırmadaki isteğe bağlı converters.decode(decoded, settings) veya converters.entry(entry, context) işlevleriyle dönüştürülebilir. İlki belgenin tamamını, ikincisi her bir tasarımı uyarlar. Normal eşleme için gerekli alanları hazırlanmış bir tablo döndürün.

Küçük resimler

Aynı pakette bulunan görselleri kullanmak için o kaynakta miniatures/ klasörünü koruyun ve şöyle bir kalıp tanımlayın:

thumbnailPattern = 'miniatures/{Name}.webp'

{Name}, {HashNameMale}, {HashNameFemale} ve {HashName} dövme verileriyle değiştirilir. Sonuçta oluşan dosya, örneğin miniatures/Rosa del desierto.webp, mevcut olmalı ve kaynak başlatılmış olmalıdır. Arayüz her küçük resmi gerektiğinde ister; görselleri CXG paketine kopyalamayın.

Bir girdide belirli bir görsel belirtmek için Thumbnail veya ThumbnailUrl da kullanabilirsiniz. http://, https:// ve data: URL'leri olduğu gibi kullanılır. Paketteki yerel küçük resim yolu thumbnailPattern ile eşleşmelidir; dosya bulunmalı ve kaynak bunu NUI'a sunabilmelidir. Harici kaynakların kendi görsel dosyaları pakette kalmalıdır.

Yapılandırmadan ve yönetim panelinden değişiklikler

Kaynak eklemek, okuma biçimini değiştirmek, paketleri etkinleştirmek veya devre dışı bırakmak ve varsayılan değerlerini ayarlamak için yapılandırmayı düzenleyin. JSON'u düzenlemeden dövmelerin adını, fiyatını, seviyesini ve kullanılabilirliğini değiştirmek için katalog yönetimini kullanın. Yönetim değişiklikleri kaydedilir ve katalog eşitlemelerinden sonra da korunur. Geri yükleme işlemi, dövmeyi kendi kaynağındaki değerlere döndürür.

Oyuncunun daha önce satın aldığı dövmeler, onları sağlayan paket geçici olarak kapatılsa bile karakterine bağlı kalır. Paket yeniden kullanılabilir olana kadar mağazada görünmez.