Creating your own paracode server

From Paradise Station Wiki
(Redirected from Install)
Jump to: navigation, search

Download, Compile, and Initial Setup

  1. Install BYOND and create an account at http://www.byond.com/
  2. Checkout the source using Git or download it directly from the ZIP button on Github and extract it into a folder of your choosing.
  3. Open paradise.dme.
  4. In the menu at the top, select Build > Compile.
    • Compile time depends on your computer specs. Expect to wait between 2-10 minutes. When it finishes you will see the following message:
      saving paradise.dmb (DEBUG mode)
      paradise.dmb - 0 errors, 0 warnings
    • If you see any errors or warnings, something has gone wrong - possibly a corrupt download or the files extracted wrong.
  5. Browse into the /config/example/ folder. Copy all of the files from there into your /config folder, then delete the config.txt and dbconfig.txt files. (Do not delete the latter if you have a MySQL database set up)
  6. Open admins.txt and remove the default admins to add your own. Some available levels (from highest to lowest) are: Hosting Provider(recommended), Maintainers, Game Admin, Moderator.
    • The admins.txt format is:
      byondkey - Rank
    • ...where the BYOND key can be in whatever case you like and the admin rank must be properly capitalized. Additional levels and specific commands accessible by each level can be seen in /code/modules/admin/admin_verbs.dm and edited in admin_ranks.txt

Starting the Server

  1. To start the server, run the BYOND client, log in, and select File > "Start Dream Daemon..." from the menu. (May be better to run it separately as admin, as people have reported crashes)
  2. At the bottom of Dream Daemon, enter the path to your compiled paradise.dmb file.
  3. Set Port to whatever port you like, in the range of 1-99999, making sure no other program is using that port.
    • Note: If you are running it locally for testing, the port can be empty and one will be selected for you. However, choosing a port will prevent needing to edit your bookmark (below). A port number that works for almost all purposes is 53970.
  4. Security: (Trusted is recommended. You can use Safe mode if you prefer, but you'll be clicking alert windows when the server needs to edit the info.json every time it boots up.)
    • Trusted mode allows the game to access files, run system commands, and perform other actions without asking for permission. This is usually not a good idea except for games that you have created yourself.
    • Safe mode is the default. File access is allowed within the same directory as the world's .dmb file, and any directories underneath that one. Most actions such as running a system command require your approval.
    • Ultrasafe mode means that nothing that could affect your system in any way will be allowed without your permission. For games that use savefiles, this is usually not desirable.
  5. Visibility: (Invisible is recommended)
    • Public mode is the default. The game will be seen by everyone on the hub.
    • Private mode means your friends on the pager will see your game. However if they are logged in, it will also be visible on their pager.
    • Invisible mode prevents the game from appearing on the hub or pager.
  6. Press the green GO button in the bottom-right. This step may take up to 10 minutes to complete as the world loads. If your Dream Daemon stops responding, simply wait longer.

Logging In

  1. In the BYOND client's menu, select Bookmarks > Add...
  2. URL: 127.0.0.1:12345
    • ...where 12345 is the port you chose in the section above. You may also use the External IP address and port (shown as xxx.x.x.xxx:xxxxx) at the bottom of the Dream Daemon window after pressing "GO".
  3. Name: Test Server (or whatever you want to call it)
  4. Click OK
  5. Find your new Test Server bookmark in the Bookmarks menu and select it to start playing.
    • Note: You can also click the yellow 'route' sign in Dream Daemon to connect to your server instantly.

Updating

  1. Download a new .ZIP from the Paradise Github repo (as explained in the first section above).
  2. Backup your /config folder. This folder stores your server configuration.
  3. Extract the new files (preferably into a clean directory, but replacing existing files should work fine).
  4. Copy your /config folder back into the new install, overwriting when prompted except if we've specified otherwise
  5. Re-compile the game.
    • NOTE: This method is not advised. A better method would be to create a GitHub account, clone our repo with a Git client and update it periodically, without needing to worry about backing files up.

MySQL Setup

The SQL backend for the library and stats tracking requires a MySQL server. Your server details go in /config/dbconfig.txt, and the SQL schema is in /SQL/paradise_schema.sql. More detailed setup instructions are coming soon, for now ask in our IRC channel.

Contribution Guides
General Contributing to Paracode, Game Resources category
Setting server Setting up the Database, Creating your own paracode server
Coding Understanding SS13 Code, SS13 for experienced programmers
Mapping Guide to Mapping,
Spriting Guide to Spriting,
Wiki Guide to Editing the Wiki