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 566
  • Win 415
  • OS X 114
  • Linux 37
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 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9
Windows 0 0 1 0 0 0 1 2 1 0 2 0 1 0 1 1 3 0 0 3 0 1 0 0 0 0 4 0 1 0 2 1 0 2 1 1 0 0 0 0 1 0 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 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0
Linux 1 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.