rotatable funnel

This mod adds a rotatable funnel to the game, as well as optional filter funnel functionality!

Rotatable funnel

🚀 ** Revolutionize your Stardew Valley hopper system! ** Adds full directional control and advanced filtering to the regular funnel!

---

✨ Core Functions

**Omni-directional direction control** - Allows the funnel to transport items in any direction, no longer limited to the original downward transport!

• **Upward Funnel**: Pull items from below and push them upwards
• **Downward Funnel**: Pull items from above and push them below (original behavior + filtering)
• **Left Funnel**: Pull items from the right and push to the left
• **Right Funnel**: Pull items from the left and push to the right

🎮Various control methods

• **Modifier Keys**: Hold down Shift/Ctrl/Alt when placing the funnel to quickly select the direction
• **Hotkey Cycle**: Use the [ and ] keys (or controller triggers) to cycle through directions
• **Right-click to cycle**: Shift+right-click on an existing funnel to change direction
• **UI Button**: Interactive directional button in the funnel inventory interface
• **Console commands**: left_hopper, up_hopper, right_hopper quick creation

🔍 Advanced filtration system

• **Item Filter**: Use items in the hopper inventory as a filter
• **Quality Filter**: Match items by star quality (optional)
• **Quantity Limit**: Set the maximum number of transfers (optional)
• **Smart Match**: Handle processed items like flavored wine and jellies
• **Filter Switch**: Disable filtering for high-speed bulk transfers

👁️ Visual Indicators

• **Direction Arrow**: The customizable color arrow above the funnel shows the direction of transfer.
• **Customized sprite**: exquisite UI direction selection button
• **21 color options**: black, blue, green, red, purple and more
• **Performance Optimization**: Render arrows only when needed

⚡ Performance optimization

• **High Throughput**: transfer up to 20 groups of items per cycle when filtering is enabled
• **Smart Indexing**: Pre-index target containers for faster transfers
• **Adaptive Processing**: Reduce processing frequency when filtering is disabled
• **Unlimited Chest Support**: Optimized handling of unlimited storage of modules

⚙️ Easy configuration

• **General module configuration menu** integrated, can be set in the game
• Configure hotkeys, visual options and filtering behavior
• **CONTROLLER SUPPORT**: Full gamepad compatibility
• **Independent settings for each archive**: different farms use different configurations

🔧 How it works

This mod uses Harmony patches to override vanilla hopper behavior while maintaining full compatibility. Each directional funnel:

• Pull items from the specified source direction
• Apply filtering based on items in inventory (if enabled)
• Push items in the target direction
• Use with boxes and machines
• Process transfers every 1-2 seconds for real-time automation

📦 Installation and Compatibility

• Install SMAPI (required)
• Install universal module configuration menu (recommended for simple configuration)
• Place this mod into the Mods folder
• Compatible with Automate, Chests Anywhere and most storage/automation mods

🎯 Applicable scenarios

• **Factory Builder** Create complex production lines
• **Perfectionist** needs precise item routing
• **Creative Builder** Design sophisticated automation systems
• **Quality of life enthusiast** wants a smarter funnel

💫 **Revolutionize your farm logistics systems with directional funnels and make them work the way you want! **