About SF-Cargo

SF-Cargo is a lightweight standalone cargo-network plugin inspired by Slimefun-style cargo management. It provides just the cargo system: managers, connectors, input nodes, and output nodes, without the rest of Slimefun’s machines, guide, research, energy, or item ecosystem.

Build compact storage networks, route items by channel, and move materials safely across connected cargo nodes on Paper and Folia servers. Think of this plugin as a far better version of item transport pipes

What’s in the Plugin
SF-Cargo focuses on a small, server-friendly feature set:

Cargo Managers that discover and coordinate connected cargo networks
Cargo Connectors that extend networks up to 6 blocks apart in straight lines
Cargo Input Nodes that pull items from attached inventories
Cargo Output Nodes that insert items into supported storage blocks
16 cargo channels per network
Input filters with whitelist/blacklist behavior
Smart-fill and round-robin movement options
Clickable admin manager list with teleport links
Worker-loop TPS diagnostics for admins
Folia-safe inventory handling with Paper fallback support
Folia And Paper Support
SF-Cargo coordinates cargo logic on its own worker loop, while all live world and inventory access is scheduled safely back to the owning Folia region. On regular Paper servers, inventory work falls back to the main server thread.

This keeps the plugin compatible with Folia’s threading rules while still avoiding unnecessary work on the main game loop.

Safety And Anti-Dupe Design
SF-Cargo is built conservatively around item safety.

Before an input node removes items, the plugin checks destination capacity and only withdraws the amount that can actually fit. Moves are tracked by an in-memory journal, allowing partial moves to complete or roll back during normal runtime interruptions.

If a rollback needs to finish and the relevant chunk is no longer loaded, SF-Cargo may temporarily load that chunk, finish the pending rollback, and then release it. This is only used to finish already-started moves, not to keep unloaded cargo networks running.

Output nodes are currently limited to normal storage-style containers:

Chests
Trapped chests
Barrels
Shulker boxes
Hoppers
Droppers
Dispensers
Shulker boxes cannot be inserted into other shulker boxes.

Admin Tools
SF-Cargo includes simple admin commands:

/sfcargo give <manager|connector|input|output>
/sfcargo reload
/sfcargo list
/sfcargo tps
/sfcargo list shows known cargo managers, owners, UUIDs, locations, and clickable teleport links.

/sfcargo tps shows cargo loop health, queued inventory moves, transport wait time, and journal status so admins can tell whether the plugin is keeping up or whether inventory work is backing up behind Folia/Paper scheduling.

Recovery
Cargo block records are stored in plugins/SF-Cargo/blocks.yml. Placed cargo heads also receive a small SF-Cargo marker so that if the YAML file is lost, marked blocks can still drop the correct SF-Cargo item when broken. Re-place the item to register it again.

Old settings like filters, channels, ownership, and manager UUIDs are not recovered from the marker.

Scope Notice
SF-Cargo is not Slimefun and does not include the full Slimefun experience. It is only a standalone cargo management plugin.

If you want the complete Slimefun gameplay system, install the official Slimefun4 plugin.

Here is a tutorial video on how to use it.
https://www.youtube.com/watch?v=MWBYo7NqPak