Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tobiasvl/moon-invaders
:space_invader: Space Invaders emulator written in Lua :moon: and LÖVE :blue_heart:
https://github.com/tobiasvl/moon-invaders
8080 arcade-game emulation emulator intel-8080 love2d lua space-invaders space-invaders-emulation space-invaders-emulator
Last synced: 8 days ago
JSON representation
:space_invader: Space Invaders emulator written in Lua :moon: and LÖVE :blue_heart:
- Host: GitHub
- URL: https://github.com/tobiasvl/moon-invaders
- Owner: tobiasvl
- License: mit
- Created: 2020-06-04T23:11:42.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-14T19:15:19.000Z (12 months ago)
- Last Synced: 2024-10-15T06:09:45.563Z (22 days ago)
- Topics: 8080, arcade-game, emulation, emulator, intel-8080, love2d, lua, space-invaders, space-invaders-emulation, space-invaders-emulator
- Language: Lua
- Homepage: https://tobiasvl.github.io/blog/space-invaders/
- Size: 3.86 MB
- Stars: 29
- Watchers: 3
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
Moon Invaders
=============
A _Space Invaders_ emulator powered by [LÖVE](https://love2d.org) and [lua-8080](https://github.com/tobiasvl/lua-8080).
* [Emulating the Space Invaders look and feel](https://tobiasvl.github.io/blog/space-invaders/) (my blog post about this emulator)
* [The Quest for the Greatest: ...the greatest invaders...](https://videogamegeek.com/blogpost/115294/greatest-invaders) (testimonial/review by Alexandre Correia)
## Features
* Persistent high scores that are saved between runs!
* Authentic-looking CRT shaders, customizable colored gel overlay and background
* Gamepad controller support
* Sound support (for user-provided sound files)
## Controls
You can use the keyboard or gamepad controllers (up to two, for two players).
| Key | Button | Action |
|------------|------------------|---------------------|
| Arrow keys | D-pad / Joystick | Move (both players) |
| Space | A / B / X / Y | Fire (both players) |
| C | Back | Insert coin |
| 1 | Start | Start 1 player mode |
| 2 | Start | Start 2 player mode |
| T | | Tilt |
## How to run
### Windows / macOS
Download the latest release from the [Releases](https://github.com/tobiasvl/moon-invaders/releases) page.
### Linux
First install [LÖVE 11.4](https://love2d.org). Your Linux distribution might have it in its package repository, but there are no guarantees that this emulator works with older versions of LÖVE.
For Ubuntu, there's a third-party repository you can use to install LÖVE 11.4:
```
sudo add-apt-repository ppa:bartbes/love-stable
sudo apt install love
```
Then clone or download this repository, including submodules with `--recursive`, and run LÖVE:
```
git clone --recursive https://github.com/tobiasvl/moon-invaders.git
love moon-invaders/
```
Note that to get the menu bar at the top of the window you will need to install [love-imgui](https://github.com/MikuAuahDark/love-imgui), but you will need to build it yourself since the [Lua rock](https://luarocks.org/modules/slages/love-imgui) requires an older version of LÖVE.
## Setup
You will then need to supply the emulator with ROM files, and some additional optional assets, in order to play.
For all the following files, put them in the following locations:
* Windows, one of the following:
* The `assets` directory inside the game's folder (containing the `.exe` file)
* `C:\Users\\AppData\Roaming\Moon Invaders\assets\`
* Linux, one of the following:
* `$XDG_DATA_HOME/love/Moon\ Invaders/assets/`
* `~/.local/share/love/Moon\ Invaders/assets/`
* macOS: `/Users//Library/Application Support/LOVE/Moon Invaders/assets/`
### ROM
You will need to supply your own Space Invaders ROM files. There are four files:
* `invaders.e`
* `invaders.f`
* `invaders.g`
* `invaders.h`
### Images
These are optional:
* `background.png`: Background image
* `overlay.png`: Colored gel overlay, see the default one for the format
### Sounds
This emulator doesn't emulate the sound chip (yet?), so to get sound, you'll need to download a sound pack online.
The sound files found online have different file names, so two variations per file are supported. These are optional.
* `0.wav` / `ufo_highpitch.wav` (UFO flying)
* `1.wav` / `shoot.wav` (player firing)
* `2.wav` / `explosion.wav` (player death)
* `3.wav` / `invaderkilled.wav` (alien death)
* `4.wav` / `fastinvader1.wav` (alien fleet movement "heartbeat")
* `5.wav` / `fastinvader2.wav`
* `6.wav` / `fastinvader3.wav`
* `7.wav` / `fastinvader4.wav`
* `8.wav` / `ufo_lowpitch.wav` (UFO death)
* `9.wav` / `extendedplay.wav` (extra life)
Note that at least one website that provides these files for download have swapped the names of `shoot.wav` and `invaderkilled.wav`.