Hypergrid

What is the hypergrid?
The hypergrid is an extension to opensim that allows you to link your regions to other opensims on the internet, and that supports seamless agent transfers among those opensims. It can be used both in standalone mode and in grid mode. The hypergrid is effectively supporting the emergence of a Web of virtual worlds.

The basic idea for the hypergrid is that region/grid administrations can place hyperlinks on their map to hypergrided regions run by others. Once those hyperlinks are established, users interact with those regions in exactly the same way as they interact with local regions. Specifically, users can choose to teleport there. Once the user reaches the region behind the hyperlink, she is automatically interacting with a different virtual world without having to logout from the world where she came from, and while still having access to her inventory.

The hypergrid is currently a GForge project. Technically, it's implemented as a thin layer on top of the OpenSim core facilities. It's very easy to install, and it is 100% compatible with the standard OpenSim distribution.

Virtual World Hyperlinks


We're all familiar with hypertext links on the Web. But what is a virtual world hyperlink?

In the hypergrid model, we consider the 2D map of the virtual world as the equivalent of a web page. As such, a VW hyperlink is simply a region on that map.

The current walled-garden model of opensim-based virtual worlds already supports this concept of hyperlink. When you teleport from one region to another via the map, chances are you are migrating your agent into a different opensim server. This migration is a glorified "agent transfer" that also exists, in rudimentary form, on the web when hypertext links are followed. The walled-garden model, however, imposes one very strong restriction on these hyperlinks: the entire map of regions is controlled by a central server known as the grid server, whose job is to provide a uniform view of the world to all of its regions.

The hypergrid removes this constraint by allowing individual opensim instances to add "neighbors" to their local map. As such, the hypergrid moves the control of the map down from the grid server to individual opensim instances (although hyperlinks can also be served by grid servers if grid admins so wish). In doing so, the world becomes a lot more interesting and varied. The map that you see in one opensim instance may be completely different from the map that you see after you teleport via an hyperlink. As an opensim administrator, you are free to define what other opensims you want to see on your map.

Usage Scenarios
The following are natural usage scenarios. There isn't a clear separation between these scenarios, there's a large overlap between them. This is also not an exhaustive list. The purpose of these descriptions is to give you some starting ideas for how to use the hypergrid in practice. Please feel free to add other interesting scenarios to this list.

Security Concerns
TODO

Hypergrid Implementation
TODO

Installing and Running Hypergrid

 * 1) Checkout the hypergrid project: svn checkout http://forge.opensimulator.org/svn/hypergrid/trunk. Usually trunk is in a usable state. If it isn't, you can check the latest stable version from tags: svn checkout http://forge.opensimulator.org/svn/hypergrid/tags
 * 2) Read the README.txt file. It has important information about which version of opensim the hypergrid has been tested with. 'No guarantees of what will happen if you use the hypergrid extension with a different version of opensim'.
 * 3) Check out the version of opensim mentioned in the README file. Prebuild build it as normal.
 * 4) Copy all the files under hypergrid/.../bin onto opensim/bin
 * 5) Make the following changes to your OpenSim.ini:
 * 6) * The map: WorldMapModule = "HGWorldMap"  If you didn't have this setting in your original OpenSim.ini, make sure yo place it under the [Startup] section.
 * 7) * If you're running your opensim in grid mode, you're done. If you're running in standalone and you want it to be network-able, change all the [Network] server addresses to "http://:"
 * 8) Run opensim like this: [mono] OpenSim.exe -hypergrid=true . To make sure the hypergrid is running type this on your console: link-region. If you don't hear anything back, the hypergrid is not properly installed.

Public Hypergrid Nodes
The following is a list of hypergrid-ready nodes that you can use for testing your installation and for linking your world. Please add your public node here if you wish to help build a web of opensims.

For the time being, and given the security concerns described above, we advise you to be careful about who you link to.

The "UCI Welcome" region connected to OSGrid. It is run by Diva (Crista) on a machine owned by the University of California, Irvine. You can link to it as a way to link to OSGrid.
 * osl2.nac.uci.edu 9006

A region in the UCI Grid. It is run by Diva (Crista) on a machine owned by the University of California, Irvine.
 * ucigrid02.nacs.uci.edu 9000