grandMA3Plugin Starter

Write grandMA3 plugins in TypeScript — with full IntelliSense, typed MA3 API, and a one-command path from .ts to importable .lua + .xml

Get Started

View on GitHub

dist/plugin.lua

lua

local sequences = ObjectList("Sequence 1 thru 10")

local i = 0
while i < #sequences do
    local seq = sequences[i + 1]
    if seq:GetClass() == "Sequence" then
        Printf(seq.name .. ": " .. tostring(seq.autoStart))
    end
    i = i + 1
end

src/plugin.ts

import { is
 } from 'grandma3-toolkit';

const sequences
 = ObjectList
('Sequence 1 thru 10');

sequences
.forEach
((seq
) => {
	if (seq
 && is
.Sequence
(seq
)) {
		Printf
(`${seq
.name
}: ${seq
.autoStart
}`);
	}
});

TypeScript end-to-end

Write plugin logic against typed MA3 API (grandMA3-types), get autocomplete and inline errors in your editor, compile to Lua with TypeScriptToLua.

One-command builds

`npm run build` produces a ready-to-import .lua + .xml pair. No glue scripts to maintain.

Release pipeline included

Tag a `v*` release and a GitHub Actions workflow ships a draft Release with the packaged zip.