CritteR's Busted! Minigame is my interpretation of the classic GTA IV multiplayer event: Busted. It's a Cops 'n' Robbers style minigame, where one player (the Robber) has to evade being caught by the other players (the Cops) for a set amount of time, before escaping to a final checkpoint.
Types of players:
There are 3 player types for the minigame:
- The Robber: 1 Player, chose at random from the players that want to. If there are more than one player that wants to play robber, the last Robber player of the lobby will not be selected.
- The Heli(copter): 1 Player, chose at random from the players that want to. If there are more than one player that wants to play robber, the last Heli player of the lobby will not be selected. The Heli is considered a Cop.
- The Cops: All the other players in the lobby.
Minigame Phases:
1. The Grace Period This is the first phase of the minigame. In this phase, the Robber cannot be busted by the Cops, and the Cops have a speed handicap. This gives the Robber an advantage before the next phase. This phase lasts 30 seconds by default (configurable per lobby).2. The Pursuit Phase In the main phase of the minigame, the Robber has to drive (or hide!) around the map, for a set amount of time (configurable per lobby), while avoiding being caught by the Cops. The Robber can be seen on the minimap as long as any of the cops can see them (configurable).3. The Escape Phase In the final phase, the Robber has to reach the Escape Checkpoint (marked on the map only to them), while avoiding being caught by the Cops. There is no time limit for this phase. Reaching the escape checkpoint is the Win Condition for the Robber.
Built for every server:
The resource was built and tested on the latest DLC (b3407). All the entities are spawned server-side, all the routing buckets used are set to lockdown mode "strict" or "relaxed" (when AI traffic is allowed in the lobby).
It supports Pure Mode, Entity Lockdown and Network Ownership Restriction.
It is compatible with regular vMenu servers and with RP frameworks. It ***should*** be compatible with you "guardian" resources, but don't quote me on that. I don't use those. (client-side scripts use SetEntityInvincible() and FreezeEntityPosition(), plus camera functions.)
Outside Connections:
As with all my scripts, every UI and HUD element is fully opened and commented, so you can modify it to fit your server. In addition to that, the resource opens a couple of functions and events that help you integrate this minigame into your server seamlessly:
| CalculatePlayerPoints(player) | function | Logic function used to calculate the points won by the player at the end of the minigame. player is an array. |
| PreferredPlayerName(source) | function | Function that provides the player source, and expects a string return, which will be used as the player name. |
| IsPlayerAllowedToPlay(source) | function | Function that provides the player source, and expects a bool return, to give the player the permission to play. |
| IsPlayerAllowedRobber(source) | function | Function that provides the player source, and expects a bool return, to give the player the permission to play as Robber. |
| IsPlayerAllowedHeli(source) | function | Function that provides the player source, and expects a bool return, to give the player the permission to play as Heli. |
| IsPlayerAllowedCop(source) | function | Function that provides the player source, and expects a bool return, to give the player the permission to play as Cop. |
| PlayerJoinedTheLobby(source, data) | function | Function that runs whenever a player joins a lobby. |
| PlayerIsOutOfLobby(source, data) | function | Function that runs whenever a player leaves a lobby. |
| & and many more! |
Other Features:
Multi-lobby support: You can configure multiple lobbies, both Public and Private (password protected), allowing multiple rounds for Busted! to be played at the same time.
Multi-language support: All the texts are available in the
sh_locales.luafile, allowing you to add as many languages as you want. Each player can choose their preferred language.
Supports
English & 
Romanian by default.Custom Vehicles support: By default you can configure different vehicle models for Robber and Cops, but with the helper functions in
server_connection.lua, you can write your own logic for Robber / Cop vehicles, including the ability to read player vehicles and tuning from the database.Points System & Leaderboard: The minigame automatically saves player’s games played and won, both for Cop and for Robber match, but also includes a Points variable, which is open for you to write the logic for. By default it gives 3 points when you win, 1 point when you lose, and 1 additional point when you play as Robber.
Screenshots:
Lobby Menu:
