Join us in Outworldz at www.outworldz.com:9000 or follow us:

Outworldz Opensim One-Click Hypergrid for Windows

The Outworldz One-Click Hypergrid is a Microsoft Windows-compatible virtual reality Opensimulator system that is easy to install, easy to run, and powerful. It it free and is open source.

Firewall

Windows will prompt you to allow Opensim to open ports when it first runs. If you say no, you will not be able to hypergrid out.

If you are using an Anti-virus with a firewall, such as ZoneAlarm, AVG Internet Suite, or anything else, running Start.exe my trigger the 3rd party firewall popup warnings. Opensim.exe needs to be allowed internet access, and Start.exe should be allowed to make changes. This code is digitally signed by me, Fred Beckhusen, and is open source and available for inspection on https://www.github.com/Outworldz.

How to modify your Dream World

The vast majority of this software is just Opensimlator and MySQL with edits in the INI files to allow auto-configuration by XML and INI editing.

The source code package "How_to_Compile.txt" explains how it is compiled, and what changes are made.

Universal Plus and Play Not Working? (uPnP)

Do you have Plug and Play (uPnP) issues?

This is a useful tool to look at uPnP in your router:
Free Upnp (Universal Plug and Play) Tool for Windows

You can add, delete and modify the settings without a password, assuming you have uPnP enabled.

Download UpnP Tool 1.0

Adding more regions (Sims)

Its now easy to add and manage one or more sims. Click the Advanced Button in the menu and open the Advanced screen. Then click "Add Region". A menu will appear. Enter the name of your new region and click "Save".

Var Grid sizes

The variable region size can be anything from 256 X 256 to 1024 X 1024, or higher. Huge sim sizes such as 4096 X 4096 can be used, such as for flying or car racing.

Rules:

Always use a square sim size.

Never put a different sizes of sim right next to each other

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

If you delete the sim, it is renamed to SimName.ini.bak. You can get it back by renaming it to SimName.ini. The files are in the Opensim\bin\Regions folder

Don't change the UUID unless you want to startr over. Altering the UUID will force the system to create a new, blank region.

Auto Backup

Autobackup Opensim 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 be placed in the \OutworldzFiles\AutoBackup folder.

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

Grid Gods

Permissions in Opensim

Grid god mode allows certain users to take and control permissions over objects. Permissions must be asked for in your viewer's Advanced menu. 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.

Maps

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.

Chat and Wallpaper Settings

Chat and Personality Settings

This setting controls the speed of the chat text on the main screen. The wallpaper cycle time defaults to one minute, and can be disabled by setting the number to 0. You can also click the screen to advance through the settings.

All images are unretouched screen grabs from Open Sim and Second Life.

Don't like Dragons? The viewer splash screen can be set to any web site

Grid Settings

Add regions to Opensim

If you have a DNS name from a Dynamic DNS system, you can enter it here. This will be your grids main address.

Diagnostic Port: (Default: 8001) The program starts a TCP/IP listener on this port for diagnosis before Opensims starts. A TCP socket connection from www.outworldz.com 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.

Diagnostics

This uses Universal Plug And Play (uPnP) and several diagnostics to configure compatible routers automatically. uPnP may be disabled, or fail. If your router does not support uPnP, you must manually open ports in your router and Port Forward them to your PC.

Diagnostics are run once upon installation. You can run them again (Help-Diagnostics) if you change the router setting manually. You may need to reset your router by cycling the router power if you change settings from the defaults. UPnP settings are removed when the program is stopped to keep your system safe.

Accessing the Hypergrid requires a compatible router with loopback. If your router does not support loopback, you can still join the hypergrid by installing a special Windows device driver. Additional Information of Routers and their confuiguration is available online at the Opensimulator site.

Help with Opensim crashes:

Your Mysql database may be crashed. This is a way to start MYSQL manually.

First, run the diagnostics in the Help menu. Then Navigate to the Outworldzfiles\mysql bin folder. Press and hold the Shift Keyand right click the BLANK area next to the files. Or navigate there , as I did below, by typing in commands. Then run "StartManually.bat"

Opensim running

Any error message it prints may be be helpful. If it crashes, a MySQL LOG file will be saved in OutworldzFiles\mysql\data as a *.err file. That may also give you a clue.

Starting over with a blank database

You can wipe ALL data out and recreate it from OAR and IAR files. This WILL LOSE ALL DATA. If you MUST wipe out the database and start over, delete the ib_logfile0, ib_logfile1 and ibdata1 file in OutworldzFiles\mysql\data ( leave the folders). Then delete just the contents of data\opensim\*. Leave mysql\data\mysql alone. This will make it start over at the very beginning and you need to re-enter your Avatar name and password and reload everything.

Credits

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.

Release History

The Dream World system is currently in Beta Release. Please report any issues you have to fred at mitsi.com, or comment below.

	
Revision History:
Outworldz "Dreamworldz" started in 2012 when it was used on a DVD and thumb drive to make a "Dream World" for a charity to give out as a thank you for donations.

This re-release updates it from the original Sim On A Stick format into a standalone app using 0.8.2.1 Diva Distro and 0.9.0 dev.  It removes the Mowes App that points to a hacked web site, PHP, and Apache (none of them are needed and are security risks).

0.80 2016-10-09 Initial release
0.81 2016-10-10 Move updater to initial stage to get past crashes
0.82 2016-10-11 Fix was made to OpenSim in bin/OpenSim.exe.config on 23-Nov-2013 (git master a68d1fa) adding the following line to the runtime section:
                loadFromRemoteSources enabled="true" 
                Updater to version 1.1 to fix progress bar.
0.83 2016-10-11 MySQL now runs when file path contains quotes.
0.84 2016-10-12 Diags run just once
0.85 2016-10-12 Upper/Lower case OAR files now work
0.86 2016-10-14 Added more images
0.87 2016-10-14 Admin panel accepts a DNS/DynDNS name, *.OAR and *.oar  case sensitive fixes
0.88 2016-10-15 Stats enabled at localhost:8002/SStats/ - hid webstats toolstrip if Admin menu is unchecked, Onlook closes with app
0.89 2016-10-15 IAR load did not work: needed an AppActivate
0.90 2016-10-16 Opensim 0.9 and 0.8.2.1 merged
0.93 2016-10-17 Public Port was not being properly set in Opensim.ini
0.94 2016-10-25 Manual backup menu
                Prompt for auto backup when loading an OAR. 
                Diagnostics test improvement on port 8001. 
0.95 2016-10-27 Creates a StartManually.bat program in mysql/bin to aid anyone needing to test the db manually. Cleaned up the my.ini file
0.96 2016-10-29 Load Oar case sensistive OAR;TGZ;GZ names work now.
0.97 2016-10-31 Compiled 0.9.1 	#7c4f2b048f4d74b3132486e8d7a6887c73d6562d
                Fixed Version 0.96 vs .96 bug - caught by Fearghus McMahon - type casting of string to single was wrong
                Opensim would switch back to 0.8.2.1 from 0.9.0 - Hypergrid => Opensim renamed
                OfflineMessageURL red error on startup fixed - Thank you, AI Austin for blogging this.
                Onlook restarts on install and sets grid vars  - Thanks for the extensive help, shaunkmaloney@craftgrid.com
                When Advanced menu grid name is changed it no longer requires a restart, can no longer change grid while running
0.98 2016-11-20	https:://api.ipify.com lost their SSL cert, so it is now on port 80.  Backdrop is hidden if timer = 0
0.99 2016-11-25 Public IP set to localhost if diags fails
                Keyboard Wait SendKeys to make Opensim command more reliable
                Onlook Viewer XML adapts to Public IP
1.00 2016-11-26 MySQL port=3308 to prevent conflict with Sim on a stick or other distros.
                Advanced db Settings Menu. 
                region_default set without CONST so Hypergrid now to/from in 0.8.2.1
                0.9.1 would not HG due to missing http:// in an INI
1.1 2016-12-02 Updater was not working correctly due to a space in the URL.
1.2 2016-12-04 Broken Login URIs everywhere - doubled http:// - emergency patch.
1.3 2016-12-28 Update Opensim 0.9.1 to #73b2c82427cf25
               Multiple region capable!
               ExternalHostName for LSL is set automatically for HTTP-IN scripts
               Added Various Physics choices none, ODE, bullet. bullet in a separate thread, plus ubODE for 0.9.1
               Diagnostics detect PC network IP for Standalone use with multiple PC's
1.3.1 2017-1-7 Hostname is always used.
               Diagnostics skip low level tests if high level tests pass.
1.3.2 2017-1-9 Remove any extra http:// from DNS name.
               Update docs for 1.3.2
1.3.3 2017-1-10 Stop MySQL forcfully
1.3.4 2017-1-12 Dynamic DNS
1.3.5 2017-1-13 Make up a DNS name on First Start
1.3.6 2017-1-22 Prompt for region on OAR and IAR
1.3.7 2017-1-24 Opensim 0.9 refresh, default region fixes to Opensim.ini		   
1.4.0 2017-1-26 Public Port moved to 8001 to fix HG issues. 
1.5.0 2017-1-31 All changes released to updater
1.5.1 2017-2-1 Default Region set.
1.5.2 2017-2-3 Groups had Public IP:Private Port leading to dead groups if you had correctly blocked Private port in the router. Should be localhost:Private port
1.5.3 2017-2-11 DNS Test button. uPnP Logging, more INFO level logging. Better IP detection when uPNP fails, Help Icons in Advanced
1.5.4 2017-2-17 Set viewer splash page for other viewers
1.6.1 2017-2-19 DNS returns Google DNS 8.8.8.8 UDPO datagram probe to detect actual LAN Ip
1.6.2 2017-2-20 Re-enable auto updates if checked a second time
1.6.3 2017-2-24 Load OAR didn't work with spaces in file names, popup notes should occur only once, CheckDatabase was missing



               
               

	
	

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