Orbit Jump

A gravity-based arcade game with realistic physics and adaptive systems.

Features

• Physics-Based Movement - Realistic orbital mechanics
• Planet Hopping - Jump between diverse planets
• Adaptive Systems - Game learns from your playstyle
• Cross-Platform - Desktop and mobile support

Requirements

• LÖVE2D 11.0+

Installation

Via LuaRocks (Recommended)

# Install via LuaRocks
luarocks install orbit-jump

# Run the game
love orbit-jump

Note: LÖVE2D must be installed separately via your system package manager.

Manual Installation

# Clone the repository
git clone https://github.com/Hydepwns/orbit-jump.git
cd orbit-jump

# Install LÖVE2D
# macOS
brew install love

# NixOS
nix profile install nixpkgs#love

# Linux
sudo apt install love2d  # Ubuntu/Debian
sudo dnf install love    # Fedora
sudo pacman -S love      # Arch

# Run the game
love .

Using the Installation Script

# Show installation options
lua install.lua --help

# Install via LuaRocks
lua install.lua --luarocks

# Show manual installation instructions
lua install.lua --manual

Package Validation

# Validate package structure for LuaRocks publishing
lua scripts/publishing/test_package.lua

Quick Start

love .

Development

Running Tests

# All tests
./run_tests.sh

# Specific test types
./run_tests.sh unit
./run_tests.sh integration
./run_tests.sh performance

# Interactive runner
lua tests/run_interactive_tests.lua

Controls

Desktop

• Jump: Click and drag to aim, release to jump
• Dash: Shift / Z / X (while in space)
• Restart: Space (after game over)
• Pause: Escape

Mobile

• Jump: Swipe from player
• Dash: Double-tap screen
• Restart: Tap screen

Documentation

• Getting Started
• Architecture
• Testing
• Contributing
• LuaRocks Publishing

License

MIT