ModRex

Overview

ModRex is a joint effort - in the form of a module - to make OpenSim aware of RealXtend specific functionality. It will allow us to use the best of both worlds. RealXtend with features like meshes, uv-mapping, particle-scripts, python-scripting, bots, and OpenSim-trunk with up-to-date codebase, and features like region webloading, mysql, hypergrid and webmaps.

This is still pre-alpha code, so some features may not work.

Procedure

Linux

At the moment branch 0.2 is used, but normally check out trunk. I use this directory structure for RealXtend now:

mkdir /opt/opensim opt/opensim/simulator /opt/opensim/authentication /opt/opensim/avatarstorage /opt/opensim/builds

• Check out and compile OpenSim:

svn co http://opensimulator.org/svn/opensim/trunk /opt/opensim/builds/7xxx
runprebuild.sh
nant

• Make a directory 'modrex' in your checked out OpenSim dir, and from there check out modrex(or check out a branch, if current)

svn checkout http://forge.opensimulator.org/svn/modrex/trunk .

• Prepare the code for nant(There should be a prebuild.xml file):

mono ../../bin/Prebuild.exe /target nant
nant

• Copy bin/Debug/ModularRex.dll to /opt/opensim/simulator
• Download and build the authentication service

svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/authentication/tags/0.4 /opt/opensim/authentication
bin/Prebuild.exe /target nant
nant

• Create a mysql database for authentication(authentication?) and start the service with mono
• Setup authentication

MySql_SqlHandler.dll (or SQLite_SqlHandler.dll. MySql_SqlHandler.dll gives not implemented messages but seems to work ok)
<enter>(AuthenticationEngine=AuthenticationEngine.dll)
<enter>(logging enabled=False)
<enter>(def. region x 1000)
<enter>(def. region y 1000)
<enter>(avatarstorageurl 172.16.1.65:10000)
<enter>(default gridurl 172.16.1.65:9000)
<enter>(default dns)
<enter>(dbserver 127.0.0.1)
<enter>(dbname authentication)
<enter>(dbuser root)
*******(dbpw for root)
172.16.1.65 (httpsettings LAN-IP)

The authentication daemon should run by now

• Download and build the avatarstorage service

svn co https://realxtendserver.svn.sourceforge.net/svnroot/realxtendserver/avatarstorage/tags/0.4 /opt/opensim/avatarstorage
bin/Prebuild.exe /target nant
nant

• Create a database for avatarstorage(avatarstorage?) and start the service with mono
• Setup avatarstorage

MySql_SqlHandler.dll
<enter>(AuthenticationEngine.dll)
<enter>(Inventory True)
<enter>(PersonalInventoryService.dll)
PersonalInventory.SQLITE.dll
<enter>(logging_enabled False)
<enter>(dbserver 127.0.0.1)
avatarstorage (dbname)
<enter>(dbuser root)
********(dbpw root)
172.16.1.65 (httpsettings LAN-IP)
<enter>(http port 10000)
<enter>(ssl False)

The avatarstorage daemon should run by now

• Setup OpenSim in standalone mode(Grid is not working yet); add these lines to OpenSim.ini:

[realXtend]
 enabled=true

• You can use this rex serverscript to manage and start the services(uses screen)
• Create a user in the authentication console

create user

the 'Account' part is the first part in your rex-username(account@myauthenticationdaemonuri) Once the three services are running, an initial user was made, fire up the realXtend client with wine and login.

Known Quirks

• Shift-copy a mesh leaves a prim behind
• Meshes are persistant only after a clean shutdown
• Mesh collision doesn't work yet
• Land owner not recognized in 'about land'