Custom Events
Build your own timed events: pick what spawns, where it spawns and how often. Surge spawns it on a loop, posts your message in game, and can wait until enough players are online.
01Free and Premium
- Free: 1 custom event.
- Premium: as many as you like.
If you drop back to Free, your newest extra events are paused instead of deleted.
02What it does
Custom Events let you drop things onto the map on a schedule. A locked crate at Dome every two hours, a few helis over the oil rig once a day, whatever fits your server. You choose the entities, the exact spot for each one, how many of each, and how often the whole thing repeats.
Every time the event fires, Surge spawns everything on your list and then sends your Trigger Message in game so players know something just landed.
- As many events per server as you like, each with its own schedule.
- Up to 50 entities per event, and each entity can spawn up to 100 times. Sulfur, stone and metal nodes get a tiny millimetre offset between each copy so they are not stacked in the exact same spot.
- An optional Pop Trigger so the event only fires when the server is busy enough.
- A ready-made Locked Crate Event template to get you started.
03Building an event
Open Events > Custom Events. You land on the Build Event tab, which walks you through five boxes.
- 1Name Your Custom Event. Give it a clear name (up to 120 characters). This is just for you, it shows in My Events.
- 2Add Entities. Hit + Add entity, pick a category (Crates, Interactables, Vehicles, Animals, World) and tap what you want, or search by name. Each entity gets its own card with a quantity and X, Y and Z boxes.
- 3Trigger Message. Write the announcement players see in game when the event spawns. The preview underneath shows roughly how it will look.
- 4Discord and pre announcements. Optional. A Discord message can go out when the event spawns. A Discord pre message and an in-game pre message go out 10 minutes before the scheduled start. Any pre message you write has to include
{time}, which is filled in as 10 minutes. The in-game line joins the message queue. Linked custom events follow the PvP event clock, so they use that event for the 10 minute warning. Surge remembers which announcements already went out, so a bot restart does not send the same Discord message again. - 5Time Cycle. Set how often it runs, for example every 2 hours. You can pick minutes, hours or days.
- 6Pop Trigger. Optional. Leave it blank to ignore player count, or enter a number from 0 to 100.
- 7Press Save Event. It shows up in My Events and is switched on straight away.
Not sure where to start? Open the Template Menu and load Locked Crate Event. It fills in a hackable locked crate, a message, a 2 hour cycle and a pop trigger of 10. Then you only need to add the coordinates.
04Coordinates and Use my Location
Every entity needs an X, Y and Z position, otherwise Surge has nowhere to put it. You can type the numbers in yourself, but the easy way is the Use my Location button on each entity card.
- 1Join your server in game and walk to the exact spot where you want the thing to spawn.
- 2In the dashboard, press Use my Location on that entity.
- 3Surge reads where your character is standing and fills in X, Y and Z for you.
The Qty box decides how many separate spawns happen at those coordinates. Qty 3 means three of that entity, all at the same spot.
Use my Location only works if you have linked your in-game name, you are online on that server right now, and the bot is connected. If any of those is missing you will get a message telling you which one.
An entity saved without coordinates is simply skipped when the event runs. If an event fires but nothing appears, check that every card has X, Y and Z filled in.
05How the schedule works
A new event does not fire the moment you save it. The first spawn happens one full cycle later. After that it repeats on your Time Cycle.
If you set a Pop Trigger, Surge checks how many players are online when the event is due. If there are fewer than your number, it holds off and keeps checking, then fires as soon as enough people are on. Leave it blank and it fires on time no matter how empty the server is.
Big events can take a little while to finish spawning. If the server gets busy, Surge picks up where it left off a little later instead of starting over.
The Trigger Message is only sent if at least one thing actually spawned, so players never get told about a crate that is not there.
06Managing your events
The My Events tab lists every event on the server with little chips showing its cycle, pop trigger, how many entity types it has and the total number of spawns. Each card also lists the entities with their coordinates.
- Edit loads the event back into the builder. Change what you need and press Update Event.
- ON / OFF pauses or resumes the event without deleting it.
- Delete removes it for good. You will be asked to confirm because this cannot be undone.
07Linking a custom event to a PVP event
You can hook a custom event onto a PVP event, for example to drop loot into the arena every time a fight starts. You set this up from the PVP event side, under Link Event.
- While linked, the custom event stops running on its own schedule. It spawns when the PVP event starts instead.
- Its Time Cycle and Pop Trigger boxes are locked and show the PVP event's settings. Your own values are kept and come back if you unlink it.
- My Events shows a chain icon with the PVP event's name, plus Live now while that fight is running.
- The custom event still has to be switched ON, otherwise it is skipped when the PVP event starts.
When the PVP event ends, Surge clears away every entity of the linked types on the map, not just the ones that event spawned. Keep that in mind if you use the same entity elsewhere.
08Good to know
- Events only run while the bot is connected to your server. If the connection drops, nothing spawns until it comes back.
- Deleting a custom event also removes it from any PVP event it was linked to.
- Messages support the same colour and size formatting you use elsewhere in Surge. Check the preview before saving.