2.2 KiB
Usage
Creating an ItemMagnet
An ItemMagnet is based on a lodestone.
The current conversion process requires the player to use the plugin's required conversion item on the lodestone and then select a target container.
Supported target containers are:
- Hopper
- Chest
- Barrel
Main Menu
Interacting with an ItemMagnet opens its main configuration menu.
The current menu provides controls for:
- Convert Back — restores the lodestone from the ItemMagnet.
- Running / Paused — pauses or resumes the machine.
- Radius — opens the radius configuration menu.
- Show Radius — closes the menu and displays a temporary particle outline of the collection radius to the player.
- Target Container — assigns or changes the container used for deposits.
- Filter — configures item filtering.
- Admin — opens administrative controls when permitted.
Radius
The radius controls how far the ItemMagnet searches for dropped items.
The current scanner uses the configured radius on the X, Y, and Z axes. The optional item-y-distance configuration setting can limit the vertical collection distance above and below the magnet.
The radius menu provides:
-10-5-1+1+5+10
The configured maximum radius is enforced when players increase the radius.
Radius Preview
Select Show Radius from the main menu to display the collection boundary temporarily.
The preview is visible only to the player who requested it and shows the collection area without creating a permanent world effect.
Target Containers
An ItemMagnet can deposit into a hopper, chest, or barrel.
The target can be assigned during conversion and can later be changed from the main menu.
While selecting a target, normal interaction with non-container blocks remains available. Selecting a valid hopper, chest, or barrel assigns it as the target.
Filters
The filter menu allows the ItemMagnet to control which item types it accepts.
Filter modes and individual filter entries are managed through the ItemMagnet inventory menus.
Pause and Resume
The main menu displays the current machine state. A running ItemMagnet can be paused and resumed without converting the machine back into a normal lodestone.