VisionExclusive

Complete FiveM server release. Built around the vRP framework, targets game build 2372 on OneSync Infinity, backed by a MariaDB / MySQL database named vision. Originally shipped as a paid Italian Semi-RP / PvP server ("Vision Exclusive"), later published as source.

Stack:

• Server: FXServer (FXServer.exe) launched from start.cmd.
• Framework: vRP (custom fork under resources/[vrp]).
• Database access: oxmysql + legacy mysql-async (both present, for compatibility with older scripts).
• Voice: pma-voice.
• UI: NUI (Vue.js / React under individual scripts).
• Locale: it-IT (Italian). Strings across the scripts and DB are Italian; the codebase reads cleanly if you already know vRP.

Repository Layout

VisionExclusive/
├── README.md
├── server.cfg                    # FXServer configuration (endpoints, ensures, sv_* vars)
├── start.cmd                     # Launcher: FXServer.exe with OneSync + build flags
├── db.sql                        # Full MariaDB schema dump (database: vision)
├── logo.png
└── resources/
    ├── [sistema]/                # Platform-level pieces
    │   ├── api_oxmysql
    │   ├── chat
    │   ├── fivem                 # Base FiveM manifest / helpers
    │   ├── mysql-async           # Legacy DB driver
    │   ├── nui_blocker
    │   ├── oxmysql               # Modern DB driver
    │   ├── pma-voice             # Voice chat
    │   ├── sessionmanager
    │   └── spawnmanager
    ├── [vrp]/                    # vRP framework + core modules
    │   ├── vrp                   # framework core
    │   ├── vrp_admin
    │   ├── vrp_barbershop
    │   ├── vrp_chest
    │   ├── vrp_codes
    │   ├── vrp_homes
    │   ├── vrp_hoverfy
    │   ├── vrp_hud
    │   ├── vrp_identity
    │   ├── vrp_inventory
    │   ├── vrp_lscustoms
    │   ├── vrp_notify
    │   ├── vrp_notifyitens
    │   ├── vrp_notifypush
    │   ├── vrp_player
    │   ├── vrp_polizia           # Police
    │   ├── vrp_progressbar
    │   ├── vrp_skinshop
    │   ├── vrp_sounds
    │   ├── vrp_tattoos
    │   └── vrp_trunkchest
    ├── [scripts]/                # Gameplay scripts
    │   ├── adminmode
    │   ├── airdrop
    │   ├── arsenal
    │   ├── bank
    │   ├── clean-cars
    │   ├── dealership
    │   ├── dnotify
    │   ├── garage
    │   ├── hospital
    │   ├── hub
    │   ├── ilegalroute
    │   ├── jump
    │   ├── login
    │   ├── marketplace
    │   ├── personaggio
    │   ├── radio
    │   ├── ranking
    │   ├── smartphone
    │   ├── store
    │   ├── trade
    │   ├── vision_puliziadenaro  # Money laundering
    │   └── visionexclusive       # Server-specific glue
    └── [resources]/              # Extra content
        ├── deku_works
        ├── vision_craftarmi      # Weapon crafting
        ├── vision_rapine         # Robberies
        ├── vision_selldrugs      # Drug selling
        └── vrp_macchine          # Vehicles / cars pack

Requirements

• Windows host (the launcher is start.cmd; adapt to a shell script for Linux).
• FXServer (cfx-server-data): place the artifact under a files/ folder next to start.cmd so the launcher hits .\files\FXServer.exe. Any FXServer build that supports sv_enforceGameBuild 2372 works. A recent artifact is fine.
• MariaDB 10.4+ or MySQL 8+ reachable on 127.0.0.1:3306.
• HeidiSQL (or any MySQL client) for importing db.sql.
• Client build lock: 2372 (Los Santos Tuners). Players will be forced onto that build on join.

Setup

1. Clone or extract the repo into your FiveM server root, so server.cfg, start.cmd, and resources/ sit at the top level.

2. FXServer artifact: create a files/ directory next to start.cmd and drop the FXServer artifact into it (FXServer.exe and its DLLs). The launcher expects .\files\FXServer.exe.

3. Database: create the schema from the SQL dump.

   mysql -u root -p < db.sql

   or open db.sql in HeidiSQL and run it. The dump creates the vision database and all tables (battlepass, characters, inventories, etc.).

4. Connection string: server.cfg already sets

   set mysql_connection_string "mysql://root:@127.0.0.1/vision?debug=false&charset=utf8mb4&multipleStatements=true&connectTimeout=90000"
   

   Edit the user, password, host, and database name to match your environment.

5. License key: get a sv_licenseKey from https://keymaster.fivem.net and drop it into server.cfg:

   sv_licenseKey "YOUR_KEY"
   

6. Steam Web API key (optional, needed if any script pulls Steam identifiers or avatars):

   set steam_webApiKey "YOUR_STEAM_WEB_API_KEY"
   

7. Hostname and branding: change sv_hostname and the sets Discord line to your own. Current defaults still point at the original operator.

8. Firewall: allow inbound TCP + UDP on 30120 (see the endpoint_add_* lines in server.cfg).

Running

Double-click start.cmd, or from a shell:

start.cmd

The launcher invokes:

FXServer.exe +set onesync_enableInfinity 1 +set onesync_enableBeyond 1 +set onesync_forceMigration 1 ^
             +set onesync_population false +set onesync_distanceCullVehicles 1 ^
             +set onesync_radiusFrequency 1 +set sv_enforceGameBuild 2372 ^
             +set sv_shutdown_cancel 1 +exec server.cfg

Watch the console output for MySQL connection failures and missing resource errors on first start.

Server Configuration Highlights

Key lines already present in server.cfg:

Setting	Value
sv_hostname	`Vision Exclusive
sv_maxclients	64
sv_endpointprivacy	true
set onesync	on (Infinity + Beyond enabled from start.cmd)
sets locale	it-IT
mysql_slow_query_warning	500 ms
voice_useNativeAudio	true (2D/3D disabled, sending-range only)
endpoint_add_tcp/udp	0.0.0.0:30120 (public) + 127.0.0.1:30120 (loopback)

Resources are pulled in with folder-wildcard style:

ensure [sistema]
ensure [vrp]
ensure [resources]
ensure [scripts]

The bracketed folder names are FiveM resource collections. Everything inside starts in the order the server discovers it. If you need to force load order, split an item out into its own ensure line.

What's Included Gameplay-Wise

Modules already wired up:

• vRP core: identity, inventory, homes, chests, HUD, notifications, skin/tattoo shops, LS Customs, barbershop.
• Police: vrp_polizia, adminmode.
• Economy: bank, dealership, marketplace, store, trade, ranking, arsenal.
• Illegal content: airdrop, ilegalroute, vision_rapine (robberies), vision_selldrugs, vision_craftarmi (weapon crafting), vision_puliziadenaro (money laundering).
• QoL: garage, hospital, radio, smartphone, hub (server hub UI), login, personaggio, jump, clean-cars, dnotify.
• Player progression: battlepass and battlepass_missions tables in db.sql.

Every gameplay module has its own fxmanifest.lua (or __resource.lua) inside its folder. Read those to see per-resource dependencies and exports before enabling or ripping one out.

Customization

• Locale / language: strings are Italian and hardcoded per resource. Grep the resource for notify, chat, TriggerClientEvent messages, and translate in place.
• Framework: this is vRP, not ESX or QBCore. Scripts talk to vRP via Proxy / Tunnel. Do not paste ESX scripts in without an adapter.
• Database schema: db.sql is authoritative. Any script that expects a new column needs a matching ALTER TABLE.
• Client build: sv_enforceGameBuild 2372. Bump only if your modded assets (vrp_macchine, custom MLOs) are compatible with the target build.
• OneSync: Infinity + Beyond are forced from start.cmd. onesync_population is off (server owns AI population). Turn on if your scripts assume client-side peds.

Troubleshooting

Symptom	Fix
Couldn't find resource [sistema]	Repo not extracted into the FXServer root. resources/[sistema] must sit next to server.cfg.
MySQL connection refused	Wrong host, port, user, or password in mysql_connection_string. Check the DB is actually up.
Server starts but hangs before Sync is enabled	License key missing or invalid. Re-issue on keymaster.fivem.net.
Client kicked with build mismatch	Client on a newer build than 2372. Either update sv_enforceGameBuild or have the player switch.
oxmysql and mysql-async fighting over the same DB	Pick one per script. Legacy scripts using mysql-async stay on it; new ones on oxmysql.
Voice broken	pma-voice did not start. Check ensure [sistema] and confirm the resource loaded before your maps.

Notes and Limits

• Not maintained upstream. Anti-cheat is not shipped. Add your own (FiveGuard, Shine, Anticheat V, custom) before opening to the public.
• Some resources are Italian-only; expect to translate strings for a non-IT community.
• No license file. Assume it was intended as a public release, but until the owner adds a LICENSE treat it as all rights reserved.
• The DB dump is a HeidiSQL export in Portuguese comments (Copiando estrutura ...). Cosmetic only, no runtime effect.
• Do not commit sv_licenseKey, steam_webApiKey, or a real MySQL password back to a public repo.