Setting Up Your Universe

 
After you have installed and started your UniServer, the next thing you'll need to do is configure the Outerworlds Browser in order to access it.

First, download and install the latest Outerworlds Browser. It is best to install the browser into a fresh, empty directory. You may encounter problems if you install on top of an existing browser installation that has already been used to access another universe.

Do not choose to start the browser automatically at the end of the installation; instead, exit the install without launching the browser.

By default, the Outerworlds Browser will attempt to access the Outerworlds Corp. main Universe on startup. You will need to modify the aworld.ini file to access your UniServer instead.

To customize your browser, add the following two lines to the top of the aworld.ini file:

[universe]
host=domain name or IP address of the UniServer machine

for example:

[universe]
host=aw.mydomain.com

We recommend using a fully qualified domain name instead of an IP address, if possible. That way, if you need to relocate your UniServer to a different machine at a later date, you can simply adjust the DNS record for that domain name and your users will switch to the new machine automatically. If you hard code a raw IP address, it will be very difficult to ever transparently move your universe to another server machine.

Entering your universe for the first time

After making the above edits to aworld.ini, save your changes and start your browser. If all works correctly, you will first see the welcome screen.

Enter your universe as a tourist. Since there are no worlds running yet, you will just see a blank blue screen in the 3D window. Immigrate to your universe by pressing the "Immigrate" button in the toolbar. Since this is the first time your universe has been run, you will be immigrating as citizen #1. Citizen #1 is the "root" citizen of a universe and has unrestricted access to all universe and world configuration options. Be sure to carefully restrict access to this account!

Creating a world license for your first world

Before you can start your first world (and, in the Galxerver configuration, your only world), you will have to create a license for it. Since you have just immigrated as citizen #1, you can now access the world license dialog. Go to the Options Menu in the browser and bring up the World License Dialog by selecting Universe -> Worlds.

In the World License Dialog, decide on a name and password for you new world, and choose an appropriate size and maximum user count. Enter this information into the dialog and press "Add". You will now be able to run your first world server in this universe.

Installing and configuring the World Server

Download and install the latest Outerworlds Server. Complete instructions for downloading, installing and configuring the World Server can be found online in our world server documentation.

If you are installing the world server under Windows, during the installation you will be asked for a name and password for the world. This will be the world name and password you chose when you created the world license above. You will also be asked for your citizen number. Since there is currently only one citizen in your universe (you), enter "1".

After installing the World Server, you will have to carry out the additional step of modifying the world.ini file so that the world server knows how to find your UniServer. To do this, add the following 2 lines to the world.ini file:

[universe]
host=domain name or IP address of the UniServer machine

where, again, the domain name or IP address is the address of your UniServer.

Starting your world server

Now, simply start your world server according to the installation instructions for your OS platform. Under Windows, it may be already running since the installer starts the server automatically. In that case, simply stop the world server (by right-clicking on the globe icon in the Windows system tray and selecting "Exit") and then start it again from the Outerworlds Server program group. It will reload your new world.ini settings.

Under Unix, you will need to take the extra step of adding your new world manually to the server after starting the server.

Once your world is running, it should appear in the World List in the browser. If you are already running the browser, it will take up to 60 seconds for the world name to first appear.

Adjusting the universe options

The last step is to fine tune your universe attribute settings. Go to the Options Menu in the Outerworlds Browser and select Universe -> Options. This brings up the Universe Attributes dialog. In this dialog, set the "Start world" field to the name of the world you want people to start out in by default, which is usually the name of the new world you just created above.

The proper settings for the various browser and world build numbers change on a regular basis. They should be at least set to these values:

Minimum browser: 306
Latest browser: 370
Latest 2.2 browser: 306
Beta browser: 370
Minimum world: 19

You are encouraged to check with support@Outerworlds.com for a list of the most up to date values for these settings.

That's it! Your UniServer is now ready to receive its first citizens. If you experience any difficulties during this set up procedure, or have any additional questions about managing and adminstering your new galaxerer or uniserver, please send email to support@Outerworlds.com.