Scripting Documentation

Revision as of 08:42, 27 July 2009

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English    Deutsch    Français    Русский

Overview

• New Script Engine - New Script Engine Transition (By Melanie_T)
• Scripting Languages - Supported Scripting Languages
• OSSL Proposals - Suggestions for custom OSL-functions
• OSSL Implemented - A list of OSL-functions that are available
• OSSL Texture Drawing Functions - Details of the os texture drawing functions
• LSL Implemented - A list of LSL-functions that are available in OpenSim
• OS Scripting Tutorial - Some useful hints for scripting in OpenSim environments
• 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 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. Linden Lab are moving LSL scripting over to Mono in Q3 2008.

OpenSim today supports LSL,OSL and C# scripts. But with limitations:

• Not all commands and events have been implemented. See LSL Status for details on what commands work and which don't.
• Scripts that are running cannot cross region borders.
• You cannot use loops inside your scripts. Actually you can use loops, but it will block other scripts from executing.

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 Execution Sandbox.

How to use scripts in OpenSim

Have a look at the 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 (Contact us), feel free to drop in. A blog with development status can be found at http://teddmaa.blogspot.com/.

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.

At present there is no WIKI for OSSL Functions of OpenSim Specific stuff like those available for SL, hopefully someday we will have our own but that is a monumental task in itself.

OspenSimulator Specific Materials:

http://opensimulator.org/wiki/OSSL_Implemented

http://opensimulator.org/wiki/LSL_Status/Functions

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

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

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

http://www.cheesefactory.us/slwm/LSL_Portal.html

Note the Tutorials, Examples & Script Libraries

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

LSLeditor http://www.lsleditor.org/ ** My Personal favourite

LSLplus http://lslplus.sourceforge.net/

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

Miscelaneous:

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

lslsnippets http://code.google.com/p/lslsnippets/

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

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

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

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