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

Starbound Lua

by UnknownX7 ST2/ST3

Syntax highlighter and autocompletions for the Starbound Lua API

Details

Installs

  • Total 512
  • Win 369
  • OS X 110
  • Linux 33
Jun 24 Jun 23 Jun 22 Jun 21 Jun 20 Jun 19 Jun 18 Jun 17 Jun 16 Jun 15 Jun 14 Jun 13 Jun 12 Jun 11 Jun 10 Jun 9 Jun 8 Jun 7 Jun 6 Jun 5 Jun 4 Jun 3 Jun 2 Jun 1 May 31 May 30 May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11
Windows 0 1 0 0 0 2 0 0 0 0 0 1 0 1 0 0 0 0 1 2 0 0 1 1 0 0 1 0 1 0 0 0 0 0 0 0 1 0 0 0 0 1 0 1 0
OS X 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Starbound Lua

This plugin enables syntax highlighting and autocompletion for Starbound Lua in Sublime Text 2 or Sublime Text 3. (Sublime Text 3 is HIGHLY recommended!)

To install this, it is recommended that you use Package Control to automatically receive the latest updates and make the entire process much simpler. This will ensure that you do not need to check this page for updates every time an update is released for Starbound as the API is constantly changing and being added to.

Package Control Installation:

  1. Open Sublime Text and press Shift+Ctrl+P.
  2. Type install and press enter.
  3. Another text box should appear, type Starbound and you should see this plugin highlighted. Press Enter to install it.

Sublime Text 3 (and possibly 2)

  1. Once you have it installed you may need to disable the default Lua syntax (Sublime will probably try to suggest functions from default Lua). Press Shift+Ctrl+P again.
  2. Type disable and press enter.
  3. Type lua and press enter.

Manual Installation:

  1. Download this Git Repository's master branch as a .zip file. (Or you can download the latest release.)
  2. Navigate to Preferences > Browse Packages....
  3. Put the folder from the .zip into the location that was opened.
  4. Restart Sublime.

Sublime Text 3 (and possibly 2)

  1. Once you have it installed you may need to disable the default Lua syntax (Sublime will probably try to suggest functions from default Lua). Navigate to Preferences > Settings - User.
  2. Add the following text:
{
    "ignored_packages":
    [
        "Vintage",
        "Lua"
    ]
}

Usage

Navigate to View > Syntax > Starbound Lua to apply the syntax to the current file and any newly opened files.

There are also custom templates for groups of specific lua hooks with documentation available. To use them, type TEMPLATE and use the arrow keys to select the correct template for your .lua file, then press Tab or Enter. These are intended for blank files and will immediately paste all known lua hooks for the selected category. You may press Tab again multiple times to highlight a predetermined order of text blocks for ease of editing. Moving your text cursor outside of the range of one of these text blocks will end the use of Tab selecting for all code snippets. These snippets will use hook information from the developers when available. Otherwise it is information gathered by trial and error.

If you have other custom Lua syntaxes…

If their scope is not correctly set, their functions and snippets will be suggested too. You can also disable them by doing the same steps above that you may have used for the default Lua syntax. (This syntax should never interfere with any other syntax. Please report it to me if it does.)

Suggestions

Open an issue if you would like to suggest anything. Or you can find me on the #starbound and ##starbound-modding IRC channels as UnknownX. (or the forums)

Nightly Branch

This branch is no longer needed and has been discontinued. This branch is for upcoming changes to the Lua API. This will not be merged with the master branch until a stable update is released and changes are verified.