Scavenger Hunt

About Scavenger Hunt
A random Scavenger Hunt mini event where players must follow a compass to find the loot box, Has multiple different types of Scavenger Hunt or Scrap Box Events. When the event has started, a Compass with a Red Indicator will appear for all players that is relative to the Event Box location from the players location, When a player turns the compass updates to the direction

Dependencies

• Drop Vehicles - (REQUIRED*) If you want to be able to use the preconfig values in loot to call air drop signals for vehicles - Otherwise you will need to remove from the items from the config file in the loot area.
• Image Library

Optional Dependencies

• ZoneManager

2.0.0 MAJOR Upate Changes

• Random Spawns re-written
  
  
  • Now can spawn 1000's of spawn points, use chat command /sh showspawns to see the total count and all locations for 30 secs (spheres & lines for visual spawn locations)
  • Will not create spawns any more in water, tries NOT to create spawns at monuments as well. May still spawn near.
  • Now includes all 5 Biomes now.
• No longer uses external URLs for Images
  
  
  • Uses the folders and image files that must be installed to your oxide/data/Images folder
  • Stores images locally and calls from server directly. No more possible IMG IP Address Black Listing like IMG.GUR is famous for.

Features

• Random Event Timers Min & Max Times
• Minimum Required Players before event can start
• Display visual options when Scavenger Hunt Box unlocks options
• Place a Custom Note that can be edited in the config for each Loot Box
• Compass UI that players must follow in order to find the Scavenger Hunt or Scrap Box loot
• Set different Background Maps or Images for the UI
• Create Temp Zones in Zone Manger if installed
• Set different flags for Zone Manager if installed
• Option for loot to have custom items with custom skins and custom names
• Custom Spawning system built in
• Players are unable to see the event loot box prior to the compass display unless the box spawns next to them or they stumble upon it before it displays (rare chance of that happening)

Commands

• /sh info - Shows the time remaining before the next event step and the position of the event box (if applicable)
• /sh start - Start the event, add the 'forced' argument to ignore player counts
• /sh starthere - Start a new event on your position, add the 'forced' argument to ignore player counts
• /sh cancel - Cancels the current event
• /sh unlock - Pre-maturely unlock the event box
• /sh showspawns - Shows the random spawnable possible locations

Permissions

• NONE, Only Admins/Owners can run commands

Configuration

{
  "Event Timers": {
    "Minimum time between events (seconds)": 3600,
    "Maximum time between events (seconds)": 7200,
    "Amount of time before the box unlocks (seconds)": 59,
    "Amount of time the box will remain on the map (seconds)": 900
  },
  "Event Options": {
    "Minimum players required online to trigger the event": 1,
    "Show a smoke signal on the box location": false,
    "Display A Rotating Red Siren Light Inside The Spawned Explosive Crate": true,
    "Enable A Siren Alarm Sound From The Spawned Explosive Crate": true,
    "Broadcast the box co-ordinates to chat": false,
    "UI Options": {
      "Enabled the UI display": true
    },
    "Event Zone Options": {
      "Disable building and deployable placement within the set radius of the box": true,
      "Radius of the event zone": 75.0,
      "Create a temporary zone around the box when it spawns using ZoneManager": true,
      "The amount of time the Zone Manager zone will remain active after the event is over (seconds)": 300,
      "Flags to be applied to the temporary Zone Manager zone": [
        "notp",
        "true",
        "notrade",
        "true",
        "name",
        "ScavengerHunt"
      ]
    }
  },
  "UI Positions": {
    "ContainerMin": "0.01 0.89",
    "ContainerMax": "0.09 1",
    "MapMin": "0.0 0.15",
    "MapMax": "0.8 0.9",
    "CompassMin": "0.57 0.57",
    "CompassMax": "0.92 0.92"
  },
  "Loot Containers (Chosen at random)": [
    {
      "Container skin ID": 1686299197,
      "Scavenger Hunt Container Title": "Builders Treasure Box",
      "Map Icon to use 0 being the first number": 0,
      "Enable note inside box": true,
      "Text for note inside": "We knew and had absolute faith in you that you could find this box!\n\nBest Regards,\nZTL",
      "Minimum amount of items to spawn": 13,
      "Maximum amount of items to spawn": 13,
      "Loot list": [
        {
          "Item shortname": "pookie.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "blueberries",
          "Minimum amount of item": 5,
          "Maximum amount of item": 95,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "toolgun",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "xmas.present.large",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "electric.generator.small",
          "Minimum amount of item": 1,
          "Maximum amount of item": 3,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "surveycharge",
          "Minimum amount of item": 5,
          "Maximum amount of item": 35,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "mining.pumpjack",
          "Minimum amount of item": 1,
          "Maximum amount of item": 2,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "wood",
          "Minimum amount of item": 15000,
          "Maximum amount of item": 15000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "stones",
          "Minimum amount of item": 10000,
          "Maximum amount of item": 10000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "metal.fragments",
          "Minimum amount of item": 7500,
          "Maximum amount of item": 7500,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "metal.refined",
          "Minimum amount of item": 750,
          "Maximum amount of item": 750,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "lowgradefuel",
          "Minimum amount of item": 500,
          "Maximum amount of item": 500,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 1942898011,
          "Item Display Name": "Minicopter Supply Signal"
        }
      ]
    },
    {
      "Container skin ID": 1209454231,
      "Scavenger Hunt Container Title": "Traps Treasure Box",
      "Map Icon to use 0 being the first number": 0,
      "Enable note inside box": true,
      "Text for note inside": "We knew and had absolute faith in you that you could find this box!\n\nBest Regards,\nZTL",
      "Minimum amount of items to spawn": 13,
      "Maximum amount of items to spawn": 13,
      "Loot list": [
        {
          "Item shortname": "pookie.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "blueberries",
          "Minimum amount of item": 5,
          "Maximum amount of item": 95,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "samsite",
          "Minimum amount of item": 1,
          "Maximum amount of item": 3,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "surveycharge",
          "Minimum amount of item": 5,
          "Maximum amount of item": 35,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "xmas.present.large",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "electric.generator.small",
          "Minimum amount of item": 1,
          "Maximum amount of item": 3,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "mining.quarry",
          "Minimum amount of item": 1,
          "Maximum amount of item": 2,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "autoturret",
          "Minimum amount of item": 1,
          "Maximum amount of item": 3,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "trap.landmine",
          "Minimum amount of item": 1,
          "Maximum amount of item": 5,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "guntrap",
          "Minimum amount of item": 1,
          "Maximum amount of item": 5,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "trap.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 5,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "electric.teslacoil",
          "Minimum amount of item": 1,
          "Maximum amount of item": 5,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 1942898011,
          "Item Display Name": "Minicopter Supply Signal"
        }
      ]
    },
    {
      "Container skin ID": 1825978701,
      "Scavenger Hunt Container Title": "Treasure Box Pumpjack",
      "Map Icon to use 0 being the first number": 0,
      "Enable note inside box": true,
      "Text for note inside": "We knew and had absolute faith in you that you could find this box!\n\nBest Regards,\nZTL",
      "Minimum amount of items to spawn": 13,
      "Maximum amount of items to spawn": 13,
      "Loot list": [
        {
          "Item shortname": "pookie.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "blueberries",
          "Minimum amount of item": 5,
          "Maximum amount of item": 95,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "wood",
          "Minimum amount of item": 2500,
          "Maximum amount of item": 5000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "stones",
          "Minimum amount of item": 2500,
          "Maximum amount of item": 5000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "metal.refined",
          "Minimum amount of item": 100,
          "Maximum amount of item": 350,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "surveycharge",
          "Minimum amount of item": 5,
          "Maximum amount of item": 35,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "explosives",
          "Minimum amount of item": 15,
          "Maximum amount of item": 64,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "ammo.rifle",
          "Minimum amount of item": 45,
          "Maximum amount of item": 175,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "mining.pumpjack",
          "Minimum amount of item": 1,
          "Maximum amount of item": 2,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "xmas.present.large",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "electric.generator.small",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 2568176049,
          "Item Display Name": "Duo Submarine Supply Signal"
        }
      ]
    },
    {
      "Container skin ID": 1825978701,
      "Scavenger Hunt Container Title": "Treasure Box Quarry",
      "Map Icon to use 0 being the first number": 0,
      "Enable note inside box": true,
      "Text for note inside": "We knew and had absolute faith in you that you could find this box!\n\nBest Regards,\nZTL",
      "Minimum amount of items to spawn": 13,
      "Maximum amount of items to spawn": 13,
      "Loot list": [
        {
          "Item shortname": "pookie.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "blueberries",
          "Minimum amount of item": 5,
          "Maximum amount of item": 95,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "wood",
          "Minimum amount of item": 2500,
          "Maximum amount of item": 5000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "stones",
          "Minimum amount of item": 2500,
          "Maximum amount of item": 5000,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "metal.refined",
          "Minimum amount of item": 100,
          "Maximum amount of item": 350,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "surveycharge",
          "Minimum amount of item": 5,
          "Maximum amount of item": 35,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "explosives",
          "Minimum amount of item": 15,
          "Maximum amount of item": 64,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "ammo.rifle",
          "Minimum amount of item": 45,
          "Maximum amount of item": 175,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "mining.quarry",
          "Minimum amount of item": 1,
          "Maximum amount of item": 2,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "xmas.present.large",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "electric.generator.small",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 2568175759,
          "Item Display Name": "Solo Submarine Supply Signal"
        }
      ]
    },
    {
      "Container skin ID": 1517816237,
      "Scavenger Hunt Container Title": "Scrap Box",
      "Map Icon to use 0 being the first number": 1,
      "Enable note inside box": true,
      "Text for note inside": "You have found the Oath Breaker Scrap Box. We knew and had absolute faith in you that you could find this box! Enjoy the spoils of your efforts.\n\nBest Regards,\nZTL",
      "Minimum amount of items to spawn": 7,
      "Maximum amount of items to spawn": 7,
      "Loot list": [
        {
          "Item shortname": "scrap",
          "Minimum amount of item": 1478,
          "Maximum amount of item": 4457,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "paper",
          "Minimum amount of item": 500,
          "Maximum amount of item": 1000,
          "SkinID of item": 1829167394,
          "Item Display Name": "Cash"
        },
        {
          "Item shortname": "pookie.bear",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 2,
          "Maximum amount of item": 2,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "xmas.present.large",
          "Minimum amount of item": 1,
          "Maximum amount of item": 3,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "metal.refined",
          "Minimum amount of item": 150,
          "Maximum amount of item": 450,
          "SkinID of item": 0,
          "Item Display Name": null
        },
        {
          "Item shortname": "supply.signal",
          "Minimum amount of item": 1,
          "Maximum amount of item": 1,
          "SkinID of item": 1942898011,
          "Item Display Name": "Minicopter Supply Signal"
        }
      ]
    }
  ],
  "Version": {
    "Major": 2,
    "Minor": 0,
    "Patch": 1
  }
}

Localization

{
  "Event.EventStart1": "<size=17><color=#00ff00>Scavenger Hunt Event will begin in {0}!</color></size>",
  "Event.EventStart1Scrap": "<size=19><color=#00ff00>Scrap Box Event will begin in {0}!</color></size>",
  "Event.EventStart2": "<size=12>Loot Boxes can contain Supply Signals, Supplies, Ammo, Berries, Pumpjacks, Test Generators, and much much more!</size>",
  "Event.EventStart2Scrap": "<size=12>The Scrap Box can contain Tons of Scrap, Money, Supply Signals, Supplies, MiniCopter Drop, and much much more!</size>",
  "Event.EventStart3": "<size=12>Follow the red compass indicator to find a box filled with Epic Loot!</size>",
  "Event.EventStart3Follow": "<size=12>Follow the red compass indicator to find the box filled with Epic Loot!</size>",
  "Event.EventStart4": "<size=12>First one to open the box gets the loot!</size>",
  "Notification.NextDrop": "<color=#ffff00>Time until next drop : {0}</color>",
  "Notification.NextUnlock": "<color=#ffff00>Time until unlocked : {0}</color>",
  "Notification.IsUnlocked": "<color=#ffff00>Chest is currently unlocked!</color>",
  "Notification.CurrentPos": "<color=#ffff00>Can be found at : {0}</color>",
  "Notification.EventWin": "<color=#0099CC><size=12>Someone found the Scavenger Loot Box!</size></color>",
  "Notification.EventWinScrap": "<color=#0099CC><size=12>Someone has found and is looting the Scrap Box!</size>",
  "Notification.EventLose": "<color=#ffff00>The box was not found in time, shame, better luck next time.</color>",
  "Notification.EventLoseScrap": "<color=#ffff00>The Scrap Box was not found in time, shame, better luck next time.</color>",
  "Notification.ContainerUnlock": "<size=12>Scavenger Hunt Event has started!</color>",
  "Notification.ContainerUnlockScrap": "<size=12>Scrap Box Event has started!</color>",
  "Notification.BroadcastMap": "<size=12>Follow the red compass indicator to find a box filled with Epic Loot!</size>",
  "Notification.BroadcastMapScrap": "<size=12>Follow the red compass indicator to find the Scrap Box filled with Epic Loot!</size>",
  "Notification.BroadcastCoords": "<color=#ffffff>The box can be found at {0} </color>",
  "Error.NoBuild": "<color=#ff0000>You can not build or deploy item near the Scavenger Box!</color>",
  "Error.NoLockDeploy": "<color=#ff0000>You are not allowed to place a lock on the Scavenger Box</color>",
  "Error.NoBuildScrap": "<color=#ff0000>You can not build or deploy item near the Scrap Box!</color>",
  "Error.NoLockDeployScrap": "<color=#ff0000>You are not allowed to place a lock on the Scrap Box</color>"
}