Getting Started

About this guide

This guide uses the following notations to distinguish certain items:

Notation	Meaning
Main Menu | Sub Menu | Menu Item	Menu item/Action
Settings | Settings Page	Page in Settings dialog
monospaced text	Assembly code or filename
F10	Keyboard shortcut or input

Installation

Latest GA release: Open the Plugin Homepage and click the Install to… button on the upper right.

See Changelog for the full changelog.

Snapshot build artifacts (m68kplugin-x.y.z.zip) for manual installation are available via GitHub CI.

🧐 Not familiar with IntelliJ-based IDEs? See IntelliJ IDEA - Getting Started.

Project Setup

There is no dedicated support for configuring or creating a specific variant for M68k projects.

All sources and include files must be located in the same project to be resolved.

By default, all files with extension .s, .asm, .i, .inc, and .x68 are treated as M68k assembly sources. See Motorola 68000 Assembler entry in Settings | Editor | File Types to customize.

On initial opening of existing sources, or when many source files are changed, the IDE will analyze relevant files to track all information. It should usually not take a noticeable amount of time, during which some functionality (e.g., resolving/navigation) is not fully available.

Building

vasm executable can easily be invoked via External Tools and mapped to a keyboard shortcut for convenience. Warning/error messages in the console provide navigation links to the file:lineNumber or label name source (see IDE).

Alternatively, any supported build system can be used, e.g., Makefile.