Hosting a server

A simple guide for hosting your very own goonstation server, for all people of all computers, no previous admin experience, dedicated hardware, or technical know-how required. Shamelessly stolen Borrowed with permission and modified/updated from a forum post by Haine.

Get a copy of a server's code

Here is the code for Goonstation's last release, from February 2020. You can click the green Clone or Download button on the right side of that page, and then Download ZIP, or if you know how to use git, do that. For this guide, we will simply download it.

Compile the server

Unzip your chosen code somewhere or navigate to where git downloaded it. Open the .DME file (in goonstation's case this is goonstation.dme). It should load up in Dream Maker (if not, use Open With to make sure it does open with DM). Once Dream Maker loads up (it might take a couple minutes), go to Build -> Compile, seen here:

<img src="https://i.imgur.com/inWcjlr.png">

Or hit CTRL+K.

It will take a few minutes to finish compiling. Once it does, if no errors have occurred, you're ready for the next step. A successful compile should look somewhat like this (by default the server compiles with different maps):

<img src="https://i.imgur.com/YCitJEL.png">

If errors HAVE occurred, please post them here or join #imcoder on the Goonstation Discord (https://discord.gg/0117EEzASKYV2vtek) and Haine and co. will try to help resolve them.

Load Dream Daemon

You can open it through the BYOND Pager by going to the gear wheel icon in the upper right corner, or by hitting CTRL+D. This is what Dream Daemon looks like:

<img src="https://i.imgur.com/KQIe6Fa.png">

First you will want to hit the ... button next to the File: box at the bottom. Navigate to where your server code is (the folder with the .DME) and select the .DMB (in goonstation's case this is goonstation.dmb). If you don't have a .DMB file, go back and try step 2 again. Security, Visibility, and webclient settings can be set up however you feel like. (Set visibility to Public if you would like your server to appear on the BYOND Hub).

Select a port and forward it

In Dream Daemon, enter a number for the port (0 makes it random each time the server is started, we don't want that unless you feel like messing with the port forwarding each time (you probably don't)). It should be something in the 1000+ range, for example 8085. You will then need to forward your chosen port to your computer, through your router's admin settings. As this is different for every router and network setup, please consult https://portforward.com/ for instructions on how to do so for your router.

Start the server

The GO button next to the Visibility settings box should have turned green once you loaded the .DMB and if you click on it now, the server will start up. After a minute or so (the window may appear frozen, but it isn't) the window should change to look like this:

<img src="https://i.imgur.com/q2u34b5.png">

After a minute, the window should update to tell you if the server's port is accessible to outside connections. If it says "BYOND hub reports port 8085 cannot be reached by players." you will need to go back to the port forwarding step and try again. Otherwise:

You are now all set to play!

Click the yellow arrow sign to join the game through DD, and the red stop sign to shut the server down when you're done. Click on the byond://[IP]:[port] text to copy the link to the server into your clipboard. You can then share that link with others and they will be able to join your server with it!

Once you've compiled the code the first time, you'll only need to load Dream Daemon and start up the server when you want to run it - you don't need to compile each time.

Quick Useful Tibits

Setting yourself as admin

To make yourself an admin:

1. Go to the goonstation/config/ folder.
2. Open up the admins.txt file. Editor does not matter.
3. Add your your ckey (lowercase byond key) to the list of names, a -, then your rank of choice.
   • For example, if your byond key/username is GokuSmokeWeed420, your ckey would be gokusmokeweed420 (notice it's all lowercase letters), and if it were Awesome McCoolkey, your ckey would be awesomemccoolkey (note that the space is removed).
   • There are many ranks, some with...interesting names, but the one with the most powers is Host. So, going back to the first example, you might add gokusmokeweed420 - Host somewhere--it doesn't really matter where.
4. Compile and run again.

Setting the map

1. Go to goonstation/_std/ folder
2. Open __build.dm.
3. There should be few lines of code that in the format //#define MAP_OVERRIDE_MAPNAMEHERE, just after the cute and adorable ASCII bee. Remove the // for your map of choice. This will uncomment the code, so that BYOND knows to run it, and this particular section code tells the game to override it to that map. Compile it again and run it.
   • For example, if you want the map to be Cogmap1, make //#define MAP_OVERRIDE_COGMAP into #define MAP_OVERRIDE_COGMAP.
4. Compile and run again.

Further Information

You can ask for server help on the goonstation's dedicated gooncode channel, #imcoder on the Goonstation Discord (https://discord.gg/0117EEzASKYV2vtek), or post a new thread in the General Discussion forum.

---