Özellikler

Telefon mağazası

Telefon mağazası tezgâhları, ürünler, 3D vitrin ve oyuncuların işlettiği mağaza işletmesi.

Telefon mağazaları, dünyada satıcı NPC'si olan tezgâhlardır. Oyuncu yanına gelir, satıcıyla konuşur ve bir telefon, bir SIM kart, bir eSIM, yeni bir numara ya da telefonu için bir renk satın alır. fx-phone-assets çalışıyorsa satıcı tezgâha bir 3D telefon da koyabilir; oyuncu onu çevirip kılıflar ve aksesuarlarla süsleyebilir.

Mağazaları oyuncular işletebilir: mağazaların sahibi bir meslektir, çalışanlar müşterilere prim karşılığında hizmet verir ve para mesleğin hesabına gider.

Her şey Config.PhoneShop içindedir.

Bölüm Nedir
Mağazalar NPC'si, blip'i ve çalışma saatleri olan tezgâh konumları
Konuşma ekranı Satıcıyla konuşma ve ürün listesi
Ürünler Neyin hangi fiyata satıldığı
Vitrin Tezgâhtaki 3D telefon (fx-phone-assets gerektirir)
İşletme Mağazaların oyuncuların işlettiği bir işletme olması (isteğe bağlı)

#Oyuncu için nasıl çalışır

  1. Oyuncu bir mağazaya yürür. Satıcı, oyuncu SpawnDistance metre içine girdiğinde belirir.
  2. ox_target çalışıyorsa oyuncu satıcıyı hedefler ve Konuş'u seçer. Çalışmıyorsa 2 metre içinde bir yardım metni görünür: E'ye bas.
  3. Kamera satıcıya yaklaşır, HUD ve radar kenara çekilir ve konuşma ekranı açılır. Telefon açıksa kapanır.
  4. Oyuncu bir ürün seçer ve öder. Fiş ne aldığını gösterir: SIM için yeni numara ve ICCID, kılıf için yeni renk.
  5. Esc ya da Kapat tezgâhtan ayrılır.

Çalışma saatleri dışında satıcı yine konuşur, ama mağazanın kapalı olduğunu söyler ve bir şey satmaz.

Server her satın alımı kontrol eder: mağaza açık ve etkin olmalı, oyuncu da tezgâhın 6 metre yakınında durmalıdır.

#Ödeme

Payment, paranın nereden çekileceğini belirler:

Değer Sonuç
'cash' Yalnızca nakit
'bank' Yalnızca banka
'both' Oyuncunun yeterli nakdi varsa nakit, yoksa banka

'both' ile fiyatın tamamı tek bir hesaptan çekilir; nakit ve banka arasında bölünmez.

#Taşınan oyunculara hoş geldin hediyesi

Telefonu başka bir telefon script'inden fxphone:migrate ile taşınan bir oyuncu (bkz. cylex_phone'dan taşıma), Config.Migration.Gift ile ayarlanan indirimli bir satın alma hakkı kazanır (varsayılan %50 indirim, taşımadan sonra telefonu ilk açışından itibaren 14 gün geçerli; tutara sınır koymamak için MaxAmount = 0).

  • Tezgâhtaki ödeme ekranında indirim kendi satırı olarak görünür ("Hoş geldin hediyesi: -%50"), toplam ve Öde düğmesi indirimden sonraki fiyatı gösterir. Fiş ne kadar tasarruf edildiğini söyler.
  • Konuşma ekranında satılan ürünlere uygulanır. Vitrin sepetinden alınan parçalar (kılıflar, aksesuarlar, aksesuar mağazasından harfler ve orada alınan bir renk) bunu kullanmaz.
  • Bir çalışanın tezgâhta yaptığı indirimden sonra uygulanır ve fiyat asla 0'ın altına inmez.
  • Yalnızca satın alma gerçekleştiğinde kullanılmış sayılır. Başarısız olan bir satın alma (yetersiz para, dolu envanter, tükenmiş stok, SIM sınırı) onu kullanılmamış bırakır.
  • Bir kez çalışır: server onu sürmekte olan tek bir satın alma için ayırır, bu yüzden aynı anda yapılan iki satın alma ya da yeniden giriş onu iki kez kullanamaz. Hediye kullanıldıktan sonra onu isteyen bir satın alma tam fiyattan ücretlendirilmek yerine reddedilir ve ödeme ekranı bundan sonra tam fiyatı gösterir.
  • Bedelini kim öder: müşteri yalnızca daha az öder. Satış ödenen fiyattan kaydedilir; bu yüzden işletme açıksa mağazanın hesabı (ve ödenen fiyatın bir payı olan çalışan primi) o tek satış için daha az alır. Farkı kapatmak için hiçbir yerden para eklenmez.

#Ürünler (Products)

lua{ kind = 'phone', item = 'phone', label = 'shop.products.phone', price = 750, enabled = true },
{ kind = 'case', variation = 'silver', label = 'shop.products.case', price = 120, enabled = true },
Alan Nedir
kind Ürünün ne yaptığı, aşağıya bak
item Item veren türler için verilen envanter item'ı
variation case için: 14 telefon renginden biri
label Ürün adının dil anahtarı
price Temel fiyat
enabled false ürünü her yerde satıştan kaldırır
Tür Oyuncu ne alır Yalnızca şu durumda gösterilir
phone Telefon item'ı. Tek seferde en fazla 5 Bir envanter algılanmışsa
sim Alıcıya kayıtlı, yeni numaralı fiziksel bir SIM Config.Sim.Enabled = true ve bir envanter varsa
sim_prepaid Kimseye kayıtlı olmayan, yeni numaralı, kayıtsız fiziksel bir SIM sim ile aynı, ayrıca mağazada prepaid = true varsa ve Config.Sim.AllowUnregistered false değilse
esim Kayıtlı bir eSIM. Boş bir SIM yuvasında hemen açılır; yalnızca iki yuva da doluysa reddedilir Config.Sim.Enabled = true
reissue Kayıp, kayıtlı bir SIM için aynı numaralı yeni bir kart. Eski kart çalışmayı durdurur Config.Sim.Enabled = true ve bir envanter varsa
number_change Telefondaki bir SIM için yeni bir numara. İki SIM takılıysa oyuncu hangi hat olduğunu seçer. Başka birine ait kayıtlı bir SIM için reddedilir. SIM kartlar kapalıysa karakter için yeni bir numara Her zaman
case Oyuncunun telefonunun rengini değiştirir (ekrandaki çerçeve ve eldeki 3D telefon) Her zaman, bkz. CasesChangeVariation

14 renk şunlardır: black, silver, white, light_gold, cosmic_orange, pink, lavender, purple, burgundy, deep_blue, mist_blue, glacier, sage ve forest.

SIM kuralları (karakter başına kayıtlı SIM sayısı, kimin yeniden çıkarabileceği, kimlik kontrolü) SIM kartlar sayfasındakilerdir. Kayıtlı bir SIM alıcının adıyla satılır; satıcı önce kimlik ister. Kayıtsız bir SIM kimlik gerektirmez.

Para alındıktan sonra başarısız olan bir satın alma (dolu envanter, SIM sınırı) iade edilir.

#Mağazalar (Shops)

luaShops = {
    legion = {
        name = 'FX Mobile Legion',
        coords = { x = 195.17, y = -933.77, z = 30.69, heading = 144.0 },
        npcModel = 's_f_y_shop_mid',
        npcScenario = 'WORLD_HUMAN_STAND_IMPATIENT',
        blip = true, blipSprite = 459, blipColor = 3,
        openFrom = 8, openTo = 22,
    },
    paleto = { ..., prepaid = true },
},

Config mağazaları yalnızca ilk kez oluşturur. Başlangıçta, anahtarı (legion, paleto) henüz veritabanında olmayan her kayıt eklenir. Bundan sonra kaydın sahibi veritabanıdır: config.lua'da bir kaydı değiştirmek zaten var olan bir mağazayı etkilemez, kaldırmak da onu silmez. Bunun yerine mağazaları yönetim tabletinde düzenle. Config'e eklenen yeni bir anahtar, bir sonraki başlatmada yeni bir mağaza ekler.

Alan Nedir
name Mağaza adı, aynı zamanda blip adı
coords Satıcının durduğu yer, heading ile birlikte
npcModel Satıcı modeli. Tablet yalnızca NpcModels içindeki modelleri sunar
npcScenario Satıcının beklerken ne yaptığı: bir scenario adı ya da NpcScenarios içinden bir key
blip, blipSprite, blipColor Harita blip'i
openFrom, openTo Çalışma saatleri, 0 ile 23 arası tam saatler. Her zaman açık için ikisini de yazma (ya da eşit yap). openFrom = 22, openTo = 6 gece yarısını geçer
prepaid Bu mağaza kayıtsız SIM satar

#Yönetim tableti, Mağazalar bölümü

Adminler mağaza ekleyebilir, düzenleyebilir ve kaldırabilir: ad, konum (Bulunduğum yer düğmesi durduğun konumu alır), satıcı, scenario, blip, saatler, kayıtsız SIM açık ya da kapalı, ayrıca mağaza başına fiyatlar ve her ürünü açıp kapatma. God rolü bütün mağazaları tek seferde kapatıp açabilir ve bir mağazaya ışınlanabilir. Değişiklikler her oyuncu için hemen uygulanır.

#Blip'ler ve çalışma saatleri

Blip, saatlerle adlandırılmış kısa menzilli bir blip'tir, örneğin "FX Mobile Legion 08:00-22:00". Çalışma saatleri dışında haritada soluk olarak kalır.

Hours = 'always' (varsayılan) her mağazayı günün her saati açık tutar; aşağıdaki saatler bu durumda yalnızca ayarın değiştirileceği günü bekler.

Hours = 'game', bir zaman senkronu resource'unun yayımladığı oyun saatini (GlobalState.currentTime), yoksa server'ın gerçek saatini izler; 'real' her zaman server'ın gerçek saatini kullanır. Bir mağazanın açık olup olmadığına server karar verir ve blip'ler de aynısını gösterir. fx-3dmap çalışıyorsa mağazalar onun haritasında da gösterilir ve kategori anahtarını izler: bkz. Harita entegrasyonu.

#Konuşma ekranı

Satıcı yerel bir NPC'dir: her oyuncunun oyunu kendi satıcısını yerleştirir, hiçbir şey ağ üzerinden senkronlanmaz. SpawnDistance metre içinde oluşturulur ve DespawnDistance ötesinde kaldırılır.

Kamera oyuncu ile satıcı arasında durur, satıcı panelin yanında duracak şekilde kaydırılır. Oyuncu yakında duruyorsa kamera bunun yerine yaklaşır ve genişler. Satıcının cümlesi göğsünün yanında yazılarak belirir ve yazılırken ağzı hareket eder.

Hud.OnOpen ve Hud.OnClose, konuşma ekranı açılıp kapanırken çalışan fonksiyonlardır. Gelenler wais-hudv6 ve fx-hud'u gizleyip gösterir; çalışmayan bir HUD atlanır. Kendi HUD'unun gizleme ve gösterme çağrılarını aynı şekilde ekle.

#Vitrin

Showroom.Enabled = true olduğunda ve Config.Prop.Assets resource'u (fx-phone-assets) başlatılmışsa konuşma ekranında bir 3D Vitrin kartı bulunur.

  1. Satıcı tezgâha oyuncunun şu anki renginde bir telefon koyar. Kamera yaklaşır.
  2. Oyuncu çevirmek için sürükler ve yakınlaştırmak için tekerleği kullanır. Birkaç saniye dokunulmazsa kendi kendine yavaşça döner.
  3. Sekmeler: Renk, Kılıf, Aksesuar, İsim (arkadaki harfler). Denenen her şey telefonda hemen görünür. İsim alanının altında Yükseklik ve Sağ / Sol, arkadaki ismi Config.Accessories.LetterMove sınırları içinde hareket ettirir (bkz. Kılıflar ve aksesuarlar).
  4. Oyuncunun sahip olmadığı parçalar Sepet'e gider. Öde ve tak onları satın alır ve görünümü oyuncunun telefonuna uygular.

Kılıflar, aksesuarlar ve harfler resmî aksesuar mağazasından Config.Accessories içindeki fiyatlarla satın alınır ve bankadan ödenir: bkz. Kılıflar ve aksesuarlar. Renk değişikliği bu mağazanın case ürünü olarak satın alınır ve Payment ne diyorsa ona göre ödenir. Mağaza seçilen rengi satmıyorsa sepet bunu söyler.

Adminler (fxphone.admin ace'i ya da framework admini) bir Konum sekmesi de görür: her aksesuar yuvasının telefonda nerede durduğunu değiştirir ve Kaydet konumları her oyuncu için uygular.

Seçenek Varsayılan Neyi değiştirir
Showroom.Enabled true Vitrin kartı
Showroom.Offset vector3(0.0, 0.55, 0.32) Telefonun satıcıya göre durduğu yer: sağ, ileri, yukarı
Showroom.CamDistance 0.42 Kameranın telefona uzaklığı, metre cinsinden
Showroom.OnCounter true Telefon, Offset noktasının altındaki yüzeyde (tezgâhta) durur. Orada yüzey yoksa Offset yüksekliği kullanılır
Showroom.Lift 0.0 Telefonu tezgâhtan yükseltir, metre cinsinden
Showroom.Fov 40.0 Lensin ne kadar geniş açıldığı, 12 (yakın çekim) ile 58 (uzak) arası. Tekerlek buradan itibaren yakınlaştırır
Showroom.Light.Enabled true Telefonun üzerinde üç stüdyo ışığı
Showroom.Light.Intensity 1.0 Işık gücü. 1.5 daha parlak, 0.6 daha yumuşak. Gündüz yarıdan az güçle çalışırlar

#İşletme (Business)

Business.Enabled = true olduğunda mağazalar, tek bir mesleğin (Job, varsayılan 'phoneshop') işlettiği bir oyuncu işletmesidir.

#Neler değişir

  • Satışlar mesleğin banka hesabına gider, hizmet veren çalışanın primi düşülerek. İşletme olmadan para ekonomiden çıkıp gider. Taşınan bir oyuncunun hoş geldin hediyesiyle yapılan satış, ödenen düşük fiyattan kaydedilir (bkz. Taşınan oyunculara hoş geldin hediyesi).
  • Fiziksel ürünlerin stoğu vardır. Stocked içindeki türler (varsayılan olarak phone, sim, sim_prepaid) mağaza başına sayılır. Her biri mağaza onu ilk sattığında StartStock ile başlar. 0'da ürün, bir yönetici yeniden sipariş verene kadar stokta yoktur.
  • Çalışanlar tezgâhta hizmet verebilir. Bir çalışan bir mağazada mesaideyken, müşterinin satın alımı onun onayını bekler. Mesaide kimse yoksa satıcı NPC her zamanki gibi satar.

#Çalışanlar için

Bir çalışan konuşma ekranını tezgâhta bir müşteri gibi açar ve bir İşletme paneli alır.

  • O mağazada Mesaiye gir / Mesaiyi bitir. DutyRange metreden uzağa yürüdüklerinde, meslekten ayrıldıklarında ya da sunucudan çıktıklarında mesaileri otomatik olarak biter.
  • Tezgâh: bekleyen müşteriler. Onayla (mağazanın sınırına kadar bir indirimle) ya da Reddet. Bugünkü satışları ve primleri.

Bekleyen bir müşteri "Bir saniye, arkadaşım hemen ilgileniyor." mesajını görür. AnswerSeconds içinde kimse yanıt vermezse satıcı NPC satar (müşteri hâlâ tezgâhtaysa). Konuşma ekranını kapatan bir müşteri isteğini iptal eder. Bir mağaza en fazla 8 bekleyen istek tutar; bunun ötesinde NPC hemen satar.

#Yöneticiler için

ManagerGrade ve üstü rütbeler ya da mesleğin patronu şunları da görür:

Sekme Ne yapar
Stok Bir ürün için stok siparişi verir; meslek hesabından temel fiyatın Wholesale katı üzerinden, en fazla MaxStock kadar ödenir
Fiyatlar Mağazanın ürün başına fiyatını, temel fiyatın PriceRange katları arasında ayarlar. Göz simgesi bir ürünü satıştan kaldırır
Fiyatlar > Tezgâh kuralları Personel primi (en fazla Commission.Max) ve personelin yapabileceği en yüksek indirim (en fazla MaxDiscount)
Kasa Hesap bakiyesi, son 24 saatin ve 7 günün satışları, son satışlar ve bunları kimin yaptığı

Fiyatlar, stok ve kurallar mağaza başınadır.

#Neye ihtiyacın var

  • Framework'ünde rütbeleri olan, Job adında bir meslek.
  • Satışların yatırılabilmesi ve stoğun ödenebilmesi için meslek hesapları olan bir banka adaptörü (Config.Bank.Adapter).
  • Personel işe almak ve hesabı yönetmek için bir şey: fx-companyapp ya da framework'ünün patron menüsü.

#Seçenekler

Seçenek Varsayılan Neyi değiştirir
Business.Enabled true Mağazalar bir işletmedir
Business.Job 'phoneshop' Bütün mağazaları işleten meslek
Business.ManagerGrade 3 Bu rütbe ve üstü fiyatları, stoğu, kuralları ve kasayı yönetir
Business.PriceRange { 0.8, 1.6 } Yöneticiler her ürünü temel fiyatının bu katsayıları arasında fiyatlandırır
Business.Wholesale 0.55 Stok, temel fiyatın bu katsayısına mal olur
Business.Stocked { phone = true, sim = true, sim_prepaid = true } Raftaki mal sayılan türler
Business.StartStock 20 Bir mağaza ilk kez sattığında stoklu ürün başına stok
Business.MaxStock 250 Ürün başına en fazla stok
Business.Commission.Default 10 Bir yönetici değiştirene kadar satışı yapan çalışana ödenen satış yüzdesi
Business.Commission.Max 30 Bir yöneticinin ayarlayabileceği en yüksek prim
Business.MaxDiscount 20 Bir yöneticinin tezgâhta izin verebileceği en yüksek indirim, yüzde
Business.DutyRange 35.0 Bir çalışanın mesaisi bitmeden mağazadan uzaklaşabileceği metre
Business.AnswerSeconds 30 Müşteri isteğinin NPC satmadan önce personeli ne kadar beklediği (en az 5)

#Seçenekler

Seçenek Varsayılan Neyi değiştirir
Enabled true Mağazaları açar. Yönetim tableti sunucu çalışırken bunu geçersiz kılabilir
Payment 'both' 'cash', 'bank' veya 'both' (önce nakit, sonra banka)
Hours 'always' 'always': her mağaza günün her saati açıktır (kendi saatleri saklanır ama kullanılmaz). 'game' / 'real': çalışma saatleri oyun saatini ya da server'ın gerçek saatini izler
CasesChangeVariation true case ürünleri telefonun rengini değiştirir. false: bunun yerine bir item verirler (her birinin bir item alanına ihtiyacı vardır)
Interaction 'auto' 'auto': çalışıyorsa ox_target, yoksa bir yardım metni ve E. 'prompt': her zaman yardım metni
SpawnDistance 60.0 Satıcının oluşturulduğu metre
DespawnDistance 80.0 Satıcının kaldırıldığı metre
NpcModels 4 model Tabletin sunduğu satıcı modelleri
NpcScenarios stand, phone, clip Satıcının bekleme scenario'ları, key ve scenario ile
Talk.CamDistance 1.9 Kameranın satıcıya uzaklığı
Talk.CamMinDistance 0.95 Oyuncu yakında durduğunda kameranın en fazla ne kadar yaklaştığı
Talk.CamFov 42.0 Kameranın görüş alanı
Talk.CamMaxFov 68.0 Yaklaşırken en fazla ne kadar genişlediği
Talk.CamHeight 0.45 Kamera yüksekliği
Talk.CamLookHeight 0.3 Kameranın satıcıda baktığı yükseklik
Talk.CamShift 0.3 Satıcının panelin yanında durması için yana kaydırma
Talk.CamEase 900 Kamera hareket süresi, ms
Talk.TypeMs 1000 Bir cümlenin yazılarak belirme süresi; satıcının ağzı o süre boyunca hareket eder
Talk.BackgroundBlur true Satıcının arkasındaki arka planı bulanıklaştırır
Talk.Bubble.Enabled true Satıcının cümlesi göğsünün yanında. false: ekranın altında
Talk.Bubble.Height 0.28 Satıcının ortasının üstünde metre
Talk.Bubble.Side 0.07 Satıcının ne kadar sağında, ekran genişliğinin bir payı olarak (negatif: sol)
Hud.OnOpen, Hud.OnClose wais-hudv6, fx-hud HUD'unu gizleyen ve gösteren fonksiyonlar

#Kurulum

  1. phone item'ını, SIM kart kullanıyorsan sim_card item'ını da ekle: Item kurulumu.
  2. Mağaza konumlarını oyunda kontrol et. Onları yönetim tabletinde taşı (Mağazalar, Bulunduğum yer) ya da ilk başlatmadan önce Shops'u değiştir.
  3. SIM ürünleri için Config.Sim.Enabled'ı aç (SIM kartlar).
  4. Vitrin için server.cfg'de fx-phone-assets'i ensure et. Resource başlatıldığında bağlı olan oyuncular modellerini yüklemek için yeniden bağlanmalıdır.
  5. İşletme: phoneshop mesleğini oluştur, banka adaptörünün meslek hesapları olduğunu kontrol et, personel işe al. Ya da Business.Enabled = false yap.

#Bilmekte fayda var

  • İşletme varsayılan olarak açıktır. Business.Job mesleği ('phoneshop') sunucunda yoksa işletme kendiliğinden kapalı kalır: konsol bunu bir kez söyler, satıcılar satar ve hiçbir şey stoklanmaz, bu yüzden hiçbir şey tükenmez. İşletmeyi kullanmak için mesleği oluştur ya da uyarıyı susturmak için Business.Enabled = false yap. Sonradan eklenen bir meslek birkaç dakika içinde algılanır.
  • Listede SIM ürünü yok. Config.Sim.Enabled false'tur. Kayıtsız SIM'ler ayrıca mağazada prepaid = true gerektirir.
  • Satışta telefon ya da SIM kart yok. Hiçbir envanter algılanmadı (Config.Inventory), bu yüzden item verilemiyor.
  • Renk kılıfları kayboldu. CasesChangeVariation = false ve kılıf ürünlerinin item alanı yok.
  • config.lua'da bir mağazayı değiştirdim ve hiçbir şey olmadı. Mağazalar ilk başlatmadan sonra veritabanında yaşar. Tableti kullan ya da kayda yeni bir anahtar ver.
  • Mağaza yanlış saatte "kapalı". Hours = 'game' ile server, bir zaman senkronu resource'unun (Renewed-Weathersync gibi) GlobalState.currentTime içinde yayımladığı oyun saatini okur. Böyle bir resource yoksa server'ın gerçek saatini kullanır. Her oyuncunun haritasındaki blip'ler server ile aynı saati izler, asla oyuncunun kendi saatini değil.
  • ox_target çalışıyor ama E yardım metnini istiyorsun. Interaction = 'prompt' yap.
  • Telefonlar tezgâhta şarj olur. Config.Battery.ChargeAtShops = true olduğunda bir telefon, sahibi bir mağazanın yakınında dururken şarj olur. Bkz. Pil ve sinyal.
  • Mağaza satın alımları shop.purchase olarak loglanır; işletme işlemleri shop.duty, shop.restock ve shop.price olarak.