Matter Orb
Matter Orb is a NeoForge 1.21.1 item drop protection mod.
When a large number of dropped items appear in the world at once, it compresses them into a single "matter cluster", reducing entity count, alleviating lag, and giving players a brief grace period to recover from accidents. The matter cluster is not a backpack, nor a long-term storage system.
By default, newly dropped items of the same type near an existing matter cluster are kept for 30 seconds for players to pick up; only after 30 seconds have passed without being picked up will they be automatically absorbed into the cluster. When no existing matter cluster is present, large quantities of drops will still be compressed immediately upon reaching the trigger threshold.
Features
- Large quantities of dropped items are automatically compressed into matter clusters.
- Drops near an existing matter cluster are first kept for 30 seconds, then automatically absorbed after timeout.
- Supports block drops, entity death drops, and existing world drops.
- Multiple matter clusters will attempt to merge when near each other.
- When a container is nearby, the matter cluster prioritizes inserting items into it.
- The matter cluster entity prevents hoppers from directly extracting items, while preserving recovery information after automated transport.
- When a player approaches a matter cluster, items are gradually returned to the player's inventory.
- Supports matter cluster destroyers for deleting unwanted cluster contents.
- Normal matter clusters automatically expire after 15 minutes of idleness; this can be disabled in configuration.
- Empty matter clusters persist briefly to continue receiving nearby drops.
- Items manually dropped by players or dropped on death are not immediately returned to the inventory.
Default Configuration
Optional presets:
SAFE: More conservative, suitable for weaker servers.BALANCED: Compromise configuration.PERFORMANCE: Faster cleanup, suitable for high-performance environments.EMERGENCY: Default, strongest accident recovery capability.
Player drop modes:
| Mode | Normal Drop | Sneak Drop | Death Drop |
|---|---|---|---|
OFF |
Not absorbed | Not absorbed | Not absorbed |
NEAR_ORB |
Only enters nearby existing cluster | Only enters nearby existing cluster | Does not actively create new cluster |
SNEAK_NEAR_ORB |
Vanilla behavior | Enters nearby existing cluster | Does not actively create new cluster |
INTENTIONAL |
Enters nearby existing cluster | May enter nearby cluster, or create new cluster on large drops | Does not actively create new cluster |
THRESHOLD |
Absorbed after 30s if nearby cluster exists; creates new cluster when reaching threshold if none exists | Absorbed after 30s if nearby cluster exists; creates new cluster when reaching threshold if none exists | Absorbed after 30s if nearby cluster exists; creates new cluster when reaching threshold if none exists |
ALWAYS |
Treated like normal world drops | Treated like normal world drops | Treated like normal world drops |

