Installation

Installation

Welcome to the NANO Scripts House Robbery System installation guide! This guide will walk you through the complete installation process to ensure a smooth and problem-free setup. By carefully following each step and completing the documentation, you'll achieve a clean and seamless installation.

In case of the use of FileZilla, we're requesting using WinSCP instead for compatibility issues. WinSCP offers greater stability and better integration with our work environment, ensuring a more efficient handling of assets and minimizing issues related to file transfers. We appreciate your cooperation in ensuring a better experience for everyone.

Asset Download

To find the asset, you must have made the purchase using your own keymaster account. Otherwise, you can use the transfer system to move the asset to a different keymaster account.

Once the purchase is made on our official website, you will receive your asset directly in your Keymaster, in your own panel you can download the asset and install it following the following documentation.

If you have more problems regarding FiveM Escrow, accounts or asset startup errors you can go here and see if any of them match your case, since Escrow requires some basic things for its operation, such as your keymaster account, your licensekey, etc.

Prerequisites

Before installing the House Robbery System, ensure you have the following dependencies installed and properly configured:

Required Dependencies

  • QBCore Framework: Latest version of QBCore framework

  • nn_lib: NANO Scripts library resource

  • nn_bridge: NANO Scripts bridge resource for framework integration

  • T3 Lockpick (or alternative): Lockpicking system for house entry

  • SQL Database: MySQL/MariaDB database for persistent data

Optional Dependencies

  • ox_lib: Alternative library system

Installation Steps

Step 1: Install Dependencies

  • Make sure to install/update nn_lib & nn_bridge

nn_bridge

  • Please follow the nn_bridge installation guide. If you have already done this before for one of our previous scripts, then skip this step.

nn_bridge Installation:

  1. Download nn_bridge from your Keymaster account

  2. Extract the files to your resources folder

  3. Add ensure nn_bridge to your server.cfg

  4. Configure the bridge settings in config.lua

  5. Restart your server

Step 2: Install House Robbery System

  1. Download the Resource

    • Download nn_houserob from your Keymaster account

    • Extract the files to your resources folder: resources/nn_houserob/

  2. File Structure Verification Ensure your file structure looks like this:

    resources/nn_houserob/
├── client/
│   ├── blackmarket.lua
│   ├── client.lua
│   ├── paintings.lua
│   ├── rob.lua
│   ├── safes.lua
│   ├── tablet.lua
│   ├── toolshop.lua
│   └── utils.lua
├── server/
│   ├── rob.lua
│   ├── server.lua
│   ├── tablet.lua
│   └── toolshop.lua
├── web/
│   ├── assets/
│   ├── game.css
│   ├── game.js
│   ├── index.html
│   ├── script.js
│   └── style.css
├── items/
├── files/
├── config.lua
├── fxmanifest.lua
└── README.md

Step 3: Database Setup

  1. Import SQL Files

    • Open your database management tool (phpMyAdmin, HeidiSQL, etc.)

    • Import the provided SQL file: files/crews.json (if applicable)

    • Ensure all tables are created successfully

  2. Database Configuration

    • Verify your database connection settings in your framework configuration

    • Ensure the database user has proper permissions

Step 4: Configuration

  1. Open Configuration File

    • Navigate to resources/nn_houserob/config.lua

    • Open the file in your preferred text editor

  2. Basic Configuration

    -- Framework Configuration
Config.Framework = "QBCore" -- Your framework (QBCore, ESX, etc.)

-- Police Configuration
Config.MinPolice = 2 -- Minimum police required online
Config.PoliceJob = "police" -- Police job name

-- Cooldown Settings
Config.Cooldown = 900000 -- 15 minutes global cooldown
Config.MissionCooldown = 30000 -- 30 seconds between missions

  3. Item Configuration

    • Configure required items for lockpicking and hacking

    • Set up black market items and their prices

    • Configure tools shop items

  4. House Configuration

    • Set up house interiors and their coordinates

    • Configure robbery locations and rewards

    • Set up safe locations and contents

Step 5: Resource Integration

  1. Add to Server Config

    • Open your server.cfg file

    • Add the following line:

    ensure nn_houserob

  2. Framework Integration

    • Ensure your framework is properly configured

    • Verify that nn_bridge is working correctly

    • Test the connection between resources

Step 6: Dependencies Configuration

  1. Lockpick System

    • Configure your preferred lockpick system in config.lua:

    Config.LockpickSystem = "t3_lockpick" -- or "qb-lock", "qb-keyminigame", "custom"

    • Ensure the lockpick resource is started before nn_houserob

  2. Target System (Optional)

    • If using qb-target, ensure it's properly configured

    • Set up target zones for house entrances

  3. Progress Bar System (Optional)

    • Configure progress bar system (ps-ui, ox_lib, etc.)

    • Set up animations and timing

Next Steps

After successful installation:

  1. Read the Configuration Documentation: Review CONFIG_DOCUMENTATION.md for detailed configuration options

  2. Customize the System: Modify settings to match your server's needs

  3. Test Thoroughly: Run comprehensive tests with multiple players

  4. Monitor Performance: Keep an eye on resource usage and database performance

  5. Community Feedback: Gather feedback from your player community

Support

If you need more support regarding the script, please reach out via our Discord.

Previousnn_houserobberyNextConfiguration

Last updated