Advanced Banking System with Hacking Provide

LGF_Banking

Provide Functions:

• Manage Robbery Bank
• CoolDown Robbery
• NPC Robbery System (duplicate card)
• 3D Printer with Prop (by Mrs. BzZz)
• Place Printer with Raycast
• Battery System for Printer
• Shop for Tools
• Support ATMs
• Create Fake Card with metadata
• Hacking Time for Robbery
• Hack Pin missed
• Dispatch Internal
• Dispatch Custom
• Support Multi-Core
• Support Multi-Notification
• Progress Bar Type
• Skillcheck type
• Admin Pannel Printer (Delete / Teleport / Recharge)
• Society Funds Management (Boss Exclusive)

Configuratiom (Convars)

To configure LGF_Banking, follow these steps:

Open your server.cfg file: This file is usually located in your server's root directory.

Add the following lines to your server.cfg file: These settings allow you to set the language and enable debug mode for troubleshooting purposes.

## Convars LGF Banking
setr LGF_Banking:Traduction en ## locales check locales 
setr LGF_Banking:Getdebug true ## enable or disable Debug
setr LGF_Banking:RunSqlTable false ## Run and create SQL table for banking
setr LGF_Banking:EnableRobberyNpc true ##Enable Stealing NPC and remove Sell Stealing Card
setr LGF_Banking:MetadataNPC en ## Language Metadata for Stealed Card -- it , en 
setr LGF_Banking:EnablePrinterMenuCommand true ## Enable o Disable command for printer menu
setr LGF_Banking:PrinterMenuCommand "printer" ## Command for open Printer Menu
setr LGF_Banking:EnableAllAtmBlips true ## Enable or Disable all Atm's Blips
setr LGF_Banking:EnableOxHooksCheck false ## If true, the item cannot be moved from the player's inventory to any stash, etc. (prevent bugs and crafty people)
setr LGF_Banking:ReturnTypeSerial 1 ## Serial type to generate: 1) generic (letters and numbers), 2) Return letters only, 3) Return numbers only

• Save the file: After making the changes, save and close the server.cfg file.

• Restart your server: For the changes to take effect, you need to restart your game server.

Dependency

• OX INVENTORY
• OX TARGET
• OX LIB

Screenshots

LGF_Banking is a comprehensive banking system designed for game servers, offering secure PIN management, customizable credit card creation, and seamless integration with popular frameworks like LGF, ESX, and QB. Enhance your server's financial interactions with real-time updates and advanced features tailored for an immersive player experience.

Framework Support

• LGF_CORE
• ESX
• QB (work in progress)

Support Resources

Skill Check Support

• Choose between OX Lib and BL UI for skill checks and configure multiple presets with various difficulty levels:

• OX Lib: Implement skill checks efficiently using OX Lib robust functionality. Customize presets for different difficulty levels, including easy, normal, hard, and insane.

• Integrate BL UI seamlessly into your server's user interface for enhanced functionality. Configure presets specifically for Circle Progress and Progress skill checks. Adjust difficulty levels to tailor the experience to your players' needs.

Framework/Core Configuration

Features

Hacking Features

• PIN Restoration: Allows restoring the PIN if forgotten
• Create Fake Card: Create fake cards to find yourself in pure RP situations, manage every metadata value
• TIME heist Restoration: Optimize time and hack time restore for heists removing cooldown with hack tool
• Crafting Tools: Create tools dedicated to robberies and hacking using the 3D printer
• Tools Shop: Support Shop Items in ox to Buy Tool
• Steal NPC: Credit card clone provider

Multi Core Support

• Supports: lgf, esx, qb

Multi Notify System Support

• Supports: lgf, esx, qb, ox

SQL Table Execution and Creation

• Execute and create SQL table: CB.RunSqlTable

Credit Card Configuration

• Credit Card Item:
  • CB.ItemCreditCard
• Credit Card Purchase Price:
  • CB.PriceCreditCard
• Fake Credit Card Item:
  • CB.ItemFakeCreditCard

Progress Bar Type

• Type: CB.TypeProgressBar (circle or label)

ATM Prop Models

• Models: CB.PropAtm

Bank Zones and Configuration

• Zones: CB.BankingZone

SkillCheck

• Difficulty Levels:
  • easy, normal, hard, insane
• SkillCheck Type:
  • CB.SkillCheckType

Enable Camera for Ped

• Enable: CB.EnableCam

---

Fake Credit Card Configuration

• Configuration: CB.FakeCreditCard
• Fake Credit Card Sellers:
  • Position: PedPosSell
  • Model: PedModelSell
  • Scenario: PedScenarioSell
  • Price:
    • Fake Card: PriceFakeCard
    • Hack Pin: PriceHackPin
  • SkillCheck: SkillCheck
  • Customization Options:
    • Choose Name
    • Choose Image
    • Manage Metadata
    • Set Weight

---

Dispatch Configuration

• Configuration: CB.UseDispatchInternal
  • Use Dispatch Internal for Robbery
    • Job: CB.DistPatchJob
      • Choice of MultiJob {'police', 'ambulance'}
    • Duration: DurationBlipDispatch
• Configuration: CB.UseCustomDispatch

  • Get player id, coordinates, job

  • Custom Dispatch:

    • Return playerId, coords, job

    CB.UseCustomDispatch = true
    CB.CustomDistPatch = function(playerId, coords, job)
        print(playerId, coords, job)
    end

---

Robbery Configuration

• Configuration: CB.BankingZone
  • Zone for Starting the Robbery: RobberyZone
  • Item Requested for Robbery: ItemRequestedRobbery
  • Quantity of Item Requested for Robbery: QntItemRequested
  • Robbery Drop Items: RobberyDrop
    • Minimum and Maximum Quantity for Drop Items
      • Example:

       RobberyDrop = {
           ['money'] = { min = 20, max = 50 },
           ['water'] = { min = 4, max = 10 },
       },

  • Skill Check Configuration: SkillCheck
    • Enable or Disable Skill Check: Enable
    • Skill Check Difficulty
    • Skill Check Type
  • Hacking Provide
    • Optimize time and hack time restore for heists removing cooldown with hack tool
    • Make tools to rob or hack with 3d printer tool

---

Printer Configuration

• 3D Printer Configuration: CB.CraftingPrinter
  • Weather System
    • when there is rain the printer will have two more description options with the current weather, and if it rains it cannot be used, and a further option will be shown with a warning,
  • Label
    • (Label in 3D printer menu)
  • itemHash
    • (Hash Items)
  • itemRequested
    • (Item requested for Craft Tool or Weapon)
  • ItemRequestedQnt
    • (Quantity requested for Craft Tool or Weapon)
  • Description
    • (Provide Description in menu)
  • CraftingTime
    • (Crafting Time with Progress Bar)
  • propHash
    • (Hash Prop for Create object in 3D Printer. Prop Object: thttps://gtahash.ru/)
      • Minimum and Maximum Quantity for Craft Tools
  • Battery
    • Recharge the battery via item - Example:

   CB.CraftingPrinter = {
    { Label = 'Weapon Pistol',  itemHash = 'WEAPON_PISTOL',       ItemRequestedPrint = 'water', ItemRequestedQnt = 3, Description = 'A standard issue pistol with moderate damage and accuracy.', CraftingTime = 20, propHash = 'w_pi_pistol' },
    { Label = 'Carabine Rifle', itemHash = 'WEAPON_CARBINERIFLE', ItemRequestedPrint = 'water', ItemRequestedQnt = 5, Description = 'A submachine gun with high fire rate and decent damage.',    CraftingTime = 20, propHash = 'w_ar_carbinerifle' }
}

---

Admin Panel Printer

LGF_Banking includes an Admin Panel Printer feature that allows authorized users to manage 3D printers in real-time. This feature is essential for server administrators to control and maintain the printer entities efficiently.

Key Features:

• Delete Object in Real-Time all sync: Admins can instantly remove a 3D printer object from the game world.

• Delete Object in Real-Time all sync: Admins can restore a 3D printer object, making it functional again in the game world.

  • Admin Panel Printer: convars
    • Printer Data
      • Get data like name, battery, serial code
        • Delete Printer for player (if the object is spawned it will be eliminated wherever it is)
        • Restore Specific Printer

---

NPC Robbery System

LGF_Banking now includes a feature for robbing NPCs, adding a dynamic and interactive element to your server. This allows players to engage in robbery scenarios with NPCs, providing rewards and consequences based on their actions.

Key Features:

• Interactive Progress Bar: A visible progress bar indicates the time required to complete the robbery.
• Distance Checks: Ensures the player stays within a specific distance of the NPC during the robbery.
• NPC Reaction: NPCs will react aggressively if the player gets too close or too far, creating a challenging and immersive experience.

Stealing NPC Configuration

Customize the settings for the NPC robbery system to tailor the experience to your server's needs.

• CardstealItem: Specify the item used for stealing from NPCs.
• TimeStealing: Set the duration, in seconds, for completing the robbery.
• DistanceCancelSteal: Define the distance, in meters, that triggers the cancellation of the robbery if the player moves away.
• DistanceStartAngryorScaried: Determine the proximity, in meters, at which the player can trigger the NPC's aggressive or frightened reaction.
• Price:
  • min: Set the minimum value of the stolen loot.
  • max: Set the maximum value of the stolen loot.

---

Bank Robbery Configuration

LGF_Banking supports customizable bank robberies, enabling players to engage in heists with randomized loot items. You can adjust various aspects of bank robberies, including loot items, hacking challenges, and the dispatch system.

Initiating a Bank Robbery

To initiate a bank robbery, players must interact with a designated object within the bank area. Once the robbery commences, players may encounter hacking challenges or other obstacles that they must overcome to succeed in the heist.

Robbery Loot Items

You have the option to configure the loot items available to players during bank robberies. These items can be randomized to introduce variety and excitement to the robbery experience, offering players a chance to obtain different rewards each time they engage in a heist.

Dispatch System

LGF_Banking provides two alternatives for handling robbery notifications: internal dispatch and custom dispatch.

• Internal Dispatch: Automatically sends robbery notifications to all players, complete with blip and position indicators.

• Custom Dispatch: Grants you the flexibility to customize how robbery notifications are managed, allowing for more control over the notification process. With custom dispatch, you can define specific actions or alerts triggered when a robbery occurs, such as notifying law enforcement or broadcasting messages to nearby players. This option offers a tailored approach to managing robbery events on your game server.

Hacktool Item for Cooldown Deviation

In addition to the standard cooldown mechanism, LGF_Banking allows players to deviate the cooldown using a special hacktool item. When used, this item can bypass or reduce the cooldown period, providing players with more strategic options during bank heists.

---

Society Funds Management (Boss Exclusive)

• Feature: Ability to manage society funds
  • The feature enables the management of society funds, allowing actions such as deposit or withdraw.
• Access: Restricted to boss roles within each framework
  • Restricted to boss roles within each framework, ensuring control and preventing misuse by limiting access to authorized personnel.

---

Items Preconfigured

Register Item in Ox Inventory

---

return {
	['credit_card'] = {
		label = 'Credit Card',
		weight = 40,
		stack = false,
		description = 'A standard credit card used for transactions.'
	},
	['fake_credit_card'] = {
		label = 'Fake Credit Card',
		weight = 40,
		stack = false,
		description = 'A counterfeit credit card, looks real but is fake.'
	},
	['battery_printer'] = {
		label = 'Battery 3D Printer',
		weight = 1000,
		stack = true,
		description = 'A battery for recharger a Printer 3D'
	},
	['tool_hack_cooldown'] = {
		label = 'Cooldown Reduction',
		weight = 1000,
		stack = false,
		degrade = 15,
		decay = true,
		description = 'A tool used to reduce the cooldown of hacking attempts.',
		client = {
			export = 'LGF_Banking.ToolRemoveCoolDown',
		}
	},
	['tool_3dprint'] = {
		label = 'Printer 3D',
		weight = 3000,
		stack = false,
		description = 'A Printer 3D for crafting Tools.',
		client = {
			export = 'LGF_Banking.ToolCraftingItems',
		}
	},
	['tool_3dprint_delprinter'] = {
		label = 'Provider Printer Wipe',
		weight = 3000,
		stack = false,
		description = 'A tool for remove Printer 3D with yur serial.',
	},
	['tool_steal_npcmoney'] = {
		label = 'Provider Steal Money',
		weight = 3000,
		stack = false,
		description = 'A tool for steal money from ped.',
	},
	['stealing_card'] = {
		label = 'Civil Credit Card',
		weight = 20,
		stack = false,
		description = 'A Credit Card Stealed by a civik.',
	},
}

---

• All: exports Server Side Exports:

-- Create Fake Card With Params
exports.LGF_Banking:CreateCreditCard(source, metadata)
-- Change Pin Directly
exports.LGF_Banking:ChangePin(data)

Exports Usage (Server Side)

Create Credit Card

Using the CreateCreditCard exports

The CreateCreditCard exports allows you to create a credit card in the game with customized metadata.

exports.LGF_Banking:CreateCreditCard(source, metadata)

source: The player ID requesting the creation of the credit card. metadata: A table containing custom data for the credit card.

Example Usage

RegisterCommand('getCard', function(source, args)
    local metadata = {
        label = 'My Custom Credit Card',
        description = 'My Custom Credit Card Description',
        type = "Custom Card Type",
        price = 0,
        itemHash = 'burger',
        weight = 10,
        imageUrl = 'nui://ox_inventory/data/images/' .. itemname .. '.png'
    }
    exports.LGF_Banking:CreateCreditCard(source, metadata)
end)

RegisterCommand('getCard2', function(source, args)
    exports.LGF_Banking:CreateCreditCard(source, {
        label = 'My Custom Credit Card',
        description = 'My Custom Credit Card Description',
        type = "Custom Card Type",
        price = 0,
        itemHash = 'burger',
        weight = 10,
        imageUrl = 'nui://ox_inventory/data/images/' .. itemname .. '.png'
    })
end)

• This format should be clearer and more structured for users to understand how to use your script.

Change PIN (Using the ChangePin exports)

The ChangePin exports allows you to change the PIN associated with a player's identifier.

exports.LGF_Banking:ChangePin(data)

data: A table containing the player's identifier and the new PIN.

Example Usage (using LegacyFramework)

RegisterCommand('newpin', function(source)
    local playerData = LGF.SvPlayerFunctions.GetPlayerData(source)[1]
    local IDent = playerData.charName
    exports.LGF_Banking:ChangePin({
        identifier = IDent, -- identifier
        pin = "1998" -- new pin (string or boolean)
    })
end)

• This function allows you to easily update a player's PIN by specifying their identifier and the new PIN.

License GPL 3.0

LGF_Banking Version 1.0

LGF_Banking is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

LGF_Banking is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with LGF_Banking. If not, see https://www.gnu.org/licenses/gpl-3.0.html for the full text of the license.

LGF_Banking is based on open-source code and contributions from the community. It was created by ENT510.

Every contribution is welcome and appreciated.