OpenSimulator - User contributions [en]

RemoteAdmin:admin authenticate user

2013-11-22T14:42:38Z

Kira Komarov: /* Examples */

'''admin_authenticate_user''' remotely allows to authenticate an user remotely. This feature is part of the development branch, after the 0.7.6 OpenSim release.

=== Enabling admin_authenticate_user ===
If not all functions are enabled, use admin_authenticate_user to enable the function in the [RemoteAdmin] section
<source lang="csharp">
enabled_methods = admin_authenticate_user,...
</source>

== Parameters ==
=== Required Parameters ===
These parameters are required
{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''user_firstname''
| first name of user
|
|-
| ''user_lastname''
| last name of user
|
|-
| ''user_password''
| and MD5 hash of the user's password
|
|-
| ''token_lifetime''
| the lifetime of the authentication token (max: 30s)
|
|}

== Returned Parameters ==
=== Returned Parameters ===
These parameters are returned by Remote Admin

{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''success''
| true when successful
| true, false
|-
|''error''
| the error that occurred (ie: authentication failed messages)
|
|-
|''token''
| the authentication token
|
|}

=== Error Messages ===
''error'' is set to "scene does not exist" in case no scene is available.

''error'' is set to "avatar FIRSTNAME LASTNAME does not exist" in case the avatar with FIRSTNAME LASTNAME does not exist.

''error'' is set to "no password provided for FIRSTNAME LASTNAME" in case the call did not include a password for the avatar named FISTNAME LASTNAME.

''error'' is set to "no token lifetime provided for FISTNAME LASTNAME" if the ''token'' parameter has been omitted from the call.

''error'' is set to "token lifetime longer than 30s for FISTNAME LASTNAME" in case the request asked for ''token_lifetime'' larger than 30.

''error'' is set to "no authentication module loaded" in case no authentication module could be loaded.

''error'' is set to "authentication failed for FIRSTNAME LASTNAME" in case the authentication failed for user FISTNAME LASTNAME.

= Examples =

Using the ''wasRemoteAdmin'' class from [http://was.fm/opensim:remote_admin Wizardry and Steamworks remote admin page], a call can be made to ''admin_authenticate_user'' to authenticate the avatar ''Kira Komarov'' using Remote Admin:

<source lang="php">
<?php
# include the KOS class
require_once 'wasRemoteAdmin.php';
# create a new connection to the OpenSim server
# with the hostname "OPENSIM" and port "10000"
# using the password "password"
$req = new wasRemoteAdmin('http://OPENSIM:10000', 'password');
# send the console command "show info" to OpenSim
print $req->admin_authenticate_user('Kira', 'Komarov', 'mypassword', '10');
</source>

which sends the request to OpenSim and returns an XML structure documented in the following section.

=== Return XML ===

''admin_authenticate_user'' returns an XML structure indicating whether an error occurred or if the call was successful.

==== Success ====

On a successful call to ''admin_authenticate_user'', the following is an example of the returned XML.

<source lang="php">
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>success</name>
<value>
<boolean>1</boolean>
</value>
</member>
<member>
<name>token</name>
<value>
<string>670962bb-7942-4d66-b7dc-b669b97e842e</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
</source>

==== Failure ====

On an unsuccessful call to ''admin_authenticate_user'', the following is an example of the returned XML.

<source lang="xml">
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>success</name>
<value>
<boolean>0</boolean>
</value>
</member>
<member>
<name>error</name>
<value>
<string>authentication failed for Kira Komarov</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>

</source>

[[RemoteAdmin]]
[[RemoteAdmin:Commands]]

RemoteAdmin:admin authenticate user

2013-11-22T14:40:59Z

Kira Komarov:

'''admin_authenticate_user''' remotely allows to authenticate an user remotely. This feature is part of the development branch, after the 0.7.6 OpenSim release.

=== Enabling admin_authenticate_user ===
If not all functions are enabled, use admin_authenticate_user to enable the function in the [RemoteAdmin] section
<source lang="csharp">
enabled_methods = admin_authenticate_user,...
</source>

== Parameters ==
=== Required Parameters ===
These parameters are required
{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''user_firstname''
| first name of user
|
|-
| ''user_lastname''
| last name of user
|
|-
| ''user_password''
| and MD5 hash of the user's password
|
|-
| ''token_lifetime''
| the lifetime of the authentication token (max: 30s)
|
|}

== Returned Parameters ==
=== Returned Parameters ===
These parameters are returned by Remote Admin

{| cellspacing="0" cellpadding="4" border="1"
|-
! parameter
! Description
! Values
|-
| ''success''
| true when successful
| true, false
|-
|''error''
| the error that occurred (ie: authentication failed messages)
|
|-
|''token''
| the authentication token
|
|}

=== Error Messages ===
''error'' is set to "scene does not exist" in case no scene is available.

''error'' is set to "avatar FIRSTNAME LASTNAME does not exist" in case the avatar with FIRSTNAME LASTNAME does not exist.

''error'' is set to "no password provided for FIRSTNAME LASTNAME" in case the call did not include a password for the avatar named FISTNAME LASTNAME.

''error'' is set to "no token lifetime provided for FISTNAME LASTNAME" if the ''token'' parameter has been omitted from the call.

''error'' is set to "token lifetime longer than 30s for FISTNAME LASTNAME" in case the request asked for ''token_lifetime'' larger than 30.

''error'' is set to "no authentication module loaded" in case no authentication module could be loaded.

''error'' is set to "authentication failed for FIRSTNAME LASTNAME" in case the authentication failed for user FISTNAME LASTNAME.

= Examples =

Using the ''wasRemoteAdmin'' class from [http://was.fm/opensim:remote_admin|Wizardry and Steamworks remote admin page], a call can be made to ''admin_authenticate_user'' to authenticate the avatar ''Kira Komarov'' using Remote Admin:

<source lang="php">
<?php
# include the KOS class
require_once 'wasRemoteAdmin.php';
# create a new connection to the OpenSim server
# with the hostname "OPENSIM" and port "10000"
# using the password "password"
$req = new wasRemoteAdmin('http://OPENSIM:10000', 'password');
# send the console command "show info" to OpenSim
print $req->admin_authenticate_user('Kira', 'Komarov', 'mypassword', '10');
</source>

which sends the request to OpenSim and returns an XML structure documented in the following section.

=== Return XML ===

''admin_authenticate_user'' returns an XML structure indicating whether an error occurred or if the call was successful.

==== Success ====

On a successful call to ''admin_authenticate_user'', the following is an example of the returned XML.

<source lang="php">
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>success</name>
<value>
<boolean>1</boolean>
</value>
</member>
<member>
<name>token</name>
<value>
<string>670962bb-7942-4d66-b7dc-b669b97e842e</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
</source>

==== Failure ====

On an unsuccessful call to ''admin_authenticate_user'', the following is an example of the returned XML.

<source lang="xml">
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>success</name>
<value>
<boolean>0</boolean>
</value>
</member>
<member>
<name>error</name>
<value>
<string>authentication failed for Kira Komarov</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>

</source>

[[RemoteAdmin]]
[[RemoteAdmin:Commands]]

RemoteAdmin:admin authenticate user

2013-11-22T12:56:05Z

Kira Komarov:

RemoteAdmin:admin authenticate user

2013-11-22T12:54:09Z

Kira Komarov: /* Error messages */

RemoteAdmin:admin authenticate user

2013-11-22T12:53:12Z

Kira Komarov: Created page with " '''admin_authenticate_user''' remotely allows to authenticate an user remotely. This feature is part of the development branch, after the 0.7.6 OpenSim release. === Enabling a..."

RemoteAdmin

2013-11-22T12:39:09Z

Kira Komarov: /* User account management */

{{Quicklinks}}

== Introduction ==

RemoteAdmin is an interface for simulators that allows various operations to be executed from outside the simulator. '''Operations that relate to the simulator itself (e.g teleport user) are always available. Those that relate to grid services (user creation and updating) are only available in standalone mode. In grid mode, one has to use ROBUST level [[UserManipulation]] capabilities instead.'''

== How to Setup the Remote Admin interface ==

First you should enable the remote admin interface to do so just add the following lines to your OpenSim.ini file Port should be set to a nonzero value to have the remote admin on a different port

As of r/16843 you can limit access to remote admin to specific IP addresses by using the optional access_ip_addresses. You can list all IP's allowed to access remote admin by seperating each IP by a comma. If access_ip_addresses isn't set, then all IP addresses can access RemoteAdmin.

[RemoteAdmin]
enabled = true
access_password = secret
enabled_methods = all

See OpenSim.ini.example in the OpenSimulator distribution for more details.

=== Further options ===

You can also specify a different port for the XMLRPCAdmin command listener from the default simulator HTTP port

[RemoteAdmin]
port = <port-number>

== RemoteAdmin Commands ==
<div style="background-color:#ffa0a0; padding:15px">
'''Caution ! All commands using parameters for the uuid of a region use "region_id" as parameter. All other parameters eg. region_uuid or regionID will be removed after June 2012'''
</div>

=== Agent management ===
*[[Remoteadmin:admin teleport agent|admin_teleport_agent]]
*[[Remoteadmin:admin get agents|admin_get_agents]] (post OpenSimulator 0.7.5)

=== User account management ===
*[[RemoteAdmin:admin create user|admin_create_user]]
*[[RemoteAdmin:admin create user email|admin_create_user_email]]
*[[RemoteAdmin:admin exists user|admin_exists_user]]
*[[RemoteAdmin:admin update user|admin_update_user]]
*[[RemoteAdmin:admin authenticate user|admin_authenticate_user]]

=== Object management ===

=== Parcel management ===

=== Region management ===
*[[RemoteAdmin:admin broadcast|admin_broadcast]]
*[[RemoteAdmin:admin close region|admin_close_region]]
*[[RemoteAdmin:admin create region|admin_create_region]]
*[[RemoteAdmin:admin delete region|admin_delete_region]]
*[[RemoteAdmin:admin modify region|admin_modify_region]]
*[[RemoteAdmin:admin region query|admin_region_query]]
*[[RemoteAdmin:admin restart|admin_restart]]
*[[RemoteAdmin:admin shutdown|admin_shutdown]]

=== Region file management ===
{{multicol}}
* [[RemoteAdmin:admin load heightmap|admin_load_heightmap]]
* [[RemoteAdmin:admin load oar|admin_load_oar]]
* [[RemoteAdmin:admin load xml|admin_load_xml]]
* [[RemoteAdmin:admin save heightmap|admin_save_heightmap]]
* [[RemoteAdmin:admin save oar|admin_save_oar]]
* [[RemoteAdmin:admin save xml|admin_save_xml]]

=== Region access management ===
* [[RemoteAdmin:admin acl list|admin_acl_list]]
* [[RemoteAdmin:admin acl clear|admin_acl_clear]]
* [[RemoteAdmin:admin acl add|admin_acl_add]]
* [[RemoteAdmin:admin acl remove|admin_acl_remove]]

=== Estate management ===
* [[RemoteAdmin:admin estate reload|admin_estate_reload]]

=== Administration ===
* [[RemoteAdmin:admin console command|admin_console_command]]

== Subcategories ==

* [[RemoteAdmin:RemoteAdmin Examples|RemoteAdmin Examples]]
* [[RemoteAdmin:RemoteAdmin Proposals|RemoteAdmin Proposals]]
* [[RemoteAdmin:RemoteAdmin Standards|RemoteAdmin Standards]]
* [[RemoteAdmin:RemoteAdmin Implement new command|RemoteAdmin How to implement new commands]]

[[Category:Development]]
[[Category:RemoteAdmin]]

RemoteAdmin

2013-11-22T12:38:48Z

Kira Komarov: /* User account management */

{{Quicklinks}}

== Introduction ==

RemoteAdmin is an interface for simulators that allows various operations to be executed from outside the simulator. '''Operations that relate to the simulator itself (e.g teleport user) are always available. Those that relate to grid services (user creation and updating) are only available in standalone mode. In grid mode, one has to use ROBUST level [[UserManipulation]] capabilities instead.'''

== How to Setup the Remote Admin interface ==

First you should enable the remote admin interface to do so just add the following lines to your OpenSim.ini file Port should be set to a nonzero value to have the remote admin on a different port

As of r/16843 you can limit access to remote admin to specific IP addresses by using the optional access_ip_addresses. You can list all IP's allowed to access remote admin by seperating each IP by a comma. If access_ip_addresses isn't set, then all IP addresses can access RemoteAdmin.

[RemoteAdmin]
enabled = true
access_password = secret
enabled_methods = all

See OpenSim.ini.example in the OpenSimulator distribution for more details.

=== Further options ===

You can also specify a different port for the XMLRPCAdmin command listener from the default simulator HTTP port

[RemoteAdmin]
port = <port-number>

== RemoteAdmin Commands ==
<div style="background-color:#ffa0a0; padding:15px">
'''Caution ! All commands using parameters for the uuid of a region use "region_id" as parameter. All other parameters eg. region_uuid or regionID will be removed after June 2012'''
</div>

=== Agent management ===
*[[Remoteadmin:admin teleport agent|admin_teleport_agent]]
*[[Remoteadmin:admin get agents|admin_get_agents]] (post OpenSimulator 0.7.5)

=== User account management ===
*[[RemoteAdmin:admin create user|admin_create_user]]
*[[RemoteAdmin:admin create user email|admin_create_user_email]]
*[[RemoteAdmin:admin exists user|admin_exists_user]]
*[[RemoteAdmin:admin update user|admin_update_user]]
*[[RemoteAdmin:admin update user|admin_authenticate_user]]

=== Object management ===

=== Parcel management ===

=== Region management ===
*[[RemoteAdmin:admin broadcast|admin_broadcast]]
*[[RemoteAdmin:admin close region|admin_close_region]]
*[[RemoteAdmin:admin create region|admin_create_region]]
*[[RemoteAdmin:admin delete region|admin_delete_region]]
*[[RemoteAdmin:admin modify region|admin_modify_region]]
*[[RemoteAdmin:admin region query|admin_region_query]]
*[[RemoteAdmin:admin restart|admin_restart]]
*[[RemoteAdmin:admin shutdown|admin_shutdown]]

=== Region file management ===
{{multicol}}
* [[RemoteAdmin:admin load heightmap|admin_load_heightmap]]
* [[RemoteAdmin:admin load oar|admin_load_oar]]
* [[RemoteAdmin:admin load xml|admin_load_xml]]
* [[RemoteAdmin:admin save heightmap|admin_save_heightmap]]
* [[RemoteAdmin:admin save oar|admin_save_oar]]
* [[RemoteAdmin:admin save xml|admin_save_xml]]

=== Region access management ===
* [[RemoteAdmin:admin acl list|admin_acl_list]]
* [[RemoteAdmin:admin acl clear|admin_acl_clear]]
* [[RemoteAdmin:admin acl add|admin_acl_add]]
* [[RemoteAdmin:admin acl remove|admin_acl_remove]]

=== Estate management ===
* [[RemoteAdmin:admin estate reload|admin_estate_reload]]

=== Administration ===
* [[RemoteAdmin:admin console command|admin_console_command]]

== Subcategories ==

* [[RemoteAdmin:RemoteAdmin Examples|RemoteAdmin Examples]]
* [[RemoteAdmin:RemoteAdmin Proposals|RemoteAdmin Proposals]]
* [[RemoteAdmin:RemoteAdmin Standards|RemoteAdmin Standards]]
* [[RemoteAdmin:RemoteAdmin Implement new command|RemoteAdmin How to implement new commands]]

[[Category:Development]]
[[Category:RemoteAdmin]]

Related Software

2013-05-13T10:26:48Z

Kira Komarov:

{{Quicklinks}}
{{thirdparty}}
= Introduction =
This is a page which lists software packages that are related to OpenSimulator but are not part of the core project. Opensimulator is not responsible for the content referenced by these links.

== OpenSimulator Viewers ==
See [[Connecting]].

== OpenSimulator Distributions ==
See [[Download#Other_Distributions]].

== OpenSimulator ROBUST replacements ==
These can be divided into projects that provide a completely replacement for the ROBUST services backend or can replace individual services.

=== Complete replacements ===
* [https://github.com/openmetaversefoundation/simiangrid/commits/master SimianGrid] - A ROBUST services replacement which replaces the whole ROBUST stack with an alternative implementation based on PHP. The necessary support for SimianGrid is included in core OpenSimulator.

=== Individual service replacements ===
OpenSimulator services are architected such that an individual service (e.g. the asset service) can be replaced without having to upgrade other services.

* [https://github.com/coyled/sras Simple Ruby Asset Service (SRAS)] - This is a replacement for the ROBUST asset service. It stores assets on disk, does compression and deduplication of identical assets.

== Web Interfaces==
See [[Webinterface]]

== Addon Modules ==
These are either application or region modules which can be added to the OpenSimulator core distribution to provide extra functionality.

* [https://github.com/aduffy70/Chat-Logger Chat-Logger] - An OpenSimulator region module to log chat traffic. Includes visitor alerts (when logging starts, stops, or new visitors enter the region) so the logging is transparent. Developed as a tool for meetings, training sessions, or educational environments.

* [https://github.com/JakDaniels/OpenSimTide OpenSimTide] - An OpenSimulator region module which adds tides to your regions. You can control the tide period and height change via settings in OpenSim.ini and enable tide info to be chatted to the region for use in scripts in boats and waves. Tides only render properly on regions that are not adjacent, i.e. 1x1 islands.

== Other OpenSimulator Forge Projects ==
{{content}}
OpenSimulator now has a [http://forge.opensimulator.org/gf/ forge] for related software.
* [http://forge.opensimulator.org/gf/project/osinstaller OpenSimulator Installers]
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)]
* [http://forge.opensimulator.org/gf/project/openterrains/ Open Source Terrain Textures]
* [http://forge.opensimulator.org/gf/project/osraw/ Open Source RAW Terrain Textures]
* [http://forge.opensimulator.org/gf/project/ostray/ OSTray]
* [http://forge.opensimulator.org/gf/project/sllauncher/ SL Launcher]
* [http://forge.opensimulator.org/gf/project/openusermanual/ Open User Manual]
'''todo''' list some of the top opensim forge projects.

=== These are old projects that no longer appear to be maintained ===
* [http://forge.opensimulator.org/gf/project/deepservers/ DeepServer (ASP.NET Grid Server)]
* [http://forge.opensimulator.org/gf/project/modrex/ realXtend Modules]
* [http://forge.opensimulator.org/gf/project/ogp/ OGP Patches]

== Other related software ==
These are independent implementations of OpenSimulator services, such as the user server or the inventory server (also known as UGAI).

* [http://www.ics.uci.edu/~lopes/terraingen/ Terraingen] - Tool for producing OpenSimulator terrains from USGS DEM files.
* [[RegionGenerator]] - Generates Region XML Files
* [http://www.secondinventory.com/ Second Inventory] - A Windows based client that can be used to back up and restore objects from Second Life™ as well as from various OpenSimulator based grids. It allows you to back up objects from the Second Life™ main grid, and restore them into OpenSimulator grids. It is still a bit primitive and sometimes can be flaky.
* [http://was.fm/opensim:rake Rake] - Created as an alternative to Second Inventory, but OpenSource and free to use. Rake is meant to dump assets (textures, animations, notecards, scripts, etc...) from either Second Life™ or OpenSim to your local hard-drive.
* [http://www.metabolt.net/ METAbolt] - METAbolt is a non-graphical (text based) viewer. It's light weight and cross grid, which means it will work in Second Life™ as well as other grids that are based on OpenSIM. The viewer is Open Source so it's free. Currently METAbolt is only available for Windows platforms.
* [http://3di-opensim.com/en/ 3Di OpenSimulator Enterpise] - Business service based on OpenSimulator.
* [http://3di-rei.org/ 3Di Viewer Rei] - Web Browser based Viewer.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?sl_proxy%20%28E%29 sl_proxy] - sl_proxy is a Proxy System for Second Life™ and OpenSimulator to beyond firewall.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?XoopenSim%20(E) XoopenSim] - OpenSimulator WEB Interface for Xoops Cube. This module was made by remodeling [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)]. v1.55 supports 0.6.7/0.6.8/0.6.9/0.7.x, and it includes flotsam group function and [http://www.nsl.tuis.ac.jp/svn/opensim/opensim.osprofile/ modified osprofile] function.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Modlos%20(E) Modlos] - OpenSimulator WEB Interface for Moodle-1.9. This is a sister program of XoopenSim.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OpenSim%2FMoneyServer Money Server (NSL Version)] - This Money Server is modified version of [http://forge.opensimulator.org/gf/project/currency/ DTL Currency Processing] for Linux/Unix.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Rinions Rinions] - This is a real-time animation tool for Second Life™/OpenSim. Rinions sends animation data from Kinect to Viewer in real time using shared memory and over the Network.
* [http://www.mobilegridclient.com/] - Mobile Grid Client. A Second Life and OpenSim (Open Simulator) messaging client for your Android powered device (mobile phone, cell phone, tablet...).

== Concepts ==
* [http://www.cs.cmu.edu/~johnny/projects/wii/ 3D Head Tracking Software] - The idea here is that Johnny has written an application that will allow real3d perspective using a WiiMote & a modified set of safety glasses. Johnny includes all of the source and several sample applications to get this moving forward. Would someone like to pick this up and build us a real3D interface for the SL browser? It's not as hard as you think.

* [http://en.wikipedia.org/wiki/Edusim Edusim on Opensim] - Edusim is a [http://en.wikipedia.org/wiki/Cave_Automatic_Virtual_Environment Cave Automatic Virtual Environment] based concept of lesson driven 3D virtual worlds on the ''classroom interactive whiteboard or classroom interactive surface''. Currently Edusim on Opencobalt Cobalt exists but tweaking a client and making Opensim "finger friendly" would seem to be a relatively straight forward task.

= See Also =
* [[:Category:Development|Development]]

[[Category:Users]]
[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]

OSSLNPC

2013-03-31T17:12:06Z

Kira Komarov:

{{Quicklinks}}
 
=Introduction=

Since OpenSimulator 0.7.2, a number of functions are provided for for creating and manipulating server-side NPCs (Non Player Characters). These replace the previous functions, that had stopped working by OpenSimulator 0.7.1.1 (possibly broken since OpenSimulator 0.6.9).

The general philosophy in creating these new functions is to

# Give script writers the simple tools needed to create more sophisticated behaviour.
# Avoid duplicating existing LSL and OSSL functions. For instance, finding out what state an agent is in can be done through llGetAgentInfo() rather than creating a special NPC function.

NPCs are controlled via a script which must be in the same region as the NPC. This could be housed in an attachment that is attached to the avatar.

Server-side NPCs cannot leave the region in which they were born. If you want region crossing behaviour, please look at the alternative NPC options on the [[NPC]] wiki page.

Server-side NPC appearance is saved and loaded by serializing the appearance data structure to a notecard present in the same prim as the script. The required textures will be preserved when an OAR is saved and loaded.

The current appearance data format (as seen in notecards created by appearing saving) is the same used for the OpenSimulator wire format and so is not designed to be edited directly. With great care it is possible, see [[Appearance Formats]] for more details but it's not recommended unless you really, really need to do it.

= Enabling =

To use these functions, in the OpenSim.ini file you will need the following config

# Enabled = true set in the [NPC] section.
# Enabled = true set in the [XEngine] section.
# AllowOSFunctions = true in the [XEngine] section.
# OSFunctionThreatLevel = VeryHigh in the [XEngine] section. The functions osAgentSaveAppearance(), osAvatarPlayAnimation() and osAvatarStopAnimation() need this level. If you don't need these functions, then a "High" level will suffice.

See [[Configuring Simulator Parameters#Getting information about parameters]] if you need to double check that these parameters have been set correctly.

= Notes =

* When using your avatar to model appearance before saving, you will need to wait a few seconds before invoking any save appearance command. This is because appearance saving currently operates on a timer in order to manage multiple appearance updates from the viewer.
* OpenSimulator 0.7.3-rc1 introduces the concept of 'owned' and 'unowned' NPC. An 'owned' NPC is one where only the creating script and other scripts with the same owner can manipulate the NPC. An 'unowned' NPC is one where any script with the right permissions (as defined in the [XEngine] configuration section) can manipulate it. In OpenSimulator 0.7.3, all avatars are 'owned' by default unless otherwise specified in the osNpcCreate() call.

= Sensing =

llAgentSensor() can be used to set up a sensor that will detected NPCs instead/of as well as other region entities.

In OpenSimulator 0.7.2, LSL sensors will detect NPCs as ordinary agents.

In OpenSimulator 0.7.3-rc1 onwards, unless otherwise specified, NPCs will only be detected using the OpenSimulator-specific NPC flag, e.g.

As of git master bcfc392 (Fri Jul 20 21:08:04 2012), the constant OS_NPC should now be used instead of NPC, in order to avoid future issues if LL decide to use NPC themselves for some other function. The NPC constant will be deprecated in the forthcoming OpenSimulator 0.7.4 release but will remain useble.

<source lang="lsl">
//Author: mewtwo0641

list keys = [];
key npc;
string toucher;
key toucherkey;
vector toucherPos;
integer npc_on = FALSE;

default
{
touch_start(integer x)
{
toucherkey = llDetectedKey(0);
toucherPos = llDetectedPos(0);
vector npcPos = llGetPos() + <1,1,1>;

if(npc_on == FALSE)
{
npc = osNpcCreate("Fred", "Flintstone", npcPos, toucherkey);
npc_on = TRUE;
llSensor("", "", AGENT | NPC, 96.0, PI); //Will always return NPC key regardless of npc create option
return;
}

if(npc_on == TRUE)
{
osNpcRemove(npc);
llResetScript();
}
}

sensor(integer num)
{
keys = [];
integer i = 0;

for(i; i < num; i++)
{
keys += llDetectedKey(i);
}

llOwnerSay(llDumpList2String(keys, "\n"));
}

no_sensor()
{
keys = [];
}
}
</source>

You can get NPCs to be detected as AGENTs again using the OS_NPC_SENSE_AS_AGENT option below in osNpcCreate().

The justification is that detecting NPCs as AGENTs by default may make some scripts unusable (e.g. radars that know nothing about NPCs). However, conversely other scripts may not behave as expected if NPCs aren't sensed as agents (e.g. doors that open automatically for avatars would not open for NPCs).

From OpenSimulator git master commit ecf7bb26 (Fri Jul 20 21:36:33 2012), llGetDetectedType() will set the OS_NPC flag if an NPC was detected. If the NPC was created with the OS_NPC_SENSE_AS_AGENT option then the AGENT flag will also be set.

= Data Formats =
For more information about the format used to store appearance information in notecards, see [[Appearance Formats]].

= Functions =

== Create and Remove ==
=== [[osNpcCreate]] ===

osNpcCreate(string firstname, string lastname, vector position, string cloneFrom):key

cloneFrom may be:

* Name of the notecard containing a serialized avatar appearance, or
* Asset UUID of the Notecard, or
* UUID of an avatar logged into the same region. However, please note that this appearance will not be persisted unless osNpcSaveAppearance() is called.

If the NPC is successfully created, then its UUID is returned, which is required for all subsequent functions. Example is available at [[osNpcCreate]]

(OpenSimulator 0.7.3-rc1 onwards only). This creates an NPC that is 'owned' by the creating script and sensed using the OpenSimulator-only NPC flag for sensors.

=== osNpcCreate ===

OpenSimulator 0.7.3-rc1 onwards.

osNpcCreate(string firstname, string lastname, vector position, string cloneFrom, integer options):key

cloneFrom may be:

* Name of the notecard containing a serialized avatar appearance, or
* Asset UUID of the Notecard, or
* UUID of an avatar logged into the same region. However, please note that this appearance will not be persisted unless osNpcSaveAppearance() is called.

integer is a set of flags that may be 0 or one or more of

* OS_NPC_NOT_OWNED - create an unowned NPC.
* OS_NPC_SENSE_AS_AGENT - create an NPC that is sensed as an AGENT with LSL sensors

If the NPC is successfully created, then its UUID is returned, which is required for all subsequent functions. Example is available at [[osNpcCreate]]

=== [[osNpcRemove]] ===

osNpcRemove(key npc):void

Remove the given avatar from the region. Example at [[osNpcRemove]].

== Get and Set ==
=== osIsNpc ===

OpenSimulator 0.7.3-rc1 onwards.

osIsNpc(key npc):integer

Returns TRUE if the given key is an NPC, false otherwise.

=== [[osNpcGetRot]] ===

Gets the rotation of the avatar. Only the rotation around the Z plane in Euler rotation (horizontal rotation) has any meaning.

osNpcGetRot(key npc):rotation

=== [[osNpcSetRot]] ===

osNpcSetRot(key npc, rotation rot):void

Set the rotation of the avatar. Only setting the rotation in the Z plane in Euler rotation will have any meaningful effect (turning the avatar to point in one direction or another). Setting X or Y Euler values will result in the avatar rotating in an undefined manner.

=== [[osNpcGetPos]] ===

osNpcGetPos(key npc):vector

Return the current position of the NPC.

=== [[osNpcGetOwner]] ===

OpenSimulator 0.7.3-rc1 onwards.

osNpcGetOwner(key npc):key

Return the owner of the given NPC (i.e. the owner of the script that created it). If the NPC is unowned or the input key does not belong to an NPC then returns NULL_KEY.

== Movement ==

=== [[osNpcMoveTo]] ===

osNpcMoveTo(key npc, vector position):void

An older function that performs an osNpcMoveToTarget() by flying and landing at the target.

=== [[osNpcMoveToTarget]] ===

osNpcMoveToTarget(key npc, vector target, int options):void

Move the avatar to a given target over time. How the avatar will get there depends on the following options.

* OS_NPC_FLY - Fly the avatar to the given position. The avatar will not land unless the OS_NPC_LAND_AT_TARGET option is also given.
* OS_NPC_NO_FLY - Do not fly to the target. The NPC will attempt to walk to the location. If it's up in the air then the avatar will keep bouncing hopeless until another move target is given or the move is stopped
* OS_NPC_LAND_AT_TARGET - If given and the avatar is flying, then it will land when it reaches the target. If OS_NPC_NO_FLY is given then this option has no effect.
* OS_NPC_RUNNING - if given, NPC avatar moves at running/fast flying speed, otherwise moves at walking/slow flying speed.

OS_NPC_FLY and OS_NPC_NO_FLY are options that cannot be combined - the avatar will end up doing one or the other. If you want the avatar to fly and land at the target, then OS_NPC_LAND_AT_TARGET must be combined with OS_NPC_FLY. For instance,

osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY|OS_NPC_LAND_AT_TARGET);

=== [[osNpcStopMoveToTarget]] ===

osNpcStopMoveToTarget(key npc):void

Stop a current move to a target.

== Sitting and standing ==

=== osNpcSit ===

OpenSimulator 0.7.3-rc1 onwards.

osNpcSit(key npc, key target, int options):void

Sit an NPC on a prim target. As yet there are no options, so always input 0.

=== osNpcStand ===

OpenSimulator 0.7.3-rc1 onwards.

osNpcStand(key npc):void

Make an npc stand up.

== Communication ==

=== [[osNpcSay]] ===

osNpcSay(key npc, string message):void
osNpcSay(key npc, int channel, string message):void

Get the NPC to say the given message.

If channel is specified then the chat is said on the given channel. The channel parameter is only available in OpenSimulator 0.7.4 development code at this time.

=== [[osNpcShout]] ===

Only in OpenSimulator 0.7.4 development code at this time.

osNpcShout(key npc, int channel, string message):void

Get the NPC to shout the given message on the given channel.

=== [[osNpcWhisper]] ===

Only in OpenSimulator 0.7.4 development code at this time.

osNpcWhisper(key npc, int channel, string message):void

Get the NPC to whisper the given message on the given channel.

== Animations ==

=== osNpcPlayAnimation ===

OpenSimulator 0.7.3-rc1 onwards.

osNpcPlayAnimation(key npc, string animation):void

Get an NPC to play an animation. The animation can either be a key or the name of an animation in the same inventory as the script.

=== osNpcStopAnimation ===

In OpenSimulator 0.7.3-rc1 there is a bug which makes this play the animation instead. This will be corrected for the final release but in the mean time please use osAvatarStopAnimation() instead.

osNpcStopAnimation(key npc, string animation):void

Get an NPC to stop playing an animation. The animation can either be a key or the name of an animation in the same inventory as the script.

== Appearance ==

NPC appearance is manipulated by saving and loading appearance data to notecards from the same inventory as the invoking script.

=== [[osOwnerSaveAppearance]] ===

osOwnerSaveAppearance(string notecard):key

Save the owner's current appearance to a notecard in the prim's inventory. This includes body part data, clothing items and attachments. If a notecard with the same name already exists then it is replaced. The owner must be present in the region when this function is invoked. The baked textures for the owner (necessary to recreate appearance on the NPC) are saved permanently.

=== [[osAgentSaveAppearance]] ===

osAgentSaveAppearance(key agentId, string notecard):key

Save an arbitrary avatar's appearance to a notecard in the prim's inventory. This includes body part data, clothing items and attachments. If a notecard with the same name already exists then it is replaced. The avatar must be present in the region when this function is invoked. The baked textures for the avatar (necessary to recreate appearance on the NPC) are saved permanently.

=== [[osNpcSaveAppearance]] ===

osNpcSaveAppearance(key npc, string notecard):key

Save the NPC's current appearance to a notecard in the prim's inventory. This includes body part data, clothing items and attachments. If a notecard with the same name already exists then it is replaced. The avatar must be present in the region when this function is invoked. The baked textures for the avatar (necessary to recreate appearance) are saved permanently.

=== [[osNpcLoadAppearance]] ===

osNpcLoadAppearance(key npc, string notecard):void

Load appearance from a notecard. This notecard must contain appearance data created with one of the save appearance functions.

== Touch ==
=== [[osNpcTouch]] ===

OpenSimulator 0.7.4 development code at this time.

osNpcTouch(key npc, key objectKey, integer linkNum)

Allows the NPC to touch objects.

= Examples =

== NPC Automator ==

*[[NPC Automator 2.0]]

This is a rough example script for most of the current NPC functionality. One of its major current deficiencies is that it doesn't track more than one created avatar at a time. Please feel free to improve it.

<source lang = "lsl">
key npc;
integer listenChannel = 10;

default
{
// NPC manipulator adapted by justincc 0.0.3 released 20121025
state_entry()
{
llListen(listenChannel,"",NULL_KEY,"");
llSetText("Listening on " + listenChannel, <0, 255, 0>, 1);
llOwnerSay("Say /" + (string)listenChannel + " help for commands");
}

listen(integer channel, string name, key id, string msg)
{
if (msg != "")
{
list commands = llParseString2List(msg, [ " " ], []);
string msg0 = llList2String(commands, 0);
string msg1 = llList2String(commands, 1);
string msg2 = llList2String(commands, 2);
string msg3 = llList2String(commands, 3);

if (msg0 == "create")
{
if (msg1 != "")
{
string notecardName = msg1;

npc = osNpcCreate("Jane", "Doe", llGetPos() + <5, 5, 0>, notecardName);

llOwnerSay("Created npc from notecard " + notecardName);
}
else
{
llOwnerSay("Usage: create <notecard-name>");
}
}
else if (msg0 =="createm" && msg1 != "")
{
osOwnerSaveAppearance("appearance");
vector pos = llGetPos();
integer i;
for (i = 0; i < (integer)msg1; i++)
{
osNpcCreate("John", "Doe", pos + <8, 0, 0>, "appearance");
llSleep(1);
}
}
else if (msg0 == "remove" && npc != NULL_KEY)
{
osNpcSay(npc, "You will pay for this with your liiiiiivvveeessss!!!.....");
osNpcRemove(npc);
}
else if (msg0 == "say" && npc != NULL_KEY)
{
osNpcSay(npc, "I am your worst Nightmare!!!!");
}
else if (msg0 == "move")
{
if (msg1 != "" && msg2 != "" && npc != NULL_KEY)
{
vector delta = <(integer)msg1, (integer)msg2, 0>;

if (msg3 != "")
{
delta.z = (integer)msg3;
}

osNpcMoveTo(npc, osNpcGetPos(npc) + delta);
}
else
{
llOwnerSay("Usage: move <x> <y> [<z>]");
}
}
else if (msg0 == "moveto")
{
if (msg1 != "" && msg2 != "" && npc != NULL_KEY)
{
vector pos = <(integer)msg1, (integer)msg2, 0>;

if (msg3 != "")
{
pos.z = (integer)msg3;
}

osNpcMoveTo(npc, pos);
}
else
{
llOwnerSay("Usage: move <x> <y> [<z>]");
}
}
else if (msg0 == "movetarget" && npc != NULL_KEY)
{
osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY|OS_NPC_LAND_AT_TARGET);
}
else if (msg0 == "movetargetnoland" && npc != NULL_KEY)
{
osNpcMoveToTarget(npc, llGetPos() + <9,9,5>, OS_NPC_FLY);
}
else if (msg0 == "movetargetwalk" && npc != NULL_KEY)
{
osNpcMoveToTarget(npc, llGetPos() + <9,9,0>, OS_NPC_NO_FLY);
}
else if (msg0 == "rot" && npc != NULL_KEY)
{
vector xyz_angles = <0,0,90>; // This is to define a 1 degree change
vector angles_in_radians = xyz_angles * DEG_TO_RAD; // Change to Radians
rotation rot_xyzq = llEuler2Rot(angles_in_radians); // Change to a Rotation
rotation rot = osNpcGetRot(npc);
osNpcSetRot(npc, rot * rot_xyzq);
}
else if (msg0 == "rotabs" && msg1 != "")
{
vector xyz_angles = <0, 0, (integer)msg1>;
vector angles_in_radians = xyz_angles * DEG_TO_RAD; // Change to Radians
rotation rot_xyzq = llEuler2Rot(angles_in_radians); // Change to a Rotation
osNpcSetRot(npc, rot_xyzq);
}
else if (msg0 == "animate" && npc != NULL_KEY)
{
osAvatarPlayAnimation(npc, "stabbed+die_2");
llSleep(3);
osAvatarStopAnimation(npc, "stabbed+die_2");
}
else if (msg0 == "save" && msg1 != "" && npc != NULL_KEY)
{
osNpcSaveAppearance(npc, msg1);
llOwnerSay("Saved appearance " + msg1 + " to " + npc);
}
else if (msg0 == "load" && msg1 != "" && npc != NULL_KEY)
{
osNpcLoadAppearance(npc, msg1);
llOwnerSay("Loaded appearance " + msg1 + " to " + npc);
}
else if (msg0 == "clone")
{
if (msg1 != "")
{
osOwnerSaveAppearance(msg1);
llOwnerSay("Cloned your appearance to " + msg1);
}
else
{
llOwnerSay("Usage: clone <notecard-name-to-save>");
}
}
else if (msg0 == "stop" && npc != NULL_KEY)
{
osNpcStopMoveToTarget(npc);
}
else if (msg0 == "sit" && msg1 != "" && npc != NULL_KEY)
{
osNpcSit(npc, msg1, OS_NPC_SIT_NOW);
}
else if (msg0 == "stand" && npc != NULL_KEY)
{
osNpcStand(npc);
}
else if (msg0 == "help")
{
llOwnerSay("Commands are:");
llOwnerSay("create <notecard-name> - Create NPC from a stored notecard");
llOwnerSay("createm");
llOwnerSay("remove - Remove current NPC");
llOwnerSay("clone <notecard-name> - Clone own appearance to a notecard");
llOwnerSay("load <notecard-name> - Load appearance on notecard to current npc");
llOwnerSay("save <notecard-name> - Save appearance of current NPC to notecard");
llOwnerSay("animate");
llOwnerSay("move");
llOwnerSay("moveto <x> <y> <z> - move to absolute position");
llOwnerSay("movetarget");
llOwnerSay("movetargetnoland");
llOwnerSay("movetargetwalk");
llOwnerSay("rot");
llOwnerSay("say");
llOwnerSay("sit <target-uuid>");
llOwnerSay("stop");
llOwnerSay("stand");
}
else
{
llOwnerSay("I don't understand [" + msg + "]");
}
}
}
}
</source>

== Wandering and Puppeteer ==

[http://was.fm Wizardry and Steamworks] provides free-to-use NPC extendable set of scripts, published under the GPLv3 license, that implements most of the NPC functions and allows you to conveniently create NPCs. There are several several scripts available at the time of writing:

* [http://was.fm/opensim:npc:wandering Wandering NPCs] is a script that just makes a non-interative NPC wander around in a given area.
* [http://was.fm/opensim:npc:puppeteer NPC Puppeteer] is a system that will allow you to playwright NPCs without too much knowledge of either LSL or OSSL.

= Questions/Comments =

Please leave your questions and comments on [[Talk:OSSLNPC|this article's talk page]].

[[Category:OSSL Functions]]
[[Category:Scripting]]

Banning Foreign Users in Hypergrid

2013-02-24T17:54:07Z

Kira Komarov:

__NOTOC__
{{Quicklinks}}

= Banning Foreign Users =

Even though the current viewers are incapable of dealing with foreign users, it is possible to ban specific foreign users from your estates. For now, you have to do it on the backend, i.e. directly editing the database and reviewing the log. Not easy for the faint of heart, but any sys admin should be able to do this with their eyes shut. What follows are instructions for adding a foreign user to the estate's ban list.

== Via the Database ==

The first thing you need to do is to find out the UUID and IP address of the user you want to ban. For that you need to look at OpenSim.log. Search for log messages like this:

2009-01-23 03:45:11,995 INFO - OpenSim.Region.Communications.Hypergrid.HGGridServicesGridMode [HGrid]: Incoming HGrid Agent
Annoying.Person http://problematic.domain.org:9002
2009-01-23 03:45:11,995 DEBUG - OpenSim.Region.Environment.Scenes.Scene [CONNECTION BEGIN]: Region Gateway 3000 told of incoming client
Annoying.Person http://problematic.domain.org:9002 c3c9ecbf-bfb3-43eb-8dce-140afad7995f (circuit code 1896255323)

In this case, the information you need is: UUID = c3c9ecbf-bfb3-43eb-8dce-140afad7995f and IPAddress = problematic.domain.org

Next, let's add this foreign user to the ban list. Note that the estate information and ban lists are kept at the region server, not in the UGAIM. If you are using local storage for your regions, this information is stored in bin/OpenSim.db. So, open that DB with whatever tool you use to access your DBs. The instructions here assume a local sqlite database; if you're using MySql or other DB technologies for the regions' storage, the instructions are almost identical, but may need adjustments.

SqlLite usually comes with a common Linux installation. In Linux, just type:

$ sqlite3 OpenSim.db

In Windows, you need to get it from [http://www.sqlite.org/download.html here]. Once installed, run it on your OpenSim.db, like this, for example (on a command shell):

$ C:/Opt/SQLite3/sqlite3.exe OpenSim.db

Once you are connected to the database, you can explore as much as you want. What follows are the concrete interactions you need for adding that foreign user into an estate ban list. Change the data for your situation.

[opensim@ucigrid04 bin]$ sqlite3 OpenSim.db
SQLite version 3.3.6
Enter ".help" for instructions
sqlite> .tables
estate_groups estate_users migrations regionban
estate_managers estateban primitems regionsettings
estate_map land prims terrain
estate_settings landaccesslist primshapes
sqlite> .schema estateban
CREATE TABLE estateban (
EstateID int(10) NOT NULL,
bannedUUID varchar(36) NOT NULL,
bannedIp varchar(16) NOT NULL,
bannedIpHostMask varchar(16) NOT NULL,
bannedNameMask varchar(64) default NULL
);
CREATE INDEX estate_ban_estate_id on estateban(EstateID);
sqlite> select EstateID, EstateName from estate_settings;
100|My Estate
101|My Estate
102|My Estate
103|My Estate
sqlite> insert into estateban values (100, 'c3c9ecbf-bfb3-43eb-8dce-140afad7995f', 'problematic.domain.org', ' ', ' ');
sqlite> insert into estateban values (101, 'c3c9ecbf-bfb3-43eb-8dce-140afad7995f', 'problematic.domain.org', ' ', ' ');
sqlite> insert into estateban values (102, 'c3c9ecbf-bfb3-43eb-8dce-140afad7995f', 'problematic.domain.org', ' ', ' ');
sqlite> insert into estateban values (103, 'c3c9ecbf-bfb3-43eb-8dce-140afad7995f', 'problematic.domain.org', ' ', ' ');
sqlite> select * from estateban;
100|c3c9ecbf-bfb3-43eb-8dce-140afad7995f|problematic.domain.org||
101|c3c9ecbf-bfb3-43eb-8dce-140afad7995f|problematic.domain.org||
102|c3c9ecbf-bfb3-43eb-8dce-140afad7995f|problematic.domain.org||
103|c3c9ecbf-bfb3-43eb-8dce-140afad7995f|problematic.domain.org||
sqlite> .quit

Once this data is entered you need to restart OpenSim, so that it gets loaded.

== On the Network Level ==

The following guide is an excerpt from the [http://was.fm/opensim:banning_agents full article at Wizardry and Steamworks]. The principle is that all viewers are meant to send a MAC address that is hashed using a hex digest algorithm. Since under linux iptables understands only MAC addresses, we can use ipt_string to match the MAC address.

For example, when a user connects to a grid, whether it is a direct login or a hypergrid teleport, a string like the following is displayed:

<pre>
OpenSim.Services.HypergridService.GatekeeperService [GATEKEEPER SERVICE]:
Login request for Jaine Mariolack @ http://virtualrealmsgrid.com:8002/
(0a009e79-7c56-11e2-b122-000c76240986) at VIBE using viewer
Imprudence 1.3.2.0, channel Imprudence,
IP 109.112.128.89,
Mac d6812bb4d7625027d53c2e9715410caf,
Id0 dd76693a887c545f4d65c2ff2da3a4d7
Teleport Flags 0
</pre>

the segment that reads '''d6812bb4d7625027d53c2e9715410caf''' is the hashed MAC address which gets sent by the viewer.

We can block that with iptables:
<pre>
iptables -A INPUT -m string --string 'd6812bb4d7625027d53c2e9715410caf' --algo bm -p tcp --dport 9000 -j DROP
</pre>

Additionally, we can even block the agent using their firstname and lastname:
<pre>
iptables -A INPUT -m string --string 'Jaine' --algo bm -m string --string 'Mariolack' --algo bm -p tcp --dport 9000 -j DROP
</pre>

The result is that the viewer will time-out while trying to teleport or while logging in.

[[Category:Hypergrid]]

NPC

2013-02-22T16:05:07Z

Kira Komarov:

{{Languages|NPC}}
= Introduction =

Broadly speaking, there are 3 ways in which Non Player Characters (NPCs) aka bots, can be operated in OpenSimulator.

== 1. Client side approaches ==

For instance, use [http://openmetaverse.org/projects/libopenmetaverse libopenmetaverse] to operate an avatar as if it were being controlled through the viewer.

This wiki does contain some information on how to do this - see

* [[Building a bot]] - Getting started with bot design using libomv from the client side
* [[pCampBot]] - A facility for stress-testing opensim which can be used as bot example code.

However, better information can be found elsewhere, since this method applies to both Linden Lab and other third party grids.

This is how bots have been traditionally done in SL, since Linden Lab provide no scripting methods for NPCs or direct access to the server software. One advantage of this method, as stated above, is that it can easily be ported between Linden Lab and third party grids, since it only relies on the client interface (leaving aside whether the grid has a policy about allowing bots). It also allows bots to go anywhere and do anything that a human could do, with the right programming. One disadvantage is that it requires user accounts to exist for the bots.

== 2. osNpc*() scripting functions ==

OpenSimulator provides a set of OSSL NPC functions for creating and manipulating bots. Please see [[OSSLNPC]] for more details.

One advantage of this approach is that no external client is necessary for a bot, and bot appearances can be saved in OpenSimulator Archives (OARs). One disadvantage is that there is a much more limited subset of functionality available, since script methods have to be written to control different aspects of an NPC. Also, such bots cannot move out of the region in which they are created.

== 3. Region Module ==

In OpenSim, the osNpc*() script methods use the internal NPCModule to actually manage and manipulate bots. Another region module could call the NPCModule methods directly. One advantage of this approach is that bot management may be easier in C# than in LSL/OSSL. One disadvantage is that any change to a region module requires recompilation and restart of the simulator in which it is hosted.

= Resources =

* The [http://was.fm/opensim:npc Wizardry and Steamworks NPC page] contains some freely available NPC scripts, including a wandering NPC, and an NPC that uses a simple notecard-based language to "playwright" an NPC. It was used for creating "scenarios" on an educational, health-related simulator.

[[Category:Scripting]]

Performance

2013-02-15T06:42:36Z

Kira Komarov: /* Database */

{{Quicklinks}}

= Introduction =
OpenSimulator performance is a very complex issue. Performance can be affected by any number of things, including the number of prims on a region, number of regions, number of avatars, network quality between server and viewer, network quality between simulator and grid services, etc.

We can break down a performance discussion into simulator issues (e.g. script performance, region database performance) and grid issues (chiefly scaling services such as asset, inventory, etc to serve more simulators and users).

= General Tips =

* Where at all possible, don't assume something is a performance bottleneck, measure it! You might think your asset database is large, for example, but even large asset database seldom cause real issues.
* Make as many objects phantom as possible. Phantom objects do not need to be tested for collisions with avatars and other objects, reducing physics frame time and increasing performance.
* Make as few objects subject to physics (e.g. falling under gravity, movable by other avatars) as possible. Physics objects need a lot more collision testing than ordinary non-phantom objects.
* It can be hard to perform measurement at the moment since not a lot of tools exist. However, one such is [[pCampbot]] which is bundled with OpenSimulator. This can instantiate a number of simultaneous libomv clients on a simulator that can take certain actions such as clicking things and bouncing aroud. Apects of it (e.g. appearance) are currently rather buggy and generate a lot of logging guff.

= Simulator =

== Hardware Requirements ==
Unfortunately, this is a very difficult question in light of all the factors mentioned in the introduction.

However, we can say that OpenSimulator does not run well when it only has access to a single CPU core - you should regard a dual-core machine as the minimum.

Below are some examples of hardware people use/have used. Please feel free to add to the list, or to add any reports to the performance studies and blog posts section. '''These are examples to help you in your selection, not recommendations.'''

Object Parts ~= # prim

Sensors and Timers are generally more intensive then regular scripts, so please specify quantity of each.

{| border="1"
!Description
!Operating System (please add Mono version if appropriate)
!OpenSimulator version
!RAM/AVG_USE_%
!CPU
!#/type of regions
!# simultaneous avs
!#scripts/timers/Sensors
!Location
!#objectparts
|-
|hosted Xen VPS
|Ubuntu Intrepid (8.10)
|Unknown
|540MB/?
|1x quad-core 2.5GHz Xeon (L5420)
|1 region + 9 voids
|generally 1-2
|few
|Knifejaw Atoll & surrounding on OSGrid
|?
|-
|hosted Xen VPS
|Ubuntu Jaunty (9.04)
|Unknown
|360MB/?
|2x dual-core 2.0GHz Xeon (5130)
|1 void
|generally 1-2
|none
|Knifejaw Road on OSGrid
|?
|-
|Dedicated Server from A+
|Windows Server 2003
|Unknown
|1 Meg
|1x single-core 2.8GHz Celeron
|2regions per server
|6 at once with no issues
|Waterfalls, texture anims, window texture switchers, lots of sound loops
|Pleasure Planet Welcome center & Region Pleasure Planet in OSGrid
|20000 prims per region
|-
|Amazon EC2 "high-CPU medium instance" (Xen VM)
|Windows Server 2003
|Unknown
|1.7GB
|1x dual-core 2.3GHz (Intel E5345)
|1 region with sailing race course
|7 avs, 4 in boats
|scripted start line
|Castle Rock, OSGrid
|
|-
|Dedicated Server from simhost.com
|SuSe 11.2 x64
|Unknown
|8gb / 50%
|4x Core2Quad Q9300 2.6ghz
|1 region (Wright Plaza) uses approx 4gb ram
|20-25 users
|Freebie Stores / Meeting Center / Video Theater
|@osgrid.org Heavy Use Sim
|17500 prims aprox 1500 scripts
|-
|Home machine
|Windows XP SP3
|0.7.0.1 (Diva r13558)
|3GB / 15-40% incl. Opensim and MySQL
|4x Core2Quad Q6600 2.4 GHz. Use: generally, 0-10%
|11 regions
|1-6 users
|Many scripted objects (1934 scripts)
|[http://zonjacapalini.wordpress.com/2010/08/25/condensation-land-a-status-report/ Condensation Land]
|38,065 prims
|-
|Home machine
|Ubuntu Lucid 10.04 (32 bit pae)
|0.7.0.1 (Diva r13558)
|160Mb no users, add 5Mb/user incl Opensim and MySQL
|I7-920 (dual threaded quad core), 3.8Ghz, 6Gb RAM, 0-10% Load
|4 regions (Diva default config)
|1-4 users (approx 20Kb/sec bandwidth/user)
|Few scripted objects (<10)
|[http://mars-simulator.hobby-site.org:9000/wifi Mars Simulation]- Based on [http://metatek.blogspot.com/2010/06/mars-simulation-for-distribution.html Erik Nauman's Open Blackboard]
|158 prims
|-
|Hosted Dedicated OVH
|Suse 12.2
|0.7.0.2 (D2)
|420Mb total, incl OS, Opensim and MySQL
|i7 Quad 950 (Bloomfield) 3.07GHz, 8 Core, 24Gb RAM, 0-1% Avg Load
|16 regions (4x4 mega-region)
|<6 users
|vehicle scripted objects (<5)
|[http://metaversesailing.com:9000/wifi Metaverse Sailing]
|<1000 prims
|-
|VPS
|Debian Lenny 5 (mono 2.4.2.3)
|OSgrid 0.7.1 (Dev) cd4d7a7: 2010-10-15
|655MB average out of 1722MB RAM, incl. MySQL
|Intel Quadcore 2.5 Ghz (1 core assigned to vps) average use: 40-45%
|20 regions
|<4 users
|about 20 different light scripts, but we're also experimenting with heavier HUD scripts (timers, lots of ll(Get/Set)PrimitiveParams and large lists) and custom IRC relay
|Phoenix Rising Isles on OsGrid
|3727 prims
|}

== Database ==

By default, OpenSimulator is configured to use the SQLite database. This is very convenient for an out-of-the-box experience since it requires no configuration. However, it's not designed for heavy usage, so if you build very quickly or have more than a few people on your simulator then you will start to see performance issues.

Therefore, we recommend that you switch to MySQL as soon as possible. This will provide a much better experience but will take a little bit of work to set up.

Unfortunately, tools for migrating OpenSimulator SQLite data to MySQL are currently limited. Migration is also possible by saving OARs/IARs of your data from sqlite and loading them up once you've reconfigured to use MySQL.

There is also a database plugin for MSSQL but this is not well maintained between OpenSimulator releases.

In standalone mode, both services and the simulator itself can use SQLite. In grid mode, SQLite is only supported for simulator data - the ROBUST instances must use a MySQL (or MSSQL) database.

In general a single MySQL instance for the ROBUST services instance will serve small, medium and even large grids perfectly well - it's a configuration that's widely used for even quite large websites.

== Configuration tweaks ==

There are a couple of OpenSimulator configuration tweaks that you can do to significantly improve script loading performance in certain situations. These tweaks can be made in your OpenSim.ini config file. These apply to current OpenSimulator development code (0.7.3-dev) and may also apply to 0.7.2, though certainly not any earlier.

===Set DeleteScriptsOnStartup = false===

[XEngine]
DeleteScriptsOnStartup = false

This means that OpenSimulator will not delete all the existing compiled script DLLs on startup (don't worry, this setting doesn't touch the actual LSL scripts in your region). This will significantly improve startup performance. However, if you upgrade OpenSimulator in place (e.g. you regularly update your installation directly from development code) then you may occasionally see problems if code changes and your previously compiled DLLs can't find their old references.

In this case, you can either set DeleteScriptsOnStartup = true for one restart in order to clean out and recompile script DLLs or you can manually delete the relevant bin/ScriptEngines/<region-uuid>/*.dll.* files, which will force OpenSimulator to recompile them. You could also delete the entire bin/ScriptEngines/<region-uuid> directory but this would lose all persisted script state (which is kept in the <script-item-id>.state files).

===Set AppDomainLoading = false===
[XEngine]
AppDomainLoading = false

By default, OpenSimulator loads every script DLL into its own AppDomain. If this is set to false, then all scripts are loaded into OpenSimulator's default AppDomain instead.

This will significantly improve script startup times and reduce initial per-script memory overhead.

However, setting this to false will also prevent derezzed script DLLs from being removed from memory (only whole AppDomains can be unloaded). This might cause an OutOfMemory problem over time, as avatars with scripted attachments move in and out of the region. Whether this is a problem for you will depend on factors such as the avatar population of your grid.

In addition, Windows users have reported script loading problems with AppDomainLoading = false, though I (justincc) haven't been able to replicate this with current OpenSimulator code on my WindowsXP machine.

= Grid =

Scaling a grid is a very complex task and only for the very technically inclined. It is also an area under active investigation. The advice below will change considerably over time as OpenSimulator and its environment changes and we learn more about perfomrnace issues.

When would you start to meet grid scaling issues? As an extremely rough and really quite arbitrary and pessimistic rule of thumb, you will probably start to have to think about things when you exceed 50 regions containing a large number of prims or 50 simultaneous users with large inventories. But this will very a tremendous amount depending on your situation. If you have thousands of regions with very few prims that much more supportable than 50 regions with 45000 prims each.

You are likely to encounter issues in two areas - database and services.

== Database ==

=== Assets ===

==== The problem ====

Due to the architecture of distributed architecture of OpenSimulator, where regions are running on a number of different machines over a network, it's extremely hard to identify assets that are not in use and hence can be deleted. Equally, the fact that assets are immutable leads to continual growth in the asset database.

In theory, one could identify unused assets if one could identify all references in simulators and in user inventory. However, this is extremely hard to do where machines are distributed over a network. If a grid only has a few simulators all running on machines that are controlled by the same entity running a grid, then it becomes a little more tractable but even then would almost certainly involve significant downtime. For stand-alone grids, or for environments where assets are not passed between grids (ie: giving a texture to a friend on another grid) [http://was.fm Wizardry and Steamworks] provides an experimental script that will do exactly that. It is currently available at the [http://was.fm/opensim:database:asset_cleaner asset cleaner] project page and published under an MIT license.

Asset deletion would be easier for a one simulator grid or a standalone. However, even code to implement asset deletion on standalones has not yet been implemented and would certainly require significant simulator downtime.

A promising area of research involves improving OpenSimulator's recording of asset access times (e.g. recording access periodically). Then assets which aren't accessed for a long time (e.g. a year) could be deleted or moved to cold storage (e.g. DVD). One is left with the problem of not deleting assets permanently cached by simulators but perhaps this could be solved by the simulators occasionally 'pinging' the asset service with notification of what assets they cache.

Another step to reduce asset database size is to eliminate duplicate assets by hashing. There is [[Deduplicating Asset Service|an experimental development asset service]] for this. Third party services such as [[https://github.com/coyled/sras SRAS]] also do this.

==== Possible solutions ====

* If you run a grid for yourself or, if you run a grid where you do not give away your content, then the [http://was.fm/opensim:database:asset_cleaner asset cleaner] from [http://was.fm Wizardry and Steamworks] may be a good solution to track down stray assets and delete them from the database automatically. It is based on dumping OARs and IARs, as per the second option in this section, but after dumping them, it automatically performs the search for you and prompts you to delete several supported assets. Current development is going towards automatically exporting OARs and IARs from PHP so that the procedure is made seamless.

* Save every region to an OAR and every user's inventory to an IAR. We believe this is equivalent to finding all referenced assets and can be done manually. However, it's very laborious for installations with a large number of users and requires grid downtime. Tools could be written to improve this, particularly in systematically saving all user inventories to IARs.

* Do nothing. MySQL can store a very large amount of data before encountering issues - it's used for extremely large websites and other applications after all. This assumes you have the disk space.

* Use an external asset service such as [[https://github.com/coyled/sras SRAS]]. SRAS, in particular, is a third party asset service that does deduplication, asset compression, and stores assets on disk rather than in a database. It also has some nice features like preventing assets being served without deleting them. It's used by OSGrid, for instance. However, it does work in a different way from the bundled OpenSimulator asset service (e.g. backup of on-disk assets involves some extra steps compared to just backing up a database). It also requires a migration step that may take a considerable time if you have an existing asset collection.

=== Other databases ===

The space required by assets far outweighs other data storage requirements so only asset data is generally an issue.

== Services ==

=== The problem ===

The other problem is with handling the number of requests to services when the number of simulators and users grow. The asset service isn't generally a problem since simulators cache all assets used, though it can form a bottleneck on OAR upload. The biggest issue is generally caused by users, chiefly due to inventory access and perhaps update last user positions in the GridUser service (and database table).

ROBUST uses an embedded [[http://webserver.codeplex.com/ C# HttpServer]]. Performance comparisons to other Webservers (e.g. Apache) have not been carried out (?) but responses appears to be much, much slower. As it has been discontinued it's also rather unlikely to have it's performance improved. In future, OpenSimulator may embed a different HTTP server but this is extremely unlikely in the short term.

=== Possible solutions ===

* Split up services. By default, ROBUST runs every service in one process. However, because services are separate from each other, you could run some services (e.g. inventory in one ROBUST instance and other services (e.g. asset) in a different instance, even if they both point to the same database. Because the embedded C# webserver is slow and possibly not very concurrent, this can achieve significant performance improvements even if all ROBUST instances are running on the same machine.

* Instantiate extra ROBUST copies of problem services (e.g. inventory). Because services are stateless (akin to a webservice), you can load balance requests between multiple instances using a reverse proxy such as nginx. Again, because the embedded webserver is probably inefficient, you can achieve performance improvements by running multiple copies of services on the same machine.

* Use an external service based on a more efficient HTTP server, e.g. [https://github.com/coyled/sras SRAS] (asset service only) or [http://code.google.com/p/openmetaverse/ SimianGrid]. Please be aware that SimianGrid uses a different set of simulator <-> service protocols than used by ROBUST. The necessary SimianGrid adaptors are part of the core OpenSimulator distribution.

* Write your own services to run on an external webserver. This wouldn't be too hard to do in something like PHP, though one would need to work out the currently undocumented wire formats. If you do this, please do let us know :)

= Performance studies and blog posts =

These provide some interesting data on the performance limitations of OpenSimulator at various points in time.

* [https://lists.berlios.de/pipermail/opensim-users/2010-August/005189.html https://lists.berlios.de/pipermail/opensim-users/2010-August/005189.html] - Some interesting information from Mr Blue. Physical objects and max avatars are limited by single thread performance in OpenSimulator.
* [http://www.sciencesim.com/wiki/doku.php/vwperf/start http://www.sciencesim.com/wiki/doku.php/vwperf/start] - Links to ScienceSim performance studies, including some very recent ones.
* [[Improving Performance]] - An old page from July 2009 detailing some performance issues on OpenSimulator. Some of these issues are still valid (e.g. ODE issues).
* [[NHibernate Performance Testing]] — SQLite and MySQL performance tests with NHibernate.
* [[LibSecondLife performance problems]] - Another old page from November 2007 detailing issues with libsecondlife (now called libopenmetaverse).
* [http://opensim.cybertechnews.org/?p=71 Experiences from Operating a 3D Region Server in OSGrid - Part 1]
* [http://opensim.cybertechnews.org/?p=104 Experiences from Operating a 3D Region Server in OSGrid - Part 2]

Public Hypergrid Nodes

2013-02-14T18:02:46Z

Kira Komarov:

{{Quicklinks}} 

__TOC__

== Hypergrid-enabled sims ==

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 at the bottom of the list if you wish to help build a web of opensims! Anyone found inserting a grid higher in the list may have their entry removed.

For the time being, and until the security concerns are addressed, we advise you to be careful about who you link to.

== Hypergrid 1.5 - General Grids/Sims ==

The following is a list of hypergrid 1.5-ready nodes that you can use for testing your installation and for linking your world. Please add your public node at the bottom of the list if you wish to help build a web of opensims! Anyone found inserting a grid higher in the list may have their entry removed.

 

{| cellspacing="0" cellpadding="5" border="1" align="center" style=""-
! [[Hypergrid|link-region server and port]]
! Organization
! Description
! Grid Location
|-
| vibe.bio-se.info:9000
| VIBE / BIO-SE Grid
| A multi-University effort for Education in Virtual Worlds. Servers are located in the US. Newcommer friendly! For collaboration please e-mail [mailto:stephen.xootfly@gmail.com Stephen Xootfly]. 
Wiki: [http://wiki.bio-se.info Main Page] 
Registration: [http://vibe.bio-se.info:9000/wifi Signup] 
| Centered at 5000,5000
|-
| ucigrid00.nacs.uci.edu:8002
| UCI Grid
| [http://ucigrid00.nacs.uci.edu:8002 UCIGrid] V 0.7.1 (post-fixes)
| Centered at 5000,5000
|-
| hypergrid.org:8002
| Metropolis Metaversum
| [http://hypergrid.org:8002 Metropolis Metaversum] V 0.7.4 (Dev)
| Centered at 7000,7000
|-
| login.germangrid.de:8002
| GermanGrid
| [http://www.germangrid.de GermanGrid] V 0.71(dev)
| Centered at 8000,8000
|-
| marlokir.selfip.net:9000
| Marlokir
| Just a small standalone for testing running on version 0.7.1 (dev).
It will probably be online only temporarily.

| Centered at 4500,4500
|-
| gridnirvana.net:8002:Rhiga
| Jez's World
| A small private Estate, previously stand alone - but for now part of GridNirvana.
Please feel free to pop over and visit.

| Centered at 6500,6500
|-
| virtual.aiai.ed.ac.uk:8002:Openvue
| Openvue
| Openvue grid at Virtual University of Edinburgh
| Centered at 1000,1000
|-
| virtual.aiai.ed.ac.uk:8002:Vue-5000
| Vue-5000
| Openvue grid at Virtual University of Edinburgh
| Centered at 5000,5000
|-
| virtual.aiai.ed.ac.uk:8002:Vue-9000
| Vue-9000
| Openvue grid at Virtual University of Edinburgh
| Centered at 9000,9000
|-
| 145.99.250.20:8002
| DWGrid
| DWGrid
| Centered at 7000,7000
|-
| metaversesims.net:9000
| Metaverse Sims
| 6-region standalone hypergrid on V 0.7.6 Dev (HG 2.0 enabled as of 02 Nov 12)
| Centred at 9000,9000
|-
| opensim.betatechnologies.info:8002
| Beta Technologies OpenSimulator Grid (btgrid)
| Grid for internal development, mostly for academic research and backups from old sims. V. 0.7.5 Dev (also HyperGate-enabled). Currently on a low-bandwidth server so HG access might not be very good.
| Centered at 3650,3650
|-
| hippo.is-a-geek.com:8002
| The Bloomfield Grid
| This is a personal grid for my friends and familly, However we welcome others with a smile. V. 0.7.0.1 (We are also Hyper Gate enabled)
| Centered at 5000,5000
|-
| tritongrid.com:8002
| Triton Grid
| This is a 100+ region Public grid. All are welcome (We are also Hyper Gate enabled in several regions throughout the grid) (HG 1.5X Interface 7 Runing the latest .71Dev revs. maintains creator data)
| Centered at 9000,9000
|-
| condensationland.com:9000
| Condensation Land
| 10 regions
| Centered at 7789, 7789
|-
| chazzmac.webhop.org:9000
| eden 16 regions
| full 3 story hidden freebie mall, HyperGate, WiFi at http://chazzmac.webhop.org:9000/wifi/
| Centered at 3917, 4144
|-
| metaversesailing.com:9000
| Sailing Grid
| A D2 grid on V 0.7.2(release)a .Net hosted 16 region mega with support regions
| Centered at 7000,7000
|-
| ogzoco.no-ip.org:8002
| Ogzoco Grid & RaionFort
| Mentolyptus Destiny testing & work grid. Hypergrid 1.5, OpenSimulator 0.7.1 (Currently OsGrid Revision 0.7.1.dev.80f9022 - 10-22-2010). Gateway to multiple grids on map. Photos: http://www.flickr.com/photos/mentolyptus/ - Twitter: https://twitter.com/Ogzoco - EMail: ogzoco@gmail.com
| Centered at 7852, 7852
|-
| grid.ansky.ca:8002
| AnSky Grid
| 10 regions
| Centered at 7100, 7100
|-
| sim-world.org:8003
| Sim-World Welcome Center
| 41 regions
| Centered at 10000, 10000
|-
| unethika.kicks-ass.net:8002
| unethika
| It works (most of the time) and it's fun! Come via hg hop or snag an avatar at [http://unethika.kicks-ass.net/ http://unethika.kicks-ass.net/] ! We also run a working(ish) Freeswitch server. <no guarantees, of course :P>
| Centered at 7500, 7500
|-
| fleepgrid.com:8002
| FleepGrid
| Personal research grid operated by Fleep Tuque, 8-12 sims at any given time. Grid hoppers and testers welcome. Running Opensim 0.7.2 RC2 Release HG 1.5 (i7). Gateway regions available at (1013,1013), (5013,5013), and (13013,13013). See [http://fleepgrid.com http://fleepgrid.com] for more information or follow Fleep at [http://twitter.com/fleep http://twitter.com/fleep].
| Centered at 9013, 9013
|-
| viradu.com:9000
| Viradu Science Fiction World
| [[Image:Vban.jpg|thumb|left|180px]]12 Science Fiction themed regions run by Michael Blade Sci-fi blogger dedicated to writers and those who love it. Hypergrid Teleporters, Builders welcome, free land grab, rules apply. Tell others about us...Join in the fun! => [http://viradu.com http://viradu.com] How to build your own virtual world here => [http://rocketvirtual.com RocketVirtual.com]
| Centered at 5001, 5001
|-
| 62.40.147.45:9090
| Psychedelia Grid
| The home of psychedelic music. This Grid is for all fans of psychedelic music. Watch the bands playing at the festival and stay over night in your tent.
| centered at 6000, 5990
|-
| '''logicamp.dyndns.org:8002:logicamp'''
| Logicamp
| [http://www.logicamp.com/ Logicamp] is a virtual world specialized in camp-site management and virtual tourism. You can visit it throughout our cable network.
| Centered at 8000, 8000
|-
| logicamp.dyndns.org:8002:SPA1 
| [http://www.logicamp.com logicamp] 
| Megaregion Entrance (7997,7994) Spa-Francorchamp[[Image:Snapshot 037.png|thumb|none|128px]]60 plot Megaregion - [http://logicamp.com logicamp] 
| Centered at 7900, 7900 
|-
| map.terravirtuavw.com:8002:Nexus 
| [http://www.terravirtuavw.com Terra Virtua] 
| The Terra Virtua intergrid nexus. 
| 6000,6000 
|-
| hg.osgrid.org:80:WestHall
| Possible future home of Champlain College in Burlington, Vermont 
| When there, check the map and TP to surrounding regions that are populated with "stuff"br>
| Centered at 6100, 6107 
|-
| www.pmgrid.org:8002
| [http://www.pmgrid.org PMGrid]
| Nursery grid to enable people to try their builds at little or no cost. Land available to try your ideas without charge.
| Centered at 7000,7000 
|-
| 91.121.153.154:8002
| [http://www.opensimserver.tk Sofitek]
| Sofitek grid, the virtual offices of Sofitek, a web development company. Includes a small selection of free avatars and a hypergate portal to other worlds. Check out the books in the office, and talk to chatbot Lady Sofitek.
| Centered at 10000,10000 
|-
| [AstralGrid]
| [http://astral.dyndns-server.com Homepage]
| 4 Freebies and 1 sandbox Region
| Centered at 10000,10000 
|-
| http://clonelife.eu:8002:Welcome 
| Clonelife.eu
| Website at http://clonelife.eu/
| Centered at 9000,9000 
|-
| http://YourSimSpot.com:9000:YourSimSpot
| [http://YourSimSpot.Com YourSimSpot.Com]
| A hosting solution for 3D virtual worlds.
| Centered at 1000,1000
|-
| opensim.nl:58002
| [http://bi.pndo.nl '''BUSINESS INSPIRE''']
| '''[opensim.nl:58002:OSNL-PLAZA]'''
'''Landingpoint coordinates: 127,127,27''' 
The central HYPERGRID service for all GRIDS in the Netherlands. Please feel welcome to visit our PLAZA and jump to other DUTCH GRID's like our RolePlay GRID. Send a mail to: mailto:silverj@xs4all.nl if you like to connect your grid in our MAP!
| Centered at 8000,8000
|-
| rp.opensim.nl:28002
| [http://bi.pndo.nl '''BUSINESS INSPIRE''']
| '''[rp.opensim.nl:28002:RPHUB]'''
'''Landingpoint coordinates: 127,127,27''' 
The International RolePlay GRID located in the Netherlands. Please feel welcome to visit our RPHUB and jump into RolePlay on one of the islands. You can get a free account at http://rp.opensim.nl:28002/wifi/index.html. There are posibilities to have your own RolePlay SIM in our RPGRID. For more information send a mail to: mailto:silverj@xs4all.nl
| Centered at 9000,9000
|-
| '''62.40.147.45:9100'''
| Austria Grid
| A virtual copy of the country Austria. This Grid is for all those who want to find their hometown in the virtual landscape of a virtual Austria.This Grid is not only for creating a virtual Austria, it's a meeting point, a place for communication. For permanent link-exchange, write an email.
| centered at 7000, 6990
|-
| http://74.170.99.194:9000
| M001 http://www.sirius-engineering.org/aboutsiriusengineeringamp7portals/
| 36 Region Estate, Hypergrid enabled with Primary Hypergate located on Region 000 at coordinates 36,40,25. Server built and maintained by Dolph Gehlbard.
| Starting Region Centered at 9221,9881
|-
| http://hg.osgrid.org:80:imagenhariaead2
| [http://hg.osgrid.org:80 imagenhariaead2]
| The Internet as a tool of education. Learning is action. Otherwise it is just information. Moodel/Sloodle/Pivote - 24h Online – http://bitly.com/imagenharia - http://vendasmais.com/moodle 
| Centered at 10009, 10005 
|-
| hgplaza.no-ip.org:9000:Hg Plaza
| Hypergrid Plaza (24/24)
| General Meeting Point, trying to establish a unique database for freinship,groups, searches for Hypergids Standalones
To Direct Tel|eport Copy This to your map!!!

hgplaza.no-ip.org:9000:Hg Plaza
| Centered at 9999,9999
Hg PLaza 2k 1999.1999
Hg Plaza 5k 5999,5999
|
|-
| iu1.typnetwork.com:8002:Pitic
| Zairus
| Island continent
| Centered at 10000,10000
|}

== Hypergrid 1.5 - Education oriented grid/sims ==

* https://sites.google.com/a/opensim-edu.org/educational-institutions-in-opensim/home - A list of OpenSimulator educational grids, some Hypergrid enabled. This list has an easy to use form to add new institutions!

== External directories of Hypergrid-enabled sims ==

* [http://www.gridhop.net GridHop]
* [http://www.hyperica.com Hyperica]
* [http://thehypergates.com/ The HyperGates] -- The first dynamic, auto-updating HyperGrid directory for HyperGrid enabled standalones & grids. Download the HyperGate from our site now and Join the HyperGate Network. The most reliable HyperGrid directory.
* [http://www.hgurl.com hgurl]

== Old List (HG 1.0) ==

Keeping this here for historical reasons, but most of these don't work anymore.
 

{| border="1" cellspacing="0" cellpadding="5" align="center"
|-
! [[Hypergrid|link-region server and port]]
! Organization
! Description
! Grid Location
|-
| '''osl2.nac.uci.edu:9006'''
| University of California, Irvine
| The "UCI Welcome" region connected to OSGrid. It is run by Diva (Crista Lopes) on a machine owned by the University of California, Irvine. You can link to it as a way to link to OSGrid.
| OSGrid is centered at 10,000, 10,000
|-
| '''osl3.nac.uci.edu:9000'''
| University of California, Irvine
| The "UC Irvine" region connected to OSGrid, neighboring Wright Plaza. You can link to it as a way to link to OSGrid.
| OSGrid is centered at 10,000, 10,000
|-
| '''ucigrid02.nacs.uci.edu:9000'''
| University of California, Irvine
| The UCI Grid
| UCIGrid is centered at 8,888, 8,888
|-
| '''ucigrid04.nacs.uci.edu:9003'''
| University of California, Irvine
| The UCI Grid, region "Gateway 3000". Link your lower-1,000's grid to this node in order to bridge to grids in the 10,000's.
| This node is positioned at 3,000, 3,000
|-
| '''ucigrid04.nacs.uci.edu:9007'''
| University of California, Irvine
| The UCI Grid, region "Gateway 7000". Link your 10,000's grid to this node in order to bridge to grids in the lower-1,000's.
| This node is positioned at 7,000, 7,000.
|-
| '''www.meanduland.com:9124'''
| Grid Meanduland
| [http://www.menduland.com], Meanduland - by Ayana and Frank Northmead. Residential grid and playground for couples. Quite, peaceful and fun. Regular live music concerts and coming soon - rpg's, adventure simulations, private beaches, sail boat racing, dune buggy racing, and much much more. All welcome, no membership or landownership requirements, you just need desire to have fun and be a good neighbor. Regions available at cost during Alpha and Beta development of OpenSimulator.
| Centered at 8000, 8000
|-
| '''hypergrid.cyberlandia.net:9100'''
| Cyberlandia
| The "Cyberlandia Gw" region. http://www.cyberlandia.net Metaverso italiano 3D, more to 250 region and 1000 users. You can link to it as a way to link to Cyberlandia.
| Cyberlandia is centered at ???
|-
| '''venezia.cyberlandia.net:9100'''
| Cyberlandia
| The "Osgrid Gw" region connected to Cyberlandia grid http://www.cyberlandia.net. Search on map "Cyberlandia grid" You can link to it as a way to link to OSGrid.
| OSGrid is centered at 10,000, 10,000
|-
| '''regions.ralf-haifisch.biz:9000:Sharkland Tropical 1'''
| Ralf Haifisch on osgrid
| The "Sharkland Tropical" region connected to OSGrid. German welcome aerea, Freebie aerea, region rental, pretty tropical regions
| Centered at 10000,10000
 

|-
| '''joomla-italia.net:9000'''
| Social Network Italia
| The "SNI City" region connected to SNI (Social Network Italia) grid http://www.opensim-italia.net. This grid is connected with Osgrid,Collateral World,Francogrid and Darwin
| Centered at ???
|-
| '''collateral.opensim-italia.net:9000'''
| Part of Social Network Italia
| Collateral World
| Centered at ???
|-
| '''88.191.79.199:9050'''
| Francogrid
| Francogrid node, connected to "City", behind the welcome land of Francogrid "Orion"
| Centered at 1000 1000
|-
| '''94.23.8.158:9300'''
| Le Monde de Darwin
| The Lost World of Darwin http://www.LeMondedeDarwin.com. [[Image:Hypergrid.jpg|200px]]
| Centered at 1000 1000
|-
| '''sg.k-grid.com:9000'''
| K-Grid
| The Kool grid for the Kool KidZ . Feel free to visit us. The main Gateway is located at 3700,3700 so take that in account before any HyperJump. Adress updated 02/07/09
| This node is located at 3700,3700
|-
| '''hypergrid.org:8002'''
| METROPOLIS-Grid
| The Region "Center-World" connected to the METROPOLIS-Grid http://metropolis.hypergrid.org . German Grid with a lot of free Content and free SIM-hosting. Connected via HG to the most of the Grids listed here
| Centered at 7000,7000
|-
| '''ascent.bluewallgroup.com:9910'''
| BlueWall Information Technologies
| This region is in a good proximity @ (6000,6000) for intermediate jumps to OSGrid from grids in the (2000,2000) range, or any region within 4096 units. [[Image:Hypernaut 001.png|thumb|none|150px|Get your Hypernaut here :)]]
| Centered at 6000,6000
|-
| '''http://myopengrid.com:9005/'''
| '''MyOpenGrid'''
| Myopengrid is connected to osl2.nac.uci.edu "Osgrid Gateway" and 88.191.79.199 9050 "Franco Grid"
| Centered at 7000,7000
|-
| '''cuonsim1.de:9300'''
| Cuon-Grid
| Cuon-Grid is a little grid and has some Main Sims with linux themes, server are in Germany. To login in to the grid use this http://sim-linuxmain.org:8081/CuonGrid/index.html. There are free sims for testing.
| Centered at 10,000, 10,000
|-
| '''metaversesims.net:9000'''
| Metaverse Sims
| 6-region standalone hypergrid on V. 0.7.2 (Dev)
| Centered at 9000, 9000
 

|-
| '''87.230.89.74:9000'''
| SCHWARZE WELT
| inworld location of www.schwarze-welle.de , the maybe biggest dark music streaming readio
| 100000 10000
 

|-
| '''peak.sciencesim.com:9001'''
| ScienceSim
| [http://www.sciencesim.com/ ScienceSim] is a virtual world created for the high performance computing community for scientific visualizations, a number of interesting real world terrains (Mt St Helens and Yellowstone Park) and some astronomical simulations. And some useful, BSD-licensed content.
| Centered at 10000,10000
|-
| '''alpha.bubblecloud.org:9000'''
| Bubble Cloud
| The alpha 00 is the entrance area to bubble cloud grid. Bubble cloud is test grid where anyone can experiment. If you build something please do it in medieval fantasy setting for others to enjoy.
| Centered at 10,000, 10,000
|-
| '''opensim.m34.mx-host.de:9090'''
| OpenSIM.de Sim1
| [http://www.opensim.de OpenSim.de], 4 Server (Linux/Windows), hypergrided standalones, 16 Regions, German Users (Deutsche Benutzer), Live-Support, IRC-Gateway, Wiki, FAQ, Howto´s, Downloads. Connected to most of the Grids and some hypergrided standalones.
| Centered at 4400,4400
|-
| '''64.150.180.188:9031'''
| Virtual World Trade Center
| [http://PleasurePlanet.net], The VWTC. A repository for freebie items to share with the OS community. Weekly oar files will be made freely available on 4shared.com.
| VWTC is at 3003, 3003
|-
| '''condensationland.com:9000'''
| Zonja Capalini
| Condensation Land, 10 regions
| Centered at 7789, 7789
|-
| '''66.240.232.94:9010'''
| Snoopy Pfeffer
| OSGrid, Samsara, freebie shopping region
| Centered at 10006, 9999
|-
| '''66.240.232.94:9011'''
| Snoopy Pfeffer
| OSGrid, Snoopies, dance club and event region
| Centered at 10005, 9999
|-
| '''twistedsky.net:9000'''
| Twisted Sky
| Welcome region on the Twisted Sky World Grid (at 998, 1000) - http://twistedsky.net
| Centered at 1000, 1000
|-
| '''www.xn--tln-tna.net:8002'''
| Tlön
| Tlön, Uqbar and Orbis Tertius - http://www.tlön.net (http://www.xn--tln-tna.net/)
| Centered at 7650, 7650
|-
| '''www.pmgrid.org:9020'''
| PMGrid
| PMGrid is a set of areas for grid development prior to implementation so there is no specific theme. Visit here and see a varied range of builds and perhaps get some ideas for yourself.[http://pmgrid.julpet.ath.cx http://www.pmgrid.org]
| centered at 7000, 7000

|-
| YourSimSpot.com:9000 
| [http://YourSimSpot.com YourSimSpot] 
| Main region at YourSimSpot (1000,1000) - [http://YourSimSpot.com YourSimSpot]
| Centered at 1000, 1000 
|-
| my3dworld.org:9000 
| My3dWorld 
| Main region at My3dworld (7900,7900) Home of Johnny 5 bot[[Image:Johnny5.jpg|thumb|none|128px|Meet Johnny 5]]16 plot Megaregion has Hypergate, linked to several other grids on map - [http://my3dworld.org My3dWorld] 
| Centered at 7900, 7900 
|-
| sim-world.org:8003 
| www.sim-world.org 
| Main region at sim-world island (10000,10000) 41 regions has teleport board linked to several other regions on map 
| Centered at 10000, 10000 
|-
| universi.servegame.org:9000    
| Shatar Lorefield [Universi Legacy]
|
Main region at Oasis (5000, 5000)

Hypergrid enabled Standalone sim. Need some people to populate this Desert World.

| Centered at 5000, 5000
|}

 

[[Category:Hypergrid]]