OpenSimulator - User contributions [en]

MediaWiki:Sidebar

2008-01-09T19:47:18Z

James Harrison: Tidied up and split into categories

MediaWiki:Sidebar

2008-01-09T19:46:54Z

James Harrison:

Developer Documentation

2008-01-09T19:39:28Z

James Harrison: Case sensitive link error

== Communication ==

A good first point of contact is the OpenSim IRC, on irc.freenode.net channel #opensim/#opensim-dev.

The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at "Wright Plaza" on OSGrid.

There is a "Test Hour" on Saturdays, also generally on "Wright Plaza". Both these weekly events are held at 11:00AM PST or 1900UTC.

Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.

== Developer Documentation ==
You can view the current [[Top 10 Bugs|top 10 bugs]] blocking forward development.

* [[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]]
* [[Grid 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.
* [[LSL Status]] — LSL implementation progress.
* [[LSL:PrimitiveParams]] Notes on converting SL Edit GUI values and LSL PrimitiveParams to OpenSim PrimitiveBaseShape fields
* [[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.

== SVN Access ==
You can browse the source code for OpenSim [http://opensimulator.org/cgi-bin/viewcvs.cgi using a web browser] or via SVN.

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

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

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

Main Page

2008-01-09T19:37:06Z

James Harrison: Style tweaks on sidebar.

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Installation]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== News ==


=== Custom osFunction Ideas wanted ===
OpenSim's own scripting team is accepting ideas/requests/wishlists for custom functions. Have a look at [[LSL_osFunctions|the full list]] over here.

You can browse older news items [[News|at the news archive]].

== OpenSim Development ==
<div style="background:#FFF;float:right;width:600px;padding:2px;padding-top:0px;margin:3px;border:1px solid #CCC"><h3>Recent SVN Commits</h3><p><rss>http://cia.vc/stats/project/opensim/.rss|max=2|title=none</rss></p></div>
The [[Development Team|OpenSim Team]] is currently working towards the 0.5 release of OpenSim. See the [[Roadmap]] for details.

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]].

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim: Grids|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | [[fr | Francais]] | [[OpenSimItalian | Italian]] | ...

Main Page

2008-01-09T19:36:34Z

James Harrison: Added SVN stuff back in under a sidebox.

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Installation]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== News ==


=== Custom osFunction Ideas wanted ===
OpenSim's own scripting team is accepting ideas/requests/wishlists for custom functions. Have a look at [[LSL_osFunctions|the full list]] over here.

You can browse older news items [[News|at the news archive]].

== OpenSim Development ==
<div style="background:#FFF;float:right;width:600px;padding:2px;border:1px solid #CCC"><h3>Recent SVN Commits</h3><p><rss>http://cia.vc/stats/project/opensim/.rss|max=2|title=none</rss></p></div>
The [[Development Team|OpenSim Team]] is currently working towards the 0.5 release of OpenSim. See the [[Roadmap]] for details.

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]].

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim: Grids|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | [[fr | Francais]] | [[OpenSimItalian | Italian]] | ...

Main Page

2008-01-09T19:33:45Z

James Harrison: Oops- typo!

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Installation]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== News ==


=== Custom osFunction Ideas wanted ===
OpenSim's own scripting team is accepting ideas/requests/wishlists for custom functions. Have a look at [[LSL_osFunctions|the full list]] over here.

You can browse older news items [[News|at the news archive]].

== OpenSim Development ==

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

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]].

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim: Grids|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | [[fr | Francais]] | [[OpenSimItalian | Italian]] | ...

Main Page

2008-01-09T01:06:30Z

James Harrison: Note to editors, news, etc

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Installation]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== News ==


=== Custom osFunction Ideas wanted ===
OpenSim's own scripting team is accepting ideas/requests/wishlists for custom functions. Have a look at [[LSL_osFunctions|the full list]] over here.

You can browse older news items [[News|at the news archive]].

== OpenSim Development ==

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

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]], where there is mostly

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim installations|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | ...

Main Page

2008-01-09T00:55:44Z

James Harrison:

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Installation]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== OpenSim Development ==

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

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]], where there is mostly

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim installations|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | ...

Main Page

2008-01-09T00:52:15Z

James Harrison:

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Install]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== OpenSim Development ==

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

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 via [[Development|the IRC channels]], where there is mostly

=== Getting online ===
There are several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim installations|Grids]].

=== Mailing lists ===
Various mailing lists are available for communication between users and developers. A list is available to subscribe to email SVN commit notifications.
* [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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows- third party viewers and modified viewers add more variables to a bug, making it harder to track down. The bug may not even be an OpenSim one! Make sure you use ''only'' the official client. See notes on configuring your client over at the [[Client Setup||client setup]] page.

You can report bugs at the [http://opensimulator.org/mantis/ Mantis bugtracker].

''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]] | ...

Main Page

2008-01-09T00:47:43Z

James Harrison: Tidied up

[[Image:opensim_avatar.png|right]]
__NOTOC__
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.

OpenSim is currently in the alpha development stage, with active testing of SVN trunk versions encouraged.

== Getting Started with OpenSim ==
* [[Features]] - Key features of the OpenSim platform.
* [[Download]] - Download a copy of OpenSim.
* [[Install]] - How to install the simulator software.
* [[Configuration]] - How to configure the simulator for various modes.
* [[Client Setup]] - How to connect to an OpenSim server with the Second Life client
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[FAQ]] - Frequently asked questions.

== OpenSim Development ==

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

For more information on OpenSim development and on how you can make your mark, check out the [[Development|development]] section.

== 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 several 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]]. Most of these grids have representation on the #opensim chat channel for asking and answering questions.

While OpenSim is not affiliated with any one grid there are many prominent [[OpenSim installations|Grids]].

=== 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

=== Bugs ===
Please use the SecondLife official 1.18.5.3 client on Linux, Mac OS X, and Windows so as to unify the issues and make it easier to narrow down 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]] | ...

Developer Documentation

2008-01-09T00:47:13Z

James Harrison: SVN moved

== Communication ==

A good first point of contact is the OpenSim IRC, on irc.freenode.net channel #opensim/#opensim-dev.

The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at "Wright Plaza" on OSGrid.

There is a "Test Hour" on Saturdays, also generally on "Wright Plaza". Both these weekly events are held at 11:00AM PST or 1900UTC.

Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.

== Developer Documentation ==
You can view the current [[top 10 bugs]] blocking forward development.

* [[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]]
* [[Grid 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.
* [[LSL Status]] — LSL implementation progress.
* [[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.

== SVN Access ==
You can browse the source code for OpenSim [http://opensimulator.org/cgi-bin/viewcvs.cgi using a web browser] or via SVN.

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

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

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

Testing

2008-01-09T00:42:17Z

James Harrison: OpenSim:Testing moved to Testing: Removing OpenSim namespace; not needed.

= Automated Testing =
For information on the planned continuous integration system for OpenSim go to [[Automated Testing]].

= Current functionality =

Standalone tested from sv ????.<br>
Grid Information tested from svn 2816 (OpenlifeGrid http://www.openlifegrid.com) Updated Regularly.

== Account ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>login</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>logout</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>relog</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>Home - Login Start Location</td>
<td bgcolor="yellow">unknown</td>
<td bgcolor="lime">OK - Configurable by Region</td>
</tr>
<tr>
<td>Alt Home - if Home unavailable</td>
<td bgcolor="yellow">unknown</td>
<td bgcolor="lime">Alternate Region hardset by GRID</td>
</tr>
</table>

== World ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>day / night cycle</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>windlight</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>clouds</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>wind</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>water and water texture</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>terrain and terrain textures</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">Partial</td>
</tr>
</table>

== Accounts and permissions ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>multiple account creation</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>permissions per account</td>
<td bgcolor="yellow">partially working</td>
<td bgcolor="yellow">minimal</td>
</tr>
<tr>
<td>account has inventory</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK - Early stages</td>
</tr>
<tr>
<td>sim supports multiple logins</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
</table>

== Avatar ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>teleport within region</td>
<td bgcolor="yellow">partially working (always facing north after teleport)</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>built-in animations (walking, flying, sitting)</td>
<td bgcolor="yellow">partially working</td>
<td bgcolor="yellow">partially working</td>
</tr>
<tr>
<td>uploaded animations / gestures</td>
<td bgcolor="yellow">partially working (play locally, but not in world)</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>uploaded sounds</td>
<td bgcolor="yellow">partially working (play locally, but not in world)</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>can wear clothes</td>
<td bgcolor="yellow">partially working (must manually re-wear after every login)</td>
<td bgcolor="yellow">temp persist (temporary persist must re-wear after server restart)</td>
</tr>
<tr>
<td>can attach items</td>
<td bgcolor="red">not yet implemented</td>
<td bgcolor="red">not yet implemented</td>
</tr>
<tr>
<td>DRAG / CTRL DRAG objects</td>
<td bgcolor="lime">OK - non physical only</td>
<td bgcolor="lime">OK - non physical only</td>
</tr>
</table>

== Building ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>create prim</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>change prim type</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>change prim transparency</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>change prim colour</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>change prim texture (including uploaded textures)</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>change prim size, cut, hollow, etc</td>
<td bgcolor="yellow">partially working (issues with prim stretching)</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>prim light, fullbright and flexi</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>link prims</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>unlink prims</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>permissions</td>
<td bgcolor="yellow">partially working</td>
<td bgcolor="yellow">Some (TBA)</td>
</tr>
<tr>
<td>objects persist in world across login / logoff and server restart</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>parcel support</td>
<td bgcolor="yellow">partially working</td>
<td bgcolor="lime">OK See Parcels Below</td>
</tr>
</table>

== Terraforming ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>select land</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>raise land</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>lower land</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>flatten land</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>roughen land</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">no causes lower</td>
</tr>
<tr>
<td>smooth land</td>
<td bgcolor="lime">OK - but slow!</td>
<td bgcolor="red">no change pauses sim</td>
</tr>
</table>

== Land and parcels ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>subdivide</td>
<td bgcolor="lime">Working</td>
<td bgcolor="lime">Working</td>
</tr>
<tr>
<td>join</td>
<td bgcolor="lime">Working</td>
<td bgcolor="lime">Working</td>
</tr>
<tr>
<td>buy and sell</td>
<td bgcolor="red">Not Yet Implemented</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Set Land To Group</td>
<td bgcolor="red">Not Yet Implemented</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Allow Deed To Group</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Owner Makes Contribution With Deed</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Buy Pass - (Temporary Paid Access)</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Buy For Group</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Used</td>
</tr>
<td><b>Covenants</b></td>
<tr>
<td>Buy For Group</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Used</td>
</tr>
<tr>
<td>Estate Owner</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<td><b>Land Objects</b></td>
<tr>
<td>Sim Usage</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
</tr>
<tr>
<td>Prims on Parcel</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
</tr>
<tr>
<td>Return Parcel Primitives</td>
<td bgcolor="red">Not Yet Implemented</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>AutoReturn of Prims</td>
<td bgcolor="red">Not Yet Implemented</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Show Owners (Land Menu)</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
<td bgcolor="yellow">Works, but Disabled for Bug Testing</td>
</tr>
<td><b>Land Options</b></td>
<tr>
<td>Show Owners (Land Menu)</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<td><b>Land Media</b></td>
<tr>
<td>Replace Texture With Media</td>
<td bgcolor="lime">Working</td>
<td bgcolor="lime">OK - Persists</td>
</tr>
<tr>
<td>Music Stream URL</td>
<td bgcolor="lime">Working</td>
<td bgcolor="lime">OK - Persists</td>
</tr>
<tr>
<td>Restrict Spatialized Sounds to Parcel</td>
<td bgcolor="red">Not Yet Implemented</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<td><b>Land Access</b></td>
<tr>
<td>Show Owners (Land Menu)</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<td><b>Land Bans</b></td>
<tr>
<td>Limit Access to Group</td>
<td bgcolor="red">Not Yet Implementedg</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>Limit Access by Avatar</td>
<td bgcolor="yellow">Somewhat Implemented</td>
<td bgcolor="yellow">Somewhat Implemented</td>
</tr>
<tr>
<td>Individual Avatar Ban</td>
<td bgcolor="lime">Working</td>
<td bgcolor="lime">Working - Grid can disable feature gridwide</td>
</tr>
</table>

== UI ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>friends list</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">(not persistent)</td>
</tr>
<tr>
<td>uploads</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK, jpg, bmp,tga (alpha)</td>
</tr>
<tr>
<td>edit profile</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">not working (not persistent)</td>
</tr>
<tr>
<td>search</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>large map</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">OK(currently map textures are a little broken - unavailable for locations not yet visited)</td>
</tr>
<tr>
<td>minimap</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>money</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>HUD attachments</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
</table>

== Friends ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>add</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>remove</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>permissions</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>mapping</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>online visibility</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>can edit my objects</td>
<td bgcolor="red">no</td>
<td bgcolor="grey">no friends = generic perms application only</td>
</tr>
Friends Are not yet implemented as at SVN2816.
</table>

== Groups ==
Groups are not yet implemented as at SVN 2492
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>create</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>join</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>description</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>graphic</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>notices</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>vote</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>invite</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>remove</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>members</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>group list</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>publish</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>set title</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>change active title</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>enrollment fee</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>open enrollment</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>set mature flag</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>group land</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
</table>

=== Group Roles ===
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>create</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>edit</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>remove</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>add person</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>remove person</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>abilities</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
Groups are not yet implemented as at SVN 2492
</table>

== Chat, IM, Voice ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>local chat</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK - Plus Configurable Distance (server)</td>
</tr>
<tr>
<td>Shout</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK - Plus Configurable Distance (server)</td>
</tr>
<tr>
<td>send / receive IM</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">Not Working</td>
</tr>
<tr>
<td>offline IM</td>
<td bgcolor="red">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>group IM</td>
<td bgcolor="red">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>multiple friend IM</td>
<td bgcolor="red">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>participant list</td>
<td bgcolor="red">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>voice</td>
<td bgcolor="red">unknown</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>IRC bridge</td>
<td bgcolor="red">unknown</td>
<td bgcolor="lime">OK (Configurable on Server)</td>
</tr>
</table>

== Physics / Collision ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="150"> </th>
<th width="150">basicphysics</th>
<th width="150">POS</th>
<th width="150">OpenDynamicsEngine</th>
<th width="150">modified_BulletX</th>
<th width="150">RealPhysX</th>
</tr>
<tr>
<td>walk on ground</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">partially working (ground is very slippery)</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>fly</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>sit on ground</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">not working</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
</tr>
<tr>
<td>sit on object</td>
<td bgcolor="lime">OK</td>
<td bgcolor="red">not working</td>
<td bgcolor="yellow">partially working (autopilot has trouble getting to the right spot 'try phantom prim')</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>walk on object</td>
<td bgcolor="red">not working</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">partially working (some stability issues)</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>bump into object</td>
<td bgcolor="red">not working</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>Avatar Land on Prim</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not yet implemented</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>prim physics</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">not working</td>
<td bgcolor="lime">OK</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
<tr>
<td>cut/hollow/dimpled prim (non)collisions</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
<td bgcolor="grey">unknown</td>
</tr>
</table>

== Scripting ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>create LSL script</td>
<td bgcolor="yellow">partially working</td>
<td bgcolor="lime">OK, see supported commands</td>
</tr>
<tr>
<td>add script to object</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">Drag from inventory into prim</td>
</tr>
<tr>
<td>execute script in object</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
</table>

Note: not all scripting features are supported yet.
Check [[LSL Status]] for currently implemented features.

== Inventory ==
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<th width="200"> </th>
<th width="200">Standalone</th>
<th width="200">Grid</th>
</tr>
<tr>
<td>create new items (folder, notes, body, clothes, prims, scripts)</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>delete prims -> trash</td>
<td bgcolor="yellow">unknown</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>delete items -> trash</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>trash folder functions (restore, purge)</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>search inventory</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>"recent items" list</td>
<td bgcolor="red">not working</td>
<td bgcolor="red">Not Yet Implemented</td>
</tr>
<tr>
<td>inventory persists across logout / login</td>
<td bgcolor="lime">OK</td>
<td bgcolor="lime">OK</td>
</tr>
<tr>
<td>drag items to / from world</td>
<td bgcolor="lime">OK</td>
<td bgcolor="yellow">half... still in progress grid wide</td>
</tr>
Inventory should not yet be treated as permanent, whilst development is still occurring.
</table>

Network Settings

2008-01-09T00:40:06Z

James Harrison: OpenSim:Network settings moved to Network Settings: Removing OpenSim namespace; not needed.

== Network settings ==

OpenSim/Grid can be pretty tricky when it comes to setting it up on a private network this document covers what OpenSim needs in terms of network resources.

== Ports used by OpenSim ==

OGS1 Grid Modes - Standard Port List

* TCP/8000 - Reserved
* TCP/8001 - Grid Server
* TCP/8002 - User Server and Login Services
* TCP/8003 - Asset Services
* TCP/8004 - Inventory Services
* TCP/8005 - Reserved (Dispatch Services)

== Simulators ==

* UDP+TCP/9000 - Default First Simulator
* UDP+TCP/9001 - Default Second Simulator
etc.

Note: If you use your simulator in standalone mode, it is enough to open the UDP+TCP/9000 on your firewall.

== Issues with NAT and Port Forwarding ==

If your host does not have a public IP address (eg it is hidden behind a home router) you will have issues hosting grid and region servers if you plan on connecting clients to it on both sides of the router, however this can be worked around through very careful application of port forwarding and use of DNS host files. Please note this is not guarunteed to work (and is most likely to fail), it is highly recommended to have a internet accessible public static IP for the server which is hosting the regions.

Method:
* Set the simulator listening IP address to your public facing IP address (that of the router concerned)
* Port forward the above ports through to the simulator on both UDP and TCP.
* Use an “ExternalAddress” of “somesimulator.somedomain.com” where you control the DNS for somedomain.com and can enter a “A Record” for ‘somesimulator.’ to your routers IP address.
* Create a “hosts” file (on windows, this is C:\Windows\System32\Drivers\etc\hosts and on Unix-type systems, this is /etc/hosts) entry on your internal client machines, for somesimulator.somedomain.com to your local LAN address for the simulator.

== A solution for local connections if you have a ZyXEL DSL modem/router with NAT and Port Forwarding ==

This solution works with the ZyXEL Prestige 660ME-61 DSL Router. It may work with other models made by ZyXEL.

Method:
* Connect by TELNET to your ZyXEL DSL modem. Use the same IP address that you would if you were using the web interface. For example, the default ip on most Embarq ZyXEL DSL modems is 192.168.2.1.

telnet 192.168.2.1

* Enter your password. If you do not know it, try just pressing <ENTER> or ask your ISP for the password. They may or may not give it to you.

* Select menu option "24. System Maintenance" from the menu.

Copyright (c) 1994 - 2004 ZyXEL Communications Corp.
Prestige 660ME-61 Main Menu
Getting Started Advanced Management
1. General Setup 21. Filter Set Configuration
2. WAN Backup Setup 22. SNMP Configuration
3. LAN Setup 23. System Password
4. Internet Access Setup 24. System Maintenance
25. IP Routing Policy Setup
Advanced Applications 26. Schedule Setup
11. Remote Node Setup
12. Static Routing Setup
15. NAT Setup 99. Exit
Enter Menu Selection Number:

* Select menu option "8. Command Interpreter Mode" from the menu

Menu 24 - System Maintenance
1. System Status
2. System Information and Console Port Speed
3. Log and Trace
4. Diagnostic
5. Backup Configuration
6. Restore Configuration
7. Upload Firmware
8. Command Interpreter Mode
9. Call Control
10. Time and Date Setting
11. Remote Management
Enter Menu Selection Number:

* At the prompt type "ip nat loopback on".

Copyright (c) 1994 - 2004 ZyXEL Communications Corp.
Sprint > ip nat loopback on

* At the prompt type "exit".

Sprint> exit

* Select menu option "99. Exit"

* Follow all other steps for configuring and starting your server as outlined in [http://opensimulator.org/wiki/Main_Page#Getting_Started_with_OpenSim Getting Started].

== A Solution for local connections if you have the DLink GamerLounge Extreme N router ==

Networking and router configurations have been responsible for 98% of all trouble I have had setting up and operating OpenSimulator region server software. Insuring that you have a capable router properly configured should be the first thing on the list of configuration checkpoints for a smooth and trouble-free path to OpenSimulator software operations in GridMode.

Below is a series of screen snapshots with the key pages of my router configuration interface with proper settings displayed.

The settings below assume that you have an otherwise working connection and do not touch on such subjects as port conflicts or logging your network onto your ISP's provider network.

== ** your status page should resemble this except for embedded site-specific details ** ==

[[Image:router config snapshot1.png]]

== ** Clicking the 'Advanced' tab, follwed by the 'Gaming' menu item, you should match what is shown here ** ==

[[Image:router config snapshot2.png]]

== ** Proceeding to Routing menu item, make sure it looks like this: ** ==

[[Image:router config snapshot3.png]]

== ** Now on to the firewall menu item ** ==

[[Image:router config snapshot4.png]]

== ** and lastly but equally important, the advanced network settings menu item ** ==

[[Image:router config snapshot5.png]]

* provided that all information supplied in ~opensim/bin/OpenSim.ini and in your ~opensim/Regions/*.xml are properly configured, this should have you up and running.

NOTE: Contrary to what is displayed above, DHCP services are not required to operate OpenSimulator server software.

Configuration

2008-01-09T00:39:10Z

James Harrison: OpenSim:Configuration moved to Configuration: Removing OpenSim namespace; not needed.

It is recommended that you first get OpenSim running in standalone mode, before you attempt to connect it to a grid, either your own grid or a public grid.

A simulator actually consists of four services, known as UGAS which stand for User, Grid, Asset & Simulator. They are started in that order.

A simulator running in its default standalone mode has all the services self-contained, but they are very modest. This means any first/last/password works. It also means inventory is all local with no region or grid-wide connections.

A simulator running as a local grid runs all four services on the same computer. Multiple sims can be run, across-region crossing including teleporting and a set of inventory items that are within this local grid.

A simulator running as part of a public grid runs only OpenSim.exe and the other three services are running on a server common to many regions. This also means that understanding the needed UUID, X,Y location, server handshake passwords, master avatar first/last/password and a couple of other settings. These are not difficult, but do require a little care in setting up.

=Command Line arguments passed to OpenSim.exe=

OpenSim.exe responds to various command line arguments. These include "-inifile", "-configfile", "-gridmode", "-physics", "-config" & "-noverbose".

When starting OpenSim in either Windows or Linux, one can add "-physics=OpenDynamicsEngine" to run the OpenDynamicsEngine instead of basicphysics.

Most users in standalone mode will not add any command line arguments. For local grid or public grid, the "-gridmode=true" is usually the only argument used. The rest are for more advanced configuration.

=OpenSim configuration file=
The simulator configuration is managed using a file called [[OpenSim.ini]]. This file is used regardless of whether the sim is running in standalone or grid mode. Detailed information on the options available for setttings in this file can be found [[OpenSim.ini|here]].
=Standalone mode=

When you start OpenSim in standalone mode, it will ask you several question at the console. The first set of prompts that start with "NETWORK SERVERS INFO", you can just hit return to accept the defaults if you will be running in standalone mode.

The prompts that start with "DEFAULT REGION CONFIG" are where you need to start paying attention. Some are self-explanatory. Here are explanations for the others:

* Grid Location. OpenSim regions can be placed anywhere on a 65536 by 65536 grid. In standalone mode, it is safe to leave these X and Y locations at their defaults.

* Filename for local storage. Safe to leave at default.

* Internal IP address; This should always be 0.0.0.0

* Internal IP port for incoming UDP client connection. You can make this any port you want, but it is safe to leave at the default 9000.

* External host name. If you will only be attaching to your sim from a SecondLife client on the same machine, you can leave this at the default 127.0.0.1. If you will be wanting to connect to it from a client on another machine, this should be the IP address or hostname of the machine you are running this sim on.

To connect to your new sim, start up secondlife with the following command line switches:

-loginuri http://127.0.0.1:9000/

This assumes you are running the secondlife client on the same box. If you are running it on a separate box, substitute the IP address of your sim machine.

To create a user:
type "create user <first> <last> <password> <x_loc> <y_loc>" in the server console

=Grid mode=

You want to run your own grid. Great! Assuming that you already got your sim running in standalone mode, here is what you need to do:

1. Current builds of OpenSim grid mode are using mysql to store the grid information. You must have this installed and configured if you want to run your own grid. See [[mysql-config]] for more information.

2. The servers should be started in a certain order. UGAS: UserServer, GridServer, AssetServer, InventoryServer, Sim. These are all found in the bin directory. In windows, you can just double-click on the executables to start them. In linux, you will probably have to start them with mono. The executable names are:

OpenSim.Grid.UserServer.exe
OpenSim.Grid.GridServer.exe
OpenSim.Grid.AssetServer.exe
OpenSim.Grid.InventoryServer.exe
OpenSim.exe

3. Start the UserServer. If you will be running the GridServer on the same box, hit enter to accept the defaults, until it gives you the prompt

OpenUser#

This is the main prompt for the user server. If you will be running the GridServer on another box, change the Default Grid Server URI as appropriate.

4. Start the GridServer. Again, you can hit return at all the prompts if you are running them all on the same machine. If not, change the URIs for the Asset Server and User server to point to where you are running them. You will finally get to the console prompt for the GridServer which looks like this:

OpenGrid#

5. Start the AssetServer. The console prompt for this server will be:

OpenAsset#

6. Start the InventoryServer. The console prompt for this server will be:

INVENTORY#

7. If you are running all of these servers on the same box, which would be the normal configuration. You should be ready to start up your sim. Since the OpenSim.exe starts up by default in standalone mode, you will need to give it a command line switch to tell it to use gridmode instead:

OpenSim.exe -gridmode=true

or

mono OpenSim.exe -gridmode=true

With any luck, everything will come up without too many errors.

8. Go to the UserServer console, and type 'create user' to create a new avatar. It will prompt you for the name and password, and the X and Y of the sim that should be his home location. Use 1000 and 1000, or wherever you told your sim to live when you brought it up in standalone mode.

At the console of any of these servers, you should be able to type 'help' to get a list of commands.

You should now be able to connect to your new grid with your secondlife client. You need to tell your client to point at the UserServer rather than directly at the sim, though:

secondlife -loginuri http://127.0.0.1:8002/

8002 is the default port for the UserServer, and that IP address should be changed to the server you are running the UserServer on, if they are not all on the same box.

Happy OpenSimming!

''Note: if you are using Windows Vista, remeber to start servers as Admin. If not it will prompt you an error in console like "Error - Access denied"
''
=== Technical Addendum ===
For running multiple regions on the same box, you simply make multiple copies of the 'default.xml' file inside the <tt>bin/Regions/</tt> directory. You can do this using the script <tt>make.php</tt> in <tt>share/regions</tt>, or you can generate the files by hand.

If you want to create the files by hand, first copy the default.xml file in the <tt>bin/Regions</tt> directory, and name them anything you want (I name mine x.y.xml, where x znd y are the grid coords.)

Open each xml file and edit the uuid (each must be unique, a generator can be found at [http://www.famkruithof.net/uuid/uuidgen uuidgen webpage]), region name, x & y positions, datastore (if you are using the prim thing) and internal ip port. EACH OF THESE MUST BE UNIQUE!

Once you have 2 or more xml files in the regions folder, running a ''single copy'' of <tt>OpenSim.exe</tt> will boot all of your sims! If you come across any errors, there is most likely an error in the xml files.

=Attaching your sim to someone else's grid=

To set up the simulation server (i.e., <tt>OpenSim.exe</tt>) to connect to an external grid, you should edit the <tt>OpenSim.ini</tt> file in the <tt>bin</tt> directory. In that file, there is a <tt>[Network]</tt> section with URLs for the grid, user, and asset servers, as well as send and receive keys (for a basic level of security). The addresses and send/receive keys will vary depending on the grid you are connecting to, and the grid operator should tell you what values to use.

The other file you may have to change is in your <tt>bin/Regions</tt> directory. This is where your individual region config files are. If you only have one region, it will by default be called <tt>default.xml</tt>.

This can be edited with any text editor. The grid owner may tell you what X and Y location you can place your sim at (you can't have multiple sims at the smae location on the grid). If so, the fields you will need to change in this file are <tt>sim_location_x</tt> and <tt>sim_location_y</tt>. And the <tt>external_host_name</tt> should be set to the hostname or IP address of your simulation server (i.e., the machine that is running <tt>OpenSim.exe</tt>).

A list of public grids that you can attach your sim to is at [[OpenSim: Grids]]

=Automate Grid Startup=

==Windows==
Create a file called StartGrid.BAT:
start OpenSim.Grid.UserServer.exe
sleep 3
start OpenSim.Grid.GridServer.exe
sleep 3
start OpenSim.Grid.AssetServer.exe
sleep 3
start OpenSim.Grid.InventoryServer.exe
sleep 3
start OpenSim.exe -gridmode=true

PS! Check that you have sleep command installed, I'm unsure if all Windows versions have that.<br>
This knowledgebase article describes how to add a batch file to startup of Windows (before logon).<br>
[http://support.microsoft.com/kb/q243486/ http://support.microsoft.com/kb/q243486/]<br>
Note that you have to start all applications and answer the configuration questions once before adding it to any startup.<br>
<br>
If you start the server before logon then there will be no window to close if you want to shut down the server, so you can create a "StopGrid.BAT" with:
taskkill /FI "IMAGENAME eq OpenSim.*"
sleep 3
taskkill /FI "IMAGENAME eq OpenSim.*"
sleep 3
taskkill /F /FI "IMAGENAME eq OpenSim.*"

''(Do they have to be shut down in any particular order?)''

==Linux/Mac OS X==

===Use Screen Command===
Use the screen command to automate startup

==== Setup screen command and setup shell file====
screen install:

Linux
apt-get install screen
Mac OS X: Download either MacPorts, http://www.macports.org/, or Fink, http://www.finkproject.org/ to download *nix packages
MacPorts
sudo port install screen
Fink
Need command line for Fink.

Create file runsim.sh
#!/bin/sh
cd opensim/bin
sleep 3
screen -S UserServer -d -m mono OpenSim.Grid.UserServer.exe
sleep 3
screen -S GridServer -d -m mono OpenSim.Grid.GridServer.exe
sleep 3
screen -S AssetServer -d -m mono OpenSim.Grid.AssetServer.exe
sleep 3
screen -S InventoryServer -d -m mono OpenSim.Grid.InventoryServer.exe
sleep 3
screen -S OpenSim -d -m mono OpenSim.exe -gridmode=true

====Startup and access servers====
./runsim.sh

If you have permission issues
chmod 755 runsim.sh

To see a list of the servers in screen:
screen -ls or screen -list

Output will look like the following:
There are screens on:
8419.OpenSim (Detached)
8403.InventoryServer (Detached)
8378.AssetServer (Detached)
8360.GridServer (Detached)
8347.UserServer (Detached)

To access server
screen -r 8419.OpenSim
screen -r 8403.InventoryServer
etc.

To exit screen, leaving server running, and to return to shell
ctrl-a d

====Shutdown Servers====
Either manually access each sceen
screen -r 8419.OpenSim
shutdown

Or use
killall mono
Or
for i in `ps afxu | grep -i "mono.*OpenSim" | grep -v grep | awk {'print $2'}`; do kill $i; done

Need to see if there is a way to use a shell script using screen to shutdown servers

Talk:Build Instructions

2008-01-09T00:38:10Z

James Harrison: OpenSim talk:Install moved to Talk:Installation: Removing OpenSim namespace; not needed.

== Problems in installation... ==

Hi, I just installed everything from the svn (see my note if you use donwload link). I was almost able to launch everything, but fail on having a fully working environment, I got null pointer exceptions and the inventory didn't work as expected.

I'm particularly interested in local grid. This might be particularly useful for making demos and so attracting more attention on this wonderful project:

Might I suggest the following for easying the installation of local grid? Just brainstorming:

- Pack the already existent installation giving a READY TO GO local grid installation. I cannot do myself because it's not working on my computer. If you assist me in having a full installation, I might publish a easyphp self installing thingy.

- What about having it working under Ubuntu or so under a VMWare machine? so that people can download the VM and be able to really see something working? Also if the deployed machine has something already built on it (some standard avatars and a small house) it would be tremendously useful.

Also some defaults are strange to me: why not be per default using physics? people used to 2ndlife cannot understand why all the objects are phantom, this is particularly strange that you have to enable it. Please have it per default more consistent.

* Textures are different from 2ndlife and appears to me a kind of rectangular dark brown. Is this wanted?

* A tutorial should be written guiding people to do something. Not needing to do the same as 2nd life, but stress the differences!!!

Greetings, and thanks for your huge effort.

== Vista firewall ==

As far as the disable Vista firewall, I have found that opening the ports that Opensim wants and the ports involved seems to work fine.
Far better than opening an already bad OS to possible net issues. Tho I tend to agree, if it just don't seem to connect and there is no
other reason for the trouble, by all means disable the firewall to see if that is the issue.

Build Instructions

2008-01-09T00:38:10Z

James Harrison: OpenSim:Install moved to Installation: Removing OpenSim namespace; not needed.

=Installing from source=

==MS Windows==

OpenSim requires either the .Net framework version 2.0, or the latest Mono. It supports the following compilers:
* [http://msdn2.microsoft.com/en-us/express/aa700756.aspx Microsoft Visual C# Express Edition] (note: not Visual C++)
* [http://www.mono-project.com/ mono]

Note for people who just downloaded the sources from http://dist.opensimulator.org/ (the "Downloads" link on the left) be advised that some important things are missing (like MySQL template scripts). For such features, you must download using svn!

=== Subversion Repository ===

1. Get the nightly build source code from the svn repository:

http://opensimulator.org/svn/opensim/trunk

2. Get 0.4.5.2 Stable version from svn repository:
svn co http://opensimulator.org/svn/opensim/tags/0.4.5.2-stable opensim

=== Building ===

2. In the top-level directory, run the '<tt>runprebuild.bat</tt>' file. This will create both a VS2005 solution file, and a nant build file.

3. Open the resulting sln file with visual studio, and build it there, or if you prefer to use nant, run nant in the same top-level directory. This will build the executables.

If you don't care about physics (walking on prims, etc), ignore the rest of this section.

==== Physics ====

===== Open Dynamics Engine (ODE) =====

If you want to implement collision-based physics, OpenDynamicsEngine (ODE) is the furthest along at the moment (9/07). It is not fully supported, but is starting to work somewhat reliably using a small number of regions per sim.

As installed from svn, ODE does not work on all platforms. If you get an ODE-related crash, and/or an <i>ode.dll not found</i> type of error (which can occur even though the dll is present!), try using the debug version of the dll, available here:

http://www.squiggle.com/opensim/ode-debug.dll <br>

Rename it <tt>ode.dll</tt> and put it in <tt>.\bin</tt>, replacing the stock <tt>ode.dll</tt>. You can also try building <tt>ode.dll</tt> from the latest version of the source (http://www.ode.org/; make sure to enable trimesh)

=== Running ===

Recent versions of OpenSim come without an <tt>OpenSim.ini</tt> file. Copy the <tt>OpenSim.ini.example</tt> file to <tt>OpenSim.ini</tt> before making any changes.

Double-click on the <tt>OpenSim.exe</tt> executable file in the <tt>bin</tt> directory. This will start up OpenSim in standalone mode.

The debugger in VS2005 C# may be used to step through the code. For those that use a Cygwin shell, you may find that one or more dll's have permissions that cause problems running. Most find that a "<tt>chmod 777 *</tt>" from the <tt>bin</tt> directory solves this.

Physics can be invoked by adding the appropriate line to the [Startup] section of <tt>OpenSim.ini</tt>. For ODE, that would be:

physics = OpenDynamicsEngine

You can also add a command line option to a shortcut, or run from a command prompt with:

-physics=OpenDynamicsEngine

'''''Windows Vista'''''

To run on Windows Vista, you must first disable Windows Firewall. Under the new "Start" button of Vista, select "Control panel". Then double-click "Windows Firewall". In the window that pops up, on the left column, select "Turn Windows Firewall on or off". You will have to give permission for this to run, then select the option "Off (not recommended)". Click "OK" and exit from the Windows Firewall window.

If you have McAfee SecurityCenter, see the description below.

Once all the security features are disabled, right click on <tt>OpenSim.exe</tt> and select "Run as administrator". This will pop up a window asking permission, select "Allow". Your OpenSim server should run in a DOS-like window and accept connections.

'''''McAfee Security'''''

McAfee Security does not allow applications to listen on ports not explicitly specified. You have two options: 1) disable firewall protection all together, 2) enable <tt>OpenSim.exe</tt> to be able to open ports.

''Disable firewall''

Open McAfee SecurityCenter. Select "Internet & Network". In the lower left corner is a small link to "Configure...". Select this. In the right side of the window, select the bar that says "Firewall protection is enabled". Here you can select "Off".

''Enable <tt>OpenSim.exe</tt> to open ports''

Open McAfee SecurityCenter. Select "Internet & Network". In the lower left corner is a small link to "Configure...". Select this. In the right side of the window, select the bar that says "Firewall protection is enabled". Select the "Advanced..." button. This will pop up a new window.

In the new window, on the left side, select "Program Permissions." In the middle on the right side of the window, select the "Add Allowed Program" button. Use the browser that pops up to find the OpenSim executable and select it.

Finally, select "OK" and exit the McAfee SecurityCenter window.

==Linux/Mac OS X/FreeBSD==

Please note that the current (as of 2007-11-23) SVN will not work on 64bit linux systems when built. You will need to use the binary build further down the page.
[[Installing and running on x86-64]]

=== Subversion Repository ===

To check out the latest revision:

svn co http://opensimulator.org/svn/opensim/trunk opensim

Note: The <tt>libopenjpeg-libsl-...so</tt> is not really working. For this reason you should download the newest libsecondlife from http://www.libsecondlife.org/, and build your own libopenjpeg library. If you use this instead of the SVN version, your sim will work fine.

Notes to Mac OS X users:

* OS X does not come packaged with subversion, so you will need to either install it or access the repository from a computer that does have subversion.
* You'll also need to install Mono.
* The version of Mono in MacPorts (formerly DarwinPorts) seems to be out of date and produced compilation errors on my system. You may have better luck installing the newest package from http://www.mono-project.com/Downloads
* Even with the newer version, there's a config problem with NAnt. There's a blog post here: http://bleepsoft.com/tyler/index.php?itemid=82 which explains how to fix the script (the blog post shows the path for 1.1.18 -- you'll need to replace this with 1.2.5 if you install the latest version from mono-project.com).

=== Building (Mono) ===

cd opensim
./runprebuild.sh
nant

If you encounter any errors while trying this, check the [[Troubleshooting]] page for help.

==== Physics (Unix) ====

If you want to implement collision-based physics, OpenDynamicsEngine (ODE) is the furthest along at the moment (9/07). It is not fully supported, but is starting to work somewhat reliably using a small number of regions per sim.

===== Open Dynamics Engine (ODE) =====

As installed from svn, ODE does not work on all platforms. If you get an ODE-related crash, and/or a <i>libode.so not found</i> type of error, you will need to build libode from source.

Remove <tt>libode.so</tt> from the <tt>./bin</tt> folder. (Note that subsequent svn updates may replace it again; best fix is to copy your built <tt>libode.so</tt> to <tt>bin</tt>). Do NOT remove <tt>ode.net.dll</tt>! Download the latest source packages from http://www.ode.org/. When compiling, make sure to use the following configure options:

--with-trimesh=gimpact
--enable-shared

Make sure the configure script confirms these choices, and always compile with single precision (I believe that's the default). Try <code> make -k </code> if you get errors relating to drawstuff, test*, or openGL. <code> make install </code> should put <tt>libode.so</tt> in the proper place (usually <tt>/usr/local/lib</tt>), and it should be seen by opensim (<tt>ode.net.dll</tt>)

=== Install Steps for Unix Platforms ===

Steps to get packages that are needed to compile the source.

==== FreeBSD 6.2 ====
su
cd /usr/ports/devel/subversion/ && make install clean (you may also need to rebuild apr-svn if this step fails)
cd /usr/ports/lang/mono/ && make install clean
cd /usr/ports/devel/nant/ && make install clean
cd /usr/ports/databases/sqlite3/ && make install clean
cd /usr/ports/x11-toolkits/libgdiplus/ && make install clean
cd /opensim/installation/directory/
svn co http://opensimulator.org/svn/opensim/trunk opensim
cd opensim
./runprebuild.sh
nant

For ODE Physics you must do the following:
cd /usr/ports/graphics/libGL/ && make install clean
cd /usr/ports/graphics/libGLU/ && make install clean
cd /opensim/installation/directory/
svn co http://opensimulator.org/svn/opensim/trunk opensim-libs
cd opensim-libs/unmanaged/OpenDynamicsEngine/
./configure --enable-shared
make
mv ./ode/src/libode.so /opensim/installation/directory/opensim/bin/

==== Ubuntu Server 7.10 ====
sudo apt-get subversion
sudo apt-get mono
sudo apt-get install nant
sudo apt-get install mono-mjs libmono-microsoft8.0-cil
sudo apt-get install libmono-system-runtime2.0-cil
svn co http://opensimulator.org/svn/opensim/trunk opensim
cd opensim
./runprebuild.sh
nant

=== Running (Mono) ===

Recent versions of OpenSim come without an <tt>OpenSim.ini</tt> file. Copy the <tt>OpenSim.ini.example</tt> file to <tt>OpenSim.ini</tt> before making any changes.

cd bin
mono OpenSim.exe

to invoke ODE, add the option:
-physics=OpenDynamicsEngine

or add <code> physics = OpenDynamicsEngine </code> to the [Startup] section of <tt>OpenSim.ini</tt>. Same deal for other physics engines, when available.

=== External tutorials and howtos ===
[http://nonumerable.net/metaverso-opensim-en-gnulinux/ Spanish howto: Opensim in GNU/Linux]

=Binary releases=

Nightly builds, in tar-gzip format:

http://ruth.petitbe.be/build/

The following packages and their dependencies are required to run OpenSim on a default Debian 4 netinstall:
* mono
* libmono-corlib2.0-cil
* libmono-sqlite2.0-cil
* libmono-system-web2.0-cil
* libmono-microsoft8.0-cil
* libmono-system-runtime2.0-cil

Download

2008-01-09T00:37:51Z

James Harrison: OpenSim:Download moved to Download: Removing OpenSim namespace; not needed.

== Stable Releases ==
These are the last version that were considered "stable" and useable in a test enviornment.

Version 0.4.0

(Source) http://dist.opensimulator.org/opensim-0.4.zip

(Source) http://dist.opensimulator.org/opensim-0.4.tar.gz

(Source) svn co http://opensimulator.org/svn/opensim/tags/0.4.5.2-stable opensim

== Nightly Builds ==
These are compiled packages created daily from the svn repository. The EXE's can be run natively under Windows, but requires Mono to run under Mac OS X and Linux.

They can be downloaded from:

(Binaries) http://ruth.petitbe.be/build/

== SVN Checkout ==
To get the very latest (and usually unstable) source, run:

svn co http://opensimulator.org/svn/opensim/trunk opensim

SVN can be downloaded for Windows from [http://subversion.tigris.org/servlets/NewsItemView?newsItemID=1941 here], or for Mac OS X [http://homepage.mac.com/martinott/Subversion-1.4.4.pkg.zip here].

== PreConfigured Standalone "Ready to Run" for XP/VISTA (32Bit) ==

A Preconfigured "Ready to Run" for Standalone based on SVN2803 is available for Download here:

http://www.openlifegrid.com/opensimdownload.aspx

Instructions provided at the page above.

Simply Unzip, and run StartRegion.bat to Start & StopRegion.bat to Stop. It already includes a default user and 1 Region (Custom made Island). Connection made via -loginuri http://127.0.0.1:9000

Developer Documentation

2008-01-09T00:34:24Z

James Harrison: Moving developer section off homepage and tidying up

== Communication ==

A good first point of contact is the OpenSim IRC, on irc.freenode.net channel #opensim/#opensim-dev.

The OpenSim developers hold [[office hours]] once a week in-world on Tuesdays at "Wright Plaza" on OSGrid.

There is a "Test Hour" on Saturdays, also generally on "Wright Plaza". Both these weekly events are held at 11:00AM PST or 1900UTC.

Check on the #opensim IRC channel on Freenode just before each of these events if there is any confusion.

== Developer Documentation ==
You can view the current [[top 10 bugs]] blocking forward development.

* [[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]]
* [[Grid 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.
* [[LSL Status]] — LSL implementation progress.
* [[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.

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