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