Main Page

2007-12-15T20:05:50Z

Darok: /* OpenSim Development */

[[Image:opensim_avatar.png|right]]

OpenSim is a BSD Licensed Open Source project to develop a functioning virtual worlds server platform capable of supporting multiple clients and servers in a heterogeneous grid structure. OpenSim is written in [http://www.ecma-international.org/publications/standards/Ecma-334.htm C#], and can run under [http://www.mono-project.com/Main_Page Mono] or the [http://www.microsoft.com/net/ Microsoft .NET] runtimes.

== Latest News ==

=== IRC move ===

We are in the process of moving the IRC channel we use (#opensim) from EFNET to Freenode. If you can't find us on EFNET, get yourself over to Freenode!

=== OpenSim 0.4 Released! ===

The OpenSim team is happy to announce the first alpha release of OpenSim, version 0.4.5. This release focuses on stand-alone mode (with one or more regions). Some stuff works, a lot doesn't. If it breaks, you get to keep '''both''' pieces.

Stuff that works:
* standalone mode with one or more regions
* basic physics (no object collisions)
* persistence of users, prims, assets, and inventory via [http://www.sqlite.org/ sqlite]
* basic building, custom-texture uploads
* avatar editing
* See [[OpenSim: Testing]]

More advanced physics, in-world scripting, grid mode, and support for other database backends are not supported in this release, though they may work from time-to-time before crashing with an earth-shattering kaboom! All of these are under active development, and are being worked on for the 0.5.0 release.

Source distributions in both .tar.gz and .zip can be found at the [http://dist.opensimulator.org/ OpenSim Downloads site].

== Getting Started with OpenSim ==
* [[OpenSim: Download]] — Download a copy of OpenSim.
* [[OpenSim: Install]] — How to install the simulator software.
* [[OpenSim: Configuration]] — How to configure the simulator for various modes.
* [[OpenSim: Network settings]] — How to setup the network for the simulator.
* [[OpenSim: Maintenance]] — How to upgrade and backup your installation.
* [[OpenSim: Running]] — How to run standalone, local grid & public grid modes, and server side commands.
* [[OpenSim: Connecting]] — How to connect to an OpenSim server.
* [[Troubleshooting]] — How to trouble shoot your OpenSim installation.
* [[FAQ]] — Frequently asked questions.
* Quick Reference [[OpenSim: Testing]] — A quick reference of current tested features.
* [[Office Hours]] — Weekly Office Hours Meeting.

== OpenSim Development ==

The [[Development Team|OpenSim Team]] is currently working towards the 0.5 release of OpenSim. See the [[Roadmap]] for details.

Top 10 bugs we are working on [[Top 10 Bugs]] are a dynamic list of those bugs that affect forward progress.

'''Recent Changes'''
<rss>http://cia.vc/stats/project/opensim/.rss|max=5|title=none</rss>

'''Handy Documentation'''
* [[OpenSim: Testing]] — What is tested.
* [[OpenSim: TechRef]] — A technical description of the simulator operation.
* [[OpenSim: Grids]] — Known Public grids currently available.
* [[Opensim: 0.4 Release Target Discussion]]
* [[Opensim: 0.5 Release Target Discussion]]
* [[OpenSim: Class Diagrams]]
* [[OpenSim: Grid's Architecture Diagram]]
* [[OpenSim: Scripting]] — How to use scripts and what limitations apply.
* [[PhysicsEngines]] — Options for physics engines in OpenSim.
* [[MonoSqlite]] — How the database model currently works.
* [[Monodevelop]] — How to use the [[monodevelop]] IDE for editing C# solutions.
* [[llFunction implementation status]] — What LSL commands has been implemented.
* [[OpenSim.Region.ScriptEngine]] — How the ScriptEngine looks internally.
* [[RegionModules]] — The various modules that are used in the RegionServer and how to write new ones.
* [[OpenSim: Screenshots]] — Various OpenSim screenshots.
* [[OpenSim: Threading strategy]] — How threading is implemented and handled.
* [[Special Building]] — Special building instructions.

== Participating in the OpenSim Community ==

OpenSim is an [http://en.wikipedia.org/wiki/Open_source open source] project. This means that it is developed by anyone who wants to participate. This could be you! We welcome testers and developers alike. Please see the [[Contributions Policy]] for more details.

If you ''need help'' or ''want to help'' the best way to get in touch is [[IRC]] (chat network). There is a lot of activity there every day.

=== Getting online ===
There are at least two public grids and several standalone arrays running 24/7. For the casual user as well as those who want to run their own public regions, there is a list of available sims at [[OpenSim: Grids]].

Also, the OpenSim developers hold [[office hours]] once a week in-world.

=== IRC ===
IRC on FreeNode, channel #OpenSim. Download an IRC client like [http://www.xchat.org/ X-Chat] (or [http://www.silverex.org/ here] for Windows) and go to FreeNode (server irc.freenode.net), channel #OpenSim.
If you have Firefox, you can also use the [https://addons.mozilla.org/firefox/addon/16 Chatzilla] IRC client (In the menu, Tools > Chatzilla).
If you already have an IRC client installed you can just follow [irc://irc.freenode.net/OpenSim this link].

*Server: irc.freenode.net
*Channel: #opensim

=== Mailing lists ===
* [https://lists.berlios.de/mailman/listinfo/opensim-users opensim-users] - a user support forum for OpenSim
* [https://lists.berlios.de/mailman/listinfo/opensim-dev opensim-dev] - development discussion of OpenSim
* [https://lists.berlios.de/mailman/listinfo/opensim-commits opensim-commits] - an email list for svn commits

=== Source Code ===
You can browse the source code for opensim at [http://opensimulator.org/cgi-bin/viewcvs.cgi OpenSim SVN browser]

'''Anonymous Checkout'''
svn co http://opensimulator.org/svn/opensim/trunk

'''Developer Checkout'''
svn co svn+ssh://USERNAME@opensimulator.org/var/svn/opensim/trunk

=== Bugs ===
You can report bugs at the [http://opensimulator.org/mantis/ Mantis opensim bug tracker].

''Note:'' Some email providers are tagging Mantis emails as spam. If you sign up for a Mantis Account and don't get a confirmation email:
* Check your spam folder, see if it is there. GMail is consistently tagging these as spam.
* If you are using yahoo, you'll need to wait ~ 8 hrs to receive any email from opensimulator.org.

=== Other languages ===
You can also see this wiki in these other languages:
[[OpenSimSpanish | Spanish]] | [[OpenSimGerman | German]] | [[OpenSimFrench | French]] | [[OpenSimItalian | Italian]] | ...

Grid Architecture Diagram

2007-12-15T20:02:28Z

Darok: New page: Image:Grids_Architecture_Diagram.jpg

[[Image:Grids_Architecture_Diagram.jpg]]

2007-11-04T15:56:50Z

Darok: /* Modified BulletX */

There are several physics engines available for use in OpenSim. Currently, they are "basicphysics", "OpenDynamicsEngine", "RealPhysX" & "BulletX" (modified version). The plugin "basicphysics" is the default and can be seen in the <tt>OpenSim.ini</tt> file.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=OpenDynamicsEngine</tt> to run the OpenDynamicsEngine (ODE) instead of basicphysics, or change the corresponding parameter in <tt>OpenSim.ini</tt>.

* When starting OpenSim in Windows, one can add <tt>-physics=RealPhysX</tt> if one has the appropriate DLL's which are not shipped with OpenSim due to license constraints.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=modified_BulletX</tt> to run a modified version of the BulletX Physics Engine aka ''Modified BulletX''. See the next [[PhysicsEngines#Modified BulletX|information]] about details and progress.

To conclude, basicphysics & OpenDynamicsEngine both are appropriate for Linux and in addition, RealPhysX is appropriate as an option for Windows if the supporting DLL's are available. Modified BulletX should be fine for Windows and Linux (not the original BulletX).

As of 10/9/07, ODE has received the bulk of testing. It supports basic collision with box-shaped primitives as well as box prims with box-shaped hollows. Bullet supports box-shaped prims and appears stable; there has been little testing yet, and it is known to have issues with friction (you skate around on non-level surfaces). Physx has not been updated in quite a while.

== Compiling ODE from source (Linux) ==
If you want to compile the OpenDynamicsEngine (ODE) by yourself, get the latest source code (Ver. 0.9 as of Oct '07) from http://www.ode.org/.
Unpack it, switch to the ode directory and compile it as follows:

./configure --enable-shared
make -k

(I used to suggest --with-trimesh=gimpact, but no longer. As of ODE 0.9, Opcode is the preferred and best-supported collision library)

This should create a <tt>libode.a</tt> and <tt>lidode.so</tt> file in the <tt>src/ode</tt> subdirectory. Copy these two files to the opensim <tt>bin</tt> directory (after having backed up the original files there). [er, I don't think the .a file is necessary to put in bin!]

== Compiling ODE from source (Windows) ==

the standard distribution from ode.org has a build directory, in which you will find subdirs for several Microsoft compilers.

The standard .sln files (at least for VS2005) compile ode.dll such that it depends on at least two Microsoft runtime dll's. This can cause failure and confusion, so do the following:
Right-click on ode in Solution Explorer, and select properties.
under Configuration Properties/General, change "Use of MFC" to read "Use MFC in a Static Library"

then compile as usual.

== ODE Plugin in OpenSim ==
Currently, the ODE Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Avies movement supported.

The currently collision behavior is:
* For avies, a capsule of .5m of radius and a length of .9m and 50Kg of mass
* For prims, like a Box.

=== To-do list (next changes) ===
* Tune ground collisions
* Introduce Prim Shape Type to have more than the box shape.
* Fix bugs
* Physical 'Active' prim

==== Known bugs ====
* xMin<xMax yMin<yMax: ''Certain scenarios cause ODE to crash with an internal error.
* Ground Collisions: ''Certain ground terrain causes avatar to bounce into the air without warning''
* Mis-aligned Terrain: ''The visible terrain is slightly mis-aligned against the heightmap. This causes the avatar to appear as if it's standing on empty space while slightly off of a hill and causes the avatar to appear as if it's knees are bent or feet in the terrain on the other side.''

== BulletX Plugin in OpenSim: Modified BulletX ==
BulletX Plugin in OpenSim runs the modified version of BulletX. The original version of BulletX runs under and has code-dependencies with MS.XNA. The orginal BulletX can be found at [http://www.codeplex.com/xnadevru XNADev.ru]. The modified version removes all code dependencies with MS.XNA. On the other hand, it needs another library to work. This library is based on Mono.Xna and it's called MonoCompactMaths. The modified BulletX and the MonoXnaCompactMaths can be found on the svn of OpenSim. Because its code independency of MS.XNA, the modified BulletX should can be run under either MS.Net or Mono and, therefore, either Windows or Linux (obviously you can combine Windows + Mono)

Currently, BulletX Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Prims and avies movement supported. By the way, collisions needs tunning. The currently collision's behavoir are:
* For avies, like and sphere of 1m of radious and 50Kg of mass
* For prims, like a Box of the prim-size and a mass that it depends of its sizes. The mass it's the mass of Box of water with density = 1Kg/l = 1Kg/dm3 = 1000Kg/m3 (Be water my friend! :D).

=== To-do list (next changes) ===
* Tune collision
* Introduce Prim Shape Type to have more than the box shape.
* Fix bugs
==== Known bugs ====
* Icy bug: ''an avatar acts like it is on ice and tends to drift off the edge of the sim after a while''
* Crash on BulletX. You will find the next message in console sometimes: ''Overflow in AABB, object removed from simulation If you can reproduce this, please email bugs@continuousphysics.com Please include above information, your Platform, version of OS. Thanks.''

PhysicsEngines

2007-11-04T15:55:17Z

Darok:

There are several physics engines available for use in OpenSim. Currently, they are "basicphysics", "OpenDynamicsEngine", "RealPhysX" & "BulletX" (modified version). The plugin "basicphysics" is the default and can be seen in the <tt>OpenSim.ini</tt> file.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=OpenDynamicsEngine</tt> to run the OpenDynamicsEngine (ODE) instead of basicphysics, or change the corresponding parameter in <tt>OpenSim.ini</tt>.

* When starting OpenSim in Windows, one can add <tt>-physics=RealPhysX</tt> if one has the appropriate DLL's which are not shipped with OpenSim due to license constraints.

* When starting OpenSim in either Windows or Linux, one can add <tt>-physics=modified_BulletX</tt> to run a modified version of the BulletX Physics Engine aka ''Modified BulletX''. See the next [[PhysicsEngines#Modified BulletX|information]] about details and progress.

To conclude, basicphysics & OpenDynamicsEngine both are appropriate for Linux and in addition, RealPhysX is appropriate as an option for Windows if the supporting DLL's are available. Modified BulletX should be fine for Windows and Linux (not the original BulletX).

As of 10/9/07, ODE has received the bulk of testing. It supports basic collision with box-shaped primitives as well as box prims with box-shaped hollows. Bullet supports box-shaped prims and appears stable; there has been little testing yet, and it is known to have issues with friction (you skate around on non-level surfaces). Physx has not been updated in quite a while.

== Compiling ODE from source (Linux) ==
If you want to compile the OpenDynamicsEngine (ODE) by yourself, get the latest source code (Ver. 0.9 as of Oct '07) from http://www.ode.org/.
Unpack it, switch to the ode directory and compile it as follows:

./configure --enable-shared
make -k

(I used to suggest --with-trimesh=gimpact, but no longer. As of ODE 0.9, Opcode is the preferred and best-supported collision library)

This should create a <tt>libode.a</tt> and <tt>lidode.so</tt> file in the <tt>src/ode</tt> subdirectory. Copy these two files to the opensim <tt>bin</tt> directory (after having backed up the original files there). [er, I don't think the .a file is necessary to put in bin!]

== Compiling ODE from source (Windows) ==

the standard distribution from ode.org has a build directory, in which you will find subdirs for several Microsoft compilers.

The standard .sln files (at least for VS2005) compile ode.dll such that it depends on at least two Microsoft runtime dll's. This can cause failure and confusion, so do the following:
Right-click on ode in Solution Explorer, and select properties.
under Configuration Properties/General, change "Use of MFC" to read "Use MFC in a Static Library"

then compile as usual.

== ODE Plugin in OpenSim ==
Currently, the ODE Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Avies movement supported.

The currently collision behavior is:
* For avies, a capsule of .5m of radius and a length of .9m and 50Kg of mass
* For prims, like a Box.

=== To-do list (next changes) ===
* Tune ground collisions
* Introduce Prim Shape Type to have more than the box shape.
* Fix bugs
* Physical 'Active' prim

==== Known bugs ====
* xMin<xMax yMin<yMax: ''Certain scenarios cause ODE to crash with an internal error.
* Ground Collisions: ''Certain ground terrain causes avatar to bounce into the air without warning''
* Mis-aligned Terrain: ''The visible terrain is slightly mis-aligned against the heightmap. This causes the avatar to appear as if it's standing on empty space while slightly off of a hill and causes the avatar to appear as if it's knees are bent or feet in the terrain on the other side.''

== Modified BulletX ==
This is a modified version of BulletX. The original version of BulletX runs under and has code-dependencies with MS.XNA. The orginal BulletX can be found at [http://www.codeplex.com/xnadevru XNADev.ru]. The modified version removes all code dependencies with MS.XNA. On the other hand, it needs another library to work. This library is based on Mono.Xna and it's called MonoCompactMaths. The modified BulletX and the MonoXnaCompactMaths can be found on the svn of OpenSim. Because its code independency of MS.XNA, the modified BulletX should can be run under either MS.Net or Mono and, therefore, either Windows or Linux (obviously you can combine Windows + Mono)

=== BulletX Plugin in OpenSim ===
BulletX Plugin in OpenSim runs the modified version of BulletX. Currently, BulletX Plugin suports collisions Av2Av, Av2Prim and Prim2Prim. Prims and avies movement supported. By the way, collisions needs tunning. The currently collision's behavoir are:
* For avies, like and sphere of 1m of radious and 50Kg of mass
* For prims, like a Box of the prim-size and a mass that it depends of its sizes. The mass it's the mass of Box of water with density = 1Kg/l = 1Kg/dm3 = 1000Kg/m3 (Be water my friend! :D).

==== To-do list (next changes) ====
* Tune collision
* Introduce Prim Shape Type to have more than the box shape.
* Fix bugs
===== Known bugs =====
* Icy bug: ''an avatar acts like it is on ice and tends to drift off the edge of the sim after a while''
* Crash on BulletX. You will find the next message in console sometimes: ''Overflow in AABB, object removed from simulation If you can reproduce this, please email bugs@continuousphysics.com Please include above information, your Platform, version of OS. Thanks.''