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 public version of Goonstation's code. 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. Once it's done, unzip your chosen code somewhere or navigate to where git downloaded it.

Don't download the 2020 or 2016 public releases or the r4407 release, if you somehow stumble upon that one. These are old snapshots of the Goonstation source code at certain points in time. They are not updated at all and can only run on older versions of BYOND. They're most likely not what you're looking for, unless what you're looking for are previous versions of Goonstation for historical interest or something.

Create the __secret.dme file

Next, you need to put a blank file named __secret with the extension .dme in the +secret subdirectory. You need this __secret.dme file for the whole thing to compile, lest you get a unable to open +secret\__secret.dme error.

There's a .bat file named initial_setup.bat in the main Goonstation folder (that is, the one with the README.md and LICENSE files) that does all that for you; just run that. If that doesn't work, you usually can simply make a blank text tile and save it as "__secret.dme".

What's the code doing with a blank file? Basically, it's standing in for any content. Normally, on the official Goonstation servers run by Goonstation staff, the secret directory is occupied and has secret content, like the latest secret chems and lots of Adventure Zone content. Since you can't get said secret stuff on public Github without being a developer though (because that kinda defeats the purpose), the code has been configured to be alright with just a blank file instead of actual secret content.

Compile the server

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:

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):

If errors HAVE occurred, please join #imcoder on the Goonstation Discord (https://discord.gg/zd8t6pY) and some of the users and staff 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:

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:

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. Open goonstation.dme. This should open up Dream Maker.
2. Go to the __build.dm through the file tree on the left. It's under _std.
3. There should be few lines of code in a "MAP OVERRIDES" section in the format //#define MAP_OVERRIDE_MAPNAMEHERE, past the cute and adorable ASCII bee and some sections for handling profiling, debugging, and speeding up setup. 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.

Note that you cannot use Map Vote to change map on private servers. On the Goonstation public servers, the Map Vote tells Goonstation's internal software to modify and recompile the code, essentially doing the above, but automatically. Even though the code's configured to use this software, a private server can't access it. Simply put, you don't have the required infrastructure unless you build a new one yourself.

Do not try to go to __build.dm directly through your browser's file system. BYOND does like it if you try to open DM files without starting up a .dme environment. If you do, you might cause BYOND to modify the .dme file to the point where it won't compile.

Starting the round early

Just testing stuff alone in a private server and don't to wait 150 seconds for the game to finish counting down? If you've given yourself admin privileges, you can use the "Start Now" command. You can enter it as "start-now" into your text parser/command bar on the bottom or find it in the Server tab.

In addition, __build.dm, which also is where you configure maps, has a list of defines for faster loading right after the ASCII bee, under a section called "OPTIONS TO GO FAST". Remove the // for the one you want and remember to save, compile, and run it again.

Fixing the unable to open +secret\__secret.dme error

Make sure you created the __secret.dme file correctly.

Further Information

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

---