Go to file

Jeffrey Han 50fb71e353 Implemented saving/loading from checkpoints. - A checkpoint (track position) can be set in the options screen, and also while playing by pressing "CTRL+S". - A checkpoint can be loaded by pressing "CTRL+L" while playing. This will reset all game data and begin from the checkpoint time; the ranking screen will be skipped upon song completion. Other changes: - Don't draw grade if no objects have been processed (previously defaulted to GRADE_D). - Calculate slider start/end angles based on a step difference (previously an arbitrary 0.01 difference). - Always end a slider curve base on the last control point. Signed-off-by: Jeffrey Han <itdelatrisu@gmail.com>		2014-07-08 22:17:48 -04:00
lib	Added a module for unpacking OSZ archives.	2014-07-06 01:58:44 -04:00
native	Initial commit.	2014-06-29 22:17:04 -04:00
res	Added support for default playfield image and an override option.	2014-07-03 01:05:23 -04:00
src/itdelatrisu/opsu	Implemented saving/loading from checkpoints.	2014-07-08 22:17:48 -04:00
tools	Initial commit.	2014-06-29 22:17:04 -04:00
.gitignore	Added initial support for loading user skins.	2014-07-02 01:53:42 -04:00
build.xml	Minor follow-up to `d9c251e`.	2014-07-06 02:27:53 -04:00
CREDITS.md	Added support for default playfield image and an override option.	2014-07-03 01:05:23 -04:00
LICENSE	Initial commit.	2014-06-29 22:17:04 -04:00
README.md	Added a module for unpacking OSZ archives.	2014-07-06 01:58:44 -04:00

README.md

opsu!

opsu! is an unofficial open-source client for osu!, a rhythm game based on popular commercial games such as Ouendan and Elite Beat Agents.

opsu! is written in Java using Slick2D and LWJGL, 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.

Beatmaps

opsu! also requires beatmaps to run, which are available for download on the osu! website and mirror sites such as osu!Mirror or Bloodcat.

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 root 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 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). All game concepts and designs are based on work by osu! developer Dean Herbert. Other credits can be found here.

License

This software is licensed under GNU GPL version 3. You can find the full text of the license here.