InstantHaul — Auto-collect drops & unclog production

[ COMPATIBILITY ]

WARNING: NOT recommended on dedicated servers. Untested, and it may cause lag without actually working. Verified on single-player and hosted sessions only.

Your Pals haul one item per trip. Your quarry hits 9,999 and stops. Your base floor is covered in loose drops eating your framerate.

InstantHaul fixes all three. Items inside your base move into your chests automatically -- and now everything is controlled from an in-game settings menu (ESC), including where things go.

[ WHAT IT DOES ]

- Floor drops are collected into a chest in the same base.

- Production facilities (Stone Pits, Logging Sites, Oil Rigs) no longer sit at max stack blocking further work.

- Conversion facilities (Furnaces, Cooking Pots, Workbenches, Medicine Workbenches): only the finished-product slot is taken. Input materials are never touched.

- Choose when facility output is pulled: on schedule / by item count / by percent. Percent uses order progress for crafting stations (e.g. 33% / 67% / done), or slot fill for endless producers like quarries. If production finishes or stalls, the remainder is taken even below the threshold.

- Guild Chest support: your in-game guild chest filter ("Chest Settings") is fully respected. Checked categories go in, everything else falls back to normal chests automatically.

- Storage Priority tab: choose where dishes, ingredients and everything else go first (Feed Box, Refrigerator, normal chest, Guild Chest, a chest holding the same item, a chest holding the same category, or the nearest chest).

- Detail tab: per-category rules using the exact same categories as the game's chest filter (weapons, ammo, blueprints, treasures and more). Pick "Same Category" and items gather into a chest that already holds that category -- perfect for a blueprint chest or a key chest. Seed the chest with one item and the rest is automatic.

- Distance-aware processing: your current base runs on short intervals (default 2s), remote bases on longer ones (default 8s/30s), reducing load and traffic.

- Per-base isolation: each base's items go to that base's chests. The one exception is the Guild Chest, which the game itself shares across bases (items are always deposited via that base's own guild chest).

- A facility with "Allow Pals to transport" switched off is left alone.

[ DEFAULT BEHAVIOUR - what happens if you touch nothing ]

- Dishes go to the Feed Box first, ingredients to the Refrigerator first (falling back when full or absent). - Bulk resources (wood, stone, ore, ingots, pal materials...) go to the Guild Chest FIRST -- but only the categories you checked in the guild chest's own filter; rejected items fall back to normal chests. - Equipment and collectibles (weapons, armor, ammo, spheres, blueprints, skill fruits, upgrade items, treasures...) gather into a chest already holding the same category. If no such chest exists they go to the nearest normal chest, with the Guild Chest as the last resort.

Don't want guild-first? Change "Everything Else" in the Priority tab, or turn off "Use Guild Chest" in the General tab. Want everything in the guild chest instead? Set the Detail tab categories to "Guild Chest".

[ CONFIGURATION ]

Open the settings page from the ESC menu (InstantHaul button). No file editing required.

- General tab: on/off, language (English/Korean), four haul intervals (near/far x drops/facilities), near radius, guild chest, food routing, debug logging, mod restart - Priority tab: first-choice storage for dishes / ingredients / everything else - Detail tab: per-category rules (Default / Guild Chest / Same Item / Same Category / Nearest Chest)

Saving writes settings.ini next to the mod and applies immediately -- interval changes take effect next cycle, no restart. You can still edit Scripts/config.lua directly (settings.ini wins).

Advanced items (Feed Box exclusions, items to leave on the ground) live in the CONFIG table at the top of Scripts/main.lua.

The settings page only shows the rows that matter for your chosen pull trigger - pick "By Item Count" and only the count row remains.

* The visible rows change AFTER you press Apply. Cycling the trigger without applying still shows the previous rows.

[ WHY IT'S SAFE ]

InstantHaul never creates or deletes an item.

It calls the same server request the game uses when you drag an item between containers in the UI. The game performs the move and the cleanup. If a request fails, the item stays where it was and is retried into a different chest next cycle. There is no code path in this mod that can make an item disappear.

Other safeguards: - Facilities are whitelisted. Feed Boxes, Incubators, Breeding Farms, Raid Altars and Team Missions are never candidates. - The finished-product slot index is read from the facility itself. There is no code path to a material slot. - Base membership is asked of the game, not guessed from a radius. Works with base-area expansion mods. - Operations pause for 10 seconds after fast travel. - Internal scheduling is self-managed, closing a UE4SS-level issue where mods could silently die around fast travel. - The settings menu switches everything off instantly.

[ VERIFIED ]

Tested on a save with 4 bases, 30 containers and 41 facilities: 12 predicted item counts, 12 matches. No loss, no duplication. A quarry clogged at x9999 (max stack, Pals idle) resumed production after collection.

Category definitions are read from the game's own data, so they always match the in-game chest filter exactly.

[ REQUIREMENTS ]

UE4SS Experimental (Palworld). Subscribe to it under Required Items, then enable BOTH in Options > Mod Management.

[ COMPATIBILITY ]

Confirmed working alongside IntegratedStorage, GutenDropItemMerger, GutenMassiveBaseArea, GutenAutoUnlockTech, PalSquadAllOut, Immersive-Palworld, PalSchema and Pal List Searchbar.