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

Starbound Lua

by UnknownX7 ALL

Syntax highlighter and autocompletions for the Starbound Lua API

Labels language syntax

Details

Installs

  • Total 836
  • Win 622
  • Mac 154
  • Linux 60
Jan 21 Jan 20 Jan 19 Jan 18 Jan 17 Jan 16 Jan 15 Jan 14 Jan 13 Jan 12 Jan 11 Jan 10 Jan 9 Jan 8 Jan 7 Jan 6 Jan 5 Jan 4 Jan 3 Jan 2 Jan 1 Dec 31 Dec 30 Dec 29 Dec 28 Dec 27 Dec 26 Dec 25 Dec 24 Dec 23 Dec 22 Dec 21 Dec 20 Dec 19 Dec 18 Dec 17 Dec 16 Dec 15 Dec 14 Dec 13 Dec 12 Dec 11 Dec 10 Dec 9 Dec 8
Windows 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 0 0 0 0
Mac 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 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.