Docked Cargo

01Premium

02What it does

Normally cargo sails around the map and players have to chase it. Docked Cargo parks the ship somewhere you pick, like a harbour, so it becomes a proper fixed fight. It stays docked for the event duration, locked crates appear on it during that time, and then it is released and sails away.

There is one Docked Cargo setup per server. It is off by default. Flip the switch at the top to turn it on and the settings appear.

03Setting it up

1. 1Open Events > Docked Cargo and turn the switch ON.
2. 2Event name. Optional, up to 48 characters. It defaults to "Docked Cargo" and fills in {eventname} in your messages.
3. 3Interval. How long to wait between events. The default is every 2 hours, and it can be up to 30 days.
4. 4Event Duration. How long the ship stays docked. Default 30 minutes, minimum 5 minutes, maximum 7 days.
5. 5Docked cargo location. Stand in the water where you want the ship to dock and press Use my Location, or type X, Y and Z.
6. 6Pop Trigger. Optional, 1 to 100 players. This box appears once a location is set.
7. 7Locked crates. Choose between 1 and 5 crates. The default is 3.
8. 8Press Save Docked Cargo. Nothing runs until a location has been saved.
9. 9Discord and pre announcements sit with the messages. The live Discord message posts when the ship docks. The pre messages, Discord and in game, go out 10 minutes before that. Write {time} in each pre message you use. It is filled in as 10 minutes, and the in-game one joins the message queue. Already-sent Discord messages are remembered across bot restarts.

04Locked crates

The crates do not all appear at once. They show up one at a time, spread evenly across the event, so every one of them is out before the ship leaves. The gap is never more than 10 minutes. The dashboard tells you roughly how far apart they will be for your chosen duration.

For example, 3 crates over 30 minutes means one about every 10 minutes.

05What happens during a run

1. 1When the interval is up, Surge checks your Pop Trigger (if you set one) and waits until enough players are online.
2. 2It also checks that no other cargo ship is already on the map. If one is, it waits until that ship has gone, so you never get two.
3. 3The ship spawns at your location and stays put. Your Announcement Message goes out.
4. 4Locked crates appear one by one during the event.
5. 5When the duration is up, the ship is released. It starts moving again, carries on round the map like a normal cargo ship and leaves on its own. Your Event Complete Message goes out.
6. 6The interval starts again from the moment the ship was released. The next docked cargo only spawns once this one has left the map.

While the ship is docked, Surge takes care of the cargo timing for you. Your normal cargo settings come back once the ship has left the map.

06Run Event Now and the status bar

The status bar at the top shows whether the event is waiting, live or leaving, and when the next one is due. If it is held up, it tells you why, for example not enough players online or another cargo ship on the map.

Run Event Now starts it right away and skips the interval and the pop trigger. If you have unsaved changes, the button becomes Save & Run Now and saves them first.

• It is blocked if no location is set, if the bot is offline, if the event is already live, or if the last ship is still sailing off.
• It also refuses if any cargo ship is already on the map. Wait for it to leave, then try again.

07Messages

• Announcement Message: sent when the docked cargo goes live.
• Event Complete Message: sent when the event ends and the ship leaves.

Both support {eventname}, both have a live preview and a Reset to default button, and both need some text before you can save.

08Good to know

• Turning Docked Cargo off while it is live releases the ship and it sails off the map. You will be asked to confirm.
• Docked Cargo only runs while the bot is connected to your server.
• If the ship cannot be placed, the status shows Retrying shortly and Surge tries again a minute later.