Skip to content

Delivery Modes

Jump to bottom
Morph edited this page Jul 22, 2026 · 1 revision

ColonyLink can hand materials to a builder in two ways. The choice is made on the server, in colonylink-server.toml, under [delivery] send_target.

BUILDER (default)

Materials go straight into the Builder's Hut. No courier is involved.

This is the original behaviour of the mod and the reason most people install it. It is fast, it works while your colony is busy, and it never gets stuck behind a courier who is asleep, hungry, or on the other side of the map.

The tradeoff is that it bypasses a MineColonies mechanic. If your colony is meant to feel like a logistics chain, this shortcuts part of it.

WAREHOUSE

Materials go into the colony Warehouse instead, and a MineColonies courier picks them up and delivers them to the builder.

Slower, and it depends on your courier staffing, but it keeps the delivery loop intact. If you are building a pack where the colony economy is supposed to matter, this is the mode you want.

Two things behave differently in this mode:

  • A resource you have already sent shows a greyed out Sent line until the courier actually delivers it. That state is stored per Clipboard and survives a relog. It clears on its own once the delivery goes through.
  • Tool substitution is turned off. The courier gets exactly the item that was requested, because a substituted tool would not match the request and the delivery would never resolve.

Which one to pick

For a private world or a small server, BUILDER is the sensible default and the mod is designed around it.

For a curated modpack, WAREHOUSE is worth considering. It keeps couriers relevant and slows resource flow enough that the colony still feels like a colony.

How the setting is applied

send_target lives in the server config, so it is authoritative. It is sent to every client when they join, and a player cannot override it locally. Set it once and it applies to everyone on the server.

Changing it at runtime with /colonylink config set takes effect on the server straight away. Clients already connected pick up the new value the next time they reconnect.

Clone this wiki locally