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 = trueandBanking.Enabled = false: wallets are local and banks are simulated. No framework bank call is made. - Real banking. Only when you set
Banking.Enabled = truedoes the app move money between the wallet and the framework bank, atTokensPerMoneytokens 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 = falseturns it off. - Casino Live. A streamer's voice is carried to viewers through pma-voice (
Config.LiveMedia.Voice). The camera options inConfig.LiveMediaare 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 inServerConfig.FrameworkAdminsalso count; set it tofalseto use only the ACE. - Account data is kept outside the resource folder, in
fx-casinoapps-datanext toserver.cfg(orStorage.DataDir), so replacing the resource does not remove accounts. Do not expose that folder through a web server or add it to afileslist. - 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.