Wifi Hoppers

!(https://cdn.modrinth.com/data/cached_images/1a67ab156e5f6b9d91819ec809a5f14f6ef9f00a.jpeg)

# Overview WifiHoppers replaces vanilla hopper logistics with wireless container links. Place a special hopper block, open its menu, upgrade stats with in-game currency, and route items to chests, furnaces, crafters, and more — without running hopper chains through the world.

The plugin is built for high-player-count survival servers: region-safe ticking on Folia, optional batch processing on Paper, player-chunk activity gating, and optional stacked-item support (WildStacker).

## Core features ### Wireless hoppers - Place a Wifi Hopper item to register a managed hopper at that location. - Break the block to recover a hopper item with saved levels, type, and link count on the item lore. - Data is stored in a local SQLite database (bundled driver — no external DB setup).

### Container linking - Link hoppers to any inventory holder in the same world: chests, barrels, shulker boxes, furnaces, blast furnaces, smokers, campfires, crafters, etc. - No physical hopper chain required — items teleport from the hopper inventory to linked targets within your configured distance. - Per-link limits based on upgrade level (up to 36 link slots in the GUI, actual max links from upgrades). - Reorder links (priority), rename links, and remove links from the menu. - Link validation: same world, distance cap, duplicate prevention, max links.

### Item suction (pickup) - Pulls ground items into the hopper inventory on a configurable tick interval. - Normal hopper: spherical radius around the hopper (upgradeable). Radius 0 = vanilla-style pickup from the block above only. - Chunk hopper: sucks items from loaded chunks in a chunk-radius around the hopper (for large farms). - Respects hopper inventory space and optional filter rules when links exist. - WildStacker : correctly handles stacked item entities when plugin is installed.

### Item transfer (output) - Moves items from the hopper inventory into linked containers on a separate tick interval. - Transfer amount per cycle is upgradeable (e.g. 8 → 320+ items per cycle on normal type). - Supports furnaces (input + fuel slots only, never output), crafters (respects disabled slots), and normal inventories.

### Advanced routing - Insert by order (ON/OFF): - ON: first matching link gets items first. - OFF: distribute evenly across matching links. - Delete non-filter items (ON/OFF): - ON: items that match no filter are voided (suction can collect everything; routing deletes rejects). - OFF: unmatched items stay in the hopper or go to unfiltered “overflow” links. - Filter priority: STRICT filters → TYPE/NAMED → unfiltered overflow links.

### Per-link filtering Each link has its own filter GUI:

• Filter mode
• - WHITELIST or BLACKLIST
• Match type
• - TYPE (material), STRICT (exact item + NBT), NAMED (display name)
• TYPE filters
• - Click items in your inventory to add/remove materials
• Shulker filters
• - Empty/full shulker occupancy tokens (TYPE mode)
• STRICT filters
• - Full item serialization — exact stack matching
• Clear filters
• - One-click reset

Default new links: WHITELIST + TYPE.

### Upgrades (GUI + economy) Four upgrade tracks per hopper type, paid via Vault (if installed; free when Vault is absent):

1. Links — max simultaneous container links 2. Transfer — items moved per transfer cycle 3. Suction radius — pickup range (blocks or chunks depending on type) 4. Link distance — how far away targets can be

All costs and level values are defined in hoppers.yml (UpgradeableHoppers-style layout).

### Active suction tuning - Separate from max suction upgrade: set active pickup radius per hopper (increase/decrease in GUI). - Lets players cap lag on busy farms without downgrading purchased upgrades.

### Hopper types Configurable in hoppers.yml:

• Normal
• - Block-radius item pickup, high link/transfer ceilings
• Chunk
• - Chunk-based pickup for large item farms; different upgrade curves

Give types with /hopper get .

### Controls - Left-click hopper -> Open upgrade & link menu - Right-click hopper -> Open vanilla hopper inventory - Break hopper -> Drops hopper item with saved stats - Link mode -> Menu → “Link to Containers” → left-click a container - Rename link -> Shift + right-click link in menu → type name in chat (clear to reset) - Reorder link -> Shift + left-click (up) / right-click (down) - Remove link -> Press Q (drop) on link icon in menu

### Commands permissions wifihoppers.get - /hopper get - Give wireless hopper item(s) - /hopper types -List configured hopper types

wifihoppers.admin - /hopper reload - Reload config + hoppers.yml + runtime - /hopper import - Re-import from UpgradeableHoppers DB

Aliases: hoppers, h, uhopper, uhoppers, uh, uhr, wifihopper, wifihoppers, wh Legacy permissions: uhr.get, uhr.admin (same as above)

### Configuration

config.yml ``` engine: tick-interval: 2