Custom Commands
Save your own console commands and Surge runs them every time your server starts. Great for anything the dashboard doesn't have a button for.
01Free and Premium
- Free: 5 custom commands.
- Premium: up to 50 custom commands.
If you drop back to Free, your newest extra commands are paused instead of deleted, and paused commands do not run on restart.
02What it does
Custom Commands is for the things Surge doesn't have a dedicated setting for. You give each one a name, type in a console command exactly as you would in your server console, and save it.
Every custom command is also added to My Settings, so it runs each time your server starts, right alongside your other saved settings. You don't have to remember to type it again after every restart.
03Adding a command
- 1Click Custom Command in the top right of the panel.
- 2Give it a Name so you'll recognise it later, up to 48 characters.
- 3Type the Command on a single line, up to 500 characters.
- 4Press Save (or hit Enter). Escape cancels.
It shows up in the list straight away with the status Runs on next boot.
04Running, editing and removing
- Run now (the play button): runs the command once on the server right away, so you can test it without waiting for a restart.
- Edit (the pencil): change the name or the command. Edits keep the command in the same spot in the boot order.
- Remove (the bin): deletes it from Custom Commands and from My Settings, so it won't run on boot anymore.
After a run, the status changes to Ran with a time, or Failed last run if the server didn't accept it. When something fails, you get a plain reason, like the server not replying in time or the connection dropping.
For some changes Surge can confirm the server really took it, and you'll see "the server confirmed the change". Otherwise a success means the server didn't report any problems.
05Limits and rules
- Up to 50 custom commands per server.
- One command per entry. If you need three commands, make three custom commands.
- Names have to be unique on the server (capital letters don't make a name different).
- Commands that restart, stop or shut down the server are blocked. They'd run on every boot and keep your server in a restart loop forever.
- Run now needs the server to be connected, and it's blocked while your saved settings are being applied.
06Tips
Always hit Run now after saving a new command. If it fails, you find out now instead of after your next restart.
Name commands after what they do, not what they say. "Night lasts longer" is much easier to spot in My Settings than a copy of the command.
Surge runs exactly what you type. Double-check a command before saving it, because it will run on your live server on every boot.