Join us in Outworldz at or follow us:

[Table of Contents]


Usually you can just run the Help-Network Diagnostics and it will tell you what to do. But you may want to troubleshoot manually.

Adding more regions (Sims)

Opensim Add Regions It is easy to add or change regions. Each region has a control panel.

Click the Advanced Button in the menu and open the Advanced screen. Then click "Add Region" or "Configure Regions".

A menu will appear. Enter the name of your new region, choose a size, and click "Save". The rest of the options can be ignored or set to override defaults for this one region.

Region Settings in Opensim 

The region size can be anything from 256 X 256 to 1024 X 1024, or higher. Huge region sizes such as 4096 X 4096 can be used, for flying or car racing. If you go over 8192 X 8192, you can expect it to be slow as the land size gets very large,  exponentially.


Always use a square sim size.

Use multiples of 256 - 256X256, 512X512, and so on.

Don't change the UUID unless you want to start over. Altering the UUID will force the system to create a new, blank region the next time it is started, and you will be forced to move your region to another spot.

You can set regions next to each other by changing the X and Y coordinates and restarting the region. The X and Y is the lower left point on the global map.

You can replace 4 single regions with a single 2X2  region and there will be no lag when crossing the (nonexistent) border. Vehicles can move smoothly anywhere. Also, NPCs can move about freely. Look in any region settings panel and you will see a "size" box. Check the 2X2 box, save it, and restart the region. It will grow North and East and will be 4 times larger overall. You will also need to move it in X and/or Y, or delete the other regions as regions cannot overlap. You can shrink them, too, but objects that fall off the right and top edge will be lost.

The photo is part of my setup at Outworldz.

Sim Map

Auto Backup

AutoBackup Opensim If enabled, the system will make OAR backups of each region. The sim must be continually on for automatic backups to operate. Files that are older than "Keep for Days" number will be deleted.

The OAR files will normally be placed in the \OutworldzFiles\AutoBackup folder.

Click the Save To Folder field and it will let you select another folder - and you can use a \\network type folder.

Grid Gods

Allow Grid GodsGrid god mode allows certain users to take and control permissions over objects. Setting Grid God Mode on allows you to control individual users by editing their access level in the Wifi Users Panel. Any user with a level > 100 will be a grid gid. You can set any estate owner or estate manager to be a grid god, too.

Allow gods can be used by itself for users that have Wifi permission levels of over 200.

God mode is a useful function. However, making copies of items that are no copy or no transfer and giving them to others could be illegal. Please remember that copyright laws for your country need to be respected.


Map Settings

Opensim has many different maps settings. I've set up 4 easy to use combinations.

Be aware it can take a very long time to boot when using the slower, more pretty maps.

Physics Engine

Opensim Physics The Opensimulator Physics selection box lets you use no physics, or very basic physics, where the only collidable object is a box shape. It supports the original Open Dynamic Engine physics. The ubODE engine, by Ubit Umarov, is an advanced version of ODE that is closer to Second Life compatibilty with vehicles. Bulletsim is an award winning physics engine. Running Bullet in a separate thread is the default.

Grid Settings

Grid Name You can enable or disable Hypergrid access with the first switch. If set to Enable, you must have compatible router and ports must be forwarded.

The Suitcase switch will enable and disable a security feature. If checked, all transactions in foreign grids must go through a Suitcase folder. This helps protect your inventory from rogue grid operators. if set to off, you will be able to access any item in your inventory and ot just your suitcase when you are on another grid.

You can set up a DNS name for your grid. You can enter any name, such as AnyNameYouWant.Outworldz.Net. This will work anywhere in the world. People can use it to get to your grid. If you already have a DNS name from another Dynamic DNS vendor, you may enter it here. This will be your grids main address. If left blank, the system will use the local LAN address and Hypergrid will not be available.

The DNS password protects your name from being taken by others. If you lose this password, you will not be able to use your original name. Contact me if you need to have this password reset.

The Viewer Splash page is shown when you log into your world. It can be any web address, including, where 'Yourname' is your grid name.


UPNP The UPnP checkbox will enable a Universal Plug and Play that will automatically open ports. This does not always work, so you may have to Port Forward the ports shown here.

Diagnostic Port: (Default: 8001) The program starts a TCP/IP listener on this port for diagnosis before Opensims starts. A TCP socket connection from is triggered by HTTP. If this inward-facing probe succeeds, the diagnostic passes. No personal data is sent, and it is not possible for anyone to retrieve any data from the diagnostic port. This checks to see if the firewall and your router are properly set up.

Public Port: (Default: 8002) The simulator and services such as Wifi use this port. It must be open to the internet for Hypergrid to work. The program locally probes this port to detect if Opensim is starting.

Private Port: (Default: 8003) There are also a set of private services (asset, inventory, etc.). By default, these run on port 8003 (TCP only) and it should not be made accessible to viewers. Port 8003 should only be accessible to the machines which are being used to run the grid. DO NOT OPEN THIS PORT ON YOUR FIREWALL.

The Dreamgrid system will automatically use ports starting with the Region Port Start #.  Default is 8004.  Each region will be one port larger.   You need to have as many ports as it lists forwarded to your computer for HG to work.

Terms of Service (TOS)

There is a screen for entering and enabling a Terms of Service (TOS) to local and/or hypergrid users.

You can change the HTML text or delete any of the text in the simple editor, and you can use Javascript as it is HTML. Your TOS will survive any updates, too, and it is stored in an easily accessible text file. It supports a 'gridname' variable that may be used to automatically put your grid name into the TOS. One other 'future-proof' feature is a button to re-request your users to agree to any future TOS changes.

Opensim TOS

Setting up the Shoutcast Server

Go to this page to set up the free Mixx Broadcaster with your free Icecast/Shoutcast server

Diva Control panel

You can select one of three default appearances for newly created avatars set up via Wifi. But in a new environment you must set those avatars up first.

1. Create the avatars with names "Female Avatar", Male Avatar", "Neutral Avatar". and  authorize them via the Wifi Admin login name.  You can find the default password for user Wifi Admin in your Settings panel for the Web pages.

2. Login as each avatar.   they will appear as a cloud initially and then usually rezz to the "Ruth" wearing four basic body parts, new pants and new shirt. Note these parts from from the OpenSim Library and MUST NOT be worn in your final appearance for the default avatars.  You must COPY these library parts into the avatar's inventory if you wish, or create new body parts and clothing, but before you finish you should remove any items that show as "worn" that are located in the OpenSim Library as those will not rezz on avatars created based on these models.

3. Add any other mesh, clothing, attachments or HUDS you wish to appear on the avatars.

4. Note you can extend (or change the avatars names or labels) for the range of default appearances that are shown in Wifi and/or change the preselected default by altering Wifi.ini

;; Syntax: AvatarAccount_<AvatarType> = "<FirstName> <LastName>"
;;         (replace spaces in <AvatarType> with underscore)
AvatarAccount_Female="Female Avatar"
AvatarAccount_Male="Male Avatar"
AvatarAccount_Neutral="Neutral Avatar"

;; Preselection for default avatar in new account registration


This work would not be possible without all the thousands of contributions of the Opensim community.

I am especially grateful to the marvelous Diva Canto, aka Dr. Crista Lopez, of the University of California.

Back to the Best Free Tools in Second Life and OpenSim.