This plugin helps improve your server performance by combining scattered dropped items that're close to one another into a single dropped item container. It's especially useful during raids or when bases decay, as it prevents the increase in entity count caused by numerous items dropping on the ground.
How It Works
If you drop an item and there are no other items nearby within the detection radius, it will remain as it is. However, if multiple items are dropped close together and their count meets or exceeds the configured threshold, they will be grouped into a single container after a short delay. Items spread out beyond the detection radius will stay as individual items.Configuration
JSON:
{
"Version": "1.2.0",
"Duration Before Grouping Items Seconds": 5.0,
"Number Of Nearby Items Needed For Grouping": 6,
"Detection Radius For Nearby Dropped Items": 4.0,
"Dropped Item Container Fallback Despawn Time Seconds": 300.0,
"Item Categories To Exclude From Grouping ": [
"Weapon",
"Ammunition"
]
}Duration Before Grouping Items Seconds- The time in seconds to wait before checking and grouping nearby dropped items.Number Of Nearby Items Needed For Grouping- The minimum number of dropped items required nearby to trigger grouping into a container.Detection Radius For Nearby Dropped Items- The radius within which dropped items are detected and considered for grouping.Dropped Item Container Fallback Despawn Time Seconds- The minimum lifespan in seconds for the dropped item container before it's removed. The actual removal time is dynamically calculated based on the items inside the container. The final removal time will be the greater of the calculated time and your configured minimum. This ensures containers never despawn too quickly.
Example:- If your minimum despawn time is set to 30 seconds:
- Scenario 1: If the container’s calculated removal time based on its contents is 20 seconds, it will be adjusted to 30 seconds.
- Scenario 2: If the calculated removal time is 60 seconds, it remains at 60 seconds.
- If your minimum despawn time is set to 30 seconds:
Item Categories To Exclude From Grouping- A list of item categories to exclude from being moved into the dropped item container. The categories are:- Weapon
- Ammunition
- Construction
- Items
- Resources
- Attire
- Tool
- Medical
- Food
- Traps
- Misc
- All
- Common
- Component
- Search
- Favourite
- Electrical
- Fun
Developer Hooks
C#:
void OnDroppedItemContainerSpawned(DroppedItemContainer droppedItemContainer, List<DroppedItem> groupedItems)- Called after a dropped item container is spawned and items are grouped into it.
- No return behavior.
