Getting Started

Revision as of 06:22, 20 September 2011

Are you a noob? Well I am... Having zero experience with OpenSimulator and Second Life has presented me with a lot of challenges. As I overcome those challenges I'll share what I've learned. Hopefully it will help you get up to speed with OpenSimulator ASAP.

OK so we've seen a few web pages out there, maybe read a wiki article or two, and saw a couple YouTube videos on this virtual world stuff. Somehow we've come to the conclusion that OpenSimulator is kick ass and is a must have application for fulfilling our dreams. For me it was the luring feature set being proposed for OpenSimulator. My dream of creating a free MMORPG seems feasible with OpenSimulator and brings with it the potential to have other dungeon masters creating their own virtual worlds based on my MMORPG gaming rules. Wish me luck!

Vocabulary

Let's start with some vocabulary so we both understand what it is that we're talking about.

• Assembly - An application library used by executable files.
• Avatar - A virtual world character that you control. It's the way you will appear to other users.
• Grid - ?
• Noob - A first time / new player in a game that makes frequent mistakes. It's often a bad thing, but I've got no beef with being new. I learn from my mistakes :)
• Region - ?
• Second Life - This is a commercial product for connecting users via a 3D environment over the internet (world wide web).

Step One

Alrighty then. Step one is to download the software and get a local server up and running. Check the Download Page for a link to download the software. I'm running Windows 7 64-bit and downloaded the file that ended with a ".zip" extension. If your running Unix then you'll want the file with a ".gz" extension.

After you download the file and expand it, head on over to the Configuration Page. It's recommended that you review the "readme.txt" file in the root folder of the file you expanded. If you open the readme file in NotePad and it looks like one long continuous line of information, try opening the file in WordPad.

After reading the readme and the Configuration Page I felt I was ready to fire this puppy up.

Noob mistake number one! Somehow I got confused and managed to download the "Source Code" rather then the "Binary Packages". This was most likely caused by the fact that I'm a software developer and wanted to see the nuts and bolts behind the seen. Anyhow if you find yourself wondering why you can't find OpenSim.exe or OpenSim.32bitLauncher.exe throws a bunch of "missing assembly" errors make sure you didn't download the "Source Code" by mistake.

By using the start-up information from the Configuration Page I got my OpenSimulator up and running. The only additional notes I can add is to keep an eye out on your Windows Firewall. It will prompt you for permission to let OpenSimulator run as a server on your network. Permit it ASAP (don't ask me why, I'm just being extra cautious). My second note would be the shutdown command. If you need to stop the OpenSimulator server type shutdown at its command prompt.

Step Two

Where's the beef? Well before you can view your newly created 3D world running on your OpenSimulator server you need to download a viewer. I surfed on over to Second Life and looked for a link to download a viewer. Their viewer is free and appears to be the origin for the messaging protocol being used.

By default the Second Life viewer will install a shortcut on your desktop. Copy and paste that shortcut so we can create a link to our local server. Edit your new shortcut and add the parameter -loginuri http://127.0.0.1:9000 to the Target (start-up command). Information about the parameter is detailed on the Configuration#Connecting_to_OpenSim Page. When prompt for a user name enter the 'first name' space 'last name' and password that you previously specified when setting up OpenSimulator.

Noob Note! If your avatar appears in your new 3D world as a white egg on a hill surrounded by whiteness then you're not alone. I too had this issue and suspected the viewer was the issue. My thought is the Second Life viewer downloads some content after you connect to their servers for the first time or perhaps it just doesn't play well with OpenSimulator. My solution was to download and use a viewer named "Imprudence". I found a link for it on the OSGrid web site. Without making any changes to the start up parameters, I was able to run Imprudence and connect to my local server. SWEET!

To summarize... I stopped using the Second Life viewer and started using the Imprudence view. My avatar now looks like a person on an island surround by water =)