OpenSimulator - User contributions [en]

Scripting Documentation

2010-07-31T15:45:30Z

Waexu66:

__NOTOC__
{{Template:Quicklinks}}

== Overview ==

*[[ScriptEngines|Scripting Engine]] - Xengine Script Engine Transition (By Melanie_T)
*[[Scripting Languages]] - Supported Scripting Languages
*[[LSL_Status|LSL/OSSL Status]] - Status and news about LSL and OSSL
*[[Non-LSL scripting]] - Information on C# and scripting in OpenSim with other languages

==About OpenSim scripting==
An important ingredient in Second Life is scripting. It is the engine that drives it all. In SL [http://wiki.secondlife.com/wiki/LSL_Portal LSL (Linden Scripting Language)] is the language you have to use. This language has its limitations, and is executed very slowly. But nevertheless it works and it gets the job done. 

OpenSim today supports LSL,OSL and C# scripts. But with limitations:
* Not all commands and events have been implemented. See [[LSL Status | LSL/OSSL Status]] for details on what commands work and which don't.
* The OpenSim script engine compiles the LSL code down to .Net code that is JIT'ed to CPU native code. In effect this means that a LSL script in OpenSim should run faster than in Second Life. Stability and security: see [[Script_Sandbox | Script Execution Sandbox]].

==How to use scripts in OpenSim==
Have a look at the [http://wiki.secondlife.com/wiki/LSL_Portal LSL wiki] to learn LSL. The current procedure to get a script working in OpenSim is:
* Create a new script in inventory. (Inventory -> Create -> New Script)
* Write whatever script you want there, or copy the script contents of another script in the pre-existing OpenSim library. Check [[LSL Status]] for what commands that are supported.
* Drag the script over to the contents of an object.
* If there is an error in the script when saving or when dropped into an object an error alert is displayed for a short time. Click on the alert to display the Debug Window and the script error.
* To deactivate a script, edit the script and uncheck 'Running'. This also stops error alerts when saving scripts.
* Deleting the script from the object will not always deactivate a script. If a script is running in a prim and the script is deleted, the script may persist in the prim - which can be useful. Be sure scripts are not running when you wish to delete them.

There are still some defects:
* Line numbers in error messages may miss by 1 or 2 lines.

== How to contribute ==
The ScriptEngine is being developed by many developers. New developers are always welcome. If you want to contribute, even just a tiny little bit, have a look at the [[OpenSim.Region.ScriptEngine]] page. There is a lot of developer activity on IRC ([[Support]]), feel free to drop in.

== Additional Resources for Scripting (LSL)==
There have been many questions regarding scripts and tools for scripting lately. Presented here are a variety of Links to Resources which will help most people with Scripting LSL.

'''OspenSimulator Specific Materials:'''

* [[LSL_Status|LSL/OSSL Status]]

'''NOTE:''' Be sure to check the Discussion Pages which is on the tabs at the top.

'''Suggested Links for LSL wikis:'''

* [http://wiki.secondlife.com/wiki/LSL_Portal wiki.secondlife.com]

* [http://www.lslwiki.net/lslwiki/wakka.php?wakka=HomePage lslwiki.net]

* [http://rpgstats.com/wiki/index.php?title=Main_Page rpgstats.com]

* [http://www.lsleditor.org/ LSLeditor]

* [http://www.cheesefactory.us/slwm/LSL_Portal.html cheesefactory.us]

Note the Tutorials, Examples & Script Libraries

'''Off-World Local LSL Editing Tools (note they do not support osFunctions)'''

''LSL EDITOR''
* [http://sourceforge.net/projects/lsleditor/ LSLeditor SourceForge]
* [http://www.lsleditor.org/ Original Author's website with his latest LSLeditor version]
Now an Open Source project. New release is 17th May 2010 (Ver.2.4). A valuable tool and easy install.

''LSL Plus''
* [http://lslplus.sourceforge.net/ LSLplus]
Open source. Regualar updates. Not quite as quick to get installed as LSLEditor, but very good tool.

Others are listed here: http://wiki.secondlife.com/wiki/LSL_Alternate_Editors

'''Miscelaneous:'''

* [http://www.hilarymason.com/blog/secondlife/autoscript-creates-lsl-scripts-without-code/ AutoScript, Simple & Quick Code generator for simple things (ONLINE)]

* [http://code.google.com/p/lslsnippets/ lslsnippets ]

* [http://www.vtoreality.com/2006/free-offsite-storage-for-lsl-scripts-up-to-250k/186/ Free offsite storage for LSL scripts up to 250k ]

* [http://www.freeslscripts.gendersquare.org/index.php Free SL Scripts (library)]

* [http://s4sl.blogspot.com/ Scratch for SecondLife (Script Code generator with Nice Interface - UPDATED JUL.09.2009)]

* [http://www.peregrinesalon.com/2009/01/05/major-upgrade-to-animated-gif-to-animated-sl-texture-conversion-tool-v04/ Second Life Animated Texture Creator v0.4 - brought to you by Peregrine Salon]

== Additional Resources for Scripting (OSSL)==
There have been many questions regarding scripts and tools for scripting lately. Presented here are a variety of Links to Resources which will help most people with Scripting OSSL.
* [[OSSL_Implemented | OSSL Functions with examples]]

[[Category:Development]]
[[Category:Users]]
[[Category:Scripting]]

[http://www.resumesplanet.com resume writing service]

Security vulnerability brought by non-check inventory service

2010-07-31T15:42:39Z

Waexu66:

__NOTOC__
{{Template:Quicklinks}}
 

== Problem ==

With the following conditions, one can simply take over the full control(CRUD) of other user's inventory.
# InventoryServer is exposed to the public.
# user's UUID is given

Simply describe in the following figure:
*InventoryServer is a normal http server, the normal way to use it is:
**user get the authentication from UserServer
**user control its inventory through RegionServer
*But since the InventoryServer accepts any request without check if the user is authenticated, or, even it does not check if the request is from a RegionServer.
*So, if you know other users' UUID, you can send CRUD http requests directly to the InventoryServer without login.

[[Image:secure_inventory_1.PNG]]

And [[Avatar_portability_version_2|AvatarPortability]] needs a public inventory server,
so we have to make a secure one.

== Solution ==

* every inventory operation packet contains a "session_id" field, but it is never used.
* so, a secure inventory service could be like this
[[Image:secure_inventory_2.PNG]]
* "session_id" is a important information, that is(should be) only transfered in a login session.
**"expect_user" transfer "session_id" from UserServer to RegionServer only when the authentication is OK, so "expect_user" is safe.
**method, such like "get_agent_by_uuid" is very dangerous.

== Configuration ==

=== RegionServer side ===
* in OpenSim.ini, [Network] section,
inventory_server_url = http://127.0.0.1:8004
'''secure_inventory_server''' = true / false
* if the inventory server specified by "inventory_server_url" is a "secure" inventory server, set "secure_inventory_server = true". Then, inventory requests from the region server will have the user's session_id attached
* else, set "secure_inventory_server = false". In this case, session_id is not attached to inventory requests.
** Setting secure_inventory_server to false is only useful when you want your region server to connect to an '''old inventory server''' which does not expect a session_id.

=== InventoryServer side ===
* in InventoryServer_Config.xml,
'''session_lookup''' = true / false
(* for session_lookup please also refer the picture above)
* if you want the inventory server to validate each incoming inventory request by session_id, set session_lookup = true
* else, set session_lookup = false
** Setting session_lookup to false makes inventory server accept any request from any client.

=== *NOTE* ===
* Regardless of whether '''session_lookup''' is true or false, '''new inventory server''' requires a session_id in every inventory request. If you want your region server to connect to a '''new inventory server''', you should always set '''secure_inventory_server = true''' in OpenSim.ini.
** Here '''new inventory server''' means inventory server after SVN revision 5600.

[http://www.resumesplanet.com resume writing service]

LSL Status/Functions/V

2010-07-31T10:55:57Z

Waexu66:

This page lists all the LSL functions starting with an V
----

{| class="wikitable sortable" border="1" cellpadding="5" cellspacing="0" align="center"

|- style="font-size:12pt"
| width="20%" align="center" valign="bottom" | Function
| width="10%" align="center" valign="bottom" | Implemented
| width="10%" align="center" valign="bottom" | Developer
| width="10%" align="center" valign="bottom" | Tester
| width="20%" align="center" valign="bottom" | Comments
| width="15%" align="center" valign="bottom" | DNE status
| width="15%" align="center" valign="bottom" | XEngine status

|- style="font-size:8pt"
|style="background-color:#99CC00" height="13" valign="bottom" | [http://www.lslwiki.net/lslwiki/wakka.php?wakka=llVecNorm llVecNorm ]
| align="center" valign="bottom" | Yes
| align="center" valign="bottom" |
| align="center" valign="bottom" | [[CharlieO]]
| align="center" valign="bottom" | (2688)
| align="center" valign="bottom" |
| align="center" valign="bottom" | Yes

|- style="font-size:8pt"
| style="background-color:#FFFF99" height="13" valign="bottom" | [http://www.lslwiki.net/lslwiki/wakka.php?wakka=llVolumeDetect llVolumeDetect ]
| align="center" valign="bottom" | Yes
| align="center" valign="bottom" | Gerhard
| align="center" valign="bottom" |
| align="center" valign="bottom" | Implementation needs ODE to work, other physics engine only have a stub for this. Persitance of this feature (survive region restart) only implemented for SQLite. Semantics are slightly different to SL (switching off phantom via GUI also resets VolDet-status to off)
| align="center" valign="bottom" |
| align="center" valign="bottom" | Yes

|}

[http://www.resumesplanet.com resume writing]

OsNpcMoveTo

2010-07-31T10:34:08Z

Waexu66:

'''Function Syntax:''' osNpcMoveTo(key npc, vector position); '''Returns:''' NULL

Example Required !
[http://www.resumesplanet.com resume writing services]

Linux Gridserver

2010-07-31T10:33:50Z

Waexu66:

__NOTOC__
{{Template:Quicklinks}}
 

This tutorial is a step-by-step procedure on how to create a production environment on a Linux-server. It's by no means perfect, so if you have ideas to improve it, please let them hear on the discussion page.

[[image:Moo.jpg|250px|thumb|Moo Menu]]

==Required/recommend Software==
* Mono 1.9.1 - .NET framework
* MySQL - Main database engine
* OpenSSH - Remote terminal connection
* RSync - Remote backup tool
* Ngircd - Easy and fast IRC-server
* SVN - If you want to use the SVN-backup module
* Screen - Multiple terminal-sessions
* Dialog - For Moo menu
* Openjpeg - Required for jp2-texture converter
* Redux - Easy to use Webinterface for OpenSim

==Setup a Grid==
* Download the Moo script from console as root in somedir (e.g. ~/source/moo) The user for the SVN is anonymous and the password is left blank.
svn checkout http://forge.opensimulator.org/svn/moo/trunk .
* Start the Moo-installer
./moo install
Moo: Install OpenSimulator in /opt/opensim? (y/n) <=y
This will install the latest svn along with the "right" directory structures in /opt/opensim
Next thing you see something like:
Moo: Ok, we need some basic config-files. Renaming...
Moo: Take a sip of coffee. This part might be important.
Moo: I will try to create a database based on the information you provide.
Moo: Now edit mysql_connection.ini, so MySQL can do it's thing...

Press any key to continue
If you don't know the vi-editor, please read up a bit about that before editing or you may become frustrated with it :-)
So, change database, username and password to reflect your MySQL settings. Save the file now, and quit the editor. After this you'll
notice you end up in yet another config-file. This is OpenSim.ini...

There are alot of settings you can tweak, but for now I'll stick with the most basic settings to start a grid.
* Set gridmode to true
* Disable current storage_plugin and storage_connection_string (disabling by putting ';' at the start of the line)
* Enably mysql storage_plugin and storage_connection_string (and enter the right db-info into the connection string)
* Change asset_database to "grid"
* Set serverside_object_permissions to true
* Set meshing to Meshmerizer
* Set physics to OpenDynamicsEngine
* Save and exit
The administrator menu will now autostart.
* Select services menu > Start UGAIM Services
When it says done, press exit
* Select User-Service
USER SERVER: Default Startup Message [Welcome to OGS]: Welcome to my gridservices
USER SERVER: Default Grid Server URI [http://127.0.0.1:8001/]: <enter>
USER SERVER: Key to send to grid server [null]: <enter>
USER SERVER: Key to expect from grid server [null]: <enter>
USER SERVER: Default Inventory Server URI [http://127.0.0.1:8004/]: <enter>
USER SERVER: DLL for database provider [OpenSim.Data.MySQL.dll]: <enter>
USER SERVER: Connection String for Database []:
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw;
USER SERVER: Http Listener port [8002]: <enter>
USER SERVER: Use SSL? true/false [False]: <enter>
USER SERVER: Known good region X [1000]: <enter>
USER SERVER: Known good region Y [1000]: <enter>
User-Service setup is now completed, and the User-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

* Select Grid-service
GRID SERVER: OGS Grid Owner [OGS development team]: My development team
GRID SERVER: Default Asset Server URI [http://127.0.0.1:8003/]: <enter>
GRID SERVER: Key to send to asset server [null]: <enter>
GRID SERVER: Key to expect from asset server [null]: <enter>
GRID SERVER: Default User Server URI [http://127.0.0.1:8002/] <enter>
GRID SERVER: Key to send to user server [null]: <enter>
GRID SERVER: Key to expect from user server [null]: <enter>
GRID SERVER: Key to send to a simulator [null]: <enter>
GRID SERVER: Key to expect from a simulator [null]: <enter>
GRID SERVER: DLL for database provider [OpenSim.Data.MySQL.dll]: <enter>
GRID SERVER: Database connect string []:
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw;
GRID SERVER: Http Listener port [8001]: <enter>
Grid-Service setup is now completed, and the Grid-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

* Select Asset-service
ASSET SERVER: Default Startup Message [Welcome to OGS]: Welcome to my gridservices
ASSET SERVER: DLL for database provider [OpenSim.Data.MySQL.dll]: <enter>
ASSET SERVER: Database connection string []:
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw;
ASSET SERVER: Http Listener port [8003]: <enter>
Asset-Service setup is now completed, and the Asset-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

* Select Inventory-service
INVENTORY: Default Startup Message [Welcome to OGS]: Welcome to my gridservices
INVENTORY: Default User Server URI [http://127.0.0.1:8002]: <enter>
INVENTORY: Key to send to user server [null]: <enter>
INVENTORY: Key to expect from user server [null]: <enter>
INVENTORY: DLL for database provider [OpenSim.Data.SQLite.dll]:
OpenSim.Data.MySQL.dll
INVENTORY: Database Connect String []:
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw;
INVENTORY: Http Listener port [8004]: <enter>
Inventory-Service setup is now completed, and the Inventory-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

* Select Messaging-service
MESSAGING SERVER: Default User Server URI [http://127.0.0.1:8002/]: <enter>
MESSAGING SERVER: Key to send to user server [null]: <enter>
MESSAGING SERVER: Key to expect from user server [null]: <enter>
MESSAGING SERVER: Key to expect from user server [null]: <enter>
MESSAGING SERVER: Key to send to grid server [null]: <enter>
MESSAGING SERVER: Key to expect from grid server [null]:
MESSAGING SERVER: Connection String for Database []:
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw;
MESSAGING SERVER: DLL for database provider [OpenSim.Data.MySQL.dll]: <enter>
Data Source=localhost;Database=opensim;User ID=dbuser;Password=dbpw; <
MESSAGING SERVER: DLL for comms provider [OpenSim.Region.Communications.OGS1.dll]: <enter>
MESSAGING SERVER: Http Listener port [8006]: <enter>
MESSAGING SERVER: Use SSL? true/false [False]: <enter>
MESSAGING SERVER: My Published IP Address [127.0.0.1]:
82.73.39.53 (WAN-IP)
Messaging-Service setup is now completed, and the Messaging-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

You have succesfully setup UGAIM-Services. If we want to enable both connections from the inside, and from the outside, we must reroute some traffic.
* Select Environment menu > System menu > Fix IP-Routing

Now that's out of the way, all we need now is to connect a Region-Service to the UGAIM.
* Select Services > Start Region Service, and press exit after "done" appears
* Select Region-service
Because the region service is new, it will try to create a default region. This will be your first region.
DEFAULT REGION CONFIG: Region Name [OpenSim Test]: My Home Island
DEFAULT REGION CONFIG: Grid Location (X Axis) [1000]: <enter>
DEFAULT REGION CONFIG: Grid Location (Y Axis) [1000]: <enter>
DEFAULT REGION CONFIG: Internal IP Address for incoming UDP client connections [0.0.0.0]:
192.168.2.101 <LAN-IP>
REGION CONFIG #1: Internal IP Port for incoming UDP client connections [9000]: <enter>
REGION CONFIG #1: External Host Name [127.0.0.1]:
82.73.39.53 <WAN-IP, in case you want both LAN and WAN connections. Otherwise enter LAN-IP>
REGION CONFIG #1: First Name of Master Avatar [Test]:
John
REGION CONFIG #1: Last Name of Master Avatar [User]:
Doe
REGION CONFIG #1: (Sandbox Mode Only)Password for Master Avatar account [test]:
MySandboxpw
Region-Service setup is now completed, and the Region-service should run fine now. Press ctrl-a + d to return to the Moo-menu.

From here, you should be able to connect the SL-Viewer to your new Grid. Try:
'/path/to/secondlife' --grid http://192.168.2.101:8002

[http://www.resumesplanet.com resume writing services]

OsNpcMoveTo

2010-07-30T14:11:30Z

Waexu66:

'''Function Syntax:''' osNpcMoveTo(key npc, vector position); '''Returns:''' NULL

Example Required !
[http://www.resumesplanet.com resume help]