OpenSimulator - User contributions [en]

File:Powered-by-simhostlogo.png

2012-09-14T18:33:58Z

Twitch: SimHost.com 'Powered By' logo

SimHost.com 'Powered By' logo

Webinterface

2012-06-23T22:10:40Z

Twitch: /* PHP */

__NOTOC__ {{Quicklinks}} {{thirdparty}}

== Addon Modules ==

* [[Wifi]] - A Simple Account Management Front-end

== PHP ==

* [https://github.com/JamesStallings/EgressWFE EgressWFE] - Web Interface for stock ROBUST-based OpenSimulator Grids (get OpenSimulator here: [http://opensimulator.org/ OpenSimulator]). Extensive grid management for operators, user account management for users. Needs additional work, but is very functional. BSD Licensed. By James G. Stallings II aka Hiro Protagonist, [http://SimHost.com SimHost.com], and others. Note that Egress is written using the Codeigniter 2.0 PHP Framework.
* [https://github.com/JamesStallings/gainsayWFE gainsayWFE] - Extremely Minimalist Web Interface for stock ROBUST-based OpenSimulator Grids (get OpenSimulator here: [http://opensimulator.org/ OpenSimulator]). Web-based account requests, Userspace request management scripts to review, approve, or delete avatar account requests made over the web. BSD Licensed. By James G. Stallings II aka Hiro Protagonist, [http://SimHost.com SimHost.com], and others.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?XoopenSim%20(E) XoopenSim] - Web Interface for [http://xoopscube.org/ Xoops Cube]. v1.50 supports MySQL Data Base of 0.6.7,0.6.8,0.6.9 and 0.7, 0.7.1Dev, and it includes flotsam group function, osprofile, ossearch, mute list and login screen function.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Modlos%20%28E%29 Modlos] - Web Interface for [http://moodle.org/ Moodle]. This software is sister application of XoopenSim. Modlos has same functions with XoopenSim and supports cooperation with [http://www.sloodle.org Sloodle].
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimulator Web Interface] This is a PHP Web Interface for OpenSimulator (Open Simulator Project), it allows grid citizens to create User Accounts to access the grid. Grid Owners can also manage all users for the grid, with a very powerful CMS system included. (Beta Release for 0.7.x is in Branches)
* [http://d4os.org D4os] - A set of [http://drupal.org Drupal] modules to control a grid.
* [http://openmetaverse.googlecode.com/ SimianGridFrontend] - The PHP-based web interface that accompanies SimianGrid. SimianGridFrontend is based on the CodeIgniter PHP MVC framework.
* [http://lab.newworldgrid.com/Wiki/index.php/Rest_Ajax_Manager/ Nwg Rest Ajax Manager] - A remote console using php & ajax to user with RestConsole system.
* [http://lab.newworldgrid.com/Wiki/index.php/Ajax_Map/ Nwg Ajax Map] - A dynamic map of the grid using ajax with a reservation system.
* [http://code.google.com/p/openmetaverse/wiki/SimianGrid SimianGrid] - A scalable, extensible, light-weight, open source persistence layer for MMOs and virtual worlds, written in PHP. Also provides the frontend mentioned above and WebDAV access to inventory.
* [http://sourceforge.net/apps/trac/unga/wiki/WikiStart unga] - Both an UGAIM (User, Grid, Assets, Inventory, Messaging) server system and a backend for configuring that servers. Also, its modular architecture allows to create (or plug) specialized modules created in standard PHP.
* [http://www.foto50.com/ jOpenSim] - Joomla! component for interacting with an OpenSimulator server and 2 modules (grid status and friends online). The component is developed and designed with opensimulator starting from V 0.7.0.1 running in grid mode with MySQL as storage engine, but also can work with standalone mode.

=== Optional modules ===

* [http://code.google.com/p/flotsam/wiki/XmlRpcGroups XmlRpcGroups] - A set of xmlrpc methods to manage groups in opensim. See [[Groups|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/ossearch ossearch] - A set of xmlrpc methods to manage search, events and classifieds. See [[OpenSimSearch|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/osprofile osprofile] - A set of xmlrpc methods to manage persistent profile.
* [http://forge.opensimulator.org/gf/project/webassets/ webassets] - A script to render assets pictures to display on a website.

== Python ==

* [https://github.com/phrearch/hwios HWIOS] - Websocket CMS with experimental OpenSimulator support. HWIOS includes OpenSimulator user management, region management with interactive scalable maps, distributed service management(start/stop/kill service + remote websocket consoles), IAR/OAR sharing through teknon webdav shares, websocket chat, a realtime distributed wiki(hyki) and a simple collaborative drawing application. HWIOS is currently compatible with OpenSimulator 0.7.1 and webkit browsers(Chrome/Chromium 8+, Safari and FF4 to some degree). For more information, check out the [http://hwios.blogspot.com HWIOS Blog]
* [https://github.com/phrearch/teknon Teknon] - A Twisted TCP daemon, capable of communicating over a persistent connection between local services and HWIOS websockets through subprocess pipes. HWIOS uses teknon for distributed service management and remote consoles.

[[Category:Development]]

Webinterface

2012-06-23T20:19:53Z

Twitch: /* PHP */ add egress and gainsay PHP web interfaces

__NOTOC__ {{Quicklinks}} {{thirdparty}}

== Addon Modules ==

* [[Wifi]] - A Simple Account Management Front-end

== PHP ==

* [https://github.com/JamesStallings/EgressWFE EgressWFE] - Web Interface for stock ROBUST-based OpenSimulator Grids (get OpenSimulator here: [http://opensimulator.org/ OpenSimulator]). Extensive grid management for operators, user account management for users. Needs additional work, but is very functional. BSD Licensed. By James G. Stallings II aka Hiro Protagonist, SimHost.com, and others. Note that Egress is written using the Codeigniter 2.0 PHP Framework.
* [https://github.com/JamesStallings/gainsayWFE gainsayWFE] - Extremely Minimalist Web Interface for stock ROBUST-based OpenSimulator Grids (get OpenSimulator here: [http://opensimulator.org/ OpenSimulator]). Web-based account requests, Userspace request management scripts to review, approve, or delete avatar account requests made over the web. BSD Licensed. By James G. Stallings II aka Hiro Protagonist, SimHost.com, and others.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?XoopenSim%20(E) XoopenSim] - Web Interface for [http://xoopscube.org/ Xoops Cube]. v1.50 supports MySQL Data Base of 0.6.7,0.6.8,0.6.9 and 0.7, 0.7.1Dev, and it includes flotsam group function, osprofile, ossearch, mute list and login screen function.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Modlos%20%28E%29 Modlos] - Web Interface for [http://moodle.org/ Moodle]. This software is sister application of XoopenSim. Modlos has same functions with XoopenSim and supports cooperation with [http://www.sloodle.org Sloodle].
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimulator Web Interface] This is a PHP Web Interface for OpenSimulator (Open Simulator Project), it allows grid citizens to create User Accounts to access the grid. Grid Owners can also manage all users for the grid, with a very powerful CMS system included. (Beta Release for 0.7.x is in Branches)
* [http://d4os.org D4os] - A set of [http://drupal.org Drupal] modules to control a grid.
* [http://openmetaverse.googlecode.com/ SimianGridFrontend] - The PHP-based web interface that accompanies SimianGrid. SimianGridFrontend is based on the CodeIgniter PHP MVC framework.
* [http://lab.newworldgrid.com/Wiki/index.php/Rest_Ajax_Manager/ Nwg Rest Ajax Manager] - A remote console using php & ajax to user with RestConsole system.
* [http://lab.newworldgrid.com/Wiki/index.php/Ajax_Map/ Nwg Ajax Map] - A dynamic map of the grid using ajax with a reservation system.
* [http://code.google.com/p/openmetaverse/wiki/SimianGrid SimianGrid] - A scalable, extensible, light-weight, open source persistence layer for MMOs and virtual worlds, written in PHP. Also provides the frontend mentioned above and WebDAV access to inventory.
* [http://sourceforge.net/apps/trac/unga/wiki/WikiStart unga] - Both an UGAIM (User, Grid, Assets, Inventory, Messaging) server system and a backend for configuring that servers. Also, its modular architecture allows to create (or plug) specialized modules created in standard PHP.
* [http://www.foto50.com/ jOpenSim] - Joomla! component for interacting with an OpenSimulator server and 2 modules (grid status and friends online). The component is developed and designed with opensimulator starting from V 0.7.0.1 running in grid mode with MySQL as storage engine, but also can work with standalone mode.

=== Optional modules ===

* [http://code.google.com/p/flotsam/wiki/XmlRpcGroups XmlRpcGroups] - A set of xmlrpc methods to manage groups in opensim. See [[Groups|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/ossearch ossearch] - A set of xmlrpc methods to manage search, events and classifieds. See [[OpenSimSearch|this page]] for how to configure it.
* [http://forge.opensimulator.org/gf/project/osprofile osprofile] - A set of xmlrpc methods to manage persistent profile.
* [http://forge.opensimulator.org/gf/project/webassets/ webassets] - A script to render assets pictures to display on a website.

== Python ==

* [https://github.com/phrearch/hwios HWIOS] - Websocket CMS with experimental OpenSimulator support. HWIOS includes OpenSimulator user management, region management with interactive scalable maps, distributed service management(start/stop/kill service + remote websocket consoles), IAR/OAR sharing through teknon webdav shares, websocket chat, a realtime distributed wiki(hyki) and a simple collaborative drawing application. HWIOS is currently compatible with OpenSimulator 0.7.1 and webkit browsers(Chrome/Chromium 8+, Safari and FF4 to some degree). For more information, check out the [http://hwios.blogspot.com HWIOS Blog]
* [https://github.com/phrearch/teknon Teknon] - A Twisted TCP daemon, capable of communicating over a persistent connection between local services and HWIOS websockets through subprocess pipes. HWIOS uses teknon for distributed service management and remote consoles.

[[Category:Development]]

Vehicles

2009-09-23T03:51:00Z

Twitch: /* VEHICLE Scripting Examples */

== Summary ==
August 2009: Kitto Flora is revising the OdePlugin files in an attempt to provide SL-compatible VEHICLE functionality to OpenSimulator. A couple of test regions have been provided by Bri Hasp, these are Sea-3 and Sea-4 in OSgrid. You may visit there and test vehicles but please clean up after. The regions will frequently be restarted to test revisions. The revised Open Simulator files are being made available as a git branch, check here to see what may or may not work.

== Terminology ==
Here some terms are defined so that when we communicate we are talking about the same things.

==== Vehicle ====

Any object or link-set that moves. It is usually rideable. It may be Physical or not.

==== VEHICLE ====
Any object or link-set that uses LSL VEHICLE functions to achieve mobility. It is set to other than 'VEHICLE_TYPE_NONE'.

==== Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, TRUE). It will fall due to gravity (unless buoyancy is changed) and collide with other prims, avatars and the ground (unless set phantom).

==== Non-Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, FALSE), or has never has llSetStatus(STATUS_PHYSICS,...) applied. Such objects 'stick in midair' and can interpenetrate other objects.

==== Kinematic ====
Motion system used by Non-Physical objects, applied by such functions as llSetPos() and llSetRot().

==== Dynamic ====
Motion system used by Physical objects, applied by such functions as llSetForce() and llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <...>).

== About This Project ==
The objectives of this project are:
# To provide VEHICLE associated LSL functions within OpenSimulator that are compatible with Second Life functionality. This means trying to get them really close, but as we are trying to emulate complex HAVOK functions using what is available in ODE they may be only close to the SL functions.
# To clean up the OdePlugin files. Over many revisions and add-ons they have become somewhat non-optimal. In particular the 'Move' operation that makes objects move around needs to be very clean and smooth so that the update rate remains high.
# Maintain the existing non-VEHICLE dynamic functions and fix errors where found.

== Vehicle LSL Functions in revised OpenSimulator ==
There are three categories of LSL functions that are used by Vehicles: Kinematic, Dynamic and VEHICLE. These are listed below with information on their current status within the revised OpenSimulator. (Not the general release at this time.)
Kinematic vehicle motion can be used by non-physical objects. VEHICLE motion and the associated functions '''ONLY''' apply to objects that are set to a VEHICLE_TYPE of AIRPLANE, BALLOON, BOAT, CAR or SLED. Dynamic functions '''ONLY''' apply (at this time) to VEHICLE_TYPE_NONE, which is the default condition of an object. (In SL it appears that one can use Dynamic functions on a VEHICLE, but to keep things simple at the start of this project such a combination is ignored.)

== Known Problems ==
# timer() event ceases about 10 seconds after Vehicle moves. Does not restart until many seconds after Vehicle stops. '''Work-around:''' Use llSensor() for a non-existent object at short range and no_sensor() event to re-trigger it. This produces about 1000 events per second. Divide down to produce more reasonable rates.
# llSetBuoyancy() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non-VEHICLE vehicles.
# llSetHoverHeight() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non VEHICLE vehicles.
# llSetVehicleFlags() and llRemoveVehicleFlags() are not hooked to physics methods, and may cause simulator crash. LSL engine problem. '''Work-around:''' None, but the VEHICLE_TYPE presets are setting necessary flags.
# Prim parameters like Material are not being saved. '''Work-around:''' Set by script on rez or whenever used.
# Script state is not maintained between Take and Rez. '''Work-around:''' on_rez() Reset script and set *everything* again.
# Border Crossing is bad. Vehicle will be killed and Av unseated and left drifting through target region. '''Work-around:''' Quickly double-click on Map to tele-port to old region. Drag vehicle back and reset it.

== VEHICLE Scripting Notes ==
#(Not really scripting , but very important) DO NOT attempt to drive a VEHICLE across the Region boundary. If you do your Av will be orbited. You may be able to recover by Map double-click TP to a nearby Region. The VEHICLE object is usually killed, and sitting at edge of the destination region.
#In revised OpenSimulator the function llSetVehicleType(VEHICLE_TYPE_xxx), where xxx is AIRPLANE, BALLOON, BOAT, CAR or SLED, pre-sets all the applicable VEHICLE parameters to reasonable numbers. If you wish to change any of these pre-set parameters do so after asserting llSetVehicleType(VEHICLE_TYPE_xxx).
#At present it appears that some conditions within an instantiated scripted object are not maintained after a Region restart, and possibly between take and rez. Therefore you should assert llSetVehicleType(VEHICLE_TYPE_xxx) when the driver sits and llSetVehicleType(VEHICLE_TYPE_NONE)when the driver stands, and probably on_rez.
#The advice above also applies to camera controls. Assert llSetCameraxxx() on sit and llClearCameraParams() on stand. (At present there seems to be bugs in the Camera Control system, the camera will go underground!)
#The advice above is also true of Material Type. Land vehicles need the 'wheels' to be PRIM_MATERIAL_GLASS. The script(s) must llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]) in every prim that touches the ground, when the rider sits, for reliable operation. Use a link mesage from the root to daughter prim scripts.
#Use llSetStatus(STATUS_PHYSICS, TRUE) to enable the VEHICLE, usually when the driver sits. Use llSetStatus(STATUS_PHYSICS, FALSE) to disable the VEHICLE, usually when the driver stands.
#It appears that the timer() event freezes while a Vehicle is in motion, so do not rely in Timer() to update things like steering or velocity. See Known Problems for a work-around.

== VEHICLE Scripting Examples ==
Below are some initial (and very similar) Vehicle scripting examples, implementing a sort of go kart, and the second a motorboat. The motorboat script is a derivative work based on the go kart script.

*** Note that these scripts are works in progress and may or may not impact the performance of your region negatively.

Car or Go kart script:

<source lang=LSL>
// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 12; //Power used to go forward (1 to 30)
float reverse_power = -6; //Power ued to go reverse (-1 to -30)
float turning_ratio = 2.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer turncount;
string Wheeldir = "WC";
string NewWheeldir = "WC";
string Wheelrot = "S";
string NewWheelrot = "S";
integer scount;
integer Speed;
integer Run;

string sit_message = "Ride"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//car
llSetVehicleType(VEHICLE_TYPE_CAR);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.50);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.50);

}
Init()
{
Sound(0);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llGround(<0,0,0>) + 0.52;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]);
llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
llLoopSound("RUNNING",1);
}
else if(n == 1)
{
llLoopSound("IDLE",1);
}
else
{
llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
NewWheeldir = "WR";
turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
NewWheeldir = "WL";
turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
if(turncount > 0)
{
turncount--;
}
if(turncount == 1)
{
NewWheeldir = "WC";
}
if(Wheeldir != NewWheeldir){
Wheeldir = NewWheeldir;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
}
if(Wheelrot != NewWheelrot){
Wheelrot = NewWheelrot;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
}
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Sound(1);
Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

Motorboat script:

<source lang=LSL>

// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

// modified by Hiro Protagonist for basic aquatic motorcraft
// September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 8; //Power used to go forward (1 to 30)
float reverse_power = -3; //Power ued to go reverse (-1 to -30)
float turning_ratio = 1.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer scount;
integer Speed;
integer Run;

string sit_message = "Man the Helm"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//boat
llSetVehicleType(VEHICLE_TYPE_BOAT);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.250);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.250);

}
Init()
{
Sound(0);
llSetBuoyancy(1);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llWater(<0,0,0>) + 0.22;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_WOOD]);
// llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
// llLoopSound("RUNNING",1);
}
else if(n == 1)
{
// llLoopSound("IDLE",1);
}
else
{
// llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
// llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
// NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
// NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
// NewWheeldir = "WR";
// turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
// NewWheeldir = "WL";
// turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
// if(turncount > 0)
// {
// turncount--;
// }
// if(turncount == 1)
// {
// NewWheeldir = "WC";
// }
// if(Wheeldir != NewWheeldir){
// Wheeldir = NewWheeldir;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
// }
// if(Wheelrot != NewWheelrot){
// Wheelrot = NewWheelrot;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
// }
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
// llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
// Sound(1);
// Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

== Vehicle LSL Functions and Status ==
NOTE! This list applies to the revised OpenSimulator, not the released
OpenSimulator.

Key: Y = Yes; N = No; F = Framework present but commented out; N/A = Has not been checked (much) yet

=== KINEMATIC ===
Object must not be PHYSICAL

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Set by LSL?!!Used by OpenSim C#!!Works?!!Comments
|-
|llSetPos()||Y||Y||Y||Also works on physical objects!
|-
|llSetRot()||Y||Y||Y||Y
|-
|llSetLocalRot()||Y||Y||Y
|-
|llSetScale()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|}

=== DYNAMIC ===
Object must be PHYSICAL and VEHICLE_TYPE_NONE(default) at present, but this must probably change.

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Parameter!!Set by LSL?!!Used by OpenSim C#!!Comments
|-
|llApplyImpulse()||N/A||N/A||N/A||N/A
|-
|llApplyRotationalImpulse()||N/A||N/A||N/A||N/A
|-
|llGroundRepel()||N/A||N/A||N/A||N/A
|-
|llMoveToTarget()||N/A||N/A||N/A||N/A
|-
|llPushObject()||N/A||N/A||N/A||N/A
|-
|llSetBuoyancy()||N/A||N/A||N/A||(do not confuse with VEHICLE_BUOYANCY)
|-
|llSetForce()||N/A||N/A||N/A||N/A
|-
|llSetForceAndTorque()||N/A||N/A||N/A||N/A
|-
|llSetHoverHeight()||N/A||N/A||N/A||(do not confuse with VEHICLE_HOVER_HEIGHT)
|-
|llSetTorque()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|}

=== VEHICLE ===
Object must be PHYSICAL and VEHICLE_TYPE_<other than NONE>
{|class="wikitable sortable"
!Functions!!Set by LSL?!!Used!!Works!!Exceptions
|-
|llSetVehicleType()||Y||Y||Y
|-
|llSetVehicleFlags()||N||N||N||Some flags are set by llSetVehicleType()
|-
|llRemoveVehicleFlags()||N||N||N||
|-
|llSetVehicleFloatParam()||Y||Y||Y||
|-
|llSetVehicleVectorParam()||Y||Y||Y||
|-
|llSetVehicleRotationParam()||Y||Y||Y||
|}

{|class="wikitable sortable"
!Parameters!!Set by LSL?!!Used!!Works!!Exceptions
|-
|VEHICLE_LINEAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_OFFSET||F||N|| ||
|-
|VEHICLE_ANGULAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
||VEHICLE_BANKING_EFFICIENCY||F||N|| ||
|-
|VEHICLE_BANKING_MIX||F||N|| ||
|-
|VEHICLE_BANKING_TIMESCALE||F||N|| ||
|-
|VEHICLE_BUOYANCY||Y||Y||Y||(do not confuse with llSetBuoyancy())
|-
|VEHICLE_HOVER_HEIGHT||Y||Y||Y||(do not confuse with llSetHoverHeight())
|-
|VEHICLE_HOVER_EFFICIENCY||Y||N|| ||
|-
|VEHICLE_HOVER_TIMESCALE||Y||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_REFERENCE_FRAME||F||N|| ||
|-
|VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY||Y||Y||Y||
|-
|VEHICLE_VERTICAL_ATTRACTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_TYPE_NONE||Y||Y||Y||
|-
|VEHICLE_TYPE_BALLOON||Y||Y||Y||
|-
|VEHICLE_TYPE_BOAT||Y||Y||Y||
|-
|VEHICLE_TYPE_CAR||Y||Y||Y||
|-
|VEHICLE_TYPE_SLED||Y||Y||Y||
|-
|VEHICLE_FLAG_NO_DEFLECTION_UP||Y||N|| ||
|-
|VEHICLE_FLAG_LIMIT_ROLL_ONLY||Y||N|| ||
|-
|VEHICLE_FLAG_HOVER_WATER_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_TERRAIN_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_GLOBAL_HEIGHT||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_UP_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_LIMIT_MOTOR_UP||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_STEER||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_BANK||Y||N|| ||
|-
|VEHICLE_FLAG_CAMERA_DECOUPLED||Y||N|| ||
|}
== VEHICLE TYPE Presets ==
VEHICLE_TYPE_SLED:
linearFrictionTimescale <30, 1, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1000
linearMotorDecayTimescale 120
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1000
angularMotorDecayTimescale 120
VhoverHeight 0
VhoverEfficiency 1
VhoverTimescale 10
VehicleBuoyancy 0
linearDeflectionEfficiency 1
linearDeflectionTimescale 1
angularDeflectionEfficiency 1
angularDeflectionTimescale 1000
bankingEfficiency 0
bankingMix 1
bankingTimescale 10
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_CAR:
linearFrictionTimescale <100, 2, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1
angularMotorDecayTimescale 0.8
VhoverHeight 0
VhoverEfficiency 0
VhoverTimescale 1000
VehicleBuoyancy 0
// m_linearDeflectionEfficiency 1
// m_linearDeflectionTimescale 2
// m_angularDeflectionEfficiency 0
angularDeflectionTimescale 10
verticalAttractionEfficiency 1
verticalAttractionTimescale 10
bankingEfficiency -0.2
bankingMix 1
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_BOAT:
linearFrictionTimescale <10, 3, 2>
angularFrictionTimescale <10,10,10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 2
VehicleBuoyancy 1
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 0.5
angularDeflectionTimescale 5
verticalAttractionEfficiency 0.5
verticalAttractionTimescale 5
bankingEfficiency -0.3
bankingMix 0.8
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_TERRAIN_ONLY
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_AIRPLANE:
linearFrictionTimescale <200, 10, 5>
angularFrictionTimescale <20, 20, 20>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 2
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 1000
VehicleBuoyancy 0
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 1
angularDeflectionTimescale 2
verticalAttractionEfficiency 0.9
verticalAttractionTimescale 2
bankingEfficiency 1
bankingMix 0.7f
bankingTimescale 2
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY

VEHICLE_TYPE_BALLOON:
linearFrictionTimescale <5, 5, 5>
angularFrictionTimescale <10, 10, 10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 6
angularMotorDecayTimescale 10
VhoverHeight 5
VhoverEfficiency 0.8
VhoverTimescale 10
VehicleBuoyancy 1
linearDeflectionEfficiency 0
linearDeflectionTimescale 5
angularDeflectionEfficiency 0
angularDeflectionTimescale 5
verticalAttractionEfficiency 1
verticalAttractionTimescale 1000
bankingEfficiency 0
bankingMix 0.7
bankingTimescale 5
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT

Vehicles

2009-09-23T03:50:35Z

Twitch: /* VEHICLE Scripting Examples */

== Summary ==
August 2009: Kitto Flora is revising the OdePlugin files in an attempt to provide SL-compatible VEHICLE functionality to OpenSimulator. A couple of test regions have been provided by Bri Hasp, these are Sea-3 and Sea-4 in OSgrid. You may visit there and test vehicles but please clean up after. The regions will frequently be restarted to test revisions. The revised Open Simulator files are being made available as a git branch, check here to see what may or may not work.

== Terminology ==
Here some terms are defined so that when we communicate we are talking about the same things.

==== Vehicle ====

Any object or link-set that moves. It is usually rideable. It may be Physical or not.

==== VEHICLE ====
Any object or link-set that uses LSL VEHICLE functions to achieve mobility. It is set to other than 'VEHICLE_TYPE_NONE'.

==== Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, TRUE). It will fall due to gravity (unless buoyancy is changed) and collide with other prims, avatars and the ground (unless set phantom).

==== Non-Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, FALSE), or has never has llSetStatus(STATUS_PHYSICS,...) applied. Such objects 'stick in midair' and can interpenetrate other objects.

==== Kinematic ====
Motion system used by Non-Physical objects, applied by such functions as llSetPos() and llSetRot().

==== Dynamic ====
Motion system used by Physical objects, applied by such functions as llSetForce() and llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <...>).

== About This Project ==
The objectives of this project are:
# To provide VEHICLE associated LSL functions within OpenSimulator that are compatible with Second Life functionality. This means trying to get them really close, but as we are trying to emulate complex HAVOK functions using what is available in ODE they may be only close to the SL functions.
# To clean up the OdePlugin files. Over many revisions and add-ons they have become somewhat non-optimal. In particular the 'Move' operation that makes objects move around needs to be very clean and smooth so that the update rate remains high.
# Maintain the existing non-VEHICLE dynamic functions and fix errors where found.

== Vehicle LSL Functions in revised OpenSimulator ==
There are three categories of LSL functions that are used by Vehicles: Kinematic, Dynamic and VEHICLE. These are listed below with information on their current status within the revised OpenSimulator. (Not the general release at this time.)
Kinematic vehicle motion can be used by non-physical objects. VEHICLE motion and the associated functions '''ONLY''' apply to objects that are set to a VEHICLE_TYPE of AIRPLANE, BALLOON, BOAT, CAR or SLED. Dynamic functions '''ONLY''' apply (at this time) to VEHICLE_TYPE_NONE, which is the default condition of an object. (In SL it appears that one can use Dynamic functions on a VEHICLE, but to keep things simple at the start of this project such a combination is ignored.)

== Known Problems ==
# timer() event ceases about 10 seconds after Vehicle moves. Does not restart until many seconds after Vehicle stops. '''Work-around:''' Use llSensor() for a non-existent object at short range and no_sensor() event to re-trigger it. This produces about 1000 events per second. Divide down to produce more reasonable rates.
# llSetBuoyancy() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non-VEHICLE vehicles.
# llSetHoverHeight() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non VEHICLE vehicles.
# llSetVehicleFlags() and llRemoveVehicleFlags() are not hooked to physics methods, and may cause simulator crash. LSL engine problem. '''Work-around:''' None, but the VEHICLE_TYPE presets are setting necessary flags.
# Prim parameters like Material are not being saved. '''Work-around:''' Set by script on rez or whenever used.
# Script state is not maintained between Take and Rez. '''Work-around:''' on_rez() Reset script and set *everything* again.
# Border Crossing is bad. Vehicle will be killed and Av unseated and left drifting through target region. '''Work-around:''' Quickly double-click on Map to tele-port to old region. Drag vehicle back and reset it.

== VEHICLE Scripting Notes ==
#(Not really scripting , but very important) DO NOT attempt to drive a VEHICLE across the Region boundary. If you do your Av will be orbited. You may be able to recover by Map double-click TP to a nearby Region. The VEHICLE object is usually killed, and sitting at edge of the destination region.
#In revised OpenSimulator the function llSetVehicleType(VEHICLE_TYPE_xxx), where xxx is AIRPLANE, BALLOON, BOAT, CAR or SLED, pre-sets all the applicable VEHICLE parameters to reasonable numbers. If you wish to change any of these pre-set parameters do so after asserting llSetVehicleType(VEHICLE_TYPE_xxx).
#At present it appears that some conditions within an instantiated scripted object are not maintained after a Region restart, and possibly between take and rez. Therefore you should assert llSetVehicleType(VEHICLE_TYPE_xxx) when the driver sits and llSetVehicleType(VEHICLE_TYPE_NONE)when the driver stands, and probably on_rez.
#The advice above also applies to camera controls. Assert llSetCameraxxx() on sit and llClearCameraParams() on stand. (At present there seems to be bugs in the Camera Control system, the camera will go underground!)
#The advice above is also true of Material Type. Land vehicles need the 'wheels' to be PRIM_MATERIAL_GLASS. The script(s) must llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]) in every prim that touches the ground, when the rider sits, for reliable operation. Use a link mesage from the root to daughter prim scripts.
#Use llSetStatus(STATUS_PHYSICS, TRUE) to enable the VEHICLE, usually when the driver sits. Use llSetStatus(STATUS_PHYSICS, FALSE) to disable the VEHICLE, usually when the driver stands.
#It appears that the timer() event freezes while a Vehicle is in motion, so do not rely in Timer() to update things like steering or velocity. See Known Problems for a work-around.

== VEHICLE Scripting Examples ==
Below are some initial (and very similar) Vehicle scripting examples, implementing a sort of go kart, and the second a motorboat. The motorboat script is a derivative work based on the go kart script.

*** Note that these scripts are works in progress and may or may not impact the performance of your region negatively. ***

Car or Go kart script:

<source lang=LSL>
// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 12; //Power used to go forward (1 to 30)
float reverse_power = -6; //Power ued to go reverse (-1 to -30)
float turning_ratio = 2.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer turncount;
string Wheeldir = "WC";
string NewWheeldir = "WC";
string Wheelrot = "S";
string NewWheelrot = "S";
integer scount;
integer Speed;
integer Run;

string sit_message = "Ride"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//car
llSetVehicleType(VEHICLE_TYPE_CAR);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.50);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.50);

}
Init()
{
Sound(0);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llGround(<0,0,0>) + 0.52;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]);
llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
llLoopSound("RUNNING",1);
}
else if(n == 1)
{
llLoopSound("IDLE",1);
}
else
{
llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
NewWheeldir = "WR";
turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
NewWheeldir = "WL";
turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
if(turncount > 0)
{
turncount--;
}
if(turncount == 1)
{
NewWheeldir = "WC";
}
if(Wheeldir != NewWheeldir){
Wheeldir = NewWheeldir;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
}
if(Wheelrot != NewWheelrot){
Wheelrot = NewWheelrot;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
}
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Sound(1);
Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

Motorboat script:

<source lang=LSL>

// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

// modified by Hiro Protagonist for basic aquatic motorcraft
// September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 8; //Power used to go forward (1 to 30)
float reverse_power = -3; //Power ued to go reverse (-1 to -30)
float turning_ratio = 1.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer scount;
integer Speed;
integer Run;

string sit_message = "Man the Helm"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//boat
llSetVehicleType(VEHICLE_TYPE_BOAT);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.250);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.250);

}
Init()
{
Sound(0);
llSetBuoyancy(1);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llWater(<0,0,0>) + 0.22;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_WOOD]);
// llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
// llLoopSound("RUNNING",1);
}
else if(n == 1)
{
// llLoopSound("IDLE",1);
}
else
{
// llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
// llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
// NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
// NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
// NewWheeldir = "WR";
// turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
// NewWheeldir = "WL";
// turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
// if(turncount > 0)
// {
// turncount--;
// }
// if(turncount == 1)
// {
// NewWheeldir = "WC";
// }
// if(Wheeldir != NewWheeldir){
// Wheeldir = NewWheeldir;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
// }
// if(Wheelrot != NewWheelrot){
// Wheelrot = NewWheelrot;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
// }
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
// llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
// Sound(1);
// Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

== Vehicle LSL Functions and Status ==
NOTE! This list applies to the revised OpenSimulator, not the released
OpenSimulator.

Key: Y = Yes; N = No; F = Framework present but commented out; N/A = Has not been checked (much) yet

=== KINEMATIC ===
Object must not be PHYSICAL

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Set by LSL?!!Used by OpenSim C#!!Works?!!Comments
|-
|llSetPos()||Y||Y||Y||Also works on physical objects!
|-
|llSetRot()||Y||Y||Y||Y
|-
|llSetLocalRot()||Y||Y||Y
|-
|llSetScale()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|}

=== DYNAMIC ===
Object must be PHYSICAL and VEHICLE_TYPE_NONE(default) at present, but this must probably change.

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Parameter!!Set by LSL?!!Used by OpenSim C#!!Comments
|-
|llApplyImpulse()||N/A||N/A||N/A||N/A
|-
|llApplyRotationalImpulse()||N/A||N/A||N/A||N/A
|-
|llGroundRepel()||N/A||N/A||N/A||N/A
|-
|llMoveToTarget()||N/A||N/A||N/A||N/A
|-
|llPushObject()||N/A||N/A||N/A||N/A
|-
|llSetBuoyancy()||N/A||N/A||N/A||(do not confuse with VEHICLE_BUOYANCY)
|-
|llSetForce()||N/A||N/A||N/A||N/A
|-
|llSetForceAndTorque()||N/A||N/A||N/A||N/A
|-
|llSetHoverHeight()||N/A||N/A||N/A||(do not confuse with VEHICLE_HOVER_HEIGHT)
|-
|llSetTorque()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|}

=== VEHICLE ===
Object must be PHYSICAL and VEHICLE_TYPE_<other than NONE>
{|class="wikitable sortable"
!Functions!!Set by LSL?!!Used!!Works!!Exceptions
|-
|llSetVehicleType()||Y||Y||Y
|-
|llSetVehicleFlags()||N||N||N||Some flags are set by llSetVehicleType()
|-
|llRemoveVehicleFlags()||N||N||N||
|-
|llSetVehicleFloatParam()||Y||Y||Y||
|-
|llSetVehicleVectorParam()||Y||Y||Y||
|-
|llSetVehicleRotationParam()||Y||Y||Y||
|}

{|class="wikitable sortable"
!Parameters!!Set by LSL?!!Used!!Works!!Exceptions
|-
|VEHICLE_LINEAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_OFFSET||F||N|| ||
|-
|VEHICLE_ANGULAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
||VEHICLE_BANKING_EFFICIENCY||F||N|| ||
|-
|VEHICLE_BANKING_MIX||F||N|| ||
|-
|VEHICLE_BANKING_TIMESCALE||F||N|| ||
|-
|VEHICLE_BUOYANCY||Y||Y||Y||(do not confuse with llSetBuoyancy())
|-
|VEHICLE_HOVER_HEIGHT||Y||Y||Y||(do not confuse with llSetHoverHeight())
|-
|VEHICLE_HOVER_EFFICIENCY||Y||N|| ||
|-
|VEHICLE_HOVER_TIMESCALE||Y||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_REFERENCE_FRAME||F||N|| ||
|-
|VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY||Y||Y||Y||
|-
|VEHICLE_VERTICAL_ATTRACTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_TYPE_NONE||Y||Y||Y||
|-
|VEHICLE_TYPE_BALLOON||Y||Y||Y||
|-
|VEHICLE_TYPE_BOAT||Y||Y||Y||
|-
|VEHICLE_TYPE_CAR||Y||Y||Y||
|-
|VEHICLE_TYPE_SLED||Y||Y||Y||
|-
|VEHICLE_FLAG_NO_DEFLECTION_UP||Y||N|| ||
|-
|VEHICLE_FLAG_LIMIT_ROLL_ONLY||Y||N|| ||
|-
|VEHICLE_FLAG_HOVER_WATER_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_TERRAIN_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_GLOBAL_HEIGHT||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_UP_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_LIMIT_MOTOR_UP||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_STEER||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_BANK||Y||N|| ||
|-
|VEHICLE_FLAG_CAMERA_DECOUPLED||Y||N|| ||
|}
== VEHICLE TYPE Presets ==
VEHICLE_TYPE_SLED:
linearFrictionTimescale <30, 1, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1000
linearMotorDecayTimescale 120
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1000
angularMotorDecayTimescale 120
VhoverHeight 0
VhoverEfficiency 1
VhoverTimescale 10
VehicleBuoyancy 0
linearDeflectionEfficiency 1
linearDeflectionTimescale 1
angularDeflectionEfficiency 1
angularDeflectionTimescale 1000
bankingEfficiency 0
bankingMix 1
bankingTimescale 10
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_CAR:
linearFrictionTimescale <100, 2, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1
angularMotorDecayTimescale 0.8
VhoverHeight 0
VhoverEfficiency 0
VhoverTimescale 1000
VehicleBuoyancy 0
// m_linearDeflectionEfficiency 1
// m_linearDeflectionTimescale 2
// m_angularDeflectionEfficiency 0
angularDeflectionTimescale 10
verticalAttractionEfficiency 1
verticalAttractionTimescale 10
bankingEfficiency -0.2
bankingMix 1
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_BOAT:
linearFrictionTimescale <10, 3, 2>
angularFrictionTimescale <10,10,10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 2
VehicleBuoyancy 1
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 0.5
angularDeflectionTimescale 5
verticalAttractionEfficiency 0.5
verticalAttractionTimescale 5
bankingEfficiency -0.3
bankingMix 0.8
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_TERRAIN_ONLY
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_AIRPLANE:
linearFrictionTimescale <200, 10, 5>
angularFrictionTimescale <20, 20, 20>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 2
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 1000
VehicleBuoyancy 0
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 1
angularDeflectionTimescale 2
verticalAttractionEfficiency 0.9
verticalAttractionTimescale 2
bankingEfficiency 1
bankingMix 0.7f
bankingTimescale 2
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY

VEHICLE_TYPE_BALLOON:
linearFrictionTimescale <5, 5, 5>
angularFrictionTimescale <10, 10, 10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 6
angularMotorDecayTimescale 10
VhoverHeight 5
VhoverEfficiency 0.8
VhoverTimescale 10
VehicleBuoyancy 1
linearDeflectionEfficiency 0
linearDeflectionTimescale 5
angularDeflectionEfficiency 0
angularDeflectionTimescale 5
verticalAttractionEfficiency 1
verticalAttractionTimescale 1000
bankingEfficiency 0
bankingMix 0.7
bankingTimescale 5
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT

Vehicles

2009-09-23T03:47:52Z

Twitch:

== Summary ==
August 2009: Kitto Flora is revising the OdePlugin files in an attempt to provide SL-compatible VEHICLE functionality to OpenSimulator. A couple of test regions have been provided by Bri Hasp, these are Sea-3 and Sea-4 in OSgrid. You may visit there and test vehicles but please clean up after. The regions will frequently be restarted to test revisions. The revised Open Simulator files are being made available as a git branch, check here to see what may or may not work.

== Terminology ==
Here some terms are defined so that when we communicate we are talking about the same things.

==== Vehicle ====

Any object or link-set that moves. It is usually rideable. It may be Physical or not.

==== VEHICLE ====
Any object or link-set that uses LSL VEHICLE functions to achieve mobility. It is set to other than 'VEHICLE_TYPE_NONE'.

==== Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, TRUE). It will fall due to gravity (unless buoyancy is changed) and collide with other prims, avatars and the ground (unless set phantom).

==== Non-Physical ====
Any object or link-set that is llSetStatus(STATUS_PHYSICS, FALSE), or has never has llSetStatus(STATUS_PHYSICS,...) applied. Such objects 'stick in midair' and can interpenetrate other objects.

==== Kinematic ====
Motion system used by Non-Physical objects, applied by such functions as llSetPos() and llSetRot().

==== Dynamic ====
Motion system used by Physical objects, applied by such functions as llSetForce() and llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <...>).

== About This Project ==
The objectives of this project are:
# To provide VEHICLE associated LSL functions within OpenSimulator that are compatible with Second Life functionality. This means trying to get them really close, but as we are trying to emulate complex HAVOK functions using what is available in ODE they may be only close to the SL functions.
# To clean up the OdePlugin files. Over many revisions and add-ons they have become somewhat non-optimal. In particular the 'Move' operation that makes objects move around needs to be very clean and smooth so that the update rate remains high.
# Maintain the existing non-VEHICLE dynamic functions and fix errors where found.

== Vehicle LSL Functions in revised OpenSimulator ==
There are three categories of LSL functions that are used by Vehicles: Kinematic, Dynamic and VEHICLE. These are listed below with information on their current status within the revised OpenSimulator. (Not the general release at this time.)
Kinematic vehicle motion can be used by non-physical objects. VEHICLE motion and the associated functions '''ONLY''' apply to objects that are set to a VEHICLE_TYPE of AIRPLANE, BALLOON, BOAT, CAR or SLED. Dynamic functions '''ONLY''' apply (at this time) to VEHICLE_TYPE_NONE, which is the default condition of an object. (In SL it appears that one can use Dynamic functions on a VEHICLE, but to keep things simple at the start of this project such a combination is ignored.)

== Known Problems ==
# timer() event ceases about 10 seconds after Vehicle moves. Does not restart until many seconds after Vehicle stops. '''Work-around:''' Use llSensor() for a non-existent object at short range and no_sensor() event to re-trigger it. This produces about 1000 events per second. Divide down to produce more reasonable rates.
# llSetBuoyancy() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non-VEHICLE vehicles.
# llSetHoverHeight() is not hooked to physics methods. LSL engine problem. '''Work-around:''' None. Big problem for non VEHICLE vehicles.
# llSetVehicleFlags() and llRemoveVehicleFlags() are not hooked to physics methods, and may cause simulator crash. LSL engine problem. '''Work-around:''' None, but the VEHICLE_TYPE presets are setting necessary flags.
# Prim parameters like Material are not being saved. '''Work-around:''' Set by script on rez or whenever used.
# Script state is not maintained between Take and Rez. '''Work-around:''' on_rez() Reset script and set *everything* again.
# Border Crossing is bad. Vehicle will be killed and Av unseated and left drifting through target region. '''Work-around:''' Quickly double-click on Map to tele-port to old region. Drag vehicle back and reset it.

== VEHICLE Scripting Notes ==
#(Not really scripting , but very important) DO NOT attempt to drive a VEHICLE across the Region boundary. If you do your Av will be orbited. You may be able to recover by Map double-click TP to a nearby Region. The VEHICLE object is usually killed, and sitting at edge of the destination region.
#In revised OpenSimulator the function llSetVehicleType(VEHICLE_TYPE_xxx), where xxx is AIRPLANE, BALLOON, BOAT, CAR or SLED, pre-sets all the applicable VEHICLE parameters to reasonable numbers. If you wish to change any of these pre-set parameters do so after asserting llSetVehicleType(VEHICLE_TYPE_xxx).
#At present it appears that some conditions within an instantiated scripted object are not maintained after a Region restart, and possibly between take and rez. Therefore you should assert llSetVehicleType(VEHICLE_TYPE_xxx) when the driver sits and llSetVehicleType(VEHICLE_TYPE_NONE)when the driver stands, and probably on_rez.
#The advice above also applies to camera controls. Assert llSetCameraxxx() on sit and llClearCameraParams() on stand. (At present there seems to be bugs in the Camera Control system, the camera will go underground!)
#The advice above is also true of Material Type. Land vehicles need the 'wheels' to be PRIM_MATERIAL_GLASS. The script(s) must llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]) in every prim that touches the ground, when the rider sits, for reliable operation. Use a link mesage from the root to daughter prim scripts.
#Use llSetStatus(STATUS_PHYSICS, TRUE) to enable the VEHICLE, usually when the driver sits. Use llSetStatus(STATUS_PHYSICS, FALSE) to disable the VEHICLE, usually when the driver stands.
#It appears that the timer() event freezes while a Vehicle is in motion, so do not rely in Timer() to update things like steering or velocity. See Known Problems for a work-around.

== VEHICLE Scripting Examples ==
# Below are some initial (and very similar) Vehicle scripting examples, implementing a sort of go kart, and the second a motorboat. The motorboat script is a derivative work based on the go kart script.

Car or Go kart script:

<source lang=LSL>
// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 12; //Power used to go forward (1 to 30)
float reverse_power = -6; //Power ued to go reverse (-1 to -30)
float turning_ratio = 2.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer turncount;
string Wheeldir = "WC";
string NewWheeldir = "WC";
string Wheelrot = "S";
string NewWheelrot = "S";
integer scount;
integer Speed;
integer Run;

string sit_message = "Ride"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//car
llSetVehicleType(VEHICLE_TYPE_CAR);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.50);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.50);

}
Init()
{
Sound(0);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llGround(<0,0,0>) + 0.52;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_GLASS]);
llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
llLoopSound("RUNNING",1);
}
else if(n == 1)
{
llLoopSound("IDLE",1);
}
else
{
llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
NewWheeldir = "WR";
turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
NewWheeldir = "WL";
turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
if(turncount > 0)
{
turncount--;
}
if(turncount == 1)
{
NewWheeldir = "WC";
}
if(Wheeldir != NewWheeldir){
Wheeldir = NewWheeldir;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
}
if(Wheelrot != NewWheelrot){
Wheelrot = NewWheelrot;
llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
}
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Sound(1);
Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

Motorboat script:

<source lang=LSL>

// Very simple vehicle script, mod for OpenSim & ODE & VEHICLE code
// By Kitto Flora September 2009

// modified by Hiro Protagonist for basic aquatic motorcraft
// September 2009

integer Private = 1; // Change to 1 to prevent others riding.

vector Sitpos = <0.35,0,0.35>;
vector SitrotV = <0,-20,0>;
rotation Sitrot;
integer tt;
key oldagent;
key agent;
float forward_power = 8; //Power used to go forward (1 to 30)
float reverse_power = -3; //Power ued to go reverse (-1 to -30)
float turning_ratio = 1.0; //How sharply the vehicle turns. Less is more sharply. (.1 to 10)
integer scount;
integer Speed;
integer Run;

string sit_message = "Man the Helm"; //Sit message
string not_owner_message = "You are not the owner of this vehicle, buy a copy for 0$ and have your own to test in this sim. It will not work in other Open Sim Regions."; //Not owner message

setVehicle()
{
//boat
llSetVehicleType(VEHICLE_TYPE_BOAT);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY, 0.2);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_EFFICIENCY, 0.80);
llSetVehicleFloatParam(VEHICLE_ANGULAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_DEFLECTION_TIMESCALE, 0.10);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_TIMESCALE, 1.0);
llSetVehicleFloatParam(VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_TIMESCALE, 0.1);
llSetVehicleFloatParam(VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE, 0.1);
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_ANGULAR_FRICTION_TIMESCALE, <0.1, 0.1, 0.1>);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY, 0.250);
llSetVehicleFloatParam(VEHICLE_VERTICAL_ATTRACTION_TIMESCALE, 0.250);

}
Init()
{
Sound(0);
llSetBuoyancy(1);
llSetStatus(STATUS_PHYSICS, FALSE);
vector here = llGetPos();
float h = llWater(<0,0,0>) + 0.22;
vector rotv = llRot2Euler(llGetRot());
rotation rot = llEuler2Rot(<0,0,rotv.z>);
llSetPos(<here.x, here.y,h>);
llSetRot(rot);
Sitrot = llEuler2Rot(DEG_TO_RAD * SitrotV);
llSetVehicleType(VEHICLE_TYPE_NONE);
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY); // wheels stop
llMessageLinked(LINK_ALL_OTHERS, 0, "WC", NULL_KEY); // wheels straight
Run = 0;
}

SetMaterial()
{
llSetPrimitiveParams([PRIM_MATERIAL, PRIM_MATERIAL_WOOD]);
// llMessageLinked(LINK_ALL_OTHERS, 0, "SetMat", NULL_KEY); // Tell daughter pims on ground to be glass
}

Sound(integer n)
{
integer oldn;
if(n != oldn)
{
oldn = n;
if(n == 2)
{
// llLoopSound("RUNNING",1);
}
else if(n == 1)
{
// llLoopSound("IDLE",1);
}
else
{
// llStopSound();
}
}
}

default
{
state_entry()
{
Init();
llSetSitText(sit_message);
// forward-back,left-right,updown
llSitTarget(Sitpos, Sitrot);
// llStopSound();
}

on_rez(integer rn){
llResetScript();
}

changed(integer change)
{
if ((change & CHANGED_LINK) == CHANGED_LINK)
{
agent = llAvatarOnSitTarget();
if (agent != NULL_KEY)
{
if( (agent != llGetOwner()) && (Private == 1) )
{
llSay(0, not_owner_message);
llUnSit(agent);
// not functional llPushObject(agent, <0,0,50>, ZERO_VECTOR, FALSE);
}
else
{
//llTriggerSound("car_start",1);
// llMessageLinked(LINK_ALL_CHILDREN , 0, "WHEEL_DRIVING", NULL_KEY);
oldagent = agent;
setVehicle();
SetMaterial();
llSleep(.4);
llSetStatus(STATUS_PHYSICS, TRUE);
llSleep(.1);
Run = 1;
//Sensor is to make a crude Timer as TimerEvent fails on vehicles
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);

llRequestPermissions(agent, PERMISSION_TRIGGER_ANIMATION | PERMISSION_TAKE_CONTROLS);
Sound(1);
}
}
else
{
Init();
llSleep(.4);
llReleaseControls();
llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
Run = 0;
llStopSound();
}
}
}

touch_start(integer tn){
}

run_time_permissions(integer perm)
{
if (perm)
{
llTakeControls(CONTROL_FWD | CONTROL_BACK | CONTROL_DOWN | CONTROL_UP | CONTROL_RIGHT |
CONTROL_LEFT | CONTROL_ROT_RIGHT | CONTROL_ROT_LEFT, TRUE, FALSE);
}
}

control(key id, integer level, integer edge)
{
integer reverse=1;
vector angular_motor;

//get current speed
vector vel = llGetVel();
float speed = llVecMag(vel);

//car controls
if(level & CONTROL_FWD)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <forward_power,0,0>);
reverse=1;
// NewWheelrot = "F";
Speed = 20;
}
if(level & CONTROL_BACK)
{
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <10.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <reverse_power,0,0>);
reverse = -1;
// NewWheelrot = "R";
Speed = 10;
}

if(level & (CONTROL_RIGHT|CONTROL_ROT_RIGHT))
{
angular_motor.z -= speed / turning_ratio * reverse;
// NewWheeldir = "WR";
// turncount = 10;
}

if(level & (CONTROL_LEFT|CONTROL_ROT_LEFT))
{
angular_motor.z += speed / turning_ratio * reverse;
// NewWheeldir = "WL";
// turncount = 10;
}

llSetVehicleVectorParam(VEHICLE_ANGULAR_MOTOR_DIRECTION, angular_motor);
// if(turncount > 0)
// {
// turncount--;
// }
// if(turncount == 1)
// {
// NewWheeldir = "WC";
// }
// if(Wheeldir != NewWheeldir){
// Wheeldir = NewWheeldir;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheeldir, NULL_KEY);
// }
// if(Wheelrot != NewWheelrot){
// Wheelrot = NewWheelrot;
// llMessageLinked(LINK_ALL_OTHERS, 0, Wheelrot, NULL_KEY);
// }
} //end control

//Sensor is to make a crude Timer as TimerEvent fails on vehicles
no_sensor()
{
if(scount < 1000)
{
scount++;
}
else
{
scount = 0;
// This happens about once per second
if(Speed > 0) Speed--;

if(Speed > 2) Sound(2);

if(Speed == 1) {
llSetVehicleVectorParam(VEHICLE_LINEAR_FRICTION_TIMESCALE, <1.0, 2.0, 1000.0>);
llSetVehicleVectorParam(VEHICLE_LINEAR_MOTOR_DIRECTION, <0,0,0>);
// llMessageLinked(LINK_ALL_OTHERS, 0, "S", NULL_KEY);
// Sound(1);
// Wheelrot = "S";
}

}

if(Run == 1)
llSensor("Non-Entity",NULL_KEY,PASSIVE,1.0, PI_BY_TWO);
}

} //end default

</source>

== Vehicle LSL Functions and Status ==
NOTE! This list applies to the revised OpenSimulator, not the released
OpenSimulator.

Key: Y = Yes; N = No; F = Framework present but commented out; N/A = Has not been checked (much) yet

=== KINEMATIC ===
Object must not be PHYSICAL

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Set by LSL?!!Used by OpenSim C#!!Works?!!Comments
|-
|llSetPos()||Y||Y||Y||Also works on physical objects!
|-
|llSetRot()||Y||Y||Y||Y
|-
|llSetLocalRot()||Y||Y||Y
|-
|llSetScale()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|}

=== DYNAMIC ===
Object must be PHYSICAL and VEHICLE_TYPE_NONE(default) at present, but this must probably change.

(Some work, some do not.)
{|class="wikitable sortable"
!Function!!Parameter!!Set by LSL?!!Used by OpenSim C#!!Comments
|-
|llApplyImpulse()||N/A||N/A||N/A||N/A
|-
|llApplyRotationalImpulse()||N/A||N/A||N/A||N/A
|-
|llGroundRepel()||N/A||N/A||N/A||N/A
|-
|llMoveToTarget()||N/A||N/A||N/A||N/A
|-
|llPushObject()||N/A||N/A||N/A||N/A
|-
|llSetBuoyancy()||N/A||N/A||N/A||(do not confuse with VEHICLE_BUOYANCY)
|-
|llSetForce()||N/A||N/A||N/A||N/A
|-
|llSetForceAndTorque()||N/A||N/A||N/A||N/A
|-
|llSetHoverHeight()||N/A||N/A||N/A||(do not confuse with VEHICLE_HOVER_HEIGHT)
|-
|llSetTorque()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|-
|llLookAt()||N/A||N/A||N/A||N/A
|-
|llRotLookAt()||N/A||N/A||N/A||N/A
|-
|llSetPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llSetLinkPrimitiveParams()||N/A||N/A||N/A||N/A
|-
|llTargetOmega()||N/A||N/A||N/A||N/A
|}

=== VEHICLE ===
Object must be PHYSICAL and VEHICLE_TYPE_<other than NONE>
{|class="wikitable sortable"
!Functions!!Set by LSL?!!Used!!Works!!Exceptions
|-
|llSetVehicleType()||Y||Y||Y
|-
|llSetVehicleFlags()||N||N||N||Some flags are set by llSetVehicleType()
|-
|llRemoveVehicleFlags()||N||N||N||
|-
|llSetVehicleFloatParam()||Y||Y||Y||
|-
|llSetVehicleVectorParam()||Y||Y||Y||
|-
|llSetVehicleRotationParam()||Y||Y||Y||
|}

{|class="wikitable sortable"
!Parameters!!Set by LSL?!!Used!!Works!!Exceptions
|-
|VEHICLE_LINEAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_LINEAR_MOTOR_OFFSET||F||N|| ||
|-
|VEHICLE_ANGULAR_MOTOR_DIRECTION||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_MOTOR_DECAY_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_ANGULAR_FRICTION_TIMESCALE||Y||Y||Y||
|-
||VEHICLE_BANKING_EFFICIENCY||F||N|| ||
|-
|VEHICLE_BANKING_MIX||F||N|| ||
|-
|VEHICLE_BANKING_TIMESCALE||F||N|| ||
|-
|VEHICLE_BUOYANCY||Y||Y||Y||(do not confuse with llSetBuoyancy())
|-
|VEHICLE_HOVER_HEIGHT||Y||Y||Y||(do not confuse with llSetHoverHeight())
|-
|VEHICLE_HOVER_EFFICIENCY||Y||N|| ||
|-
|VEHICLE_HOVER_TIMESCALE||Y||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_LINEAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_EFFICIENCY||F||N|| ||
|-
|VEHICLE_ANGULAR_DEFLECTION_TIMESCALE||F||N|| ||
|-
|VEHICLE_REFERENCE_FRAME||F||N|| ||
|-
|VEHICLE_VERTICAL_ATTRACTION_EFFICIENCY||Y||Y||Y||
|-
|VEHICLE_VERTICAL_ATTRACTION_TIMESCALE||Y||Y||Y||
|-
|VEHICLE_TYPE_NONE||Y||Y||Y||
|-
|VEHICLE_TYPE_BALLOON||Y||Y||Y||
|-
|VEHICLE_TYPE_BOAT||Y||Y||Y||
|-
|VEHICLE_TYPE_CAR||Y||Y||Y||
|-
|VEHICLE_TYPE_SLED||Y||Y||Y||
|-
|VEHICLE_FLAG_NO_DEFLECTION_UP||Y||N|| ||
|-
|VEHICLE_FLAG_LIMIT_ROLL_ONLY||Y||N|| ||
|-
|VEHICLE_FLAG_HOVER_WATER_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_TERRAIN_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_GLOBAL_HEIGHT||Y||Y|| ||
|-
|VEHICLE_FLAG_HOVER_UP_ONLY||Y||Y|| ||
|-
|VEHICLE_FLAG_LIMIT_MOTOR_UP||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_STEER||Y||N|| ||
|-
|VEHICLE_FLAG_MOUSELOOK_BANK||Y||N|| ||
|-
|VEHICLE_FLAG_CAMERA_DECOUPLED||Y||N|| ||
|}
== VEHICLE TYPE Presets ==
VEHICLE_TYPE_SLED:
linearFrictionTimescale <30, 1, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1000
linearMotorDecayTimescale 120
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1000
angularMotorDecayTimescale 120
VhoverHeight 0
VhoverEfficiency 1
VhoverTimescale 10
VehicleBuoyancy 0
linearDeflectionEfficiency 1
linearDeflectionTimescale 1
angularDeflectionEfficiency 1
angularDeflectionTimescale 1000
bankingEfficiency 0
bankingMix 1
bankingTimescale 10
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_CAR:
linearFrictionTimescale <100, 2, 1000>
angularFrictionTimescale <1000, 1000, 1000>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 1
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 1
angularMotorDecayTimescale 0.8
VhoverHeight 0
VhoverEfficiency 0
VhoverTimescale 1000
VehicleBuoyancy 0
// m_linearDeflectionEfficiency 1
// m_linearDeflectionTimescale 2
// m_angularDeflectionEfficiency 0
angularDeflectionTimescale 10
verticalAttractionEfficiency 1
verticalAttractionTimescale 10
bankingEfficiency -0.2
bankingMix 1
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
flags TRUE:
NO_DEFLECTION_UP
LIMIT_ROLL_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_BOAT:
linearFrictionTimescale <10, 3, 2>
angularFrictionTimescale <10,10,10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 2
VehicleBuoyancy 1
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 0.5
angularDeflectionTimescale 5
verticalAttractionEfficiency 0.5
verticalAttractionTimescale 5
bankingEfficiency -0.3
bankingMix 0.8
bankingTimescale 1
referenceFrame ZERO_ROTATION
flags FALSE:
HOVER_TERRAIN_ONLY
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
flags TRUE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
LIMIT_MOTOR_UP

VEHICLE_TYPE_AIRPLANE:
linearFrictionTimescale <200, 10, 5>
angularFrictionTimescale <20, 20, 20>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 2
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 4
angularMotorDecayTimescale 4
VhoverHeight 0
VhoverEfficiency 0.5
VhoverTimescale 1000
VehicleBuoyancy 0
linearDeflectionEfficiency 0.5
linearDeflectionTimescale 3
angularDeflectionEfficiency 1
angularDeflectionTimescale 2
verticalAttractionEfficiency 0.9
verticalAttractionTimescale 2
bankingEfficiency 1
bankingMix 0.7f
bankingTimescale 2
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_GLOBAL_HEIGHT
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY

VEHICLE_TYPE_BALLOON:
linearFrictionTimescale <5, 5, 5>
angularFrictionTimescale <10, 10, 10>
linearMotorDirection <0, 0, 0>
linearMotorTimescale 5
linearMotorDecayTimescale 60
angularMotorDirection <0, 0, 0>
angularMotorTimescale 6
angularMotorDecayTimescale 10
VhoverHeight 5
VhoverEfficiency 0.8
VhoverTimescale 10
VehicleBuoyancy 1
linearDeflectionEfficiency 0
linearDeflectionTimescale 5
angularDeflectionEfficiency 0
angularDeflectionTimescale 5
verticalAttractionEfficiency 1
verticalAttractionTimescale 1000
bankingEfficiency 0
bankingMix 0.7
bankingTimescale 5
referenceFrame ZERO_ROTATION
flags FALSE:
NO_DEFLECTION_UP
HOVER_WATER_ONLY
HOVER_TERRAIN_ONLY
HOVER_UP_ONLY
LIMIT_MOTOR_UP
flags TRUE:
LIMIT_ROLL_ONLY
HOVER_GLOBAL_HEIGHT

Vehicles

2009-09-04T02:25:01Z

Twitch: /* VEHICLE */

Vehicles

2009-09-04T01:01:55Z

Twitch: /* DYNAMIC */

Vehicles

2009-09-04T00:55:16Z

Twitch: /* DYNAMIC */

Vehicles

2009-09-04T00:54:20Z

Twitch: /* DYNAMIC */

Vehicles

2009-09-04T00:53:22Z

Twitch: /* KINEMATIC */

Vehicles

2009-09-04T00:40:42Z

Twitch: /* KINEMATIC */

Vehicles

2009-09-03T23:58:04Z

Twitch: /* Vehicle LSL Functions in revised OpenSimulator */

Installing and Running Hypergrid

2009-08-24T04:32:00Z

Twitch:

__NOTOC__
{{Template:Quicklinks}}
 

=== Installing ===

# Checkout OpenSim, prebuild and build as normal.
#
#* If you're running your opensim in grid mode with the UGAIM servers on other machines, you're done. If you're running in standalone and you want it to be network-able, or if you have your grid on loopback (127.0.0.1) change all the [Network] server addresses to <nowiki>"http://<external_host_name>:<http_port>"</nowiki>. See below.
# Run opensim like this: <nowiki>[mono] OpenSim.exe -hypergrid=true</nowiki>. To make sure the hypergrid is running type this on your console: '''link-region'''. If you don't hear anything back, the hypergrid is not properly installed.
 
''The Following command line switch for mono has been deprecated and should probably be removed from this page in the near future. - Hiro P./daTwitch'' 
'''[mono] OpenSim.exe -hypergrid=true'''
 
Here is an example of the Network settings for a standalone:

[Network]
http_listener_port = 9300
remoting_listener_port = 9895 (legacy - not used any more)

grid_server_url = http://example.com:9300
grid_send_key = null
grid_recv_key = null

user_server_url = http://example.com:9300
user_send_key = null
user_recv_key = null

asset_server_url = http://example.com:9300
inventory_server_url = http://example.com:9300
messaging_server_url = http://example.com:9300

Here is an example of the Network settings for a grided opensim:

[Network]
http_listener_port = 9300
remoting_listener_port = 9895 (legacy - not used any more)

grid_server_url = http://example.com:8001
grid_send_key = null
grid_recv_key = null

user_server_url = http://example.com:8002
user_send_key = null
user_recv_key = null

asset_server_url = http://example.com:8003
inventory_server_url = http://example.com:8004
; Port 8005 reserved
messaging_server_url = http://example.com:8006

It is also recommended to have '''both''' of:

WorldMapModule = "WorldMap"
WorldMapModule = "HGWorldMapModule"

in your OpenSim.ini . HGWorldMapModule will, after teleporting to another grid, clean up tiles in your map left over from the grid on which you were previously.

'''Important Note'''

Make sure you have a 'home' set. If your home region doesn't exist, the hyperlink TPs may not work. To set your home, go to one of your local regions and "Set Home" from the viewer.

=== Linking regions ===

==== Method 1 ====

On the console, type for example:

link-region <Xloc> <Yloc> osl2.nac.uci.edu:9006

* Use Xloc and Yloc that make sense to your world, i.e. close to your regions, but not adjacent.
* replace osl2.nac.uci.edu and 9006 with the domain name / ip address and the http_listener_port of the simulator where the region is running you want to link to

You can link to a specific region within an instance, by using the name of the region at the end, for example:

link-region 997 997 osl2.nac.uci.edu:9006:UCI Welcome

==== Method 2 ====

There is also some initial support for reading the links from a xml file.

Use the console command: link-region <URI> [<excludeList>]

The uri can be either the path of a local xml file or a xml document on a http server.

The format of the xml file is:

<Nini>
<Section Name="Region1"> 
<Key Name="xloc" Value="1002"/>
<Key Name="yloc" Value="1006" />
<Key Name="externalPort" Value="9006" />
<Key Name="externalHostName" Value="osl2.nac.uci.edu" />
<Key Name="localName" Value="OSGrid-Gateway" />
<Key Name="real-xloc" Value="10222"/> //optional field that gives the region's real location on its home grid
<Key Name="real-yloc" Value="10265" /> //optional field that gives the region's real location on its home grid
</Section>
<Section Name="Region2">
...
</Section>
...
</Nini>

[Note] The section names can be anything you want, but they all should be different and have no spaces in the name.

ExcludeList:

The exclude list is a single string paramater with the format: excludeList:<SectionName>[;<SectionName>]

This means that while reading from the xml file any sections that are listed in the excludeList will be ignored and no HyperGrid link created for them.

This could allow, link lists to be created on a webserver that everyone could add their own regions to, and then they just make sure they add their own section name(s) to the exclude list on their own region(s).

So for example, someone might create a editable online list for the up coming OpenSimulator's 2nd birthday. Which might look something like:

<Nini>
<Section Name="OSGrid-Party"> 
<Key Name="xloc" Value="1002"/>
<Key Name="yloc" Value="1006" />
<Key Name="externalPort" Value="9006" />
<Key Name="externalHostName" Value="osl2.nac.uci.edu" />
<Key Name="localName" Value="OSGrid-Gateway" />
</Section>
<Section Name="UCIGrid-Party">
...
</Section>
</Nini>

I could then add my own region to the list with the section name "MW-Party". Then when I startup that region that I want to be part of this hypergrid, I use the command: "link-region <URI of xml file> excludeList:MW-Party"

This is so that my region doesn't try to create a hyper link to itself.

==== Method 3 (dynamic) ====

Starting in r8193, if you're in an HG-enabled region, you'll be able to dynamically link sims, and TP there, in any one of these ways (and probably more). All you need to know is the target address, e.g. from the list below.

1) Type for example secondlife://ucigrid04.nacs.uci.edu:9007/ in the
chat box, pull up the chat history and click on that link

2) Pull up the map and search for things like
ucigrid04.nacs.uci.edu:9007

3) Using the embedded browser visit pages that have links like
secondlife://ucigrid04.nacs.uci.edu:9007/ (there's one up at
http://www.ics.uci.edu/~lopes/hypergrid/test.html)

Again, you can link to a specific region within an instance by adding the name of that region at the end, like this:
secondlife://ucigrid04.nacs.uci.edu:9007:Gateway 7000/

'''Important Note'''

Due to a viewer [https://jira.secondlife.com/browse/SVC-2941 bug], you can only TP between regions that are no more than 4096 cells apart in any dimension. What this means in practice is that if you want to link to OSGrid, you must have your own regions reachable from the (10,000; 10,000) point on the map, which is where OSGrid is centered. Place your regions somewhere in the 8,000s or the 12,000s.

=== Unlinking regions ===

On the console, type for example:

unlink-region osl2.nac.uci.edu:9006

or

unlink-region <local region name>

[[Category:Hypergrid]]

PCampBot

2009-01-22T19:06:24Z

Twitch: From the README.txt included with the source

This is the PhysicsCamperbot libslBot tester.

This is designed to be run in standalone mode with authorize accounts
turned off as a way to stress test the simulator. It creates <N>
clients that log in, randomly jump/walk around, and say excuses from
the BOFH.

*** WARNING ***
Using this bot on a public grid could get you banned permanently, so
just say No! to griefing!

----- Setup -----
Linux: To build, in the main opensim directory, run:
./runprebuild.sh
nant

Windows: Run the prebuild.bat in the main opensim directory and then
open the created solution and compile it.

pCampBot.exe will end up in the regular opensim/bin folder

----- Running the bot -----

windows: pCampBot.exe -botcount <N> -loginuri <URI>
*nix: mono pCampBot.exe -botcount <N> -loginuri <URI>

The names it produces are random by default, however, you can specify
either a firstname or a lastname in the command line also.

ex: pCampBot.exe -botcount <N> -loginuri <URI> -lastname <lastname>

If you specify both a firstname *and* a lastname, you'll likely run
into trouble unless you're only running a single bot. In that case,
there's also a password option.

pCampBot.exe -botcount 1 -loginuri http://somegrid.com:8002 -firstname SomeDude -lastname SomeDude -password GobbleDeGook

----- Commands -----

The bot has console commands:
help - lists the console commands and what they do
shutdown - gracefully shuts down the bots
quit - forcefully shuts things down leaving stuff unclean
addbots N - adds N number of random bots. (replace 'N' with a number)

From the README.txt included with the source

User Documentation

2009-01-22T19:03:22Z

Twitch: /* Cross-platform */

{{Template:Quicklinks}}

==Initial Setup==
* [[Download]] - Download instructions
* [[Dependencies]] - The other packages you need to install that OpenSim relies upon
* [[Build Instructions]] - How to build and compile OpenSim from Source
* [[Configuration]] - How to configure your OpenSim server up and running
* [[Upgrading]] - How to upgrade your OpenSim version so that you can use your existing data
* [[Connecting]] - How to connect a compatible viewer to OpenSim
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[Tips]] - Useful tips from users like you
* [[FAQ]] - Frequently Asked Questions

==Administrator Guide==
* [[Server Commands]] - Commands to control OpenSim
* [[OpenSim Database support]] - Dealing with databases
* [[Logging]] - Logging in OpenSim
* [[Custom Libraries]] - Describes how to add custom content to your OpenSim server
* [[Automating Tasks]] - How to make administrating a walk in the park
* [[Network Settings]] - NAT, Ports, Services and more...
* [[Management]] - All about being an effective administrator/moderator
* [[Performance]] - How to tweak OpenSim's performance
* [[Console-less OpenSim]] - How to run OpenSim without console

==Core Facilities==
* [[OpenSim Archives]] - Loading and saving whole region archives with OpenSim
* [[IRCBridgeModule]] - A core OpenSim module for integrating IRC with a simulator.
* [[Hypergrid]] - Information about how to configure the experimental hypergrid architecture
* [[GridInfo]] - how to provide information about your grid to smart clients

==RealXtend==
* [[ModRex]] - How to setup the RealXtend server module
* [[RealXtend Viewer Linux]] - This tutorial describes how to use the RealXtend viewer on Linux, using wine

==Scripting==
* [[Scripting Documentation]] - Everything you need to know about OpenSim scripting
* [[Scripting Library]] - A list of example scripts

==Tutorials==
===Platform specific===
* [[Linux Gridserver, the ubuntu way]] the quick and dirty way to install opensim under ubuntu (Linux)
* [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSim viewer (Linux)
* [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux)
* [http://sunredbeach.com/dokuwiki/doku.php?id=opensim:minimal-server Installing an openSUSE 11.1 Minimal server setup for an OpenSim server] - Quick and Dirty setup on an openSUSE 11.1 server

* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows)

===Cross-platform===
* [[OSGrid Region Registration]] - Describes how to link your region into OS-Grid
* [[Hints & Tricks]] - A page for Hints and Tricks
* [[Getting Started with Region Modules]] - The Hello World of OpenSim application development
* [[Building a bot]] - Getting started with bot design using libomv from the client side.
* [[pCampBot]] - Physical OpenSim bots
* [[Using L3DT]] - How to create custom terrains
* [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains
* [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)]

==Gforge Projects==
* [[OpenSimSearch]] - Search for your OpenSim
* [[Linux Gridserver]] - Linux Gridserver using the Moo tool
* [[ServerStats]] - RRD/Proc serverstats using the OpenSim module for Berlios Serverstats (Linux)

==Contribution Policy==
* [[User_Wiki_Conventions|User Wiki Conventions]] - Read this carefully, before adding content to the wiki
[[Category:Users]]
<cleanpage title=hide cats=hide />

User Documentation

2009-01-22T19:02:44Z

Twitch: /* Platform specific */

{{Template:Quicklinks}}

==Initial Setup==
* [[Download]] - Download instructions
* [[Dependencies]] - The other packages you need to install that OpenSim relies upon
* [[Build Instructions]] - How to build and compile OpenSim from Source
* [[Configuration]] - How to configure your OpenSim server up and running
* [[Upgrading]] - How to upgrade your OpenSim version so that you can use your existing data
* [[Connecting]] - How to connect a compatible viewer to OpenSim
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[Tips]] - Useful tips from users like you
* [[FAQ]] - Frequently Asked Questions

==Administrator Guide==
* [[Server Commands]] - Commands to control OpenSim
* [[OpenSim Database support]] - Dealing with databases
* [[Logging]] - Logging in OpenSim
* [[Custom Libraries]] - Describes how to add custom content to your OpenSim server
* [[Automating Tasks]] - How to make administrating a walk in the park
* [[Network Settings]] - NAT, Ports, Services and more...
* [[Management]] - All about being an effective administrator/moderator
* [[Performance]] - How to tweak OpenSim's performance
* [[Console-less OpenSim]] - How to run OpenSim without console

==Core Facilities==
* [[OpenSim Archives]] - Loading and saving whole region archives with OpenSim
* [[IRCBridgeModule]] - A core OpenSim module for integrating IRC with a simulator.
* [[Hypergrid]] - Information about how to configure the experimental hypergrid architecture
* [[GridInfo]] - how to provide information about your grid to smart clients

==RealXtend==
* [[ModRex]] - How to setup the RealXtend server module
* [[RealXtend Viewer Linux]] - This tutorial describes how to use the RealXtend viewer on Linux, using wine

==Scripting==
* [[Scripting Documentation]] - Everything you need to know about OpenSim scripting
* [[Scripting Library]] - A list of example scripts

==Tutorials==
===Platform specific===
* [[Linux Gridserver, the ubuntu way]] the quick and dirty way to install opensim under ubuntu (Linux)
* [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSim viewer (Linux)
* [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux)
* [http://sunredbeach.com/dokuwiki/doku.php?id=opensim:minimal-server Installing an openSUSE 11.1 Minimal server setup for an OpenSim server] - Quick and Dirty setup on an openSUSE 11.1 server

* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows)

===Cross-platform===
* [[OSGrid Region Registration]] - Describes how to link your region into OS-Grid
* [[Hints & Tricks]] - A page for Hints and Tricks
* [[Getting Started with Region Modules]] - The Hello World of OpenSim application development
* [[Building a bot]] - Getting started with bot design using libomv from the client side.
* [[Using L3DT]] - How to create custom terrains
* [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains
* [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)]

==Gforge Projects==
* [[OpenSimSearch]] - Search for your OpenSim
* [[Linux Gridserver]] - Linux Gridserver using the Moo tool
* [[ServerStats]] - RRD/Proc serverstats using the OpenSim module for Berlios Serverstats (Linux)

==Contribution Policy==
* [[User_Wiki_Conventions|User Wiki Conventions]] - Read this carefully, before adding content to the wiki
[[Category:Users]]
<cleanpage title=hide cats=hide />

User Documentation

2009-01-22T19:02:22Z

Twitch: /* Platform specific */

{{Template:Quicklinks}}

==Initial Setup==
* [[Download]] - Download instructions
* [[Dependencies]] - The other packages you need to install that OpenSim relies upon
* [[Build Instructions]] - How to build and compile OpenSim from Source
* [[Configuration]] - How to configure your OpenSim server up and running
* [[Upgrading]] - How to upgrade your OpenSim version so that you can use your existing data
* [[Connecting]] - How to connect a compatible viewer to OpenSim
* [[Troubleshooting]] - How to trouble shoot your OpenSim installation.
* [[Tips]] - Useful tips from users like you
* [[FAQ]] - Frequently Asked Questions

==Administrator Guide==
* [[Server Commands]] - Commands to control OpenSim
* [[OpenSim Database support]] - Dealing with databases
* [[Logging]] - Logging in OpenSim
* [[Custom Libraries]] - Describes how to add custom content to your OpenSim server
* [[Automating Tasks]] - How to make administrating a walk in the park
* [[Network Settings]] - NAT, Ports, Services and more...
* [[Management]] - All about being an effective administrator/moderator
* [[Performance]] - How to tweak OpenSim's performance
* [[Console-less OpenSim]] - How to run OpenSim without console

==Core Facilities==
* [[OpenSim Archives]] - Loading and saving whole region archives with OpenSim
* [[IRCBridgeModule]] - A core OpenSim module for integrating IRC with a simulator.
* [[Hypergrid]] - Information about how to configure the experimental hypergrid architecture
* [[GridInfo]] - how to provide information about your grid to smart clients

==RealXtend==
* [[ModRex]] - How to setup the RealXtend server module
* [[RealXtend Viewer Linux]] - This tutorial describes how to use the RealXtend viewer on Linux, using wine

==Scripting==
* [[Scripting Documentation]] - Everything you need to know about OpenSim scripting
* [[Scripting Library]] - A list of example scripts

==Tutorials==
===Platform specific===
* [[Linux Gridserver, the ubuntu way]] the quick and dirty way to install opensim under ubuntu (Linux)
* [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSim viewer (Linux)
* [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux)
* [http://sunredbeach.com/dokuwiki/doku.php?id=opensim:minimal-server Installing an openSUSE 11.1 Minimal server setup for an OpenSim server] - Quick and Dirty setup on an openSUSE 11.1 server

* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows)
* [[pCampBot]] - Physical OpenSim bots

===Cross-platform===
* [[OSGrid Region Registration]] - Describes how to link your region into OS-Grid
* [[Hints & Tricks]] - A page for Hints and Tricks
* [[Getting Started with Region Modules]] - The Hello World of OpenSim application development
* [[Building a bot]] - Getting started with bot design using libomv from the client side.
* [[Using L3DT]] - How to create custom terrains
* [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains
* [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)]

==Gforge Projects==
* [[OpenSimSearch]] - Search for your OpenSim
* [[Linux Gridserver]] - Linux Gridserver using the Moo tool
* [[ServerStats]] - RRD/Proc serverstats using the OpenSim module for Berlios Serverstats (Linux)

==Contribution Policy==
* [[User_Wiki_Conventions|User Wiki Conventions]] - Read this carefully, before adding content to the wiki
[[Category:Users]]
<cleanpage title=hide cats=hide />

Getting Started with Region Modules

2008-12-23T23:15:57Z

Twitch: /* Hello World */

== Hello World ==

This brief tutorial is intended to get people started with developing applications with/for opensim using [[IRegionModule|region modules]] and the [http://docs.opensimulator.org/namespaceOpenSim.html opensim API]. This approach to developing virtual world applications, unique to OpenSim, is a powerful alternative to the well-known inworld scripting approach.
The very simple module available here writes "HELLO" with prims on every region of your opensim instance, and makes them move every 2 seconds or so. Please note:

* The opensim API is rapidly changing. The code available in this example has been written and tested for opensim release 0.6.0, which corresponds to SVN 7176. The example has also been tested for a more recent stable version, SVN 7320. You are encouraged to use 7176, if possible.
* You are also encouraged to try this code on the default standalone region first before running on a grid.
* The resulting dll will run both in Windows and Linux, but the building environment is assumed to be VC# on Windows. Users of other operating systems will be able to follow, though.

To get started:

# Download and install opensim (preferably 7176), and build it as normal. Run it once, so you create a default region and a default user. Then shut it down.
# Get this zip file: http://www.ics.uci.edu/~lopes/opensim/HelloWorld-current.zip. Unzip it somewhere.
# Before you go changing the code of the application, see its effect inworld by doing this:
#* Grab HelloWorld/bin/Release/HelloWorld.dll and dump it in opensim/bin
#* Start opensim as normal, and login to it.

You should see the word HELLO spelled out in prims, and moving every so often.

[[image:Hello 001.jpg|220px|left|thumb|Hello]]

Are you ready to explore the code now?

Hold on. Before we do that, let me give you the 30-second introduction to Visual C#. Visual C# is similar to Eclipse, if you ever used that. When it builds, it places the resulting dll or exe in whatever folder you tell it to (right-click on the project->properties). By default it places them in bin/Release. When you compile it with debugging, that goes into bin/Debug. In spirit, the dll is equivalent to a jar file. That's what you want to produce and pass around. The PDB file can be ignored, unless you want to debug. The HelloWorld example uses the defaults of VC#, so every time you build it without debugging, the dll is placed under HelloWorld/bin/Release. To build without debugging information, simply right-click on the solution in the Solution Explorer window and choose Build.

Another note: the solution file included in the zip is for VC# 2005. If you have VC# 2008 that's fine too. Just double-click on the solution file, and VC# 2008 will convert the whole thing.

And now for the linux/mac/unix folk:
We now have a nant default.build file included in the tutorial zip - just drop it in the same directory with the source. Note that for everything to go well, you will need to park your module source directory inside opensim/bin/. When you are ready to build, open a shell, change to the module source directory, and then run 'nant' without any args.

OK, now we're ready. Go ahead and double-click HelloWorld.sln.

The only class in this example is called HelloWorldModule. I know you're eager to get to the part where objects are created and moved around, but I'm afraid that's the easy part. In order to be able to write those functions effectively, you will need to understand a lot more of the engineering of these modules, and that's the part that's not so trivial, especially if you aren't familiar with VC#. So let me go through the code very slowly.
<source lang="csharp">
using System;
using System.Collections.Generic;
using System.Reflection;

using log4net;
using Nini.Config;
using OpenMetaverse;

using OpenSim.Framework;
using OpenSim.Region.Environment;
using OpenSim.Region.Environment.Interfaces;
using OpenSim.Region.Environment.Scenes;
</source>

This first part consists of a collection of "using" declarations. If you come from Java, those declarations are equivalent to "import" declarations. And you know what that means in Java: the jar files must be reachable for compilation to succeed. Same here: the dlls for those elements must be reachable for this project to build. Luckily for you, I have included those dlls in the zip file, so you don't need to add them. They are all happily bundled in HelloWorld/bin/Release. Go ahead and look there. However, as you start getting cozy with this code and you start wanting more, more, more, you will need more from the OpenSim API and even from other libraries. When that comes, you will need to add more dlls to your project. That is done through VC#, not on the file system directly! To add libraries ("References"), right-click on "References" in the Solution Explorer, and choose "Add Reference". A small window will pop up with a few tabs. If the library you need is under the System namespace, you want to interact with the .NET tab. If the library you need is from OpenSim you need to interact with the "Browse" tab; then, navigate to your installation of opensim bin, and pick the dlls you need.

<source lang="csharp">
namespace HelloWorld
{
public class HelloWorldModule : IRegionModule
{
</source>

This second part is the namespace and class declaration. The only noteworthy thing here is the ": IRegionModule" part. What that means is that our class HelloWorldModule implements the [[Region Modules|IRegionModule]] interface, which means that we have to implement the 5 methods of that interface, namely: Initialise (yes, it's the British spelling...), PostInitialise, Close, Name, and IsSharedModule. But that's not all. OpenSim treats IRegionModule classes in a very special way. When OpenSim starts, it looks into all the dlls it can reach (under its bin) in search for classes that implement the IRegionModule interface. All of those classes are then acquired and run by OpenSim as if they were part of OpenSim.

And this is the key to OpenSim application development: you can add your own code, or somebody else's code, as a plug-in that runs natively on the server. Yeepie!

<source lang="csharp">
private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
</source>

This third block above is the declaration of the m_log variable. This variable helps us output messages into a log. I'm just using a common idiom that is used all over OpenSim and that uses log4net. If you come from Java, I'm sure this rings a bell... if you've never seen this, you don't need to understand it, just use it to output messages both onto the console and onto the OpenSim.log file.

<source lang="csharp">
List<Scene> m_scenes = new List<Scene>();
Dictionary<Scene, List<SceneObjectGroup>> scene_prims = new Dictionary<Scene, List<SceneObjectGroup>>();

int counter = 0;
bool positive = true;
</source>

The fourth block of code is the declaration of a few instance variables for our HelloWorld example, and this is where we start getting acquainted with the OpenSim API.
* m_scenes will hold references to all the scenes. "What's a scene?", I hear you asking. A scene is OpenSim's representation of the contents of a region. If your opensim has only one region, there will be only one scene object; if it has more, there will be as many.
* scene_prims is a dictionary that associates scenes with a list of objects of type SceneObjectGroup. In the Java world this would probably be a Hashtable; in the .NET world it's a Dictionary. scene_prims will hold references to the prims that we will instantiate for constructing the world HELLO in each scene. An important note: if you look inside OpenSim's Scene class, you will see that it has a list of entities corresponding to all objects and avatars present in the scene. As we place prims in scenes, including these HELLO prims, they will be placed on that list. However, what we are doing here is constructing a set of prims that are special for our application and that we want to track throughout our application; they are our managed prims. As such, we want to hold references to those, and only those. That's what scene_prims is for.
* The other two variables, counter and positive, are explained later.

<source lang="csharp">
#region IRegionModule interface

public void Initialise(Scene scene, IConfigSource config)
{
m_log.Info("[HELLOWORLD] Initializing...");
m_scenes.Add(scene);
}

public void PostInitialise()
{
m_scenes[0].EventManager.OnFrame += new EventManager.OnFrameDelegate(OnTick);
foreach (Scene s in m_scenes)
DoHelloWorld(s);
}

public void Close()
{
}

public string Name
{
get { return "Hello World Module"; }
}

public bool IsSharedModule
{
get { return true; }
}

#endregion
</source>

The fifth block is the implementation of the IRegionModule methods. There's nothing much here, and this is how it should be: encapsulate all of your code in your own functions. Let's go through the most important of these methods:
* Initialise (I still can't get over this British spelling): this method is called by OpenSim when it is discovering all the IRegionModule classes in dlls. OpenSim sends us two parameters: a scene object and a configuration object. The configuration object allows us to browse through the OpenSim configuration, if we need that info. The scene object is the very important scene information that we want to hold on to; the scene object is our code's main link to OpenSim, it's how we get to access and modify things in the world and beyond. So the main thing our Initialise method does is to hold on to the scene object that OpenSim sends us.
* PostInitialise (argh, British spelling again): this method is called by OpenSim once everything is ready to go, that is, after OpenSim has properly set all the internal things it needs to set. You should look at PostInitialise as the Main method of our application modules. In this case, we are doing two things:
** We are subscribing to an OpenSim event called OnFrame. This event is the Heartbeat of the simulator, so if our module is to do things periodically, we may want to tag along this heartbeat. We are going to move the word HELLO periodically, that's why we're subscribing to this event. Note that this is not always the best approach, though. The simulator is a busy bee, and has to do lots of things already without our module being there. Tagging along the simulator's heartbeat means that we're making it do more stuff. If you're planning to develop modules with your own simulations, you're much better off defining your own timer object, because that will make the tick function run on a different thread than the simulator's heartbeat. But in this case, this is just HelloWorld, so we can abuse gently.
** For each scene, we are constructing the HELLO word.
* Close and Name are trivial -- see the [[IRegionModule|documentation]].
* IsSharedModule is very important, and may be a source of much grief. Here's the deal: OpenSim can either (a) instantiate our HelloWorldModule class exactly once, a singleton, independent of the number of regions; or (b) instantiate our HelloWorldModule class as many times as the number of regions, creating a different HelloWorldModule instance for every scene. These two modes are captured by the IsSharedModule method. If you want OpenSim to create a singleton, make this method return true ("yes, OpenSim, my module is shared"); if you want to create different instances for different regions, make this method return false ("no, OpenSim, my module is not shared among the regions"). Depending on your application, you may want one thing or the other. In this case, I want to centralize the management of my specially constructed prims, so I made it be shared. (In reality for this simple example, it wouldn't matter). But here's the important idiom: when you have a shared module, you want to have a list of scenes, just like the m_scenes variable in this example; when you have a non-shared module, you want to have only one scene variable declared in your module, so that would be "Scene m_scene;" instead of "List<Scene> m_scenes;"

Alright! If you read up to here, and followed the story, you're now ready to move on to the fun part.

<source lang="csharp">
void DoHelloWorld(Scene scene)
{
// We're going to write HELLO with prims

List<SceneObjectGroup> prims = new List<SceneObjectGroup>();
// First prim: |
Vector3 pos = new Vector3(120, 128, 30);
SceneObjectGroup sog = new SceneObjectGroup(UUID.Zero, pos, PrimitiveBaseShape.CreateBox());
sog.RootPart.Scale = new Vector3(0.3f, 0.3f, 2f);
prims.Add(sog);

...

// Add these to the managed objects
scene_prims.Add(scene, prims);

// Now place them visibly on the scene
foreach (SceneObjectGroup sogr in prims)
{
scene.AddNewSceneObject(sogr, false);
}
}
</source>

This method creates 12 SceneObjectGroup (SOG) instances corresponding to the 12 segments that constitute the word HELLO. '''BIG WARNING:''' SOG is currently under heavy redesign, and may be replaced with another class altogether in future versions of opensim. But for 0.6.0 SOG is tha man. SOG represents a linked group of objects, the linksets in SL, with root part and all. If you have your VC# open with HelloWorld, go to this method, and type, somewhere: sog. -- just like that, stopping at the dot. VC# will show you everything that is inside SOG instances. And that is A LOT! It's one of those monster classes! (and that's the reason why it's being redesigned) You should spend some time exploring what's inside SOG. In this example, I'm only using a couple of things: one of the constructors and the RootPart. For the RootPart, I'm only setting its Scale, i.e. the size of the prim.

At the end of this method, when all prims are instantiated, they're added to the list of managed prims (scene_prims) and they're finally made visible on the scene, by calling scene.AddNewSceneObject. The second argument to this method, false, means that we're telling OpenSim not to back these objects up on the DB; we want them to be non-persistent.

And finally we come to the end of the application:

<source lang="csharp">
void OnTick()
{
if (counter++ % 50 == 0)
{
foreach (KeyValuePair<Scene, List<SceneObjectGroup>> kvp in scene_prims)
{
foreach (SceneObjectGroup sog in kvp.Value)
{
if (positive)
sog.AbsolutePosition += new Vector3(5, 5, 0);
else
sog.AbsolutePosition += new Vector3(-5, -5, 0);
sog.ScheduleGroupForTerseUpdate();
}
}
positive = !positive;
}
}
</source>

This is the worker method in our application for every heartbeat of the simulator. Notice that I have a counter there so that things only move every 50 heartbeats. I also have a direction (positive) that can be true or false, so that the prims move back and forth. As you can see, the way to move prims is to set their AbsolutePosition property directly. After that, we tell opensim to schedule the object for an update, so that we can see it move. Note this last bit, the scheduling for updates, is still a fragile piece of the opensim API; we may need it here or not, depending on the version of opensim you're using.

Voila!

Running on custom configurations (grids, alternate terrain) should work fine if you take into account the following:

# Make sure that the Z value in the C# code is above the terrain. Instead of 30,you may wish to raise or lower this value. Make sure to also modify 29 and 31, similarly.
# Change UUID.Zero to your a UUID for an avatar that has build rights on your region. You can replace "UUID.Zero" with "new UUID("your UUID string here")"
# This C# module will place "HELLO" on each region in your grid. If you want to make it so that "HELLO" appears in only one region, try this quick replacement:

<source lang="csharp">
foreach (Scene s in m_scenes)
if (s.RegionInfo.RegionName == "YourRegionName")
DoHelloWorld(s);
</source>

=== What Next ===

This is an [http://www.youtube.com/watch?v=Xxsk9WDYMtg example]
of 100 continuously moving blocks.

Here are some other suggestions for what you can do next, on your own:

* Change the Color of the prims
* Complete the example by creating prims for the word WORLD. For the W you probably need our beloved quaternions...
* Add more regions to your opensim and see what happens
* Change this module from shared to non-shared and see what happens (nothing much different, one hopes, in this simple case)
* Be more creative with the movement and make the prims move in circles
* ...

Remember, every time you make changes to the application code, and you build it, its dll is placed under bin/Release, so you have to copy it to opensim/bin. If you want, you can change the build settings of your application, so that it places the dll directly in opensim/bin.

Have Fun!

=== Tips ===

There is very little documentation about the OpenSim API. One of the reasons for that is that it is still evolving and therefore unstable. A reasonable place to look at the API is http://docs.opensimulator.org/namespaceOpenSim.html; in there, the most interesting place to start is the Region.Environment.Scenes namespace http://docs.opensimulator.org/namespaceOpenSim_1_1Region_1_1Environment_1_1Scenes.html.

The code itself is full of information, if you can cope with looking at too much information. Here's what I do and recommend: when you're developing these modules, have 2 VC# open, one with your application and the other with opensim. My experience with opensim is that the names of things are quite reasonable. So whenever you want something that you don't know exactly how to get, go to the opensim code and make heavy use of the Search functions, especially Edit->Find and Replace->Find in Files. VC#, just like Eclipse, also has those wonderful navigation facilities that take you to definitions from calls, etc. Just right-click on things in the code.

Database Documentation

2008-10-08T00:20:00Z

Twitch: Database Documentation moved to Database:Documentation

#REDIRECT [[Database:Documentation]]

Database:Documentation

2008-10-08T00:19:59Z

Twitch: Database Documentation moved to Database:Documentation

This is a running start at documenting the tables in the MySQL instances used on both grid and regions, and describing how they relate to each other in the context of an OpenSim grid.

SQLite is generally not considered apropriate for this use case and will not be covered here; however the table structures are very similar and most of what is here will be useful in that context as well.

Note that some of these tables may be relics, some may be planned for future use, and some may see heavy use but have columns which are relics, not yet properly updated or not yet used at all. Alpha code FTW!! :D

The instances:
<table>
<tr>
<td align=left>Grid:</td>
<tr>
<td> </td>
</tr>
<tr>
<td>[[agents]] </td><td>Records agent (Avatar/User) login details</td>
<tr>
<td>[[assets]] </td><td>Comprehensive grid assets including textures and avatar inventories</td>
</tr><tr>
<td>[[avatarappearance]] </td><td>Persistence of the visual appearance of avatars between logins</td>
</tr>
<tr>
<td>[[inventoryfolders]] </td><td>Inventory folder-related details *excepting contents*</td>
</tr>
<tr>
<td> </td><td>Contents are in the [[inventoryitems]] table and point back to [[inventoryfolders]]</td>
</tr>
<tr>
<td>[[inventoryitems]] </td><td>All inventory item details (including folder associations) except contents - contents are referenced</td>
</tr>
<tr>
<td> </td><td>in the [[assets]] table </td>
</tr>
<tr>
<td>[[logs]] </td><td>Stores a record of logged events</td>
</tr>
<tr>
<td>[[logs_preTimestamp]] </td><td>Old format [[logs]] table? **RELIC - no longer present in dist DB</td>
</tr>
<tr>
<td> </td><td>*** it would appear neither of these log tables is currently used *** </td>
</tr>
<tr>
<td>[[migrations]]</td><td>Supports 'automagic' migration to new database formats</td>
</tr>
<tr>
<td>[[regions]]</td><td>Regions known to the grid</td>
</tr>
<tr>
<td>[[reservations]]</td><td>Region registration table. This table has no rows on OSGrid and is likely in place for future functionality **RELIC - no longer present in dist DB</td>
</tr>
<tr>
<td>[[userfriends]]</td><td>Friends list registration</td>
</tr>
<tr>
<td>[[users]]</td><td>Stored user profile</td>
</tr>
</table>
 
<table>
<tr>
<td align=left>Region:</td>
<tr>
<td> </td>
</tr>
<tr>
<td>[[estate_groups]] </td><td>Narrowly purposed at present. Appears to associate UUIDs under an Estate ID</td>
</tr>
<tr>
<td>[[estate_managers]] </td><td>Assoicates UUIDs with Estate ID</td>
</tr>
<tr>
<td>[[estate_map]] </td><td>Associates Regions with Estates By Estate ID</td>
</tr>
<tr>
<td>[[estate_settings]] </td><td>Settings for Estates</td>
</tr>
<tr>
<td>[[estate_users]] </td><td>Users allowed on the Estate</td>
</tr>
<tr>
<td>[[estateban]] </td><td>Users banned from the Estate</td>
</tr>
<tr>
<td>[[land]] </td><td>Parcel Properties</td>
</tr>
<tr>
<td>[[landaccesslist]] </td><td>Parcel Access List</td>
</tr>
<tr>
<td>[[migrations]] </td><td>Supports 'automagic' upgrade to new database formats</td>
</tr>
<tr>
<td>[[primitems]] </td><td>contains the prim's inventory, which is not at all unlike the avatars' inventory with the exception of folders</td>
</tr>
<tr>
<td>[[prims]] </td><td>All rezzed prim details *excepting shape and contents*</td>
</tr>
<tr>
<td>[[primshapes]] </td><td>Properties of all rezzed prims</td>
</tr>
<tr>
<td>[[regionban]] </td><td>Per-Region ban list</td>
</tr>
<tr>
<td>[[regionsettings]] </td><td>Per-Region settings</td>
</tr>
<tr>
<td>[[terrain]] </td><td>Terrain mesh revision history</td>
</tr>
</table>

Full details of back-store instantiation as performed by the OpenSim software can be found here: 
http://opensimulator.org/svn/opensim/trunk/OpenSim/Data/MySQL/Resources/
 
Here is a note concerning the [[initial creation of the MySQL tables]] 
Questions about this documentation can be directed to daTwitch on #opensim-dev or #osgrid FreeNode IRC or Hiro Protagonist on OSGrid. 
For further clarification of the content ask on #opensim-dev look for sdague, JustinCC or DrSco

[[Category:Database]]

Database:Users

2008-10-06T23:33:10Z

Twitch:

'''users''' ''Stores users profile data''      (back to [[Database Documentation]])

The current structure of the users table is as follows:
{| cellpadding="5" cellspacing="0" border="1"
!align="left"| Field
!align="left"| Type
!align="left"| Null
!align="left"| Key
!align="left"| Default
!align="left"| Extra
|-
| UUID || varchar(36) || NO || PRI || '' ||
|-
| username || varchar(32) || NO || UNI || ||
|-
| lastname || varchar(32) || NO || UNI || ||
|-
| passwordHash || varchar(32) || NO || || ||
|-
| passwordSalt || varchar(32) || NO || || ||
|-
| homeRegion || bigint(20) unsigned || YES || || NULL ||
|-
| homeLocationX || float || YES || || NULL ||
|-
| homeLocationY || float || YES || || NULL ||
|-
| homeLocationZ || float || YES || || NULL ||
|-
| homeLookAtX || float || YES || || NULL ||
|-
| homeLookAtY || float || YES || || NULL ||
|-
| homeLookAtZ || float || YES || || NULL ||
|-
| created || int(11) || NO || || ||
|-
| lastLogin || int(11) || NO || || ||
|-
| userInventoryURI || varchar(255) || YES || || NULL ||
|-
| userAssetURI || varchar(255) || YES || || NULL ||
|-
| profileCanDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileWantDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileAboutText || text || YES || || NULL ||
|-
| profileFirstText || text || YES || || NULL ||
|-
| profileImage || varchar(36) || YES || || NULL ||
|-
| profileFirstImage || varchar(36) || YES || || NULL ||
|-
| webLoginKey || varchar(36) || YES || || NULL ||
|-
| homeRegionID || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|-
| userFlags || int(11) || NO || || '0' ||
|-
| godLevel || int(11) || NO || || '0' ||
|-
| customType || varchar(32) || NO || || '' ||
|-
| partner || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|}

;UUID
:The unique id of the user

;username
:The first name of the user

;lastname
:The last name of the user

;passwordHash
:The MD5-hash from password and salt
;passwordSalt
:The password salt

;homeRegion
:The region-handle of the home-region

;homeLocationX, homeLocationY, homeLocationZ
:The home-location within the home-region

;homeLookAtX, homeLookAtY, homeLookAtZ
:The direction the avatar looks after TP to the home-location

;created
:Creation timestamp of the profile (in seconds since UNIX-epoch (Jan 1st, 1971))

;lastLogin
:Time of last login (in seconds since UNIX-epoch)

;userInventoryURI
:needs to be documented

;userAssetURI
:needs to be documented

;profileCanDoMask
:needs to be documented

;profileWantDoMask
:needs to be documented

;profileAboutText
:The text in the about field of the profile dialog

;profileFirstText
:The text in the first-life field of the profile dialog

;profileImage
:The UUID of the profile image

;profileFirstImage
:The UUID of the first-life image

;webLoginKey
:needs to be documented

;homeRegionID
:The region UUID of the home-region

;userFlags
:needs to be documented

;godLevel
:needs to be documented

;customType
:needs to be documented

;partner
:The UUID of a user that will appear in the partner field of the profile dialog
[[Category:Database]]

Database:Users

2008-10-06T23:32:15Z

Twitch:

'''users''' ''Stores users profile data''      (back to [[Database Documentation]])

The current structure of the users table is as follows:
{| cellpadding="5" cellspacing="0" border="1"
!align="left"| Field
!align="left"| Type
!align="left"| Null
!align="left"| Key
!align="left"| Default
!align="left"| Extra
|-
| UUID || varchar(36) || NO || PRI || '' ||
|-
| username || varchar(32) || NO || UNI || ||
|-
| lastname || varchar(32) || NO || UNI || ||
|-
| passwordHash || varchar(32) || NO || || ||
|-
| passwordSalt || varchar(32) || NO || || ||
|-
| homeRegion || bigint(20) unsigned || YES || || NULL ||
|-
| homeLocationX || float || YES || || NULL ||
|-
| homeLocationY || float || YES || || NULL ||
|-
| homeLocationZ || float || YES || || NULL ||
|-
| homeLookAtX || float || YES || || NULL ||
|-
| homeLookAtY || float || YES || || NULL ||
|-
| homeLookAtZ || float || YES || || NULL ||
|-
| created || int(11) || NO || || ||
|-
| lastLogin || int(11) || NO || || ||
|-
| userInventoryURI || varchar(255) || YES || || NULL ||
|-
| userAssetURI || varchar(255) || YES || || NULL ||
|-
| profileCanDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileWantDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileAboutText || text || YES || || NULL ||
|-
| profileFirstText || text || YES || || NULL ||
|-
| profileImage || varchar(36) || YES || || NULL ||
|-
| profileFirstImage || varchar(36) || YES || || NULL ||
|-
| webLoginKey || varchar(36) || YES || || NULL ||
|-
| homeRegionID || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|-
| userFlags || int(11) || NO || || '0' ||
|-
| godLevel || int(11) || NO || || '0' ||
|-
| customType || varchar(32) || NO || || '' ||
|-
| partner || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|}

;UUID
:The unique id of the user

;username
:The first name of the user

;lastname
:The last name of the user

;passwordHash
:The MD5-hash from password and salt
;passwordSalt
:The password salt

;homeRegion
:The region-handle of the home-region

;homeLocationX, homeLocationY, homeLocationZ
:The home-location within the home-region

;homeLookAtX, homeLookAtY, homeLookAtZ
:The direction the avatar looks after TP to the home-location

;created
:Creation timestamp of the profile (in seconds since UNIX-epoch (Jan 1st, 1971))

;lastLogin
:Time of last login (in seconds since UNIX-epoch)

;userInventoryURI
:needs to be documented

;userAssetURI
:needs to be documented

;profileCanDoMask
:needs to be documented

;profileWantDoMask
:needs to be documented

;profileAboutText
:The text in the about field of the profile dialog

;profileFirstText
:The text in the first-life field of the profile dialog

;profileImage
:The UUID of the profile image

;profileFirstImage
:The UUID of the first-life image

;webLoginKey
:needs to be documented

;homeRegionID
:The region UUID of the home-region

;userFlags
:needs to be documented

;godLevel
:needs to be documented

;customType
:needs to be documented

;partner
:The UUID of an user that will appear in the partner field of the profile dialog
[[Category:Database]]

Regions (database table)

2008-10-06T23:31:25Z

Twitch:

The regions table contains information concerning all the regions authorized to connect to the grid.

The columns are as follows:
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>uuid</td><td>varchar(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td> </td></tr>
<tr><td>regionHandle</td><td>bigint(20) unsigned</td><td>NO</td><td>MUL</td><td>NULL</td><td> </td></tr>
<tr><td>regionName</td><td>varchar(32)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td></tr>
<tr><td>regionRecvKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionSendKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>regionSecret</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>regionDataURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverIP</td><td>varchar(64)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverPort</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locX</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locY</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locZ</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>eastOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td>MUL</td><td>NULL</td><td></td><tr>
<tr><td>westOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>southOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td> 
<tr><td>northOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionAssetURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionAssetRecvKey</td><td>varchar(128)</td><td>YES</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>regionAssetSendKey</td><td>varchar(128)</td><td>YES</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>regionUserURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><tr>
<tr><td>regionUserRecvKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionUserSendKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionMapTexture</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>serverHttpPort</td><td>int(10)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>serverRemotingPort</td><td>int(10)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>owner_uuid</td><td>varchar(36)</td><td>NO</td><td></td><td>00000000-0000-0000-0000-000000000000</td><td></td></tr>
<tr><td>originUUID</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
</table>
 
 
'''uuid''' 
The region's unique identifier
 
 
'''regionHandle''' 
more detail req'd
 
 
'''regionName''' 
the region's name as it appears on maps - not necesarily unique
 
 
'''regionRecvKey''' 
the key used by the region server to verify authenticity of communications from other regions
 
 
'''regionSendKey''' 
the key used by the region server when verifying its identity in communications with other regions
 
 
'''regionSecret''' 
more detail req'd
 
 
'''regionDataURI''' 
more detail req'd
 
 
'''serverIP''' 
IP address of region server
 
 
'''serverPort''' 
connection port for region server
 
 
'''serverURI''' 
more detail req'd
 
 
'''locX''' 
X coordinate of region on the grid
 
 
'''locY''' 
Y coordinate of region on the grid
 
 
'''locZ''' 
Z coordinate of region on the grid *grinz*
 
 
'''eastOverrideHandle''' 
more detail req'd
 
 
'''westOverrideHandle''' 
more detail req'd
 
 
'''southOverrideHandle''' 
more detail req'd
 
 
'''northOverrideHandle''' 
more detail req'd
 
 
'''regionAssetURI''' 
more detail req'd
 
 
'''regionAssetRecvKey''' 
key used to verify the authenticity of communications received from the asset server
 
 
'''regionAssetSendKey''' 
key used to verify the authenticity of communications sent to the asset server
 
 
'''regionUserURI''' 
more detail req'd
 
 
'''regionUserRecvKey''' 
key used to verify the authenticity of communications received from the user server
 
 
'''regionUserSendKey''' 
key used to verify the authenticity of communications sent to the user server
 
 
'''regionMapTexture''' 
texture for the map as displayed in the client minimap
 
 
'''serverHttpPort''' 
port the region will answer on for HTTP requests
 
 
'''serverRemotingPort''' 
more detail req'd
 
 
'''owner_uuid''' 
UUID of the avatar/account which owns the region
 
 
'''originUUID''' 
more detail req'd
[[Category:Database]]

Database:Migrations

2008-10-06T23:31:06Z

Twitch:

This table is of little use to the enduser in any direct fashion, except perhaps to verify the database schema version. It is used by the software to automatically detect the necesity to migrate the database.
 
The two columns in the table are 'name' and 'version'. 'version' is pretty self-documenting; name a little less so. 'version' is the column of typical interest, though 'name' is likely informative too.
[[Category:Database]]

Database:Inventoryitems

2008-10-06T23:30:31Z

Twitch:

'''inventoryitems''' ''Records details with respect to the avatar's personal property (assets)''      (back to [[Database Documentation]]) 
 
The current structure of the inventoryitems table is as follows: 
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>assetID</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td> </td></tr>
<tr><td>assetType</td><td>int(11) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>inventoryName</td><td>varchar(64)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>inventoryDescription</td><td>varchar(64)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>inventoryNextPermissions</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>inventoryCurrentPermissions</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>invType</td><td>int(11)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>CreatorID</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>inventoryBasePermissions</td><td>int(10) unsigned</td><td>NO</td><td></td><td>0</td><td></td><td></td></tr>
<tr><td>inventoryEveryOnePermissions</td><td>int(10) unsigned</td><td>NO</td><td></td><td>0</td><td></td><td></td></tr>
<tr><td>salePrice</td><td>int(11)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>saleType</td><td>tinyint(4)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>creationDate</td><td>int(11)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>groupID</td><td>varchar(36)</td><td>NO</td><td></td><td>00000000-0000-0000-0000-000000000000</td><td></td> 
<tr><td>groupOwned</td><td>tinyint(4)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>flags</td><td>int(11) unsigned</td><td>NO</td><td></td><td>0</td><td></td></tr>
<tr><td>inventoryID</td><td>char(36)</td><td>NO</td><td>PRI</td><td>00000000-0000-0000-0000-000000000000</td><td></td></tr>
<tr><td>avatarID</td><td>char(36)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td><tr>
<tr><td>parentFolderId</td><td>char(36)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td></tr>
</table>
 
 
      (back to [[Database Documentation]]) 
<hr>
'''assetID''' 
Refers to the related row in the assets table.
 
'''assetType''' 
Type of asset (e.g., script, texture, or shape)
 
'''inventoryName''' 
Text of the name of the inventory item as it appears in the client inventory interface.
 
'''inventoryDescription''' 
Text of the description of the inventory item as it appears in the client inventory interface.
 
'''inventoryNextPermissions''' 
Permissions that will be applied to the item if/when it is transferred to another avatar.
 
'''inventoryCurrentPermissions''' 
Permissions on the the item for the current posessor of the item.
 
'''invType''' 
Type of inventory item (is this redundant with assetType?)
 
'''creatorID''' 
UUID of the item's original creator.
 
'''inventoryBasePermissions''' 
Base permissions of the object.
 
'''inventoryEveryOnePermissions''' 
Permissions with respect to everyone but the owner of the item.
 
'''salePrice''' 
Sale price of the item.
 
'''saleType''' 
''presently unknown''
 
'''creationDate''' 
Date the item was created
 
'''groupID''' 
UUID of the group that the items is 'deeded' to
 
'''groupOwned''' 
group ownership flags
 
'''flags''' 
''presently unknown''
 
'''inventoryID''' 
UUID of inventory item
 
'''avatarID''' 
UUID of item's owner
 
'''parentFolderID''' 
UUID of the folder said to 'contain' the item
<hr> 
      (back to [[Database Documentation]]) 
[[Category:Database]]

Database:Inventoryfolders

2008-10-06T23:30:07Z

Twitch:

'''inventoryfolders''' ''Records details concerning the avatar's inventory organisation,''      (back to [[Database Documentation]]) 
specifically the folders. No information about contents of the folders is in this table.
 
The current structure of the avatar appearance table is as follows: 
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>folderName</td><td>varchar(64)</td><td>YES</td><td> </td><td>NULL</td><td> </td></tr>
<tr><td>type</td><td>smallint(6)</td><td>NO</td><td></td><td>0</td><td></td></tr>
<tr><td>version</td><td>int(11)</td><td>NO</td><td></td><td>0</td><td></td></tr>
<tr><td>folderID</td><td>char(36)</td><td>NO</td><td>PRI</td><td>00000000-0000-0000-0000-000000000000</td><td></td><td></td><tr>
<tr><td>agentID</td><td>char(36)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td><td></td></tr>
<tr><td>parentFolderID</td><td>char(36)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td><td></td></tr>
</table>
 
 
      (back to [[Database Documentation]]) 
<hr>

'''folderName''' 
 
Text of the folder's name as it appears in the client inventory interface
 
 
'''type''' 
 
numerically encoded inventory folder type (e.g., 'Textures', 'Scripts', or 'Objects')
 
 
'''version''' 
''unknown at present''
 
 
'''folderID''' 
 
Uniquely identifies the folder. This facilitates the folder being claimed as a logical container by other folders, or the things in the inventoryitems table that are said to be 'in' the folder.
 
 
'''agentID''' 
 
Unique agent identifier - identifies the agent which owns the folder.
 
 
'''parentFolderID''' 
Unique folder identifier 'claims' the folder which is said to 'contain' this one in the same fashion as things in the inventoryitems table 'claim' the folder said to 'contain' them
<hr>
      (back to [[Database Documentation]]) 
[[Category:Database]]

Database:Avatarappearance

2008-10-06T23:29:49Z

Twitch:

'''avatarappearance''' ''Records avatar appearance details, i.e., worn wearables''      (back to [[Database Documentation]]) 
 
The current structure of the avatar appearance table is as follows: 
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>Owner</td><td>char(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td> </td></tr>
<tr><td>Serial</td><td>int(10) unsigned</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Visual_Params</td><td>blob</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Texture</td><td>blob</td><td>NO</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>Avatar_Height</td><td>float</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>Body_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>Body_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>Skin_Item</td><td>char(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>Skin_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Hair_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Hair_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td> 
<tr><td>Eyes_Item</td><td>char(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>Eyes_Asset</td><td>char(36)</td><td>NO</td><td>UNI</td><td>NULL</td><td></td></tr>
<tr><td>Shirt_Item</td><td>char(36)</td><td>NO</td><td>UNI</td><td>NULL</td><td></td></tr>
<tr><td>Shirt_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Pants_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Pants_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Shoes_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Shoes_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Socks_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Socks_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Jacket_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Jacket_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Gloves_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Gloves_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Undershirt_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Undershirt_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Underpants_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><tr>
<tr><td>Skirt_Asset</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>Skirt_Item</td><td>char(36)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td><tr>
</table>
 
 
      (back to [[Database Documentation]]) 
<hr>

'''Owner''' 
UUID of avatar's owner.
 
 
'''Serial''' 
Monotonic counter gets incremented by 1 each time the avatar is updated.
 
'''Visual_Params''' 
Byte array of some 240 or so numerically descriptive shape parameters describing the look of the avatar.
 
 
'''Texture''' 
The avatar's 'baked' texture.
 
 
'''Avatar_Height''' 
Height of the avatar in meters.
 
 
'''Body_Item''' 
Refers to inventory item for Body
 
 
'''Body_Asset''' 
Refers to item in assets for Body
 
 
'''Skin_Item''' 
Refers to inventory item for Skin
 
 
'''Skin_Asset''' 
Refers to item in assets for Skin
 
 
'''Hair_Item''' 
Refers to inventory item for Hair
 
 
'''Hair_Asset''' 
Refers to item in assets for Hair
 
 
'''Eyes_Item''' 
Refers to inventory item for Eyes
 
 
'''Eyes_Asset''' 
Refers to item in assets for Eyes
 
 
'''Shirt_Item''' 
Refers to inventory item for Shirt
 
 
'''Shirt_Asset''' 
Refers to item in assets for Shirt
 
 
'''Pants_Item''' 
Refers to inventory item for Pants
 
 
'''Pants_Asset''' 
Refers to item in assets for Pants
 
 
'''Shoes_Item''' 
Refers to inventory item for Shoes
 
 
'''Shoes_Asset''' 
Refers to item in assets for Shoes
 
 
'''Socks_Item''' 
Refers to inventory item for Socks
 
 
'''Socks_Asset''' 
Refers to item in assets for Socks
 
 
'''Jacket_Item''' 
Refers to inventory item for Jacket
 
 
'''Jacket_Asset''' 
Refers to item in assets for Jacket
 
 
'''Gloves_Item''' 
Refers to inventory item for Gloves
 
 
'''Gloves_Asset''' 
Refers to item in assets for Gloves
 
 
'''Undershirt_Item''' 
Refers to inventory item for Undershirt
 
 
'''Undershirt_Asset''' 
Refers to item in assets for Undershirt
 
 
'''Underpants_Item''' 
Refers to inventory item for Underpants
 
 
'''Underpants_Asset''' 
Refers to item in assets for Underpants
 
 
'''Skirt_Asset''' 
Refers to item in assets for Skirt
 
 
'''Skirt_Item''' 
Refers to inventory item for Skirt
<hr>
      (back to [[Database Documentation]]) 
[[Category:Database]]

Database:Assets

2008-10-06T23:29:25Z

Twitch:

'''assets''' ''Records all assets''      (back to [[Database Documentation]]) 
          ''including textures, notecards, scripts, and avatar parts''
 
The current structure of the assets table is as follows: 
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>Name</td><td>varchar(64)</td><td>NO</td><td></td><td>NULL</td><td> </td></tr>
<tr><td>description</td><td>varchar(64)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>assetType</td><td>tinyint(4)</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>local</td><td>tinyint(1)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>temporary</td><td>tinyint(1)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>data</td><td>longblob</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>id</td><td>char(36)</td><td>NO</td><td>PRI</td><td>00000000-0000-0000-0000-000000000000</td><td></td><td></td></tr>
</table>
 
 
      (back to [[Database Documentation]]) 
<hr>
'''name'''
 
Name of the asset as it would appear in inventory 
 
'''description'''
Asset's description field, as it appears in various client-side editing widgets
 
 
'''assetType'''
 
Integer which designates the asset's inventory type
 
 
'''local'''
 
For Future Use
 
 
'''temporary'''
 
For Future Use
 
 
'''data'''
This is the blob which contains the actual script, notecard text, 
or binary image (texture) or other data characterized by the invType column 
 
'''id'''
 
UUID which uniquely identifies the asset within the system
 
 
<hr>
      (back to [[Database Documentation]]) 
[[Category:Database]]

Database:Agents

2008-10-06T23:29:02Z

Twitch:

[[Category:Database]]

'''agents''' ''Records agent (Avatar/User) login details''      (back to [[Database Documentation]]) 
 
The current structure of the agents table is as follows: 
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>UUID</td><td>varchar(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td> </td></tr>
<tr><td>sessionID</td><td>varchar(36)</td><td>NO</td><td>UNI</td><td>NULL</td><td></td></tr>
<tr><td>secureSessionID</td><td>varchar(36)</td><td>NO</td><td>UNI</td><td>NULL</td><td></td></tr>
<tr><td>agentIP</td><td>varchar(16)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>agentPort</td><td>int(11)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>agentOnline</td><td>tinyint(4)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>loginTime</td><td>int(11)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>logoutTime</td><td>int(11)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>currentRegion</td><td>varchar(36)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>currentHandle</td><td>bigint(20) unsigned</td><td>NO</td><td></td><td>NULL</td><td></td></tr>
<tr><td>currentPos</td><td>varchar(64)</td><td>NO</td><td></td><td>NULL</td><td></td><td></td> 
</table>
 
 
      (back to [[Database Documentation]]) 
<hr>
'''UUID'''
 
The UUID uniquely identifies the avatar associated with the user's account. This master ID 'number' is used for everything the avatar interacts with - it is used to determine permissions, identify belongings, and route messages to and from system and other avatars.
 
 
'''sessionID'''
 
For Future Use
 
 
'''SecureSessionID'''
 
For Future Use
 
 
'''agentIP'''
 
IP address of logged-in agent? 
Does not appear to be updated at this time
 
 
'''agentPort'''
Port the agent is connected on 
Does not appear to be updated at this time
 
 
'''agentOnLine'''
 
Status of agent (Online/Offline)
 
 
'''loginTime'''
 
Time the agent logged in at
 
 
'''logoutTime'''
 
Time the agent logged out at
 
 
'''currentRegion'''
 
Region UUID for the region the av is presently resident within
 
 
'''currentHandle'''
 
Records the grid position of the region the av is presently resident within
 
 
'''currentPos'''
 
Records the av's current position with the region in which it is currently resident
 
 
<hr>
      (back to [[Database Documentation]]) 
[[Category:Database]]

Database:Documentation

2008-10-06T23:28:29Z

Twitch:

Users

2008-10-06T23:25:57Z

Twitch: Users moved to Database:Users: tidy up namespace per sdague

#REDIRECT [[Database:Users]]

Database:Users

2008-10-06T23:25:57Z

Twitch: Users moved to Database:Users: tidy up namespace per sdague

'''users''' ''Stores users profile data''      (back to [[Database Documentation]])

The current structure of the users table is as follows:
{| cellpadding="5" cellspacing="0" border="1"
!align="left"| Field
!align="left"| Type
!align="left"| Null
!align="left"| Key
!align="left"| Default
!align="left"| Extra
|-
| UUID || varchar(36) || NO || PRI || '' ||
|-
| username || varchar(32) || NO || UNI || ||
|-
| lastname || varchar(32) || NO || UNI || ||
|-
| passwordHash || varchar(32) || NO || || ||
|-
| passwordSalt || varchar(32) || NO || || ||
|-
| homeRegion || bigint(20) unsigned || YES || || NULL ||
|-
| homeLocationX || float || YES || || NULL ||
|-
| homeLocationY || float || YES || || NULL ||
|-
| homeLocationZ || float || YES || || NULL ||
|-
| homeLookAtX || float || YES || || NULL ||
|-
| homeLookAtY || float || YES || || NULL ||
|-
| homeLookAtZ || float || YES || || NULL ||
|-
| created || int(11) || NO || || ||
|-
| lastLogin || int(11) || NO || || ||
|-
| userInventoryURI || varchar(255) || YES || || NULL ||
|-
| userAssetURI || varchar(255) || YES || || NULL ||
|-
| profileCanDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileWantDoMask || int(10) unsigned || YES || || NULL ||
|-
| profileAboutText || text || YES || || NULL ||
|-
| profileFirstText || text || YES || || NULL ||
|-
| profileImage || varchar(36) || YES || || NULL ||
|-
| profileFirstImage || varchar(36) || YES || || NULL ||
|-
| webLoginKey || varchar(36) || YES || || NULL ||
|-
| homeRegionID || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|-
| userFlags || int(11) || NO || || '0' ||
|-
| godLevel || int(11) || NO || || '0' ||
|-
| customType || varchar(32) || NO || || '' ||
|-
| partner || char(36) || NO || || '00000000-0000-0000-0000-000000000000' ||
|}

;UUID
:The unique id of the user

;username
:The first name of the user

;lastname
:The last name of the user

;passwordHash
:The MD5-hash from password and salt
;passwordSalt
:The password salt

;homeRegion
:The region-handle of the home-region

;homeLocationX, homeLocationY, homeLocationZ
:The home-location within the home-region

;homeLookAtX, homeLookAtY, homeLookAtZ
:The direction the avatar looks after TP to the home-location

;created
:Creation timestamp of the profile (in seconds since UNIX-epoch (Jan 1st, 1971))

;lastLogin
:Time of last login (in seconds since UNIX-epoch)

;userInventoryURI
:needs to be documented

;userAssetURI
:needs to be documented

;profileCanDoMask
:needs to be documented

;profileWantDoMask
:needs to be documented

;profileAboutText
:The text in the about field of the profile dialog

;profileFirstText
:The text in the first-life field of the profile dialog

;profileImage
:The UUID of the profile image

;profileFirstImage
:The UUID of the first-life image

;webLoginKey
:needs to be documented

;homeRegionID
:The region UUID of the home-region

;userFlags
:needs to be documented

;godLevel
:needs to be documented

;customType
:needs to be documented

;partner
:The UUID of an user that will appear in the partner field of the profile dialog

Regions (disambiguation)

2008-10-06T23:25:08Z

Twitch: Regions moved to Database:Regions: tidy up namespace per sdague

#REDIRECT [[Database:Regions]]

Regions (database table)

2008-10-06T23:25:08Z

Twitch: Regions moved to Database:Regions: tidy up namespace per sdague

Database:Migrations

2008-10-06T23:24:41Z

Twitch: Migrations moved to Database:Migrations: tidy up namespace per sdague

Migrations

2008-10-06T23:24:41Z

Twitch: Migrations moved to Database:Migrations: tidy up namespace per sdague

#REDIRECT [[Database:Migrations]]

Database:Inventoryitems

2008-10-06T23:23:46Z

Twitch: Inventoryitems moved to Database:Inventoryitems: tidy up namespace per sdague

Inventoryitems

2008-10-06T23:23:46Z

Twitch: Inventoryitems moved to Database:Inventoryitems: tidy up namespace per sdague

#REDIRECT [[Database:Inventoryitems]]

Inventoryfolders

2008-10-06T23:23:10Z

Twitch: Inventoryfolders moved to Database:Inventoryfolders: tidy up namespace per sdague

#REDIRECT [[Database:Inventoryfolders]]

Database:Inventoryfolders

2008-10-06T23:23:09Z

Twitch: Inventoryfolders moved to Database:Inventoryfolders: tidy up namespace per sdague

Database:Avatarappearance

2008-10-06T23:22:31Z

Twitch: Avatarappearance moved to Database:Avatarappearance: tidy up namespace per sdague

Avatarappearance

2008-10-06T23:22:31Z

Twitch: Avatarappearance moved to Database:Avatarappearance: tidy up namespace per sdague

#REDIRECT [[Database:Avatarappearance]]

Database:Assets

2008-10-06T23:21:46Z

Twitch: Assets moved to Database:Assets: tidy up namespace per sdague

Assets

2008-10-06T23:21:46Z

Twitch: Assets moved to Database:Assets: tidy up namespace per sdague

#REDIRECT [[Database:Assets]]

Agents

2008-10-06T23:20:48Z

Twitch: Agents moved to Database:Agents: tidy up namespace per sdague

#REDIRECT [[Database:Agents]]

Database:Agents

2008-10-06T23:20:47Z

Twitch: Agents moved to Database:Agents: tidy up namespace per sdague

Regions (database table)

2008-08-07T17:40:41Z

Twitch:

Regions (database table)

2008-08-07T17:27:48Z

Twitch:

The regions table contains information concerning all the regions authorized to connect to the grid.

The columns are as follows:
 
<table>
<tr><td>Field </td><td>Type</td><td>Null</td><td>Key</td><td>Default</td><td>Extra</td></tr>
<tr><td> </td></tr>
<tr><td>uuid</td><td>varchar(36)</td><td>NO</td><td>PRI</td><td>NULL</td><td> </td></tr>
<tr><td>regionHandle</td><td>bigint(20) unsigned</td><td>NO</td><td>MUL</td><td>NULL</td><td> </td></tr>
<tr><td>regionName</td><td>varchar(32)</td><td>YES</td><td>MUL</td><td>NULL</td><td></td></tr>
<tr><td>regionRecvKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionSendKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td><tr>
<tr><td>regionSecret</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>regionDataURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverIP</td><td>varchar(64)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverPort</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>serverURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locX</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locY</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td><td></td></tr>
<tr><td>locZ</td><td>int(10) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>eastOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td>MUL</td><td>NULL</td><td></td><tr>
<tr><td>westOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>southOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td> 
<tr><td>northOverrideHandle</td><td>bigint(20) unsigned</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionAssetURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionAssetRecvKey</td><td>varchar(128)</td><td>YES</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>regionAssetSendKey</td><td>varchar(128)</td><td>YES</td><td>PRI</td><td>NULL</td><td></td></tr>
<tr><td>regionUserURI</td><td>varchar(255)</td><td>YES</td><td></td><td>NULL</td><td></td><tr>
<tr><td>regionUserRecvKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionUserSendKey</td><td>varchar(128)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>regionMapTexture</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>serverHttpPort</td><td>int(10)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>serverRemotingPort</td><td>int(10)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
<tr><td>owner_uuid</td><td>varchar(36)</td><td>NO</td><td></td><td>00000000-0000-0000-0000-000000000000</td><td></td></tr>
<tr><td>originUUID</td><td>varchar(36)</td><td>YES</td><td></td><td>NULL</td><td></td></tr>
</table>
 
 
'''uuid''' 
 
 
'''regionHandle''' 
 
 
'''regionName''' 
 
 
'''regionRecvKey''' 
 
 
'''regionSendKey''' 
 
 
'''regionSecret''' 
 
 
'''regionDataURI''' 
 
 
'''serverIP''' 
 
 
'''serverPort''' 
 
 
'''serverURI''' 
 
 
'''locX''' 
 
 
'''locY''' 
 
 
'''locZ''' 
 
 
'''eastOverrideHandle''' 
 
 
'''westOverrideHandle''' 
 
 
'''southOverrideHandle''' 
 
 
'''northOverrideHandle''' 
 
 
'''regionAssetURI''' 
 
 
'''regionAssetRecvKey''' 
 
 
'''regionAssetSendKey''' 
 
 
'''regionUserURI''' 
 
 
'''regionUserRecvKey''' 
 
 
'''regionUserSendKey''' 
 
 
'''regionMapTexture''' 
 
 
'''serverHttpPort''' 
 
 
'''serverRemotingPort''' 
 
 
'''owner_uuid''' 
 
 
'''originUUID'''

Regions (database table)

2008-08-07T17:16:18Z

Twitch:

Regions (database table)

2008-08-07T17:12:47Z

Twitch: