92 lines
1.7 KiB
Markdown
92 lines
1.7 KiB
Markdown
# Configuration
|
|
|
|
The configuration file is located at:
|
|
|
|
`plugins/RS-ItemMagnet/config.yml`
|
|
|
|
## Current Settings
|
|
|
|
```yaml
|
|
# Default scan radius for RS-ItemMagnet to scan for dropped items.
|
|
default-radius: 10
|
|
|
|
# Maximum radius players may set their RS-ItemMagnets to.
|
|
# 0 = Unlimited.
|
|
max-radius: 25
|
|
|
|
# Seconds allowed to select a target Container.
|
|
conversion-timeout: 30
|
|
|
|
# Distance in blocks ABOVE and BELOW the magnet
|
|
# that items may be collected from.
|
|
#
|
|
# 0 = Unlimited (legacy behavior)
|
|
# >0 = Limit vertical collection distance.
|
|
item-y-distance: 0
|
|
|
|
# Whether OP players bypass permissions checks
|
|
admin-bypass: true
|
|
|
|
# Enable debug logging.
|
|
debug-mode: false
|
|
```
|
|
|
|
## `default-radius`
|
|
|
|
Sets the starting collection radius for newly created ItemMagnets.
|
|
|
|
Default:
|
|
|
|
`10`
|
|
|
|
## `max-radius`
|
|
|
|
Sets the maximum radius players may configure on an ItemMagnet.
|
|
|
|
`0` means unlimited.
|
|
|
|
Default:
|
|
|
|
`25`
|
|
|
|
## `conversion-timeout`
|
|
|
|
Sets how many seconds a player has to select a target container during conversion.
|
|
|
|
Default:
|
|
|
|
`30`
|
|
|
|
## `item-y-distance`
|
|
|
|
Controls the vertical collection distance above and below the magnet.
|
|
|
|
- `0` = unlimited vertical distance, preserving the legacy behavior.
|
|
- `1` = collect up to 1 block above and 1 block below.
|
|
- `2` = collect up to 2 blocks above and 2 blocks below.
|
|
- Higher values increase the allowed vertical distance accordingly.
|
|
|
|
Default:
|
|
|
|
`0`
|
|
|
|
## `admin-bypass`
|
|
|
|
When enabled, OP players can bypass permission checks used by the plugin.
|
|
|
|
Default:
|
|
|
|
`true`
|
|
|
|
## `debug-mode`
|
|
|
|
Enables additional debug logging for troubleshooting.
|
|
|
|
Default:
|
|
|
|
`false`
|
|
|
|
## Configuration Migration
|
|
|
|
RS-ItemMagnet checks for missing configuration settings when it starts. New settings can be added to an existing configuration without replacing the server owner's existing values.
|