Disassemblies of BBC Micro Games

TobyLobster · Post by **TobyLobster** » Sun Aug 08, 2021 9:05 pm

Diminished suggested there should be a list of published Beeb game disassemblies. Here's a list of all the ones I know about (including my own). Some can be reassembled too. Any more?

Reassemblies:
* Attack on Alpha Centauri https://github.com/fizgog/Attack-On-Alp ... isassembly
* Adventure Quest viewtopic.php?f=40&t=26239
* Aviator https://aviator.bbcelite.com (and https://github.com/markmoxon/aviator-beebasm)
* Bird Strike https://github.com/iainfm/BirdStrike (See also original sources / reworking: https://github.com/qurm/BirdStrike)
* Boulder Dash https://github.com/TobyLobster/Boulderdash
* Castle Raider https://github.com/dboddie/Castle-Raider
* Chroma http://level7.org.uk/chroma/chroma.asm
* Chuckie Egg https://github.com/mungre/chuckie (See also viewtopic.php?f=1&t=16021)
* Citadel viewtopic.php?t=15819
* Citadel viewtopic.php?p=344318 (original source code)
* Colossal Aventure viewtopic.php?f=40&t=26239
* Crazee Rider (BBC) https://github.com/KevEdwards/CrazeeRiderBBC
* Crazee Rider (Electron) https://github.com/KevEdwards/CrazeeRiderElectron
* Crypt Capers viewtopic.php?p=344318
* Defender - see Planetoid
* DROD https://github.com/hexwab/beebdrod
* Dungeon Adventure viewtopic.php?f=40&t=26239
* Eagle Empire viewtopic.php?p=65477#p65477
* Elite

Web page https://www.bbcelite.com/ (plenty of explanations and deep dives into the disassemblies)
BBC Micro cassette Elite https://github.com/markmoxon/cassette-elite-beebasm
BBC Micro disc Elite https://github.com/markmoxon/disc-elite-beebasm
6502 Second Processor Elite https://github.com/markmoxon/6502sp-elite-beebasm
BBC Master Elite https://github.com/markmoxon/master-elite-beebasm
Acorn Electron Elite https://github.com/markmoxon/electron-elite-beebasm
Elite-A https://github.com/markmoxon/elite-a-beebasm
(See also: Elite for the NES https://github.com/markmoxon/nes-elite-beebasm)

* Elite, see also:

https://github.com/kieranhj/elite-beebasm
http://www.elitehomepage.org/bbc/index.htm (original source code and variants)
http://www.elitehomepage.org/archive/index.htm (original source code and variants)

* Exile https://github.com/tom-seddon/exile_disassembly
* Galactic Hitchhiker https://github.com/ahope1/Galactic-Hitchhiker (See also viewtopic.php?f=65&t=24536)
* Galaforce (BBC) https://github.com/KevEdwards/Galaforce1BBC (See also viewtopic.php?f=1&t=11368, https://github.com/crumbgit/Galaforce)
* Galaforce (Electron) https://github.com/KevEdwards/Galaforce1Electron
* Galafore II https://github.com/KevEdwards/Galaforce2BBC
* Gridrunner https://github.com/fizgog/Gridrunner
* Hard Hat Harry http://www.retrosoftware.co.uk/wiki/ind ... _Hat_Harry
* Hard Hat Harry 2 http://www.retrosoftware.co.uk/wiki/ind ... at_Harry_2
* Helicopter Score Attack https://hackaday.io/project/19168-bbc-m ... ore-attack
* HyperViper http://www.retrosoftware.co.uk/wiki/ind ... HyperViper
* Imogen https://github.com/ZornsLemma/Imogen
* Island of Xaan https://github.com/tautology0/textadven ... obico/xaan (a work in progress, see also notes about it https://tautology.org.uk/blog/2017/11/)
* Jeltron https://web.archive.org/web/20200612141 ... le=Jeltron (Unfinished game)
* Jet Boat https://github.com/ajgbarnes/bbc-micro-jet-boat
* Jet Set Miner http://www.retrosoftware.co.uk/wiki/ind ... ownloads_2
* Jet Set Willy https://github.com/TobyLobster/jsw
* Jet Set Willy 2021 https://github.com/TobyLobster/jsw2021
* Jungle Journey https://github.com/dboddie/Jungle-Journey
* Lady Bug https://github.com/LoveBug2084/LadyBug
* Lode Runner https://github.com/0xC0DE6502/lode-runner-disassembled
* Lords of Time viewtopic.php?f=40&t=26239 and viewtopic.php?f=40&t=24268
* Manic Miner https://github.com/TobyLobster/ManicMiner
* Manic Miner 2021 https://github.com/TobyLobster/ManicMiner2021
* Meteors https://gitlab.riscosopen.org/RiscOS/So ... r/Srce6502
* Mountain Panic https://github.com/dave-f/panic
* Night World https://github.com/ZornsLemma/night-world (BASIC with sprite routines in 6502, See also viewtopic.php?f=1&t=24857)
* Onslaught https://github.com/mattgodbolt/onslaught (Unfinished game)
* Pacman (Tricky) viewtopic.php?p=376718#p376718
* Plan B https://github.com/TobyLobster/planb
* Planet Nubium https://github.com/andrewwaite1?tab=repositories
* Planet Nubium 2 https://github.com/andrewwaite1?tab=repositories
* Planetoid https://github.com/mikroman/planet/tree/Relocatable and https://github.com/r41n60w/planetoid-disasm
* Polymer Picker https://github.com/sassquad/polymer-picker-6502
* Prince of Persia https://github.com/kieranhj/pop-beeb
* Repton https://github.com/ajgbarnes/bbc-micro-repton
* Repton 2 https://github.com/gfoot/repton2disassembly
* Repton 3 viewtopic.php?p=331329#p331329
* Revs

Web Page https://revs.bbcelite.com/
Source https://github.com/markmoxon/revs-beebasm

Part A http://level7.org.uk/miscellany/doctor- ... sembly.txt
Part B http://level7.org.uk/miscellany/doctor- ... sembly.txt
Warlord (modified version for Acorn User) http://level7.org.uk/miscellany/warlord-disassembly.txt

Rick Hanson http://level7.org.uk/miscellany/
Project Thesius http://level7.org.uk/miscellany/
Myorem http://level7.org.uk/miscellany/

* The Sentinel http://www.level7.org.uk/miscellany/
* Siege http://www.8bs.com/submit/subgamedis.htm
* Spellbinder http://www.level7.org.uk/miscellany/
* Sphere of Destiny http://level7.org.uk/miscellany/
* Starquake http://www.level7.org.uk/miscellany/ (see also Reassemblies section above)
* Starship Command http://www.level7.org.uk/miscellany/ (see also Reassemblies section above)
* Stranded https://github.com/tautology0/textadven ... r/Stranded
* Stryker's Run http://level7.org.uk/miscellany/
* Super Invaders http://level7.org.uk/miscellany/
* Swoop http://www.8bs.com/submit/subgamedisswoop.htm
* Syncron http://level7.org.uk/miscellany/
* Twin Kingdom Valley https://github.com/mcnalu/twinkingdomvalley-dasm
* Wizadore http://www.level7.org.uk/miscellany/
* XOR http://www.level7.org.uk/chroma/xor-disassembly.txt
* Zalaga http://www.level7.org.uk/miscellany/

Unpublished Works In Progress:
* Inertia - gfoot viewtopic.php?p=354417#p354417
* Mr. Ee - 0xC0DE viewtopic.php?p=330512#p330512
* Wizzy's Mansion - gfoot viewtopic.php?p=354417#p354417
* Colossal Adventure (Level 9) - cardboardguru viewtopic.php?f=40&t=24776

Archimedes
* Lander https://lander.bbcelite.com/

Disassemblers:
* 6502Bench (SourceGen) https://github.com/fadden/6502bench/ (Windows only)
* bbc-disgo https://github.com/dave-f/bbc-disgo (Go based)
* BBC Disasm https://github.com/chriskillpack/bbcdisasm (Go based)
* BeebDis https://github.com/prime6809/BeebDis (Pascal based)
* DASMFW (DisASseMbler FrameWork) https://github.com/Arakula/dasmfw (C++ based)
* DIS6502 viewtopic.php?f=2&t=20488 (Windows only)
* Ghidra https://ghidra-sre.org/ (Java based)
* Masswerk 6502 Disassembler https://www.masswerk.at/6502/disassembler.html (Web based)
* py8dis viewtopic.php?f=55&t=23335 (Python based)
* WFDis https://www.white-flame.com/wfdis/ (Web based)
* Other 6502 disassemblers: http://6502.org/tools/asm/

Related Tools
* cc652beebasm viewtopic.php?f=12&t=24397 Converts assembly code from cc65 asm to beebasm.
* converttoacme https://github.com/jefflomax/converttoacme Converts assembly code from 2500AD Cross Assembler, Commodore Macro Assembler, or Programmers Development System (PDS) to acme format.
* UEFLoader https://github.com/tautology0/UEFLoader Tool to load a UEF save state (e.g. from BeebEm) into the Ghidra disassembler.

Diminished · Post by **Diminished** » Sun Aug 08, 2021 9:17 pm

Great job on the compilation (and the disassemblies!)

In addition to the above, perhaps people could also mention disassemblies they're currently working on but haven't finished, to try to avoid two people independently working on the same title at the same time?

It would be great to get some more of these in the future.

iainfm · Post by **iainfm** » Sun Aug 08, 2021 9:18 pm

Bird Strike (my re-assemble-able disassembly): https://github.com/iainfm/BirdStrike

Author's original sources and reworking project: https://github.com/qurm/BirdStrike

TobyLobster · Post by **TobyLobster** » Sun Aug 08, 2021 9:25 pm

Thanks Iainfm, how did I miss adding that? I'll update the list as more are mentioned.

kieranhj · Post by **kieranhj** » Sun Aug 08, 2021 10:08 pm

What a great idea! Thanks for putting the list together and keeping it updated. Not original published games but don't forget:

Prince of Perisa: https://github.com/kieranhj/pop-beeb
Stunt Car Racer: https://github.com/kieranhj/scr-beeb

TobyLobster · Post by **TobyLobster** » Sun Aug 08, 2021 10:11 pm

kieranhj wrote: ↑Sun Aug 08, 2021 10:08 pm What a great idea! Thanks for putting the list together and keeping it updated. Not original published games but don't forget:

Thanks - added.

MarkMoxon · Post by **MarkMoxon** » Sun Aug 08, 2021 11:02 pm

Lots of Elite disassemblies and reassemblies here (the first one started out as a fork of Kieran’s excellent repository, which you already have on the list):

BBC Micro cassette Elite
https://github.com/markmoxon/cassette-elite-beebasm

BBC Micro disc Elite
https://github.com/markmoxon/disc-elite-beebasm

6502 Second Processor Elite
https://github.com/markmoxon/6502sp-elite-beebasm

BBC Master Elite
https://github.com/markmoxon/master-elite-beebasm

Acorn Electron Elite
https://github.com/markmoxon/electron-elite-beebasm

Elite-A
https://github.com/markmoxon/elite-a-beebasm

Plus there’s a web version of all the code, with plenty of explanations and deep dives into the disassemblies:
https://www.bbcelite.com/

It’s a great idea to maintain a list! I love a good disassembly.

Mark

TobyLobster · Post by **TobyLobster** » Sun Aug 08, 2021 11:12 pm

MarkMoxon wrote: ↑Sun Aug 08, 2021 11:02 pm Lots of Elite disassemblies and reassemblies

Thanks - added.

0xC0DE · Post by **0xC0DE** » Mon Aug 09, 2021 6:34 am

Thanks for the list. In case you are adding a WIP section: I'm working on a Mr. Ee reassembly.

TobyLobster · Post by **TobyLobster** » Mon Aug 09, 2021 12:28 pm

0xC0DE wrote: ↑Mon Aug 09, 2021 6:34 am Thanks for the list. In case you are adding a WIP section: I'm working on a Mr. Ee reassembly.

Thanks - added.

fizgog · Post by **fizgog** » Mon Aug 16, 2021 1:11 pm

I'm curious, as I've always fancied having a go at this myself.

What software does everyone use to dissemble a game?

jms2 · Post by **jms2** » Mon Aug 16, 2021 1:17 pm

Beebdis - it creates files which can then be fed into BeebAsm to allow you to rebuild the game (allowing you to customise it or otherwise modify it as you see fit).

0xC0DE · Post by **0xC0DE** » Mon Aug 16, 2021 1:32 pm

SourceGen https://github.com/fadden/6502bench/

Diminished · Post by **Diminished** » Mon Aug 16, 2021 2:31 pm

In the past I've used WFDIS, which runs in a browser, although it has some limitations (slow, limited commenting ability, RAM hog, difficulty exporting results, C64-centric).

jms2 · Post by **jms2** » Mon Aug 16, 2021 3:33 pm

0xC0DE wrote: ↑Mon Aug 16, 2021 1:32 pm SourceGen https://github.com/fadden/6502bench/

Wow, that looks good! I assume that the apparent absence of a BBC micro "mode" isn't a problem? Or does it have one now?

Definitely looks worth further investigation anyway.

0xC0DE · Post by **0xC0DE** » Mon Aug 16, 2021 3:50 pm

I am throwing a little Python at the output generated by SourceGen to make BeebAsm compatible source

fizgog · Post by **fizgog** » Mon Aug 16, 2021 4:24 pm

Thanks

0xC0DE wrote: ↑Mon Aug 16, 2021 1:32 pm SourceGen https://github.com/fadden/6502bench/

Just had a quick play on this and it looks good, pity there is no BBC mode for it though.

Diminished wrote: ↑Mon Aug 16, 2021 2:31 pm In the past I've used WFDIS, which runs in a browser, although it has some limitations (slow, limited commenting ability, RAM hog, difficulty exporting results, C64-centric).

I like this, especially the ability to run a section of code, for things such as relocation, although it does start to get a bit complicated and messy.

I still need to try out BeebDis

TobyLobster · Post by **TobyLobster** » Mon Aug 16, 2021 4:29 pm

It's a shame SourceGen / 6502Bench is Windows only, otherwise it looks good.
WFDIS works, but has a weird interface, and uses PETSCII not ASCII.

I've added links to these tools at the end of the initial post, for reference.

Diminished · Post by **Diminished** » Mon Aug 16, 2021 5:03 pm

I've wanted several times to start work on a cross-platform, Beeb-centric GUI-based disassembly tool which has the features of WFDIS but lacks its shortcomings. You could have some nice stuff like being able to graphically display a sprite memory region for a given screen mode, or something similar for memory containing Teletext.

You could probably also have it automatically recognise common sequences to do trivial operations like system calls and so on.

I've never really got further than thinking about what toolkit to base it on (JavaFX or Swing? GTK? HTML+Javascript?), and unfortunately I have enough half-finished projects on the go already.

oss003 · Post by **oss003** » Mon Aug 16, 2021 5:50 pm

Robc upgraded DIS6502 to disassemble 6502 code and export Beebasm source code . You can also view parts of the disassembly as Beeb graphics.

viewtopic.php?f=2&t=20488

Greetings
Kees

iainfm · Post by **iainfm** » Mon Aug 16, 2021 10:32 pm

fizgog wrote: ↑Mon Aug 16, 2021 1:11 pm I'm curious, as I've always fancied having a go at this myself.

What software does everyone use to dissemble a game?

I started with WFdis to do the initial poking around, then used what I'd gleaned from that to create a beebdis control file.

As the beebdis documentation points out, disassembling is an iterative process, so there was a bit of going back and forth while I was trying to figure out the more peculiar aspects of the game (self modifying code and areas that were a 'hangover' from the source files and things).

fizgog · Post by **fizgog** » Sat Aug 21, 2021 10:31 am

I've been using WFdis to locate the code and data with Shift A and then running the relocation code with Shift R, then switching to BeebDis for the initial disassembly.

I've made a start on Zany Kong by Solar Soft

https://github.com/fizgog/Zany-Kong-Disassembly

tricky · Post by **tricky** » Sat Aug 21, 2021 12:22 pm

I've never tried it, but there is also https://6502bench.com/ spotted by Tom Seddon.

TobyLobster · Post by **TobyLobster** » Sat Aug 21, 2021 11:10 pm

fizgog wrote: ↑Sat Aug 21, 2021 10:31 am I've made a start on Zany Kong by Solar Soft

Thanks - added.

TobyLobster · Post by **TobyLobster** » Sat Aug 21, 2021 11:23 pm

Another web based disassembler is Masswerk 6502 Disassembler which looks easy enough to use and has a BBC Micro mode. It doesn't seem to follow the flow of execution to disassemble though, just disassembles between two addresses.

gfoot · Post by **gfoot** » Sun Sep 12, 2021 10:45 pm

I've been disassembling Repton 2 over the past few days.

Are there any copyright issues with publishing this sort of thing? It's such old software, I'd hope not!

MarkMoxon · Post by **MarkMoxon** » Tue Oct 26, 2021 2:10 pm

Here's another one for the list:

https://github.com/markmoxon/aviator-beebasm

It's a commented reassembly of Aviator, which is long overdue a proper code analysis. The commentary is a work in progress and is far from finished, but I've added detailed comments to about half the codebase and identified quite a few of the core elements, so I figured it was worth letting it out of the bag. I've also knocked out some deep dives, though they're extremely basic at this point:

https://aviator.bbcelite.com/deep_dives/

My plan is to keep adding commentary over the coming weeks, and then to release a web version with plenty of deep dives, cross-references and so on (much like my Elite project). There's a really long way to go yet, but progress is steady and I'm adding something to it most days, so hopefully it'll be worth the wait.

Apologies in advance for the many howlers that lurk within. Consider this an early access project...

Mark

TobyLobster · Post by **TobyLobster** » Tue Oct 26, 2021 2:57 pm

MarkMoxon wrote: ↑Tue Oct 26, 2021 2:10 pm Here's another one for the list:

Added, thanks. Oooh, this looks very nice

Diminished · Post by **Diminished** » Wed Oct 27, 2021 10:53 pm

edit: deleted

garfield · Post by **garfield** » Thu Oct 28, 2021 1:11 am

https://github.com/historicalsource

Lots of arcade (and BBC Micro) assembly source code repos here.

stardot.org.uk