Skip to content

Latest commit

 

History

History
57 lines (41 loc) · 3.32 KB

env_setup.md

File metadata and controls

57 lines (41 loc) · 3.32 KB

Environment and Tools Setup for nv_c64_util code

To setup a development environment to build and run code in this repository you can follow these steps. The versions used for development are mentioned but there is no known dependency on particular versions.

  1. OS used for development: Windows 10 Pro, build: 19043.1165. Most if not all of these tools are available for other OSes as well but that hasn't been tried.

  2. Install the latest java runtime

  1. Install Kick Assembler. This is an assembler specifically for C64 code.
  1. Install the VICE C64 emulator. Technically not required if you want to run the result on real C64 hardware, but definitely convienent as it lets you run the software right on your development machine.
  1. Install VS Code. This IDE along with the Kick Assembler extension was used to build the code rather than scripts or makefiles
  1. Install the Kick Assembler IDE Extension for VS Code Named "Kick Assembler (C64) for Visual Studio Code" by Paul Hocker
  • Start up VS Code
  • Search for Extension (ctrl-shift-x)
  • type in Kick Assembler (C64)
  • Install
  • Version used for development: 0.7.15
  • configure the extension in VS Code, specifically find and set the settings that point the extension where it can find
    • Kick assembler jar file (KickAss.jar)
    • Emulator runtime, which is the VICE C64 emulator (x64sc.exe)
    • C64 debugger runtime (C64Debugger.exe)
    • Java runtime (java.exe)

Now you should be ready to try build and run code from this repository.


Additional tools that might be helpful, if not required, include the following:

  1. Install C64 debugger. This is also not technically required to simply build the software, but useful if you want to debug anything.
  1. Install GoatTracker if you are interested in looking at or editing the music or sound effects for C64 this is useful.
  1. Install CBM Prg Studio. This is useful to edit custom character sets and export them as .bin files. The code in this repo regarding custom char sets was tested using charsets built from this tool. There are probably lots of other C64 charset editors that could do this job as well.
  1. Spritemate website that can be used to create the C64 sprites. The sprite code in this repository was developed and tested using sprites defined from this tool.