README

🚀 JETPAC 2025 - HD Remastered

A modern HTML5 recreation of the classic 1983 ZX Spectrum game by Ultimate Play the Game (Rare Ltd.), featuring stunning visual effects, enhanced gameplay mechanics, and progressive difficulty.

🎮 Play Now

Quick Start

bash

# Clone the repository
git clone https://github.com/jonathanleahy/jetpack.git
cd jetpack

# Start the game server
python3 server.py

# Open in browser
# Navigate to http://localhost:8000

🎯 Game Features

Core Gameplay

Classic Jetpac mechanics - Collect rocket parts, assemble your rocket, refuel, and blast off!
Smooth jetpack physics - Responsive controls with momentum-based movement
Sequential assembly - Rocket parts must be collected in order (Base → Middle → Top)
Auto-drop system - Parts and fuel automatically drop when flying over the rocket
6+ levels with increasing difficulty and unique challenges

Visual Enhancements

Modern particle effects - Explosions, thrust, and impact effects
Neon glow graphics - Vibrant colors with dynamic lighting
Alien variations - Different alien designs and colors based on level
Visual feedback - Clear indicators for collectible items and objectives
Smooth animations - 60 FPS gameplay with fluid motion

Progressive Difficulty System

Dynamic alien spawning - More aliens appear as levels increase
Varied alien types - 5 different alien behaviors (floater, zigzag, hunter, swooper, teleporter)
Increased fuel requirements - Higher levels require more fuel (6-10 canisters)
Faster spawn rates - Aliens appear more frequently in later levels
Level-specific themes - Visual changes every 2 levels

🕹️ Controls

Key	Action
← →	Move Left/Right
↑	Jetpack Thrust
SPACE	Fire Laser
ENTER	Start Game
H	Show Help
P	Pause Game

Advanced Mechanics

Double-tap direction keys for dash (with Shift)
Combo system - Chain alien kills for multiplier bonuses (up to 8x)
Smart pickup - Items automatically picked up when flying over them

🎨 Level Themes

Alien Evolution by Level

Levels 1-2: Classic neon aliens (cyan, magenta, green)
Levels 3-4: Fire theme (red, orange, yellow) - circular aliens with horns
Levels 5-6: Ice theme (blue, white) - hexagonal aliens with 3 eyes
Levels 7-8: Toxic theme (green variations) - diamond aliens with spikes
Level 9+: Rainbow chaos - mixed colors and shapes

⚡ Power-Ups

Power-Up	Effect	Duration
⚡ Triple Shot	Fire 3 lasers at once	300 frames
🛡️ Shield	Temporary invincibility	300 frames
💨 Speed Boost	Faster movement	300 frames
🧲 Magnet	Auto-collect nearby items	300 frames
💣 Smart Bomb	Destroy all enemies on screen	Instant

Power-ups appear after Level 2

💯 Scoring System

Basic Aliens: 50 points
Zigzag Aliens: 100 points
Hunter Aliens: 150 points
Swooper Aliens: 200 points
Fuel Delivery: 100 points each
Combo Multiplier: Up to 8x for consecutive kills
Time Bonus: Complete levels quickly for extra points

🛠️ Technical Details

Built With

Frontend: HTML5 Canvas, TypeScript/JavaScript
Graphics: 2D Canvas API with particle systems
Audio: Web Audio API for sound effects
Server: Python HTTP server
Resolution: 1024×768 (scaled for modern displays)
Performance: 60 FPS target with optimized rendering

Project Structure

shell

jetpac2/
├── index.html          # Main game page with modals
├── server.py           # Python development server
├── README.md           # This file
└── src/
    ├── css/
    │   └── style.css   # Modern UI with glassmorphism effects
    └── ts/
        └── game.js     # Main game engine and logic

🏗️ Development

Requirements

Python 3.x (for development server)
Modern web browser (Chrome, Firefox, Safari, Edge)
No build tools or npm required!

Running Locally

bash

# Method 1: Using the included server
python3 server.py

# Method 2: Python's built-in server
python3 -m http.server 8000

# Method 3: Node.js http-server
npx http-server -p 8000

# Method 4: PHP server
php -S localhost:8000

Browser Compatibility

✅ Chrome/Edge 90+
✅ Firefox 88+
✅ Safari 14+
✅ Opera 76+

🎯 Game Objectives

Collect rocket parts in order (Base, Middle, Top)

Assemble the rocket at the landing zone

Collect fuel canisters (6+ depending on level)

Board the rocket when fully fueled

Survive alien attacks while completing objectives

Progress through levels with increasing difficulty

🏆 Tips & Strategies

Focus on the base first - You can only pick up parts in order
Use auto-drop - Fly over the rocket to automatically drop items
Build combos - Kill aliens consecutively for score multipliers
Collect power-ups - They appear after Level 2 and provide significant advantages
Watch for hunters - Red aliens actively track your position
Manage fuel - Higher levels require more fuel canisters

🐛 Known Issues & Future Enhancements

Current Features

✅ Progressive difficulty scaling
✅ Level-based alien variations
✅ Sequential part collection
✅ Auto-drop mechanics
✅ Combo scoring system
✅ Power-up system
✅ Visual feedback and labels

Planned Enhancements

[ ] High score persistence (localStorage)
[ ] Sound effects and music
[ ] More alien types and behaviors
[ ] Boss enemies every 5 levels
[ ] Additional power-ups
[ ] Achievements system
[ ] Mobile touch controls

📜 Credits

Original Game (1983)

Developer: Ultimate Play the Game (Rare Ltd.)
Programmers: Chris Stamper, Tim Stamper
Platform: ZX Spectrum, VIC-20, BBC Micro

2025 HD Remaster

Recreation: HTML5/Canvas implementation
Enhancements: Modern graphics, particle effects, progressive difficulty
Purpose: Educational tribute to the classic

📄 License

This is a fan-made recreation for educational purposes. All rights to the original Jetpac game belong to Rare Ltd. and their respective owners.

The source code for this recreation is provided as-is for learning purposes.

Enjoy this blast from 1983! 🚀

Experience the classic with modern enhancements - collect, assemble, fuel, and launch your way through increasingly challenging alien worlds!