# asteroids

**Repository Path**: mirrors_puppetlabs/asteroids

## Basic Information

- **Project Name**: asteroids
- **Description**: A JavaScript based Asteroids variation.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Asteroids! ... Or something kind of like it.

# Introduction

In my free time I coded a version of Asteroids using JavaScript and the 
canvas element. This was just a little experiment so it's unlikely I'll
improve it much more. I'm posting it on GitHub in case anyone finds any
of the bits of code useful. Programming Asteroids is a really great way
to get started understanding the basics of 2D video games. Enjoy!

![alt text](https://raw.githubusercontent.com/Xaxis/asteroids/master/assets/asteroids-screenshot.png "Asteroids in Nyan Mode")

View [demo](http://boilerjs.com/misc/asteroids/asteroids.html).

## Up and running

Include the asteroids.js file in the header of your page and add a canvas
element with an id of `asteroids-container`, like this:

```
 <canvas id="asteroids-container" width="800" height="400"></canvas>
```

Then include the following script to initialize the game.

```
<script>
    var asteroids = new Asteroids();
    asteroids.init({
        debug_mode: false,
        nyan_mode: true,
        nyan_path_override: '',
        nyan_sound: true,
        levels: {
            1: {
                asteroids: 3,
                asteroid_speed: 1,
                ufos: 2,
                ufo_speed: 2,
                ufo_min_pause_time: 1000,
                ufo_max_pause_time: 3000,
                ufo_missile_fire_rate: 1000
            },
            2: {
                asteroids: 4,
                asteroid_speed: 2,
                ufos: 2,
                ufo_speed: 3,
                ufo_min_pause_time: 1000,
                ufo_max_pause_time: 3000,
                ufo_missile_fire_rate: 1000
            },
            3: {
                asteroids: 5,
                asteroid_speed: 2,
                ufos: 2,
                ufo_speed: 4,
                ufo_min_pause_time: 1000,
                ufo_max_pause_time: 3000,
                ufo_missile_fire_rate: 1000
            }
        },
        gameCompleted: function() {
            alert('You won the game!');
        }
    });
</script>
```

You can define the parameters and overall difficulty of each level you
create.