lc3-vm-kotlin

A Kotlin implementation of the LC-3 Virtual Machine, inspired by "Write your Own Virtual Machine" article by Justin Meiners and Ryan Pendleton.

Reference links

• Write your Own Virtual Machine
• LC-3 Instruction Set
• The RawConsoleInput.java class by Christian d'Heureuse (originally found in this StackOverflow thread)

Screenshots

Hangman

Rogue

Installation and Setup Instructions

You will need Maven installed and configured onto your machine.

Cloning the repository:

1. Run git clone https://github.com/CianciuStyles/lc3-vm-kotlin.git in the terminal

Installation:

1. Run mvn clean install in the terminal

To run the test suite:

1. Run mvn test in the terminal

To run lc3-vm-kotlin:

1. Run mvn exec:java@2048 in the terminal to run 2048.
2. Run mvn exec:java@hangman in the terminal to run Hangman.
3. Run mvn exec:java@rogue in the terminal to run Rogue.