opsu-dance/README.md
Jeffrey Han 943c2af178 Resolved some reported issues.
- Threaded OGG loading (in addition to MP3) to eliminate delays in song select menu. (reported by xasuma)
- Changed default OSZ unpacking location to a "SongPacks" directory to prevent unintended unpacking. (reported by Lanturn)
- Fixed a null pointer for a corner case in 'getRandomNode()'. (reported by @iceblade112)

Signed-off-by: Jeffrey Han <itdelatrisu@gmail.com>
2014-07-15 00:20:36 -04:00

47 lines
2.1 KiB
Markdown

# opsu!
opsu! is an **unofficial** open-source client for [osu!](https://osu.ppy.sh/),
a rhythm game based on popular commercial games such as *Ouendan* and
*Elite Beat Agents*.
opsu! is written in Java using [Slick2D](http://slick.ninjacave.com/) and
[LWJGL](http://lwjgl.org/), wrappers around the OpenGL and OpenAL libraries.
## Getting Started
### Java Setup
The Java Runtime Environment (JRE) must be installed in order to run opsu!.
The download page can be found [here](https://www.java.com/en/download/).
### Beatmaps
opsu! also requires beatmaps to run, which are available for download on the
[osu! website](https://osu.ppy.sh/p/beatmaplist) and mirror sites such as
[osu!Mirror](https://osu.yas-online.net/) or [Bloodcat](http://bloodcat.com/osu/).
If osu! is already installed, this application will attempt to load songs
directly from the osu! program folder. Otherwise, place songs in the generated
`Songs` folder or set the `BeatmapDirectory` value in the generated
configuration file to the path of the root song directory.
Note that beatmaps are typically delivered as OSZ files. These can be extracted
with any ZIP tool, and opsu! will automatically extract them into the songs
folder if placed in the `SongPacks` directory.
### First Run
The `Music Offset` value will likely need to be adjusted when playing for the
first time, or whenever hit objects are out of sync with the music. This and
other game options can be accessed by clicking the wrench icon in the song menu.
## Building
The LWJGL native libraries must be linked and distributed with this application.
[JarSplice](http://ninjacave.com/jarsplice) is included in the tools directory
to merge the files into a single executable fat jar for distribution.
## Credits
This software was created by Jeffrey Han
([@itdelatrisu](https://github.com/itdelatrisu/)). All game concepts and
designs are based on work by osu! developer Dean Herbert. Other credits can
be found [here](CREDITS.md).
## License
**This software is licensed under GNU GPL version 3.**
You can find the full text of the license [here](LICENSE).