simon-butler / bndrsntch

Fan made game finishing Stefan Butler's Bandersnatch game, as seen in Black Mirror CYOA film.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

BNDRSNTCH

BNDRSNTCH logo

BNDRSNTCH is a fan made game attempting to finish the Spectrum ZX game Stefan is making in Black Mirror: Bandersnatch, except for Commodore 64 platform.

So far it is a clone of what we see Stefan has made, with an additional map view.

BNDRSNTCH logo

Screenshots

Note that these are carefully constructed to not give too much away!

BNDRSNTCH screenshot 1

BNDRSNTCH screenshot 2

BNDRSNTCH screenshot 3

BNDRSNTCH screenshot 4

BNDRSNTCH screenshot 5

Code template used and thanks

This project forked from acme-assembly-vscode-template, an excellent template for creating 6503 assembly code programs quickly and easily on any of the main platforms. I won't repeat the beautifully detailed general instructions here, check it out directly for that. Here you'll just find the minimum to understand this project.

Running and playing the game

You can run the latest build of BNDERSNTCH on any supporting emulator using the main.prog file. Just download it and run it on your favourite emulator.

When we get to some kind of coherent demo stage I'll create a simple way to play it online without any downloading but for now we're in alpha.

Build set up

Copied and modified from original README at acme-assembly-vscode-template

You will need the following:

  1. Visual Studio Code
  2. Acme Cross Assembler extension for VSCode
  3. VICE Emulator
  4. A download / clone / fork of this project

1. Visual Studio Code

First, get VSCode.

2. Acme Cross Assembler extension for VSCode

Now let's add an extension for syntax highlighting. Click on the extension icon, enter 'acme' in the search bar and click on the 'Acme Cross Aseembler' extension. There's an install button on the right side where the extension is previewed. Unfortunately, the extension does not have any compiler functionality, so we will have to deal with that in another way.

acme-install

acme-preview

3. VICE Emulator

Get it here: http://vice-emu.sourceforge.net/index.html#download

4. A download / clone / fork of this project

Save it anywhere you like.

Building

First open the VSCode project file for this project (or just open the root directory in VSCode, it's the same).

Configuring

You should open the file /.vscode/tasks.json and and inspect the paths. I have it set up with the VICE emulator installed at location ~/vice/ for Mac / Linux or C:\tools\vice\ on Windows, you'll probably need to change this part.

To build

Select menu item Terminal > Run Build Task..., or use the shortcut CMD + SHIFT + B (at least that's it on Mac)

Background on building

All binaries needed for compiling (the ACME assembler, the Pucrunch & Exomizer packers) are included in the bin folder. Code purists might wave their fist in agony now (as it is usually not advised to check in binaries in git), but I found this to be the most comfortable way for newbies to not get lost in configuration. There are folders for Mac, Windows and Linux binaries.

Again, for more general information please go to the acme-assembly-vscode-template repo.

License

The original repo is unlicenced so it's hard to know what to assume. I have chosen CC0 license here but I will change if the original author disagrees.

Changelog

  • v0.1.0 - create repo, code contains x,y plotting test only :D

About

Fan made game finishing Stefan Butler's Bandersnatch game, as seen in Black Mirror CYOA film.

License:Other


Languages

Language:Assembly 100.0%