Skip to content
/ NES-Game Public template
forked from gregkrsak/first_nes

Create your own games for the Nintendo Entertainment System! This "starter" game is easily extensible for your own projects. Includes references.

License

Notifications You must be signed in to change notification settings

NetizenAbel/NES-Game

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

first_nes project - Your first NES game!

Assembly language

Create your own games for the Nintendo Entertainment System with this "starter" project!

Boilerplate code is provided! Instantly get up and playing!
Image: Editing Image: Running

Getting started

Install the cc65 binutils:

Linux

sudo apt-get install -y cc65

OSX

brew install cc65

Windows

Make sure git and make are installed and download the cc65 binutils from here and extract it to somehwere in your system path.

All

Now start your project from this template, click "use template" at the top of this page.

MY-USER-NAME= Your Username on github
NES-Game= The name you gave your new repo made from this template
git clone https://github.com/${MY-USER-NAME}/${NES-Game}
cd ${NES-Game}
make

Now go ahead and run the ${NES-Game}.nes file. You can move the copyright-neutral-green-construction-worker character back and forth with the A and B buttons.

Credits

Authors:

  • Written by Greg M. Krsak (email), 2018

Standing on the shoulders of giants:

Additional thanks to:

  • @elennick for testing the Mac OS quick start instructions (Issue #22).

  • @hxlnt for expanding the credits (PR #33).

  • Reddit user u/Rocky99433 for prompting me to fix the Windows quick start instructions (Issue #21).

  • @ericandrewlewis for correcting some bad comments (PR #53).

About my Development Environment

  • Target CPU: 8-bit, Ricoh RP2A03 (6502), 1.789773 MHz (NTSC)

  • Assembler: ca65 (cc65 binutils)

Tested on:

  • Linux with Nestopia UE 1.47

  • Windows with Nestopia UE 1.48

Additional Resources

NES programming in general:

The ca65 assembler:

Building this project:

first_nes was written by Greg M. Krsak, 2018. You may send him an email using this address. If you'd like to contribute to his project, click here to learn how.

About

Create your own games for the Nintendo Entertainment System! This "starter" game is easily extensible for your own projects. Includes references.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Assembly 84.0%
  • HTML 6.0%
  • Makefile 5.9%
  • C++ 4.1%