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

=BB= LSL

LSL for ST3154+ with linting (works with Firestorm preprocessor). Tooltips & completions with your indent style of choice.

Details

Installs

  • Total 1K
  • Win 813
  • OS X 171
  • Linux 83
Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5 Aug 4 Aug 3 Aug 2 Aug 1 Jul 31 Jul 30 Jul 29 Jul 28 Jul 27 Jul 26 Jul 25 Jul 24 Jul 23 Jul 22 Jul 21 Jul 20 Jul 19 Jul 18 Jul 17 Jul 16 Jul 15 Jul 14 Jul 13 Jul 12 Jul 11 Jul 10 Jul 9 Jul 8 Jul 7 Jul 6 Jul 5 Jul 4
Windows 2 0 0 2 2 0 0 1 1 2 3 1 1 0 0 1 5 0 1 0 1 1 2 1 1 1 1 0 0 5 1 1 0 4 1 0 1 0 0 0 1 0 0 1 0
OS X 0 2 0 0 0 0 0 0 1 0 0 0 0 0 1 1 0 0 0 0 0 0 2 0 1 0 2 0 1 1 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 1 1 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

License Requires Sublime Text Build 3154 or later Download the =BB= LSL on Package Control Latest tag

Table of contents


=BB= LSL package for Sublime

Bringing Linden Scripting Language (LSL) support to Sublime Text.

About

With regards to the development of this package, supporting new features of Sublime Text as they become available takes precedence over ensuring backwards compatibility. Therefore this package targets and is tested against the latest Build of Sublime Text, releases are frequent and the requirements for this package will be updated accordingly. Implicitly this might require you to be on the dev release channel and consequently have a valid Sublime Text license.

Requirements

Installation

Make sure your setup meets the requirements before you:

  • open Sublime Text
  • open the command palette
    • via Tools > Command Palette
  • select Package Control: Install Package
  • select =BB= LSL

⚠ To get LSL syntax highlighting in tooltips, refer to the settings section.

Close and re-open Sublime Text.

Usage

To use Sublime Text for editing your script in-world:

  • Enable: Me > Preferences > Advanced > Show Advanced menu
  • Go to: Advanced > Show Debug Settings
  • Edit: ExternalEditor

Setting consists of these three parts:

  • Path to editor (use quotes if path has spaces)
  • Optional command line params
  • "%s" will paste script path automatically (do NOT change this)

For a list of Sublime arguments run subl --help and/or refer to the OSX Command Line documentation.

Example for Windows:

"C:\Program Files\Sublime Text 3\subl.exe" "%s"

When editing scripts in the viewer, click the EDIT button in the script edit window. Save and close view (tab) when done.

Building

runs lslint only, not lslint in combination with mcpp

  • Select Tools > Build on Linux or macOS.
  • Select Tools > Build with … on Windows and select a binary to use.

Output to a Build results panel, in which you can double click (possible) errors to move the cursor to that point in your file.

⚠ To debug LSL scripts that make use of the Firestorm preprocessor, please use the linting functionality of this package.

Color Scheme

Sublime Text 3 Color Scheme documentation

Requires Sublime Text Build 3149 or later

You can toggle using the official Color Scheme for LSL files by selecting Preferences > Package Settings > =BB= LSL > Settings > Use official color scheme for LSL files from the main menu.

The color scheme file can be overridden via Packages/User/LSL.hidden-color-scheme.

Contributing

The issue tracker can be found at https://github.com/buildersbrewery/sublime-lsl/issues.

Please read CONTRIBUTING.md and make sure tests pass before sending a pull request.

Linting

Requires the SublimeLinter package, uses the included binaries lslint and mcpp if not found in PATH and some code from XenHat/SublimeLinter-contrib-lslint.

Linting also works for LSL files that use the Firestorm preprocessor.

SublimeLinter with lslint

Indent styles

Require Sublime Text Build 3154 or later

LSL Indent Styles

You can change the indent style of all LSL completions and snippets to:

  • Allman
  • GNU
  • Horstmann
  • K & R
  • Lisp
  • Pico
  • Ratliff
  • or Whitesmiths

by:

  • selecting Preferences > Package Settings > =BB= LSL > Settings > Choose indent style from the main menu
  • or selecting Preferences: LSL: Settings - Indent Style in the command palette

Settings

Sublime Text 3 Settings documentation

Open Preferences > Settings from the main menu.

These mdpopups.* settings are needed to get LSL syntax highlighting in tooltips:

//  "Packages/User/Preferences.sublime-settings"

{
    "mdpopups.sublime_user_lang_map":
    {
        "lsl":
        [
            [ "lsl" ],
            [ "=BB= LSL/.sublime/syntaxes/LSL" ]
        ]
    },
    "mdpopups.use_sublime_highlighter": true
}

Tooltips

Require Sublime Text Build 3124 or later

LSL Tooltips

⚠ To get LSL syntax highlighting in tooltips, refer to the settings section.

Disclaimer

Second Life® and the Linden Scripting Language are trademarks of Linden Research, Inc.

The Builder's Brewery is neither affiliated with nor sponsored by Linden Research.