ModRex
From OpenSimulator
(minor fixes to linux guide) |
DeepSurfer (Talk | contribs) (→Overview) |
||
(24 intermediate revisions by 10 users not shown) | |||
Line 1: | Line 1: | ||
− | + | __NOTOC__ | |
+ | {{Quicklinks}} | ||
+ | <br /> | ||
− | ==Overview== | + | == Overview == |
− | [[ | + | [[Image:modrex.jpg|250px|thumb|left|ModRex with mesh support, running on Linux]] |
− | ModRex is a joint effort between RealXtend and | + | ModRex is a joint effort between RealXtend and OpenSimulator developers to make it |
− | possible to join the RealXtend viewer to the | + | possible to join the RealXtend viewer to the OpenSimulator codebase. The RealXtend |
− | viewer employs the open source [http://www.ogre3d.org OGRE | + | viewer employs the open source [http://www.ogre3d.org OGRE 3D engine] |
and differs from the Linden Lab viewer (LLviewer) in several ways. The most distinct | and differs from the Linden Lab viewer (LLviewer) in several ways. The most distinct | ||
difference is in the new rendering potential offered by OGRE. When using | difference is in the new rendering potential offered by OGRE. When using | ||
Line 12: | Line 14: | ||
(multiple meshes and sub-meshes) and can include a skeleton for defining avatar motion and dynamics. | (multiple meshes and sub-meshes) and can include a skeleton for defining avatar motion and dynamics. | ||
− | ModRex is important to the | + | ModRex is important to the OpenSimulator community mainly because, like the base |
opensim code base itself, the RealXtend viewer is open source and breaks away | opensim code base itself, the RealXtend viewer is open source and breaks away | ||
from some of the key contraints imposed by the LLviewer, such as inability to | from some of the key contraints imposed by the LLviewer, such as inability to | ||
Line 19: | Line 21: | ||
trunk code. | trunk code. | ||
− | and a | + | and a to illustrate some of the mesh and lighting effects in the viewer: |
To use ModRex, you need the following: | To use ModRex, you need the following: | ||
− | * [http:// | + | * [http://realxtend.org/download/ RealXtend viewer (CodeName: Tundra)] |
+ | * Alternatively you can also use the new [http://wiki.realxtend.org/index.php/Getting_Started_with_Naali Naali viewer] | ||
* [http://forge.opensimulator.org/gf/project/modrex/ ModRex] | * [http://forge.opensimulator.org/gf/project/modrex/ ModRex] | ||
* [OpenSim-SVN (rev. 8814+) | * [OpenSim-SVN (rev. 8814+) | ||
+ | * [http://www.mono-project.com/Main_Page Mono] (Linux) | ||
+ | * [http://nant.sourceforge.net/ NAnt] (Linux) | ||
− | ==Links== | + | == Links == |
* [http://forge.opensimulator.org/gf/project/modrex/ Source Code] | * [http://forge.opensimulator.org/gf/project/modrex/ Source Code] | ||
− | * [http:// | + | * [http://wiki.realxtend.org/index.php/Features_supported_currently ModRex Features/Status] |
* [http://www.realxtend.org Main RealXtend] | * [http://www.realxtend.org Main RealXtend] | ||
− | * [http:// | + | * [http://wiki.realxtend.org/ RealXtend community wiki] |
− | ==Setup== | + | == Setup == |
− | + | ||
− | + | ||
− | + | First launch realXtend authentication and avatar storage servers. You can download them from [http://sourceforge.net/projects/realxtendserver/files/ SourceForge project page]. Documentation for these servers can be found from [http://docs.realxtend.org/ realXtend user documentation wiki]. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | After successfully launching authentication and avatar storage server, build ModreX according to instructions in [http://wiki.realxtend.org/index.php/Building_ModreX realXtend wiki]. To configure ModreX follow the instructions in [http://wiki.realxtend.org/index.php/Configuring_ModreX this wiki page]. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | If any bugs occur, please report them to [http://forge.opensimulator.org/gf/project/modrex/tracker/ ModreX bug tracker]. Note that to run realXtend 0.4 series viewer on Linux, you need to follow [[RealXtend Viewer Linux|these instructions]]. | |
− | + | ||
− | + | == Known Issues == | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | ==Known Issues== | + | |
* Some parts of the LLViewer interface do not yet exist in the RealXtend viewer. This is related to ModRex not allowing the viewer to set or retrieve certain data. | * Some parts of the LLViewer interface do not yet exist in the RealXtend viewer. This is related to ModRex not allowing the viewer to set or retrieve certain data. | ||
− | |||
* Inter-mesh collisions not yet implemented, although avatar w/ primitive collisions work | * Inter-mesh collisions not yet implemented, although avatar w/ primitive collisions work | ||
+ | * Shift-copied Objects may loose their texture after a sim restart | ||
− | ==Recent Fixes== | + | == Recent Fixes == |
− | * Multiregion Support | + | * Multiregion Support with RexQueue |
+ | * Multiple standalones on one machine supported | ||
* NHibernate-db supports mysql, sqlite and mssql2005. Meshes are persistent | * NHibernate-db supports mysql, sqlite and mssql2005. Meshes are persistent | ||
* Mesh collisions with primitives work | * Mesh collisions with primitives work | ||
* Python scripting works for the most part (some functions are not working yet) | * Python scripting works for the most part (some functions are not working yet) | ||
* Shift-copy keeps mesh as primdata | * Shift-copy keeps mesh as primdata | ||
− | * | + | * OpenSimulator library useable now |
+ | * Avatar is stored, but appearance changes only after viewer restart |
Revision as of 13:31, 13 August 2012
Overview
ModRex is a joint effort between RealXtend and OpenSimulator developers to make it possible to join the RealXtend viewer to the OpenSimulator codebase. The RealXtend viewer employs the open source OGRE 3D engine and differs from the Linden Lab viewer (LLviewer) in several ways. The most distinct difference is in the new rendering potential offered by OGRE. When using RealXtend as a viewer for OpenSim, one obtains real-time shadows, improved lighting simulation, and more importantly, the OGRE mesh. The mesh is hierarchical (multiple meshes and sub-meshes) and can include a skeleton for defining avatar motion and dynamics.
ModRex is important to the OpenSimulator community mainly because, like the base opensim code base itself, the RealXtend viewer is open source and breaks away from some of the key contraints imposed by the LLviewer, such as inability to create meshes, shadows, realistic avatars, and advanced lighting effects. ModRex while not part of the viewer, is the glue that connects the viewer to the opensim trunk code.
and a to illustrate some of the mesh and lighting effects in the viewer:
To use ModRex, you need the following:
- RealXtend viewer (CodeName: Tundra)
- Alternatively you can also use the new Naali viewer
- ModRex
- [OpenSim-SVN (rev. 8814+)
- Mono (Linux)
- NAnt (Linux)
Links
Setup
First launch realXtend authentication and avatar storage servers. You can download them from SourceForge project page. Documentation for these servers can be found from realXtend user documentation wiki.
After successfully launching authentication and avatar storage server, build ModreX according to instructions in realXtend wiki. To configure ModreX follow the instructions in this wiki page.
If any bugs occur, please report them to ModreX bug tracker. Note that to run realXtend 0.4 series viewer on Linux, you need to follow these instructions.
Known Issues
- Some parts of the LLViewer interface do not yet exist in the RealXtend viewer. This is related to ModRex not allowing the viewer to set or retrieve certain data.
- Inter-mesh collisions not yet implemented, although avatar w/ primitive collisions work
- Shift-copied Objects may loose their texture after a sim restart
Recent Fixes
- Multiregion Support with RexQueue
- Multiple standalones on one machine supported
- NHibernate-db supports mysql, sqlite and mssql2005. Meshes are persistent
- Mesh collisions with primitives work
- Python scripting works for the most part (some functions are not working yet)
- Shift-copy keeps mesh as primdata
- OpenSimulator library useable now
- Avatar is stored, but appearance changes only after viewer restart