Search and Destroy

About Search and Destroy

Search And Destroy
Search and Destroy Classic PVP Game Mode Event. 2 in 1: Respawn or No Respawn.

Features

How Search and Destroy works:

Each team spawns on the opposite side of the arena.
Both teams must locate the bomb sites.
Each round one team defends and one team is the attacker, the objectives switch each round.
The attackers can plant the bomb at a bomb site to start the countdown.
If the bomb detonates before the defender team defuses it the attackers win the round.
If the defenders prevent the attackers from planting, or defuse the bomb before it explodes they win the round.
The game ends when one team reaches the score limit first.
Choose if players respawn until the round time limit is reached or if players have one life per round so you can also win the round by eliminating the other team.
Choose if anyone on the attacking team can plant the bomb or if one bomb spawns on the ground that someone from the attacking team must pick up to plant at the bomb site.

Edit your game settings for a faster or slower paced game!

Three demo arenas included as seen in images. These are Copy Paste files.

Build your own custom arena: You can build a custom arena in-game or use an arena prefab and set the location where the game starts with commands.

Use the commands /bomb 1, /bomb 2, /setspawn red, /setspawn blue, and /setspawn spectate to set the teleport locations for the game to your arena. Location settings can be saved and loaded using the arena profile command.

Lots of configurable options and an editable language file for in-game message customization.

Customize your game settings including:

Time limit for event registration.
Time limit for game (or disable by setting to 0).
Time limit per round if bomb is not planted.
Choose if players respawn until the round time limit is reached or if they have one life per round.
Choose optional respawn delay timer.
Choose optional spawn protection timer.
Choose if all attacking team players can plant bomb or if only one bomb spawns on the ground for the attackers to plant.
Choose duration of bomb timer.
Choose number of points points required to win.
Choose if there are one or two bomb sites.
Choose length of bomb plant code.
Choose length of bomb defuse code.
Minimum number of players required to start event.
Maximum number of players required to start event.
Choose if players get instant full health when they get a kill.
Choose if players can team kill.
Increase or decrease randomized distance from spawn point to teleport players.
Optional temporary Team UI with save and restore original team UI after the game. Works with vanilla teams only.
Blocked command list to prevent players from using commands during the game.
Choose kit name for Red and Blue teams to spawn with.
Choose kit for ammo and med restock when a player gets a kill.
Configure skin ID for bomb site object (fridge). Required.
Configure skin ID for ground bomb item (satchel). Required.

More Features:

GUI with random code for planting and defusing the bomb.
Command for players to join event when registration opens.
Chat command and console command to start event registration.
If enabled, bomb item spawns in front of attacking teams spawn. One player can pick it up and it is required to plant the bomb at the bomb site. If they die with the bomb it will drop and only the attacking team can pick it up.
Bomb ticking noise near bomb that speeds up in the last five seconds.
Chat notifications to participating players for events like kills, bomb plants, etc.
Scoreboard (sorted by kills) in chat at the end of the event with player names, kills, deaths, plants, and defuses.
If you knock a player and they f1 kill it will count as a kill for the person who knocked them.
Developer API hook OnGameWin to notify you when a game has been won along with the statistics. Good for rewards and score keeping.
Optional temporary Team UI for players on the same team during the event. They will be returned to their original team after the event (vanilla teams only).
Restore player items after the game. (Players are teleported to the event naked).
After the event teleport players back to original location from when they joined the event.
Player disconnection handling in case anyone leaves during the event.
Bomb object is unbreakable during the event.
You can't remove your team clothing and armor.
No looting bodies or knocked players.
Admin team change commands to change players teams with a configurable amount of time for team changing before game.
Yes, the bomb explodes.

Demo Arenas:

If you want to use the three demo arenas that come with the plugin as seen in the images you will need:

Copy Paste by misticos (https://umod.org/plugins/copy-paste)

Skins:

If you want colored kits and don't have a plugin to skin items already:

Skins by misticos (https://umod.org/plugins/skins)

Check out Steam Workshop for free skins.

Dependencies
The following plugin is required for Search And Destroy.

Rust Kits by k1lly0u - Required (Free)

This plugin does not include pre-configured kits. You can choose what to give as a kit in the configuration.

Permissions

searchanddestroy.join - Required to use /snd command to join event.
searchanddestroy.admin - Required to use event management and setup commands.

Chat Commands

Join, start, stop event:

/snd - Command for players to join event during registration. Requires permission searchanddestroy.join.
/snd start - Command for admins to start the event registration. Requires permission searchanddestroy.admin.
Optionally, you can also use /snd start <profile name> to start a specific arena profile if you have any saved.
/snd stop - Command for admins to stop the event in progress. Requires permission searchanddestroy.admin.

Set bomb locations:

/bomb 1 - Set location for Bomb 1 to where you are standing Requires permission searchanddestroy.admin.
/bomb 2 - Set location for Bomb 2 to where you are standing. Requires permission searchanddestroy.admin.

Set spawn locations:

/setspawn red - Set location for Red Team Player Spawn to where you are standing. Requires permission searchanddestroy.admin.
/setspawn blue - Set location for Blue Team Player Spawn to where you are standing. Requires permission searchanddestroy.admin.
/setspawn spectate - Set location for pre-game lobby and spectator zone to where you are standing. Requires permission searchanddestroy.admin.

Team management:

/sndteam swap <player1> <player2> - Swap two players teams during the team swapping period. Requires permission searchanddestroy.admin.
/sndteam red <player> - Force blue team player to join red team during team swapping period. Requires permission searchanddestroy.admin.
/sndteam blue <player> - Force red team player to join blue team during team swapping period. Requires permission searchanddestroy.admin

Arena profiles (optional):

/profile save <name> - Save current arena configuration to an arena profile. Requires permission searchanddestroy.admin.
/profile load <name> - Load arena configuration from an arena profile. Requires permission searchanddestroy.admin
Keep in mind you can also use /ctf start <profile name> to load and start a specific profile.
/profile list - List saved arenas. Requires permission searchanddestroy.admin.
/profile option <name> <option> <value> - Change arena gameplay settings for a specific arena. Requires permission searchanddestroy.admin.
/profile show <name> - Display current settings for an arena profile. Requires permission searchanddestroy.admin.

Console Commands

startsnd - Command for admins to start the event registration.

Configuration

{
  "Amount of time in seconds for event registration": 180,
  "Amount of time in seconds before game ends for taking too long (0 to disable)": 3600,
  "Amount of time in seconds before a round ends for taking too long if bomb is not planted": 300,
  "Amount of time in seconds between registration end and event start (for admin team swapping)": 15,
  "First to reach this number of points wins": 4,
  "Minimum number of players required to start the game": 2,
  "Maximum number of players before registration closes": 20,
  "Maximum distance from team spawn point player can spawn within": 4.0,
  "Length of random code to enter when planting bomb": 10,
  "Length of random code to enter when defusing bomb": 10,
  "Duration of bomb timer in seconds": 60,
  "Use two bomb sites, otherwise use one": true,
  "Require bomb ground item to plant at bombsite, otherwise anyone on attacking team can plant": true,
  "Do players respawn until the round time limit is reached or bomb explodes?": false,
  "Cooldown in seconds for respawning during game": 10,
  "Amount of time in seconds player will be invincible after spawning": 5,
  "Can players on the same team kill each other?": false,
  "Grant player instant full health when they get a kill": false,
  "Create a temporary Team UI for players and restore vanilla teams after the game": false,
  "Blocked command list for players during game": [
    "home",
    "outpost"
  ],
  "Red Team kit name": "red team",
  "Blue Team kit name": "blue team",
  "Ammo Restock and Meds on kill kit name": "restock ammo",
  "Bomb Skin ID (Fridge)": 3484089384,
  "Bomb ground item Skin ID (Satchel)": 2921225770,
  "Bomb one position (X)": 0.0,
  "Bomb one position (Y)": 0.0,
  "Bomb one position (Z)": 0.0,
  "Bomb two position (X)": 0.0,
  "Bomb two position (Y)": 0.0,
  "Bomb two position (Z)": 0.0,
  "Position to teleport players on pre-game lobby and spectate (X)": 0.0,
  "Position to teleport players on pre-game lobby and spectate (Y)": 0.0,
  "Position to teleport players on pre-game lobby and spectate (Z)": 0.0,
  "Red team spawn position (X)": 0.0,
  "Red team spawn position (Y)": 0.0,
  "Red team spawn position (Z)": 0.0,
  "Blue team spawn position (X)": 0.0,
  "Blue team spawn position (Y)": 0.0,
  "Blue team spawn position (Z)": 0.0
}

Arena Profiles (optional):

Save your arena settings and load them later. If you have multiple arenas on your map you can save your current arena configuration to an arena profile and load it when you need it. Use the /arena commands to manage your arena profiles. An arena profile contains player spawn locations and bomb spawn locations and gameplay settings.

What is an arena profile?

Arena profiles are optional and are not required. They are used to make setting up games easier when you have multiple arenas on your map. Use arena profiles to save arena and game settings from your current configuration to a named profile that you can load back to your configuration when needed. This lets you configure multiple arenas on your map with different settings, and swap between them when you need to with one command.

How do I create an arena profile?

First, set up your /bomb and /setspawn locations.
Save your current config to an arena profile using the command /profile save <profile name>.
Edit additional arena gameplay options using /profile option <profile name>.
Load the arena with /profile load <profile name> when you need it. This will copy the arena profile to your current configuration.

How do I edit an existing arena profile?

Updating player and bomb spawn points:
- Load the arena profile you want to edit.
- Use the commands /bomb and /setspawn to set update teleport locations in your current configuration.
- Using the same saved profile name with /profile save, save the current configuration to the arena profile so the teleport locations are updated and your current profile options are still saved.
Updating arena gameplay options:
- Save your arena profile after you set up the spawn points, then use the command /profile option to change your settings. Reload the arena profile to apply the updated profile to your current configuration.

What arena gameplay options can I edit on the arena profile?

You can use the /profile option command to modify:

PointsToWin
MaxPlayers
SpawnMaxDistance
BombTimer
UseTwoBombSites
RequireGroundBomb
PlayerRespawn
RespawnDelay
RespawnProtection
RedTeamKit
BlueTeamKit
AmmoRestockKit

In case you want to have different settings per arena.
Here's an example: /profile option <profile name> PointsToWin 5.

Included Arenas

The included arenas are Copy Paste data files. To use the arenas you must download Copy Paste by Misticos here and upload the snd_*.json files to your your server framework folder (oxide/carbon)/data/copypaste/snd_stone.json. Paste the arena in-game using the command /paste snd_stone. If you need to, you can adjust the height with /paste ctf_stone height 10 (to paste it in the air). Use the available commands to set the bomb spawns and teleport locations.

Developer API

Hooks

void OnGameWin(string winningTeam, List<ulong> redTeamPlayers, List<ulong> blueTeamPlayers, Dictionary<ulong, int> playerKills, Dictionary<ulong, int> playerDetahs, Dictionary<ulong, int> playerPlants, Dictionary<ulong, int> playerDefuses) - Called when a game is won. Good for rewards and score keeping.

Support and Configuration Help Discord

For support or for questions about the plugin before you purchase reach out on Codefling or visit the support Discord for my plugins here: https://discord.gg/25sR5EZktP