Skip to content

Installation

1. Dependencies

Make sure these are installed:

  • vns-core - separate free download from your Keymaster/cfx Portal. It is not included in the Base Building zip.
  • ox_lib
  • oxmysql
  • Your framework: qb-core, qbx_core or es_extended
  • Your inventory (see Items Setup)
  • Your target system: ox_target, qb-target or qtarget

vns-core detects your framework, inventory, target and notification system by itself. Base Building has no framework settings of its own.

2. Resources

Place these folders in your resources directory. Do not rename them.

Resource Who needs it
vns-core Everyone (skip if you already have it from another VNS script, keep one copy)
vns-basebuildingprops-lite Lite only - building, furniture, turret and electricity models
vns-basebuildingprops-pro Pro only - includes every model (Lite and Pro). Don't install the Lite props next to it
vns-basebuilding-lite or vns-basebuilding-pro The script itself - Lite buyers get vns-basebuilding-lite, Pro buyers get vns-basebuilding-pro. Install only the one you bought

3. server.cfg

Add the resources in this order, and add the dynamic door setting:

ensure ox_lib
ensure oxmysql
ensure qb-core          # your framework (or qbx_core / es_extended)
ensure ox_inventory     # your inventory
ensure ox_target        # your target system
# ...and everything else: housing, garages, phone, fuel, clothing, jobs

ensure vns-core

ensure vns-basebuildingprops-lite  # or vns-basebuildingprops-pro on Pro
ensure vns-basebuilding-lite       # or vns-basebuilding-pro

setr game_enableDynamicDoorCreation "true"
sv_enforceGameBuild 3407

Ensure order

  • vns-core must be ensured after ox_lib, oxmysql (database), your framework, inventory, target system and your other server scripts such as housing, garages and phone.
  • The props and vns-basebuilding-lite / vns-basebuilding-pro must be ensured after vns-core.

If vns-core starts too early, the database, items, storages, money or targeting won't work. See Installing vns-core.

Warning

Without setr game_enableDynamicDoorCreation "true" placed doors will not appear.

Game build 3407 or newer

Some props use models from newer GTA DLCs, so your server needs sv_enforceGameBuild 3407 (Agents of Sabotage) or a higher build:

Prop Model Needs build
Base Control m24_2_prop_m42_sec_console_01a 3407
Small Storage Box m23_1_prop_m31_woodencrate_01a 2944
Ceiling light xm_prop_x17_sub_lampa_small_white 2189

On an older build those models never load, so nothing happens when a player tries to place them and there is no error in the console. If you have to stay on an older build, set a model you do have in config/props.lua, for example prop_toolchest_05 for the Base Control.

4. Database

Nothing to import. On first start the script creates its vns_basebuilding table by itself. On every start it also checks the table and adds any missing columns.

5. Items

Add the items to your inventory. Copy-paste blocks per inventory are on the Inventory Item Definitions page, and item names are explained in Items Setup.

6. Admin command (optional)

The admin command is restricted and needs an ace permission:

add_ace group.admin command.devbuilding allow
Command What it does
/devbuilding Opens the dev/admin building panel

7. First start

  1. Start the server and check the console. There should be no red [vns-core] warnings.
  2. Press G (default) to open the radial build menu and place a Base Control. This claims the base territory.
  3. Start building from the same menu.

Escrow note

The encrypted version keeps every file in config/ (including config/language.lua), client/open_client.lua and server/open_server.lua editable. All balancing, items, recipes, props and texts live there. The open version is fully editable.

Updating from the previous version

  • Pro servers use one props pack. vns-basebuildingprops-pro now includes every model. Remove vns-basebuildingprops-lite and its ensure line when you run Pro.
  • vns-core is now required. Download it separately from your portal and start it before the props and the script (see step 3).
  • The resource was renamed. vns-basebuilding is now vns-basebuilding-lite (Lite) or vns-basebuilding-pro (Pro). Remove the old vns-basebuilding folder, place the new one, and change the ensure line in server.cfg. Your database and bases are not affected by the rename.
  • Framework settings are gone from Base Building. Config.Framework, Config.FrameworkFolder, Config.Inventory, Config.Notification, Config.TargetSystem and Config.InventoryImagePath were removed from config/general.lua. Delete them from your old config if you copy values over. If you need to force a system, set it in vns-core/config.lua.
  • Item icons in "inventory" mode now use vns-core's Config.ItemImagePath. Config.ItemIcons = "custom" still uses the resource's own html/icons/others folder.
  • The QBox manifest step is gone. There is no @qbx_core/modules/playerdata.lua line to uncomment anymore, QBox works out of the box.
  • Database: replace the files and start the server. Missing columns are added and old prop data (renamed prop types, changed models) is converted automatically the first time your existing bases load. Bases, members and storages are kept.
  • If you use the encrypted version and edited client/open_client.lua or server/open_server.lua, redo your changes on the new files. They now call vns-core instead of framework code.