Skip to content

Open Source & Encrypted Versions

Almost every VNS script is sold in two variants. This page explains the difference and exactly what you can edit in each one.

The two variants

  • Open: the complete script, fully readable. Edit anything.
  • Encrypted: the core logic is protected through Cfx.re escrow and runs only on your licensed server. Everything you might reasonably need to change stays as plain, editable files.

Both variants behave identically in game. Updates are released for both at the same time.

What stays open in the encrypted version

Part What you can change there
config.lua (or the config/ folder) Every gameplay setting: items, prices, positions, limits, permissions, feature toggles.
Locale / language files Every text a player sees. Translate or reword freely.
Open bridge files How the script talks to your server and hooks for your own code.

The protected files contain only the internal logic, such as placement math, UI handling and server validation. Nothing framework- or inventory-specific is hidden in there.

The open bridge files

The open bridge files are the customization point of every encrypted script. They are ordinary Lua files where the script:

  • reads the player's identity and job,
  • gives, takes and checks items and money,
  • opens stashes, sends notifications and registers target options,
  • and exposes hooks: functions the protected code calls at the right moments (for example CanUserPlaceObject in Base Building), left for you to fill in.

If you want a script to behave differently towards your server (extra permission checks, a different notification, integration with another resource), this is where you do it, with full code access.

vns-core

All framework, inventory and target compatibility lives in vns-core, a separate, free download in your Keymaster/cfx Portal. It is not part of any script's zip, it updates independently, and it is always fully open source, no matter which variant of a script you buy.

Because of that, the open bridge files are short: they call vns-core's functions (VNS.AddItem, VNS.Notify, and so on), and vns-core translates them for your framework and inventory. Adding support for a custom framework or inventory in vns-core fixes every VNS script at once. See Custom frameworks & inventories.

Note

Escrow protection is enforced by FiveM itself (Keymaster), not by obfuscation. The encrypted variant runs only on the server linked to your purchase.