Ö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 = trueveBanking.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 = trueyaptığında, birim para başınaTokensPerMoneyjeton 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 = falsebunu kapatır. - Casino Live. Yayıncının sesi izleyicilere pma-voice üzerinden taşınır (
Config.LiveMedia.Voice).Config.LiveMediaiç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.adminACE'sidir.ServerConfig.FrameworkAdminsiçindeki framework yetkili grupları da sayılır; yalnızca ACE'yi kullanmak için bunufalseyap. - Hesap verileri resource klasörünün dışında,
server.cfgdosyasının yanındakifx-casinoapps-dataklasöründe (ya daStorage.DataDiriçinde) tutulur; böylece resource'u değiştirmek hesapları silmez. Bu klasörü bir web sunucusu üzerinden açığa çıkarma ya da birfileslistesine 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.