https://github.com/hydepwns/orbit-jump
A gravity-based jumping game
https://github.com/hydepwns/orbit-jump
arcade game love2d lua monaspace physics typography
Last synced: 7 months ago
JSON representation
A gravity-based jumping game
- Host: GitHub
- URL: https://github.com/hydepwns/orbit-jump
- Owner: Hydepwns
- Created: 2025-07-22T16:16:32.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T23:08:44.000Z (8 months ago)
- Last Synced: 2025-08-01T01:31:46.211Z (8 months ago)
- Topics: arcade, game, love2d, lua, monaspace, physics, typography
- Language: Lua
- Homepage:
- Size: 3.61 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
Awesome Lists containing this project
README
# Orbit Jump
[](https://love2d.org/)
[](https://www.lua.org/)
[](https://luarocks.org/modules/hydepwns/orbit-jump)
[](docs/testing.md)
[](LICENSE)
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](https://love2d.org/) 11.0+
## Installation
### Via LuaRocks (Recommended)
```bash
# 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
```bash
# 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
```bash
# Show installation options
lua install.lua --help
# Install via LuaRocks
lua install.lua --luarocks
# Show manual installation instructions
lua install.lua --manual
```
### Package Validation
```bash
# Validate package structure for LuaRocks publishing
lua scripts/publishing/test_package.lua
```
## Quick Start
```bash
love .
```
## Development
### Running Tests
```bash
# 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](docs/getting-started.md)
- [Architecture](docs/architecture.md)
- [Testing](docs/testing.md)
- [Contributing](docs/contributing.md)
- [LuaRocks Publishing](docs/publishing.md)
## License
MIT