Patch Notes for sk-burglary

Latest patch notes for both escrow and full source versions.

Update 3.3.5 - Latest

Item Name Compatibility

  • When ox_inventory is enabled, the script now auto-converts item names during prop pickups.
  • Added a mapping table to config.lua → Config.ReplaceQbItemNames to handle item name translations.
  • Added all items used in the T4 interior – you will now receive the correct item when using ox_inventory.

Job Menu Improvements

  • Added an option to config.lua → Config.ShowAllJobTiers to enable or disable showing all job tiers in the job menu.
  • Job menu items are now disabled if the required level is not met and the blank menu item has been fixed. If Config.ShowAllJobTiers is disabled it will just add the unlocked tier to the job menu when the required level is met.

Security Minigames

  • Added Var and Thermite minigames from ps-ui. These can now be used in SecurityMinigame tables for both interior and exterior security panels.
  • Fixed an issue where the security panel phone hacking scene would replay and cause the player to get stuck in the hack loop after certain minigames (circle/mhacking).

General Fixes & Adjustments

  • Prevented ox_target warnings for setup peds and prop pickups.
  • Coffee in T3 now actually looks like coffee ☕
  • Adjusted two models in T3 interiors that were previously inaccessible with ox_target.
  • Rearranged T3 safe contents to improve targeting and interaction.
  • Replaced the cash stack inside safes with a better model for ox_target functionality.
  • Removed firearms from T2.
  • T1 Motel: Actually fixed the interior exit for ox_target, correctly adjusting ipl_coords.
  • T3 High-End Interior: Adjusted extra main door coordinates to prevent door glitching.

Interior & Loot Changes

  • T4 Interior:
    • Replaced 4 weapon models with ox_target compatible ones.
    • Added 7 new lootable items.
    • Added 2 brand-new items to loot.
  • T3 Interiors:
    • Replaced 4 weapon models with ox_target compatible ones.
    • Added 1 new weapon to loot.
  • Seasonal Cleanup:
    • Removed Xmas tree from T3 Franklin’s interior.
    • Removed milk & cookies from the T4 interior.

Group Password & Menu

  • You can now create/join groups with a password (only using sk-menu).
  • Revamped sk-menu UI – added an option to include a textbox in menu items.

Update 3.3.4

General Fixes & Improvements

  • Auto Resource Detection: Added Config.AutoResourceSetup to automatically detect and enable required resources. Minigames are now detected based on availability.
  • Exterior Entities Handling: Introduced the exteriorEntities table to manage all exterior objects and peds, replacing interiorEntities and guardEntities for outside entities. Also refactored T4 security panel and guard handling.
  • Guard Behavior Fixes:
    • Guards will no longer use vehicles to reach a target.
    • Fixed guards not returning to patrolling or standing when they lose their target.
    • Temporarily replaced knife/melee guards with shotguns.

Carry Object Improvements

  • Moved the carry objects table from carry.lua to config.lua.
  • Fixed an issue where props would not consistently appear when using ox_inventory, only showing when the carry prop was used.
  • A new thread now checks the player’s inventory for the carry item when using ox_inventory.

Sell Menu Fixes & Buyer Categories

  • Fixed the sell menu not refreshing when all items expired or ran out.
  • Split buyers into Tech, Collectibles, and Misc categories, each with a unique ped. A random ped is chosen from each category on onServerResourceStart.
  • Added all burglary items to Config.BuyersList and included additional comments for configuring the buyer system. Adjust rarity, price, and other settings as needed.

Targeting & Interaction Fixes

  • T4 Security Keypad Targeting: Fixed an issue where targeting the T4 door security keypad with ox_inventory was broken due to incorrect item metadata handling.

Miscellaneous Updates

  • Sell Menu Item Images: Updated the sk-menu repository to include images for all burglary items in the sell menu.
  • Required Cop Count Handling: Now defined in tiered house configs when Config.LevelScaling = false.
  • Alarm Sound Update:
    • Updated the link for the alarm sound MP3.
    • Planning to replace it with YT and add a fallback option (likely a GTA soundtrack) in the next update.
  • Bug Fixes & Typo Corrections:
    • Fixed a typo in the item image for 'figure2' in both item.lua lists.

Update 3.3.3

General Fixes & Improvements

  • Blacksreen Loop: Fixed blackscreen loop when entering an interior caused by missing object or ped models. Added IsModelValid() and IsModelInCdimage() checks to prevent blackscreen loops by skipping invalid models and printing a message with the model name if Config.PrintStuff is enabled.
  • ox_target Security Zone: Adjusted ox_target box zone size/pos for security keypad props.
  • ox_target T1 Exit Zone: Fixed ox_target exit interior box zone for the T1 motel, broken in update 3.3.2 due to adjustments to ipl_coords.

Update 3.3.2

General Fixes & Improvements

  • sk-menu group/member menu: Fixed an issue where creating or joining a group using sk-menu would not display the group in the menu when ox_lib was enabled. This was caused by group data being set for the ox_lib menu instead of sk-menu, as the addGroupToMenu and addMemberToMenu functions prioritized ox_lib in client\menu.lua.
  • Create main interior door: Added an additional main door for the motel T1 interior and both T3 interiors using the extra_props table in the interior config. This ensures there’s no escape from the interior when the default interior door object is missing or fails to be retrieved, moved, or frozen. No more T1 motel void!
  • Adjusted Config.BuyersList: Since ox_inventory does not include the markedbills item by default, which the dirty_cash = true setting in the Config.BuyersList relies on, dirty_cash has been set to false by default. If you want to use this feature, simply update the dirty_item_name to match the name of your dirty cash item in your ox_inventory item list and set dirty_cash to true.
  • Added Ammo Crate and as useable item in server\items.lua
  • Removed Christmas trees from T2/T3

Update 3.3.1

General Fixes & Improvements

  • ox_target Spam: Attempted to fix the spam issue when trying to remove zones.
  • Debugging Disabled: Disabled some debugging elements for cleaner logs.
  • Entity Spawn Logging: Added print statements when attempting to spawn entities (Config.PrintStuff), helping identify missing models, typically due to different game versions.
  • Error Handling:
    • Print error message if minigame/menu resources are missing.
    • Fixed ox_target security error.
    • Fixed ox_lib menu error when accessing the fence menu.
    • Fixed sk-menu nil error if not present on the server.
  • Group Change Reverted: Reverted a group change to resolve group display issues.
  • Guard Spawning: Slowed down guard spawning to reduce MS load.

Documentation

  • Minigame Setup: Updated documentation for setting up or changing minigames Visit Minigame Documentation.
  • README.md: Updated for clarity.
  • Ox Items List: Updated to work with 3.3 ox_items.lua.

Compatability

  • QBox: Fully tested and working with QBox txAdminRecipe.
    • Ensure ox_lib, ox_target, and ox_inventory are enabled (true) in main config.lua.
    • Set qbx:enableBridge "true" in your QBox server config to enable the QB-Core bridge for qbx_core (this should be true by default).

Update 3.3 - Our biggest yet!

New Tier 4 Heist: Weapons Cache Robbery

  • Players can now undertake a Tier 4 heist to rob a weapons cache, with rewards including weapons, attachments, materials, and more.
  • Key Features:
    • Meet the boss’s contact to get job details, tools, and the location of the heist.
    • Interact with guards, avoid CCTV detection, and crack the security keypad.
    • Introduced the securitycard, used alongside the securityphone to bypass keypads.
      • The securitycard has a unique ID that must match the assigned security panel.
      • Obtain the securitycard and location details from the setup ped.
    • CCTV detection triggers a lockdown:
      • A boss guard may spawn during the lockdown.
      • Keypad access is temporarily disabled until the lockdown is resolved.
      • Disable the lockdown by locating and smashing the correct power box using the heistaxe.
      • CCTV cameras can be disabled by shooting them. If a silencer is not used, a lockdown will be triggered.

Reworked Reputation System

  • XP required per level is now configurable via Config.XPPerLevel in config.lua.
  • Starting reputation is now set to 0 (previously 10,000).
  • Revised reputation rewards based on actions and tiers:
    • AddRepForReason in func.lua is now called from main.lua for actions like breaking in or bypassing security.
    • Rewards can be configured in the repRewards table and AddRepForReason function in funcs.lua.

Outdoor Security Features

  • Added guards, keypads, alarms, powerbox and CCTV for enhanced security.
  • Initially implemented for Tier 4 but fully adaptable for other tiers.

New Menu

  • Added compatibility with sk-menu.

New Selling Mechanic

  • Added a fence menu for selling items.
    • Items are randomly selected from the Config.BuyersList table in config.lua at resource start.
    • Prices vary based on supply, demand, and rarity.
    • Items expire after a set time or when a specified quantity is sold.
  • Optimized for sk-menu with auto-refreshing functionality.

SetupInterior Function Refactor

  • Improved reliability by running spawning functions sequentially within a single thread.
  • Reduces blackscreen loading time and ensures safe props are created before pickup props.

Interior Overhaul

  • Over 250+ new objects added across interiors, including 35 unique items for more immersive environments.

Miscellaneous Improvements and Fixes

  • Smoother animation and scene entry when interacting with a security keypad; the player ped now correctly moves towards and faces the security panel.
  • Enhanced processes for selling items and receiving marked money.
  • Disabled collision and damage for the keypad prop (ch_prop_fingerprint_scanner_01d).
  • Improved carry code and handling for multiple items in player inventory.
  • Added group status checks to prevent joining or leaving while busy.
  • Prevented nil errors from group functions.
  • Added a Cayo Perico elevator hacking scene for Tier 4 security.
  • Adjusted player ped’s vertical offset during the USB hacking scene to prevent elevation issues.
  • Cleaned up and organized functions in client/main.lua:
    • Improved comments and organized house and player data variables.
  • Ensured carriable items are accounted for when sold to the fence.
  • Utilized AsNoLongerNeeded natives to significantly reduce streaming memory usage.
  • Added qb-inventory to the DefaultResources table for better export handling.
  • Moved queue and job times to tiered [houses] configurations, allowing different times per tier.
  • Improved the transition from closed to open safes for the client by using a networked safe opening scene.
  • Tier 4 interior peds now have a chance to drop their current weapon when looted.
  • Improved item descriptions and updated prompts/translations.
  • Players now receive mail if no job is available.
  • Addressed potential issues with interior loading when skipping pickup props requiring a safe:
    • The spawnPickupProps function now exits efficiently if no safe is present, skipping to the next pickup.
    • Added the DoesAnySafeExist function and improved checks using the interiorEntities table.
  • Updated target handling to use ox_target's addBoxZone export directly, if available, instead of qb-target.
  • Updated inventory handling to use ox_inventory's addItem export directly, if available, instead of qb-inventory.
  • Resolved an issue where the “Sneaky Beaky” task could complete after canceling a job without performing any actions.
  • Fixed an issue where carry props were not being removed properly when using the updated qb-inventory.