# Neverball & Neverputt Quest VR

[![Sponsor](https://img.shields.io/badge/Sponsor-SgtBilko76-ea4aaa?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/SgtBilko76)

[Neverball](https://neverball.org/) and its mini-golf sibling Neverputt, ported to Meta Quest as standalone VR apps.

- **Neverball:** tilt the floor to roll a ball through an obstacle course before time runs out. Collect coins to unlock the exit.
- **Neverputt:** mini golf played on Neverball's courses.

## Install

1. Enable developer mode on your Quest.
2. Download the APK from the [Releases](../../releases) page.
3. Sideload it with [SideQuest](https://sidequestvr.com/) or `adb install -r <file>.apk`.
4. Launch it from *Library → Unknown Sources*.

Neverball and Neverputt are separate APKs (`neverballquest.apk` and `neverputtquest.apk`), so you can install either or both.

## Status

Beta. Please report problems in [Issues](../../issues).

---

## Original Neverball README

> Below is the upstream project's README, kept for credits, licensing and desktop build instructions.

## Neverball

![Neverball](https://neverball.org/images/shots/01-neverball-easy/easy-07-01.jpg)

Tilt the  floor to roll a  ball through an obstacle  course within the
given  time.  If  the  ball falls  or time  expires, a ball is lost.

Collect coins to unlock the exit  and earn extra balls.  Red coins are
worth 5.  Blue coins are worth 10.  A ball is awarded for 100 coins.

### Release Notes

Release highlights can be found in [doc/release-notes.md](doc/release-notes.md).

### Documentation

* [LICENSE.md](LICENSE.md): a description of licensing and exceptions
* [doc/install.txt](doc/install.txt): instructions on how to build the
  game from source code
* [doc/manual.txt](doc/manual.txt): a detailed description of how to
  play and configure the game
* [doc/authors.txt](doc/authors.txt): a list of people who have
  contributed to Neverball

### Resources

* [Website](https://neverball.org/)
* [Development](http://github.com/Neverball)
* [Discord](https://discord.gg/HhMfr4N6H6)

### Translation

Neverball uses the gettext approach to translations. We're always
interested in covering more languages. Join the
[Neverball project on Transifex](https://www.transifex.com/neverball/neverball/).