Supported Assemblers¶
Regenerator 2000 exports ready-to-assemble source code for four 6502 assemblers—and can verify byte-for-byte parity against your original binary automatically.
| Assembler | Build Command | Notes |
|---|---|---|
| 64tass | 64tass -o output.prg input.asm |
Supports scopes (.block) and .encode directives |
| ACME | acme -f cbm -o output.prg input.asm |
-f cbm prepends the 2-byte PRG load address |
| KickAssembler | java -jar kickass.jar input.asm |
Requires JRE; set KICKASS_JAR for --verify |
| ca65 (cc65) | cl65 -t c64 -C c64-asm.cfg -o output.prg input.asm |
Custom linker .cfg needed if origin ≠ $0801 |
Per-Assembler Setup¶
64tass is a multi-pass optimizing macro assembler for the 65xx family (homepage).
-o: Output.prgfile path.
ACME is a fast cross-assembler targeting 6502, 6510, and 65816 (homepage).
-f cbm: Emits CBM.prgformat (including the 2-byte load header).-o: Output.prgfile path.
KickAssembler is a Java-based 6502 assembler with built-in scripting (homepage).
KickAssembler outputs a .prg file automatically.
ca65 ships with the cc65 suite (homepage). Assemble and link Regenerator 2000's single-file output with cl65:
If your program's origin is $0801, cc65's stock c64-asm.cfg works directly; for any other origin, copy it and adjust STARTADDRESS (see the ld65 docs).
Default c64-asm.cfg Linker Config
FEATURES {
STARTADDRESS: default = $0801; # (1)!
}
SYMBOLS {
__LOADADDR__: type = import;
}
MEMORY {
ZP: file = "", start = $0002, size = $00FE, define = yes;
LOADADDR: file = %O, start = %S - 2, size = $0002; # (2)!
MAIN: file = %O, start = %S, size = $D000 - %S;
}
SEGMENTS {
ZEROPAGE: load = ZP, type = zp, optional = yes;
LOADADDR: load = LOADADDR, type = ro;
EXEHDR: load = MAIN, type = ro, optional = yes;
CODE: load = MAIN, type = rw;
RODATA: load = MAIN, type = ro, optional = yes;
DATA: load = MAIN, type = rw, optional = yes;
BSS: load = MAIN, type = bss, optional = yes, define = yes;
}
- Change
$0801(or pass--start-addr) if your binary loads elsewhere. - Reserves the 2-byte
.prgload-address header immediately beforeMAIN.
Assembler Syntax Comparison¶
Fill Directives¶
Contiguous runs of identical bytes meeting the Fill run threshold in Document Settings emit fill directives:
| Assembler | Directive | Example (10 zero bytes) |
|---|---|---|
| 64tass | .fill |
.fill 10, $00 |
| ACME | !fill |
!fill 10, $00 |
| ca65 | .res |
.res 10, $00 |
| KickAssembler | .fill |
.fill 10, $00 |
Scope Directives¶
Scopes isolate local label names inside subroutines (see Block Types — Scopes):
| Assembler | Start Directive | End Directive | Notes |
|---|---|---|---|
| 64tass | .block |
.bend |
Scope label precedes .block |
| ACME | — | — | Not supported (omitted on export) |
| ca65 | .proc |
.endproc |
Unnamed scopes default to unnamed_scope |
| KickAssembler | { |
} |
Scope label precedes { |
Verifying Exports (--verify)¶
Run roundtrip verification to export your .regen2000proj to every installed assembler, reassemble each file, and verify byte-for-byte parity with the original binary:
(Enables --headless automatically. Any assembler missing from PATH—64tass, acme, cl65, or KICKASS_JAR—is skipped cleanly as long as at least one assembler runs.)