About Loot Rush Event
Loot Rush Event
Create dynamic loot hotspot events across the map where players compete to secure valuable loot before the event disappears.
Loot Rush spawns a temporary event zone containing crates, barrels, and other loot entities. Players must enter the zone and fight for the rewards before the timer expires.
Designed to be lightweight, highly configurable, and engaging for PvP servers.
Features:
Dynamic Loot Hotspot Events
Loot Rush spawns timed loot events across the map that attract players and create natural PvP encounters.
When the event begins:
- A random location is selected
- A visual sphere marker appears
- Loot containers spawn inside the zone
- Players receive an event announcement
- Players compete to secure the loot
- Once the timer expires, the event ends and remaining loot is cleaned up automatically.
Fully Configurable Loot Categories:
Loot Rush includes a flexible zone category system that allows server owners to define different types of events.
Each category can define:
- spawn weight
- sphere radius
- sphere color
- loot entities
- loot amounts
Example categories included by default:
- Default
- Industrial
- Military
- Roadsigns
- Jackpot
- ChristmasLoot (optional seasonal event)
Server owners can easily create their own categories.
Weighted Event Selection:
Each category can define a weight value controlling how often it appears.
Example:
- Default events → common
- Military events → uncommon
- Jackpot events → rare high-value events
This keeps events unpredictable and exciting.
Custom Loot Container System:
LootRush uses a safe prefab whitelist system to control which loot entities can spawn.
This prevents invalid entities from being used and ensures server stability.
Allowed loot prefabs are stored in:
/data/LootRush/LootContainers.json
Example:
{
"Allowed Loot Prefabs": [
"assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-1.prefab",
"assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-2.prefab",
"assets/bundled/prefabs/autospawn/resource/loot/trash-pile-1.prefab",
"assets/bundled/prefabs/radtown/crate_basic.prefab",
"assets/bundled/prefabs/radtown/crate_elite.prefab",
"assets/bundled/prefabs/radtown/crate_normal.prefab",
"assets/bundled/prefabs/radtown/crate_normal_2.prefab",
"assets/bundled/prefabs/radtown/crate_normal_2_food.prefab",
"assets/bundled/prefabs/radtown/crate_normal_2_medical.prefab",
"assets/bundled/prefabs/radtown/crate_tools.prefab",
"assets/content/props/roadsigns/roadsign1.prefab",
"assets/content/props/roadsigns/roadsign2.prefab",
"assets/content/props/roadsigns/roadsign3.prefab",
"assets/content/props/roadsigns/roadsign4.prefab",
"assets/content/props/roadsigns/roadsign5.prefab",
"assets/content/props/roadsigns/roadsign6.prefab",
"assets/content/props/roadsigns/roadsign7.prefab",
"assets/content/props/roadsigns/roadsign8.prefab",
"assets/prefabs/misc/xmas/giftbox/giftbox_loot.prefab",
"assets/prefabs/misc/xmas/sleigh/presentdrop.prefab",
"assets/prefabs/missions/portal/proceduraldungeon/xmastunnels/loot/xmastunnellootbox.prefab",
"assets/prefabs/npc/m2bradley/bradley_crate.prefab",
"assets/prefabs/npc/patrol helicopter/heli_crate.prefab"
]
}
To use a new loot container:
Add the prefab path to the allowed list
Reference the prefab inside a zone category
This allows server owners to safely add new loot without editing plugin code.
Display Name Overrides
Each loot entry supports a Display Name Override which controls how the loot appears in announcements.
Example:
{
"Prefab": "assets/prefabs/misc/xmas/giftbox/giftbox_loot.prefab",
"Amount": 30,
"Display Name Override (empty = auto)": "Gift Box"
}
If left empty, the plugin automatically generates a readable name from the prefab path.
Advanced Announcement System:
Loot Rush includes two announcement modes.
Announcement Mode 1
Simple event message notifying players that a Loot Rush event has started.
Example:
Loot Rush Event Started!
Check your map for the event marker.
Announcement Mode 2
Detailed announcement showing the loot available inside the event.
Example:
Loot Rush Event Started!
Possible Loot:
• 6x Normal Crate
• 4x Elite Crate
• 1x Bradley Crate
Enter the zone and secure the loot before it disappears!
Announcements support RichText formatting and sound effects.
Fully Customizable CUI:
LootRush includes an optional in-game UI that displays event information.
All CUI elements are fully configurable.
Server owners can customize:
- UI position
- UI size
- text formatting
- update intervals
- proximity display
- colors
Resizeable and Repositionable UI
All UI elements use configurable anchors allowing them to be resized or repositioned anywhere on the screen.
This makes LootRush compatible with servers that use custom UI layouts.
Map Marker & Event Sphere
Each event creates a visual indicator to help players locate the event.
Features include:
- map radius marker
- colored sphere dome
- configurable zone radius
- configurable sphere colors
Available sphere colors:
- Blue
- Green
- Red
- Purple
Configuration Example:
{ "Chat": { "Use Prefix": true, "Prefix": "<color=#89CFF0>[LootRush Event]</color> ", "Channel (0=Global)": 0, "Icon SteamId": 76561198888888888 }, "Event": { "Only Command Start Event": false, "Minimum Players to Start Event": 1, "Event Minimum Interval (seconds)": 3600, "Event Maximum Interval (seconds)": 7200, "Event Duration Seconds": 1200, "Allow Event To Spawn Near Monuments/Roads/Rails": false, "Minimum Distance From Monuments (meters) used When AllowEventToSpawnNearMonumentsRoadsRails = false": 100.0 }, "Announcements": { "Broadcast Start/End Messages": false, "Event Start Message": "<color=#ffd479>Loot Rush Event</color> <color=white>has started! Check your map.</color>", "Event End Message": "<color=#ffd479>Loot Rush Event</color> <color=white>has ended.</color>", "Play Start Notification Sound": true, "Start Sound FX #1 (empty = disabled)": "assets/bundled/prefabs/fx/invite_notice.prefab", "Start Sound FX #2 (empty = disabled)": "assets/bundled/prefabs/fx/item_unlock.prefab" }, "Announcement Option 2": { "Enabled (Announcement Option 2)": true, "Warn When X Minutes Left (0 = disabled)": 10, "Start Message (RichText)": "<color=#ffd479>Loot Rush</color> started! Check your map.", "Warning Message (use {minutes})": "<color=#ffd479>Loot Rush</color>: <color=white>{minutes} minutes left!</color>", "End Message Header (RichText)": "<color=#ffd479>Loot Rush</color> ended!", "End Summary Message (use {category} and {count})": "<color=white>Category:</color> <color=#ffd479>{category}</color>\n<color=white>Loot Remaining:</color> <color=#ffd479>{count}</color>", "Play Start Notification Sound": true, "Start Sound FX #1 (empty = disabled)": "assets/bundled/prefabs/fx/invite_notice.prefab", "Start Sound FX #2 (empty = disabled)": "assets/bundled/prefabs/fx/item_unlock.prefab" }, "UI": { "Show UI": true, "UI Update Interval Seconds": 1.0, "UI Use Handwriting Font": true, "UI Proximity Mode (only show when near dome)": false, "UI Proximity Range (meters)": 350.0, "Title": { "Enabled": true, "Text": "<color=#ffd479>Loot Rush Event</color>", "Anchor Min (x y)": "0.35 0.90", "Anchor Max (x y)": "0.65 0.94", "Font Size": 19 }, "Time": { "Enabled": true, "Text": "Time Left: <color=#ffd479>{time}</color>", "Anchor Min (x y)": "0.35 0.85", "Anchor Max (x y)": "0.65 0.89", "Font Size": 16 }, "Players Inside": { "Enabled": true, "Text": "Players Inside: <color=#ffd479>{0}</color>", "Anchor Min (x y)": "0.35 0.80", "Anchor Max (x y)": "0.65 0.84", "Font Size": 16 }, "Category": { "Enabled": true, "Text": "Category: <color=#ffd479>{category}</color>", "Anchor Min (x y)": "0.35 0.75", "Anchor Max (x y)": "0.65 0.79", "Font Size": 16 }, "Loot Remaining": { "Enabled": true, "Text": "Loot Remaining: <color=#ffd479>{count}</color>", "Anchor Min (x y)": "0.35 0.70", "Anchor Max (x y)": "0.65 0.74", "Font Size": 16 } }, "Map Marker": { "Map Marker Enabled": true, "Map Marker Message": "LOOT RUSH EVENT", "Map Marker Radius (0.05 - 1.0)": 0.25, "Map Marker Alpha (0-1)": 0.7, "Map Marker Colour 1 (hex)": "#050505", "Map Marker Colour 2 (hex)": "#e5ff00" }, "Default Sphere": { "Fallback Sphere Prefab Key blue/green/purple/red": "blue", "Fallback Sphere Radius (yards)": 70.0, "Sphere Visual Scale Multiplier (2.0 = matches radius)": 2.0, "Sphere Lerp Speed": 60.0 }, "Spawn Validation": { "Minimum Loot Spacing (meters)": 3.0, "Prevent loot spawning on water": true, "Maximum Terrain Slope Degrees": 35.0, "Dome Area Sample Count": 36, "Maximum Bad Sample Fraction (0-1)": 0.25, "Per Loot Spawn Attempts Multiplier": 20 }, "Debug": { "Enabled": true } }
Data Files:
LootRush generates two data files:
Zone Categories
- /data/LootRush/Zones.json
Defines event categories and their loot profiles.
Allowed Loot Prefabs
- /data/LootRush/LootContainers.json
Defines which prefabs are allowed to spawn.
ZoneCategories Example:
{
"Default": {
"Enabled": true,
"Weight": 100,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "blue",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/bundled/prefabs/radtown/crate_basic.prefab",
"Amount": 16,
"Display Name Override (empty = auto)": "Basic Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab",
"Amount": 15,
"Display Name Override (empty = auto)": "Normal Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_tools.prefab",
"Amount": 13,
"Display Name Override (empty = auto)": "Tool Crate"
},
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-1.prefab",
"Amount": 16,
"Display Name Override (empty = auto)": "Loot Barrel"
},
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-2.prefab",
"Amount": 16,
"Display Name Override (empty = auto)": "Loot Barrel"
},
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/trash-pile-1.prefab",
"Amount": 14,
"Display Name Override (empty = auto)": "Trash Pile"
}
]
},
"Industrial": {
"Enabled": true,
"Weight": 50,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "green",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-1.prefab",
"Amount": 20,
"Display Name Override (empty = auto)": "Loot Barrel"
},
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-2.prefab",
"Amount": 20,
"Display Name Override (empty = auto)": "Loot Barrel"
},
{
"Prefab": "assets/bundled/prefabs/autospawn/resource/loot/trash-pile-1.prefab",
"Amount": 20,
"Display Name Override (empty = auto)": "Trash Pile"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_basic.prefab",
"Amount": 20,
"Display Name Override (empty = auto)": "Basic Crate"
}
]
},
"Military": {
"Enabled": true,
"Weight": 25,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "red",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab",
"Amount": 16,
"Display Name Override (empty = auto)": "Normal Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal_2.prefab",
"Amount": 14,
"Display Name Override (empty = auto)": "Normal Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal_2_food.prefab",
"Amount": 13,
"Display Name Override (empty = auto)": "Food Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal_2_medical.prefab",
"Amount": 13,
"Display Name Override (empty = auto)": "Medical Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_elite.prefab",
"Amount": 13,
"Display Name Override (empty = auto)": "Elite Crate"
}
]
},
"Roadsigns": {
"Enabled": true,
"Weight": 15,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "green",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/content/props/roadsigns/roadsign1.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign2.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign3.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign4.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign5.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign6.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign7.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
},
{
"Prefab": "assets/content/props/roadsigns/roadsign8.prefab",
"Amount": 6,
"Display Name Override (empty = auto)": "Road Sign"
}
]
},
"Jackpot": {
"Enabled": true,
"Weight": 5,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "purple",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/prefabs/npc/m2bradley/bradley_crate.prefab",
"Amount": 5,
"Display Name Override (empty = auto)": "Bradley Crate"
},
{
"Prefab": "assets/prefabs/npc/patrol helicopter/heli_crate.prefab",
"Amount": 8,
"Display Name Override (empty = auto)": "Helicopter Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_elite.prefab",
"Amount": 10,
"Display Name Override (empty = auto)": "Elite Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_normal.prefab",
"Amount": 12,
"Display Name Override (empty = auto)": "Normal Crate"
},
{
"Prefab": "assets/bundled/prefabs/radtown/crate_tools.prefab",
"Amount": 10,
"Display Name Override (empty = auto)": "Tool Crate"
}
]
},
"ChristmasLoot": {
"Enabled": true,
"Weight": 15,
"Sphere Radius (yards)": 40.0,
"Sphere Prefab Key blue/green/purple/red": "red",
"Marker Message Override (empty = default)": "",
"Loot": [
{
"Prefab": "assets/prefabs/missions/portal/proceduraldungeon/xmastunnels/loot/xmastunnellootbox.prefab",
"Amount": 8,
"Display Name Override (empty = auto)": "Xmas Tunnel Loot Box"
},
{
"Prefab": "assets/prefabs/misc/xmas/giftbox/giftbox_loot.prefab",
"Amount": 30,
"Display Name Override (empty = auto)": "Gift Box"
},
{
"Prefab": "assets/prefabs/misc/xmas/sleigh/presentdrop.prefab",
"Amount": 4,
"Display Name Override (empty = auto)": "Present Drop"
}
]
}
}
Optimizations:
- • minimal allocations
- • pooled collections where appropriate
- • optimized spawn validation
- • safe entity tracking
- • lightweight UI updates
Safe for high population servers.
Loot Rush works especially well on:
- • PvP servers
- • modded servers
- • high population servers
- • servers looking to create hotspot PvP encounters
Plugins By Duff