ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

LSL

by Makopo ST2/ST3

Syntax definitions for LSL(Linden Scripting Language) in Second Life and OSSL(OpenSimulator Scripting Language) in OpenSimulator.

Details

Installs

  • Total 2K
  • Win 1K
  • OS X 267
  • Linux 216
Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8
Windows 0 1 2 1 0 2 0 1 1 1 1 2 0 1 1 2 1 1 1 5 0 2 0 1 2 2 1 0 2 0 0 0 1 3 0 1 0 0 0 1 0 1 1 2 1 1
OS X 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 1 0 1 0 0 0 0 0 1 0 0 0 0 0 0 0 1 0 0 0 0 0
Linux 0 0 0 0 1 0 0 0 0 0 0 2 0 0 0 1 0 1 0 0 0 0 0 0 1 0 0 0 1 0 0 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

LSL/OSSL Bundle for Sublime Text

Current supported language

  • LSL [*.lsl]: Second Life 17.08.11.328159
  • OSSL [*.ossl]: OpenSimulator v0.9.0.0-rc2
    • Including mod*, os*, wl*(LightShare) functions

kwdb version 0.0.20171002000

I try to update the keyword list as soon as it is updated by kwdb, however, I sometimes may not be able to do that. Please refrain from requesting maintenance for at least one month after the kwdb have higher version than the version above. If you want to make an urgent request, please poke me via @makopo on Twitter or send an inworld IM to Mako Nozaki.

Features

  • More quick completion of functions & events.
  • Stricter syntax detection - if you miss something, the rest will be colored oddly.
  • You can even use Second Life Viewer styled theme.
  • Compatible with TextMate scoping rules.
  • lslint as build system(F7, CtrlB or CommandB).
  • No Commands, no Macros, no Templates …

Syntax Indentation

See LSL Style Guide for coding samples. (method one = K&R Style, method two = Allman style)

Installation

This bundle is designed to work with the latest version of Sublime Text 2.

v1.3.2 or later will work with Sublime Text 3 as well.

Using Sublime Package Control

The easiest way to install this is via Package Control.

  • If you just went and installed Package Control, you probably need to restart Sublime Text before doing this next bit.
  • Bring up the Command Palette (CommandShiftP on OS X, CtrlShiftP on Linux/Windows).
  • Select “Package Control: Install Package” (it'll take a few seconds)
  • Type and select “LSL” when the list appears.

Package Control will automatically keep LSL/OSSL Bundle up to date with the latest version.

Using Git

Alternatively, if you are a git user, you can install the plugin and keep up to date by cloning the repo directly into your Packages directory in the Sublime Text application settings area.

You can locate your Sublime Text Packages directory by using the menu item Preferences -> Browse Packages....

While inside the Packages directory, clone the plugin repository using the command below:

git clone https://github.com/Makopo/sublime-text-lsl LSL

Download Manually

  • Download the files using the GitHub *.zip and *.tar.gz download options.
  • Unzip the files and rename the folder to LSL.
  • Copy the folder to your Sublime Text Packages directory.

Additional Features

Second Life Viewer Theme

You can use the bundled theme for only .lsl or .ossl files to the same look-and-feel with inworld editor.

To activate it, use the menu item Preferences -> Package Settings -> LSL/OSSL -> Use Viewer Theme.

The same steps to deactivate it.

Note that you need to have this bundle in “LSL” package directory to use it.

Changing Snippet Insertion Style

You can change insertion style of snippets from default Allman style to K&R style.

To activate it, use the menu item Preferences -> Package Settings -> LSL/OSSL -> K&R Style.

The same steps to deactivate it.

lslint Build System

You can run lslint as LSL/OSSL build system.

lslint is originated by http://w-hat.com.

I added some features on it for use as build command in Sublime Text. https://github.com/Makopo/lslint

Simply hit F7 or CtrlB or CommandB to check the syntax of currently opened lsl/ossl script.

Currently it is not supported for os/mod/wl functions.

If you want to change the key bindings, use “build” command for it in your Default.sublime-keymap. Following example assigns CommandL to lslint.

[
    {
        "keys": ["super+l"],
        "command": "build",
        "context":[
            { "key": "selector", "operator": "equal", "operand": "source.lsl" }
        ]
    },
    {
        "keys": ["super+l"],
        "command": "build",
        "context":[
            { "key": "selector", "operator": "equal", "operand": "source.ossl" }
        ]
    }
]

non-ascii system issue

If you have lsl/ossl script in the path conatins non-ascii (eg. UTF-8) characters, the check may fail.

You might want to avoid placing your scripts in such a path, or if you can't,

You may workaround this issue by inserting a line after line 99 in “Packages/Default/exec.py”.

cmd = [c.encode(sys.getfilesystemencoding()) for c in cmd]

Additionally if your system encoding isn't UTF-8, you may need to modify “Packages/LSL/LSL.sublime-build”.

"windows":
    {
        "encoding": "cp932",
        "cmd": ["$packages\\LSL\\windows\\lslint.exe", "-p", "$file"]
    },

This example above is for Japanese version of Windows. Change the corresponding block(windows/linux/osx) with your environment.

LSL/OSSL sidebar icons

Starting from Sublime Text 3062, you can assign file icons on the sidebar. However, since this plugin is not a theme, I can't provide this feature, instead you can assign your favorite icon to LSL/OSSL entries by yourself.

In short: scope “source.lsl” for LSL and “source.ossl” for OSSL.

  1. Create or fetch a 16x16 image. FYI, you can find SecondLife icons in BitBucket repository.
  2. Rename the image to “file_type_lsl.png”.
  3. You can even add secondary 32x32 image as “file_type_lsl@2x.png”. I don't know how it will be used though.
  4. Create a file “icon_lsl.tmPreferences” with the following contents.
  5. Put the file above and PNG image(s) into your active theme folder.

icon_lsl.tmPreferences: “xml <?xml version="1.0” encoding=“UTF-8”?> <!DOCTYPE plist PUBLIC “-//Apple//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”> scopesource.lslsettingsiconfile_type_lsl

For ossl, put 16x16 "file_type_ossl.png" and "icon_ossl.tmPreferences" with scope "source.ossl" into the theme folder.

## API Reference Tooltip

Starting from Sublime Text 3070, you can look in the API reference by context meny on the keywords.
Due to performance overhead, I created anothe plugin "TooltipLSL". The project is [here](https://github.com/Makopo/sublime-text-tooltip-lsl).

In short, install "TooltipLSL" with Package Control, then place the caret on functions/constants/events before choosing "Show LSL Reference" from the right-click context menu.

## About Keyword Database

This bundle uses [kwdb](https://bitbucket.org/Sei_Lisa/kwdb) as source of its LSL/OSSL funcion/event/constant names. The LSL/OSSL keywords in .tmLanguage and .sublime-completions are automatically generated from the file kwdb.xml within. I have the automation tool in [another project(kwdb_to_sublime)](https://github.com/Makopo/kwdb_to_sublime). Thus, if you find any flaw in the keywords, please first search for the keyword you want to use in `kwdb.xml`. Then compare kwdb version at the top of this readme to that in `kwdb.xml`. If you find mine is way behind of `kwdb.xml`, please be patient or poke me [@makopo](https://www.twitter.com/makopo) on Twitter or send an inworld IM to [Mako Nozaki](https://my.secondlife.com/mako.nozaki).