Sublime PICO-8

PICO-8 plugin for the Sublime Text 3 editor.

This package includes:

• .p8 language definition (by Overkill).
• Syntax highlighting (by Overkill).
• PICO-8 .ttf font (by RhythmLynx).
• Cartridge runner to launch your cart right from Sublime Text.
• Code completion based on the official PICO-8 API.
• Code snippets.

Installation

Using Package Control

1. Open the command palette with ctrl+shift+p (cmd+shift+p in OSX).
2. Run Package Control: Install Package command.
3. Search for PICO-8 and install it.
4. Restart Sublime Text.

Using Git

Linux

cd ~/.config/sublime-text-3/Packages
rm -rf PICO-8
git clone https://github.com/Neko250/sublime-PICO-8 PICO-8

OSX

cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
rm -rf PICO-8
git clone https://github.com/Neko250/sublime-PICO-8 PICO-8

Windows

cd "%APPDATA%\Sublime Text 3\Packages"
rd /s /q PICO-8
git clone https://github.com/Neko250/sublime-PICO-8 PICO-8

Manual Installation

1. Download the files using the GitHub .zip download option.
2. Unzip the files and rename the folder to PICO-8.
3. Find your Packages directory:
   • Linux: ~/.config/sublime-text-3/Packages
   • Mac OS: ~/Library/Application Support/Sublime Text 3/Packages
   • Windows: %APPDATA%\Sublime Text 3\Packages
4. Copy the folder into your Sublime Text Packages directory.

Post Installation

Font Setup

Independently of the installation method you chose, after installing you'll need to setup the PICO-8 font.

1. Open the command palette with ctrl+shift+p (cmd+shift+p in OSX).
2. Run PICO-8: Download Font command.
3. Find PICO-8.ttf in your downloads folder and install it.
4. Restart Sublime Text.

Test different font sizes until you find one that goes well with your screen resolution !

Cartridge Runner Setup

To setup the Cartridge Runner, open the Command Palette in Sublime Text (ctrl+shift+p / cmd+shift+p) and run "PICO-8: Setup PICO-8 Path". Then enter the path to PICO-8 in the prompt input.

1. Open the command palette with ctrl+shift+p (cmd+shift+p in OSX).
2. Run PICO-8: Setup PICO-8 Path command.
3. Type the path to your PICO-8 executable. Defaults to:
   • Linux: /there/is/no/default/in/linux/shrug/pico8
   • OSX: /Applications/PICO-8.app/Contents/MacOS/pico8
   • Windows: C:\\Program Files (x86)\\PICO-8\\pico8.exe

IMPORTANT: Remember using the escape character for the backslash (\\) instead of a single one (\) in Windows !!!

Version History

• v2017.3.14:

  • added: automatically lowercase the file upon saving.
  • added: extcmd function (syntax and autocomplete).
  • added: raspberry pi / pocketchip gpio snippet.
  • added: forpairs block snippet.
  • added: repeat-until block snippet.
  • added: goto block snippet.
  • added: semantic comments inside block snippets.
  • changed: updated api autocompletions to match PICO-8 0.1.10.
  • changed: forin block snippet renamed to forall.
  • fixed: hex number highlighting when not preceded by space.
  • fixed: comment start definition (Toggle Comment from the Command Palette).

• v2016.7.1:

  • added: .no-sublime-package.
  • changed: package is no longer compressed.
  • fixed: cartridge runner is now visible to sublime.

• v2016.6.30:

  • added: command palette download font shortcut: PICO-8: Download Font.
  • added: command palette preferences: Preferences: PICO-8 - Default & Preferences: PICO-8 - User.
  • added: command palette bbs shortcut: PICO-8: Browse BBS.
  • added: command palette API reference shortcut: PICO-8: Browse API Reference.
  • added: highlight_line setting defaults to true.
  • added: menu items to open preferences files: Preferences > Package Settings > PICO-8.
  • changed: version system changed to tagging date.
  • changed: theme's line highlight is now a bit brighter than the background.
  • fixed: setup cartridge runner from the command palette: PICO-8: Setup PICO-8 Path.
  • fixed: run cartridges from the command palette: PICO-8: Run Cartridge.
  • removed: old build system: PICO-8.sublime-build.

• v0.1.8:

  • added: snippet library.
  • added: code completion.
  • changed: changed version to match PICO-8.
  • fixed: completed .tmLanguage functions.

• v0.0.3:

  • removed: .no-sublime-package.

• v0.0.2:

  • added: build system.
  • changed: installation message.
  • changed: font size no longer predefined.
  • changed: caret width no longer predefined.

• v0.0.1:

  • added: installation message.

• v0.0.0:

  • added: .p8 language definition.
  • added: syntax highlighting.
  • added: PICO-8 TrueType font.