Features

Fixitfy Play (fx-casinoapps)

The bundled phone games app, how it installs into the phone and its main server settings.

#What it is

fx-casinoapps adds one app to the phone, shown as "Fixitfy Play" (Config.AppName). According to its manifest it contains 13 phone games, a Prestige system and Casino Live.

Players play with tokens ("jetons") held in an in-app wallet. Three things decide what those tokens are worth on your server:

  • Fun mode. A separate wallet of fake tokens. As shipped, FunMode.Forced = true: everyone plays with fake tokens only and bank transfers are off.
  • Sandbox. As shipped, SandboxEnabled = true and Banking.Enabled = false: wallets are local and banks are simulated. No framework bank call is made.
  • Real banking. Only when you set Banking.Enabled = true does the app move money between the wallet and the framework bank, at TokensPerMoney tokens per unit of money.

Other features:

  • Nearby screen sharing. A player can share their game screen with nearby players as a read-only view. It needs the same routing bucket and a short distance, checked on the server. ServerConfig.SharingEnabled = false turns it off.
  • Casino Live. A streamer's voice is carried to viewers through pma-voice (Config.LiveMedia.Voice). The camera options in Config.LiveMedia are off and should stay off.
  • Admin page. Reports and game settings inside the app, for players with the admin permission.

#Requirements

Resource Required
fx-phone Yes (the app also installs into lb-phone or cylex_phone)
A framework ESX, QBCore, Qbox or standalone, set by ServerConfig.Framework (auto by default)
A MySQL connection Optional. With Storage.Driver = 'auto' accounts use MySQL when the server has a connection, otherwise JSON files

The server code uses FiveM's built-in Node 22 runtime (node_version '22' in the manifest). No Node dependencies need to be installed on the server.

#Installation

Start it after the phone:

cfgensure fx-phone
ensure fx-casinoapps
add_ace group.admin fxcasino.admin allow
  • The admin permission is the ACE fxcasino.admin. The framework staff groups in ServerConfig.FrameworkAdmins also count; set it to false to use only the ACE.
  • Account data is kept outside the resource folder, in fx-casinoapps-data next to server.cfg (or Storage.DataDir), so replacing the resource does not remove accounts. Do not expose that folder through a web server or add it to a files list.
  • When updating, stop the resource and back up the data folder together with the resource version it belongs to.
  • Keep the texts in licenses/ with the resource.

#How it registers into the phone

Config.Phone selects the phone: auto, fx-phone, lb-phone or cylex_phone.

The FX Phone adapter (client/phones/fxphone.lua) calls exports['fx-phone']:AddCustomApp with identifier = Config.AppId (default fx-arcade), name = Config.AppName, defaultApp = Config.DefaultApp, ui and icon. It sends messages to the page with SendCustomAppMessage, reports text-field focus with SetInputFocus, and removes the app with RemoveCustomApp. The app is added again once when the phone loads.

To keep the app from starting at all, set ['fx-casinoapps'] = false in Config.BundledApps. See Apps.

#Config highlights

config.lua (shared):

Setting Meaning
Phone auto, fx-phone, lb-phone or cylex_phone
AppId, AppName, DefaultApp App id, name under the icon, and whether it is installed on every phone
CylexSafeArea Space kept clear at the top and bottom on Cylex Phone
LiveMedia Casino Live voice and volume. Leave FaceCam and FaceVideo off

config_server.lua (server only):

Setting Meaning
SandboxEnabled Local demo wallets and simulated banks
ProductionEnabled Real wallets; enable only after your own deployment checks
SharingEnabled Nearby read-only screen sharing
Storage Driver (auto, mysql, json), the connection convar name, and DataDir
AutoSignIn A character that signed in is signed in again on its next connection
Framework, FrameworkAdmins Framework choice and staff groups that count as admin
Burst, RequestsPerSecond Request rate limits per player
SandboxBankBalance Simulated bank balance per character in sandbox
TokensPerMoney How many tokens one unit of server money buys. Changing it changes the money value of tokens players already hold
WithdrawalTax Tax on wallet-to-bank transfers. Deposits are not taxed; the tax is paid to nobody
FunMode Enabled, Forced, StartBalance, RefillBalance, AutoRefillBelow
Support Account support (cashback) rates and caps
Fivemanage Clip audio for Casino Live: an on/off switch and the upload token setting. The token can also come from a server convar; never set it with setr
Relay Optional HTTPS relay for nearby screen sharing. If it cannot be reached, sharing continues over game events
Banking Enabled turns on real framework bank calls; TimeoutMs is how long a bank call may take. An uncertain result freezes the funds and is not retried automatically

Game availability and stakes are in config/games.json (activeGames, defaultStakes, gameStakes). A ladder saved on the admin page overrides the file for that game. An invalid value in these settings stops the server from starting the resource rather than running with a wrong setting.

#Fun mode

  • Enabled = true, Forced = true: everyone plays with fake tokens only. The real wallet, deposits and withdrawals are off.
  • Enabled = true, Forced = false: players start with real tokens and can switch to a separate fake wallet and back.
  • Enabled = false: no fun mode.

The two wallets and their histories are kept apart. Fake tokens cannot reach the bank, do not earn support or Prestige, and do not appear in the real admin reports; they have their own section there.

#Going live with real money

Before turning on Banking.Enabled, test on your own server: phone focus, opening and closing, character switch, the same account on two devices, and a resource restart. Then set FunMode.Forced = false (or Enabled = false).

#Commands

Command What it does
/fxcasino-stopwatch Stops watching a shared screen

#Exports

The resource has no exports.