GTA:SA Burglary System for SA-MP

[0xDizzle]

What's needed?

• [x] The same features like the singleplayer burglar missions.
• [x] About 5-10 empty house interiors that we can map some objects in
• [x] 5-6 items that can be stolen per house, only TVs, boomboxes, game consoles etc like in singleplayer
• [x] About 50 house entrance coordinates across Los Santos
• [x] 5 garages to drop off the stolen goods
• [x] Houses should not be owned by players
• [x] foreach include
• [x] zcmd include

Note: Only 1 player should be able to rob a specific house at a time, so we'll need something like HouseBeingRobbed[houseid] to exclude such from the loop when assigning a house when players start the burglar mission._

Note 2: Try to avoid using commands to give it that "single-player" feel, use keys instead where possible.

VIDEO: https://www.youtube.com/watch?v=e7Ua2NE8j2Y

How it's going to work?

• [x] Get in a boxville between 00:00 and 06:00 to start the burglar mission.
• [x] A checkpoint is set to one of the 50 random house coordinates.
• [x] When you get to the house, a yellow ENEX marker (pickup ID 19198) will be displayed.
• [x] When a player walks into the yellow marker, they will be teleported to a random pre-made interior.
• [x] The interior will feature 5-6 objects that can be stolen.
• [x] Player will be able to pick up the object and will be put into SPECIAL_ACTION_CARRY which disallows running, jumping, and punching and also applies "carrying" animation.
• [x] Destroy the picked up object and attach it to the player.
• [x] Once picked up, they can carry the object to the back of their Boxville, apply animation "drop down" and remove the object, then store a random amount of money into their BurglaryMoney[playerid] variable.
• [x] Once all items are robbed, a checkpoint is set to a random garage from an array of coordinates.
• [x] Player drops off the stolen goods, finishes the mission and gets paid.
• [x] A cooldown is applied using UNIX timestamps, not timers, to avoid unnecessary load.
• [x] Cooldown will be reset either when actual current time is higher than the UNIX timestamp or every midnight.
• [x] If player dies, disconnects or gets IC/admin jailed, the mission ends.
• [x] Add a noise meter using progress2 include (https://github.com/Southclaws/progress2) and player velocity
• [x] If the bar value goes up to a 100, hide the bar and display text "cops arriving in: %d" and notify the police after a set amount of time

[0x8FAB]

Note so I don't forget: IC/admin jail logic not implemented. You will have to do that when you merge it with the gamemode.

[0xDizzle]

Yeah no probs I forgot to mention that I'll handle that

[0x8FAB]

These are the things that you have to do when you merge the code:

• [ ] IC/admin jail
• [ ] Save burglary cooldown time upon disconnect
• [ ] Load burglary cooldown upon authentication
• [ ] Give the money. Variable used is PlayerData[playerid][burgValue]
• [ ] Notify police
• [ ] Implement HUD elements (I implemented no interface stuff whatsoever, all variables should be available)
• [x] Handle what happens when the player dies during a mission
• [x] Handle what happens when the vehicle despawns during a mission (either death or admin respawn)

I'm going to add a progress bar for testing purposes. The variable will be PlayerData[playerid][burgNoise]. Its value will be calculated using the player's velocity while inside the house.

[0x8FAB]

In addition to the list above, there are some oddities that I am currently unable to resolve.

• The rear doors can be forced open using SetVehicleParamsCarDoors. Doing so with a command works fine. Doing it while doing a mission appears to not work. I suspect it's because the states are toggled too quick after one another.

• The drop off checkpoint, despite having a size of 20.0, has the appearance of a small checkpoint. I believe the cause is the same as with the doors; the drop off checkpoint is enabled too quickly after the last object unload checkpoint is removed. Per the native source code:

* \ * If a checkpoint is already set it will use the radius of that checkpoint instead of the new one.<br * />

These should not have an impact on functionality. I will continue to investigate.

EDIT (02-MARCH-2024): These issues were fixed. (See comment below.)

[0xDizzle]

Looking good so far!

Just a note: We need /empty/ house interiors for the system to work properly, so we can map our own objects that can be stolen. The default GTA:SA interiors are mostly 1 big object with all the furniture attached to it so it can't be removed by using RemoveBuildingForPlayer.

I've prepared a list of small and medium interiors that are completely empty below, would be great if you could use these co-ordinates: https://pastebin.com/NNpGckma

[0x8FAB]

Here are the changes since your last test run:

• Added function "BurglaryNotifyPolice". (Empty.)
• Added empty interiors.
• Added mapping to the first interior.
• Resized all checkpoints by at least a factor of 2.
• Added timers where necessary. (ToggleRearDoors, SetDropOffCheckpoint, ToggleFreeze, and StopCompleteSound.)
• Reworked logic to be more function-heavy. Functions are meant to do one thing, no side effects.
• Added sound effects when loading an object into the boxville and when the burglary mission is completed.
• Reworked how the data is represented. All object data is now included in bgInteriorObjects. No more cross-referencing between arrays. (It was getting confusing.)
• Added the necessary logic to generate snoring noises. Upon starting a burglary mission, it is determined whether or not there are inhabitants sleeping in the house. If there are, snoring noises would be heard. There is still some work to make this work good.
• Removed house entrance / exit pickups as soon as all objects are in the boxville.
• Replaced pick up and drop animation with "pickup_box". (Untested.)
• Matched frozen timer to new "pickup_box" animation.
• Aligned the object with the ground when dropped.

There are probably a few other things I forgot to mention.

[0xDizzle]

Amazing job ^

[0x8FAB]

So nearly done with the fundamentals.

• Fixed object virtual worlds. (Objects spawned in all virtual worlds.)
• Fixed determination of virtual world. (No more overlap possible.)
• Fixed vehicle objective shown to all players. (It's per player now.)
• Fixed vehicle objective disappearing when vehicle is streamed out and back in.
• Fixed noise limit for police notification.

I'll keep commenting here with what I've changed until it's merged.

[0x8FAB]

• Fixed snoring timer.
• Added inhabitant panic sounds upon detection.
• Added police radio message upon detection. ("Respond to a 10-34 in Central. Suspect last seen on foot.")