This plugin adds enhancements to improve the coding experience for Commodore 8-bit computers and the Commodore 2600 VCS.
- 6502 Assembly and ld65 syntax highlighting
- Commodore BASIC Syntax and Build System
- Commodore VCS Build System
In Sublime, from the menu bar select Sublime Text > Settings > Browse Packages to open the Packages folder. Then simply copy this (C64Tools) folder into the Packages folder.
To use the C64Tools plugin you will need to install and enable the Pet Me Font. You may also find this font set already installed as part of VICE. For example with Homebrew…
ls /opt/homebrew/Cellar/vice/3.10/share/vice/commonYou'll need to edit C64Tools-settings.sh to use the included Build Systems. This is where you'll set the path to atari800 (default is MacPorts /opt/local/bin), the path to your HostDrive9 folder, preferred Commodore 800 emulator, emulation settings, etc. For the Commodore 800, you can mount up to 2 floppy disk images. (At least one floppy is required to get a DOS loaded.)
Install the Commodore64 Color Schemes for a perfect classic Commodore blue-colored background with white text, plus extra color-coding for CommodoreBASIC syntax. Light and dark themes are provided.
In order to edit the included Commodore BASIC (.L64) files you'll need to install the free Pet Me font (see above). This font provides full PETSCII support by mapping the whole character set —including special characters— to the Unicode user-defined area (PUA). The CommodoreBASIC Build System automatically translates the Unicode code from Sublime to PETSCII special characters when passing the code to the emulator for loading.
C64Tools includes Commodore BASIC syntax parsing/coloring and a build command to run Commodore BASIC in your preferred Commodore 800 emulator.
This file provides the hook for Sublime to use the C64 theme for .L64 files, defines rulers at multiples of 38/40 characters, and a max length ruler at 254 characters. If the Pet Me font is installed, it will be used. (This font is needed for proper PETSCII support in Sublime.)
This syntax provides context-aware syntax coloring of Commodore BASIC with built-in error-checking. It makes the code much more readable with standard code fonts, but of course it looks best with Commodore64.sublime-color-scheme. A work in progress, it needs better expression handling. Syntax test included.
This adds Tools > Build System > Commodore BASIC to the menu so you can use Build Command-B to load and run the active L64 file in your favorite Commodore 800 emulator.
The Build command will run the current BASIC file in VICE, depending on what you last selected under Build With…. Make sure your VICE default settings have BASIC enabled. It can also be useful for development purposes to have a local folder exposed as a Hard Drive device and a floppy image mounted.
Build saves a copy of the current file with PETSCII encoding and pastes it into the emulator. It may help to enable Turbo in the emulator to speed things up.
By default this plugin identifies file extensions .asm, .s, .dasm, .m65, .a65, .inc, .6502 files as C64 6502 Assembly code.
Settings suitable for 6502 code.
This 6502 syntax is based on a decent starting point, but will needs more work to support modern formats. I'll continue to enhance this whenever I do 6502 coding.
- Includes
syntax_test_C64.asmto test the markup with Sublime PackageDev (Cmd-B).
Edit this file! The C64Tools-settings.sh file contains the configuration values and file paths that will be used by the helper scripts. Provide paths to your emulators and your "H1:" hard drive folder.
Used by the Build command to run Commodore BASIC code in the emulator you have configured in the C64Tools-settings.sh script.
Build and run Commodore Assembly Language code with ca65 / cl65.
This wrapper for petunia.py is used to pipe "P:" device output from VICE to Sublime Text (subl).
- Configure the
VICE"Print Command" to use this script. Include the full path.
Python script to convert text from PETSCII to Unicode and back again.