item_magnet
Pulls nearby dropped items toward the holder while active, optionally restricted to specific item types.
Categories: inventory, movement
Required arguments
| Key(s) | Description | Type |
|---|
radius | The radius within which dropped items will be pulled, in blocks. Supports expressions. | EXPRESSION |
Optional arguments
| Key(s) | Description | Type | Default |
|---|
items | A whitelist of item types to attract. If empty, all items are attracted. | ITEM_LIST | [] |
exclude_items | A blacklist of item types to never attract, checked after the whitelist. | ITEM_LIST | [] |
pull_strength | How strongly items are pulled per tick. Supports expressions. | EXPRESSION | 0.3 |
Example
effects:
- id: item_magnet
args:
radius: 5 + %level% * 0.5
items: <value> # ← Optional
exclude_items: <value> # ← Optional
pull_strength: 0.1 + %level% * 0.02 # ← Optional
Behaviour
| Setting | Value |
|---|
| Run order | NORMAL |
| Supports delay | true |
| Reloads on plugin reload | true |