Özellikler

Fixitfy Play (fx-casinoapps)

Paketle gelen telefon oyunları uygulaması, telefona nasıl kurulduğu ve ana server ayarları.

#Nedir

fx-casinoapps telefona "Fixitfy Play" (Config.AppName) adıyla görünen tek bir uygulama ekler. Manifest'ine göre 13 telefon oyunu, bir Prestige sistemi ve Casino Live içerir.

Oyuncular uygulama içi bir cüzdanda tutulan jetonlarla ("jetons") oynar. Bu jetonların sunucunda neye değdiğini üç şey belirler:

  • Eğlence modu. Sahte jetonlardan oluşan ayrı bir cüzdan. Paket geldiği haliyle FunMode.Forced = true: herkes yalnızca sahte jetonla oynar ve banka transferleri kapalıdır.
  • Sandbox. Paket geldiği haliyle SandboxEnabled = true ve Banking.Enabled = false: cüzdanlar yereldir ve bankalar simüle edilir. Framework bankasına hiçbir çağrı yapılmaz.
  • Gerçek bankacılık. Uygulama, cüzdan ile framework bankası arasında parayı yalnızca Banking.Enabled = true yaptığında, birim para başına TokensPerMoney jeton oranıyla taşır.

Diğer özellikler:

  • Yakındakilerle ekran paylaşımı. Bir oyuncu oyun ekranını yakındaki oyuncularla salt okunur bir görünüm olarak paylaşabilir. Aynı routing bucket ve kısa bir mesafe gerekir; bunlar server tarafında kontrol edilir. ServerConfig.SharingEnabled = false bunu kapatır.
  • Casino Live. Yayıncının sesi izleyicilere pma-voice üzerinden taşınır (Config.LiveMedia.Voice). Config.LiveMedia içindeki kamera seçenekleri kapalıdır ve kapalı kalmalıdır.
  • Yönetim sayfası. Admin yetkisi olan oyuncular için uygulama içinde raporlar ve oyun ayarları.

#Gereksinimler

Resource Zorunlu
fx-phone Evet (uygulama lb-phone ya da cylex_phone'a da kurulur)
Bir framework ESX, QBCore, Qbox veya standalone; ServerConfig.Framework ile ayarlanır (varsayılan auto)
Bir MySQL bağlantısı İsteğe bağlı. Storage.Driver = 'auto' ile hesaplar, sunucunun bağlantısı varsa MySQL'i, yoksa JSON dosyalarını kullanır

Server kodu FiveM'in yerleşik Node 22 çalışma ortamını kullanır (manifest'te node_version '22'). Sunucuya hiçbir Node bağımlılığı kurman gerekmez.

#Kurulum

Telefondan sonra başlat:

cfgensure fx-phone
ensure fx-casinoapps
add_ace group.admin fxcasino.admin allow
  • Admin yetkisi fxcasino.admin ACE'sidir. ServerConfig.FrameworkAdmins içindeki framework yetkili grupları da sayılır; yalnızca ACE'yi kullanmak için bunu false yap.
  • Hesap verileri resource klasörünün dışında, server.cfg dosyasının yanındaki fx-casinoapps-data klasöründe (ya da Storage.DataDir içinde) tutulur; böylece resource'u değiştirmek hesapları silmez. Bu klasörü bir web sunucusu üzerinden açığa çıkarma ya da bir files listesine ekleme.
  • Güncellerken resource'u durdur ve veri klasörünü ait olduğu resource sürümüyle birlikte yedekle.
  • licenses/ içindeki metinleri resource ile birlikte tut.

#Telefona nasıl kaydolur

Config.Phone telefonu seçer: auto, fx-phone, lb-phone veya cylex_phone.

FX Phone adaptörü (client/phones/fxphone.lua), exports['fx-phone']:AddCustomApp export'unu identifier = Config.AppId (varsayılan fx-arcade), name = Config.AppName, defaultApp = Config.DefaultApp, ui ve icon ile çağırır. Sayfaya SendCustomAppMessage ile mesaj gönderir, metin alanı odağını SetInputFocus ile bildirir ve uygulamayı RemoveCustomApp ile kaldırır. Telefon yüklendiğinde uygulama bir kez yeniden eklenir.

Uygulamanın hiç başlamamasını istiyorsan Config.BundledApps içinde ['fx-casinoapps'] = false yap. Bkz. Uygulamalar.

#Öne çıkan config ayarları

config.lua (ortak):

Ayar Anlamı
Phone auto, fx-phone, lb-phone veya cylex_phone
AppId, AppName, DefaultApp Uygulama id'si, simgenin altındaki ad ve her telefonda kurulu gelip gelmediği
CylexSafeArea Cylex Phone'da üstte ve altta boş bırakılan alan
LiveMedia Casino Live sesi ve ses düzeyi. FaceCam ve FaceVideo seçeneklerini kapalı bırak

config_server.lua (yalnızca server):

Ayar Anlamı
SandboxEnabled Yerel demo cüzdanları ve simüle edilen bankalar
ProductionEnabled Gerçek cüzdanlar; yalnızca kendi yayına alma kontrollerinden sonra aç
SharingEnabled Yakındakilerle salt okunur ekran paylaşımı
Storage Driver (auto, mysql, json), bağlantı convar adı ve DataDir
AutoSignIn Giriş yapmış bir karakter, sonraki bağlantısında yeniden giriş yapmış olur
Framework, FrameworkAdmins Framework seçimi ve admin sayılan yetkili grupları
Burst, RequestsPerSecond Oyuncu başına istek hızı sınırları
SandboxBankBalance Sandbox'ta karakter başına simüle edilen banka bakiyesi
TokensPerMoney Bir birim sunucu parasının kaç jeton aldığı. Değiştirmek, oyuncuların elindeki jetonların para değerini de değiştirir
WithdrawalTax Cüzdandan bankaya transferlerde vergi. Yatırmalar vergilendirilmez; vergi kimseye ödenmez
FunMode Enabled, Forced, StartBalance, RefillBalance, AutoRefillBelow
Support Hesap desteği (cashback) oranları ve üst sınırları
Fivemanage Casino Live için klip sesi: bir açma/kapama anahtarı ve yükleme token'ı ayarı. Token bir server convar'ından da gelebilir; onu asla setr ile ayarlama
Relay Yakındakilerle ekran paylaşımı için isteğe bağlı HTTPS relay. Ulaşılamazsa paylaşım oyun event'leri üzerinden devam eder
Banking Enabled gerçek framework banka çağrılarını açar; TimeoutMs bir banka çağrısının ne kadar sürebileceğidir. Belirsiz bir sonuç parayı dondurur ve otomatik olarak yeniden denenmez

Oyunların açık olup olmadığı ve bahisler config/games.json içindedir (activeGames, defaultStakes, gameStakes). Yönetim sayfasında kaydedilen bir bahis basamağı o oyun için dosyanın yerine geçer. Bu ayarlardaki geçersiz bir değer, sunucunun resource'u yanlış bir ayarla çalıştırması yerine hiç başlatmamasına yol açar.

#Eğlence modu

  • Enabled = true, Forced = true: herkes yalnızca sahte jetonla oynar. Gerçek cüzdan, para yatırma ve çekme kapalıdır.
  • Enabled = true, Forced = false: oyuncular gerçek jetonlarla başlar, ayrı bir sahte cüzdana geçip geri dönebilir.
  • Enabled = false: eğlence modu yok.

İki cüzdan ve geçmişleri ayrı tutulur. Sahte jetonlar bankaya ulaşamaz, destek ya da Prestige kazandırmaz ve gerçek yönetim raporlarında görünmez; orada kendi bölümleri vardır.

#Gerçek parayla yayına alma

Banking.Enabled seçeneğini açmadan önce kendi sunucunda test et: telefon odağı, açma ve kapama, karakter değiştirme, aynı hesabın iki cihazda kullanımı ve resource'un yeniden başlatılması. Sonra FunMode.Forced = false (ya da Enabled = false) yap.

#Komutlar

Komut Ne yapar
/fxcasino-stopwatch Paylaşılan bir ekranı izlemeyi bırakır

#Export'lar

Bu resource'un export'u yoktur.