update README
This commit is contained in:
yugecin
parent
4769c1cfda
commit
baa3abd1f4
97
README-OPSU.md
Normal file
97
README-OPSU.md
Normal file
|
|
@ -0,0 +1,97 @@
|
||||||
|
# [opsu!](http://itdelatrisu.github.io/opsu/)
|
||||||
|
**opsu!** is an unofficial open-source client for the rhythm game
|
||||||
|
[osu!](https://osu.ppy.sh/). It is written in Java using
|
||||||
|
[Slick2D](http://slick.ninjacave.com/) and [LWJGL](http://lwjgl.org/),
|
||||||
|
wrappers around the OpenGL and OpenAL libraries.
|
||||||
|
|
||||||
|
opsu! runs on Windows, OS X, and Linux platforms.
|
||||||
|
A [libGDX port](https://github.com/fluddokt/opsu) additionally supports Android
|
||||||
|
devices.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
Precompiled binaries for opsu! can be found on the
|
||||||
|
[releases](https://github.com/itdelatrisu/opsu/releases) page, with the latest
|
||||||
|
builds at the top. APK releases can be found
|
||||||
|
[here](https://github.com/fluddokt/opsu/releases).
|
||||||
|
|
||||||
|
### Java Setup
|
||||||
|
The Java Runtime Environment (JRE) must be installed in order to run opsu!.
|
||||||
|
The download page is located [here](https://www.java.com/en/download/).
|
||||||
|
|
||||||
|
### Beatmaps
|
||||||
|
opsu! 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/) and [Bloodcat](http://bloodcat.com/osu/).
|
||||||
|
Beatmaps can also be downloaded directly through opsu! in the downloads menu.
|
||||||
|
|
||||||
|
If osu! is already installed, this application will attempt to load beatmaps
|
||||||
|
directly from the osu! program folder. Otherwise, place beatmaps in the
|
||||||
|
generated `Songs` folder or set the "BeatmapDirectory" value in the generated
|
||||||
|
configuration file to the path of the root beatmap 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 beatmap
|
||||||
|
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 "Other Options" button in
|
||||||
|
the song menu.
|
||||||
|
|
||||||
|
### Directory Structure
|
||||||
|
The following files and folders will be created by opsu! as needed:
|
||||||
|
* `.opsu.cfg`: The configuration file. Most (but not all) of the settings can
|
||||||
|
be changed through the options menu.
|
||||||
|
* `.opsu.db`: The beatmap cache database.
|
||||||
|
* `.opsu_scores.db`: The scores database.
|
||||||
|
* `.opsu.log`: The error log. All critical errors displayed in-game are also
|
||||||
|
logged to this file, and other warnings not shown are logged as well.
|
||||||
|
* `Songs/`: The beatmap directory (not used if an osu! installation is detected).
|
||||||
|
The parser searches all of its subdirectories for .osu files to load.
|
||||||
|
* `SongPacks/`: The beatmap pack directory. The unpacker extracts all .osz
|
||||||
|
files within this directory to the beatmap directory.
|
||||||
|
* `Skins/`: The skins directory. Each skin must be placed in a folder within
|
||||||
|
this directory. Any game resource (in `res/`) can be skinned by placing a
|
||||||
|
file with the same name in a skin folder. Skins can be selected in the
|
||||||
|
options menu.
|
||||||
|
* `Screenshots/`: The screenshot directory. Screenshots can be taken by
|
||||||
|
pressing the F12 key.
|
||||||
|
* `Replays/`: The replay directory. Replays of each completed game are saved
|
||||||
|
as .osr files, and can be viewed at a later time or shared with others.
|
||||||
|
* `ReplayImport/`: The replay import directory. The importer moves all .osr
|
||||||
|
files within this directory to the replay directory and saves the scores in
|
||||||
|
the scores database. Replays can be imported from osu! as well as opsu!.
|
||||||
|
* `Natives/`: The native libraries directory.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
opsu! is distributed as both a [Maven](https://maven.apache.org/) and
|
||||||
|
[Gradle](https://gradle.org/) project.
|
||||||
|
|
||||||
|
### Maven
|
||||||
|
Maven builds are built to the `target` directory.
|
||||||
|
* To run the project, execute the Maven goal `compile`.
|
||||||
|
* To create a single executable jar, execute the Maven goal `package -Djar`.
|
||||||
|
This will compile a jar to `target/opsu-${version}.jar` with the libraries,
|
||||||
|
resources and natives packed inside the jar. Setting the "XDG" property
|
||||||
|
(`-DXDG=true`) will make the application use XDG folders under Unix-like
|
||||||
|
operating systems.
|
||||||
|
|
||||||
|
### Gradle
|
||||||
|
Gradle builds are built to the `build` directory.
|
||||||
|
* To run the project, execute the Gradle task `run`.
|
||||||
|
* To create a single executable jar, execute the Gradle task `jar`.
|
||||||
|
This will compile a jar to `build/libs/opsu-${version}.jar` with the libraries,
|
||||||
|
resources and natives packed inside the jar. Setting the "XDG" property
|
||||||
|
(`-PXDG=true`) will make the application use XDG folders under Unix-like
|
||||||
|
operating systems.
|
||||||
|
|
||||||
|
## 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).
|
||||||
104
README.md
104
README.md
|
|
@ -1,97 +1,13 @@
|
||||||
# [opsu!](http://itdelatrisu.github.io/opsu/)
|
#opsu!dance
|
||||||
**opsu!** is an unofficial open-source client for the rhythm game
|
fork of [opsu!](https://github.com/itdelatrisu/opsu) with cursordancing auto.
|
||||||
[osu!](https://osu.ppy.sh/). It is written in Java using
|
I make cursordancing video's -[example](https://www.youtube.com/watch?v=1oFH58X_lTY)-, but I have too many requests and this way I can give people the opportunity to just run it and see the result instead of waiting for me to make a video. Original bot is written in C# and videos are made on osu!, but I don't want to distribute that program, because I don't want to endorse cheating in any way. The sources found in this repo are very representative of the ones of my bot (most files are the exact same, except for C#/java changes).
|
||||||
[Slick2D](http://slick.ninjacave.com/) and [LWJGL](http://lwjgl.org/),
|
|
||||||
wrappers around the OpenGL and OpenAL libraries.
|
You can find general (run/build) instructions in the original [opsu! README](README-OPSU.md).
|
||||||
|
|
||||||
opsu! runs on Windows, OS X, and Linux platforms.
|
###Credits
|
||||||
A [libGDX port](https://github.com/fluddokt/opsu) additionally supports Android
|
opsu! was made by Jeffrey Han ([@itdelatrisu](https://github.com/itdelatrisu)). All game concepts and designs are based on work by osu! developer Dean Herbert. Other opsu! credits can be found [here](CREDITS.md).
|
||||||
devices.
|
opsu!dance (everything in the src package yugecin.opsudance) was made by me ([@yugecin](https://github.com/yugecin)). Originally in C#, now ported to java. Some edits were made in the opsu! sources.
|
||||||
|
|
||||||
## Getting Started
|
###License
|
||||||
Precompiled binaries for opsu! can be found on the
|
|
||||||
[releases](https://github.com/itdelatrisu/opsu/releases) page, with the latest
|
|
||||||
builds at the top. APK releases can be found
|
|
||||||
[here](https://github.com/fluddokt/opsu/releases).
|
|
||||||
|
|
||||||
### Java Setup
|
|
||||||
The Java Runtime Environment (JRE) must be installed in order to run opsu!.
|
|
||||||
The download page is located [here](https://www.java.com/en/download/).
|
|
||||||
|
|
||||||
### Beatmaps
|
|
||||||
opsu! 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/) and [Bloodcat](http://bloodcat.com/osu/).
|
|
||||||
Beatmaps can also be downloaded directly through opsu! in the downloads menu.
|
|
||||||
|
|
||||||
If osu! is already installed, this application will attempt to load beatmaps
|
|
||||||
directly from the osu! program folder. Otherwise, place beatmaps in the
|
|
||||||
generated `Songs` folder or set the "BeatmapDirectory" value in the generated
|
|
||||||
configuration file to the path of the root beatmap 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 beatmap
|
|
||||||
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 "Other Options" button in
|
|
||||||
the song menu.
|
|
||||||
|
|
||||||
### Directory Structure
|
|
||||||
The following files and folders will be created by opsu! as needed:
|
|
||||||
* `.opsu.cfg`: The configuration file. Most (but not all) of the settings can
|
|
||||||
be changed through the options menu.
|
|
||||||
* `.opsu.db`: The beatmap cache database.
|
|
||||||
* `.opsu_scores.db`: The scores database.
|
|
||||||
* `.opsu.log`: The error log. All critical errors displayed in-game are also
|
|
||||||
logged to this file, and other warnings not shown are logged as well.
|
|
||||||
* `Songs/`: The beatmap directory (not used if an osu! installation is detected).
|
|
||||||
The parser searches all of its subdirectories for .osu files to load.
|
|
||||||
* `SongPacks/`: The beatmap pack directory. The unpacker extracts all .osz
|
|
||||||
files within this directory to the beatmap directory.
|
|
||||||
* `Skins/`: The skins directory. Each skin must be placed in a folder within
|
|
||||||
this directory. Any game resource (in `res/`) can be skinned by placing a
|
|
||||||
file with the same name in a skin folder. Skins can be selected in the
|
|
||||||
options menu.
|
|
||||||
* `Screenshots/`: The screenshot directory. Screenshots can be taken by
|
|
||||||
pressing the F12 key.
|
|
||||||
* `Replays/`: The replay directory. Replays of each completed game are saved
|
|
||||||
as .osr files, and can be viewed at a later time or shared with others.
|
|
||||||
* `ReplayImport/`: The replay import directory. The importer moves all .osr
|
|
||||||
files within this directory to the replay directory and saves the scores in
|
|
||||||
the scores database. Replays can be imported from osu! as well as opsu!.
|
|
||||||
* `Natives/`: The native libraries directory.
|
|
||||||
|
|
||||||
## Building
|
|
||||||
opsu! is distributed as both a [Maven](https://maven.apache.org/) and
|
|
||||||
[Gradle](https://gradle.org/) project.
|
|
||||||
|
|
||||||
### Maven
|
|
||||||
Maven builds are built to the `target` directory.
|
|
||||||
* To run the project, execute the Maven goal `compile`.
|
|
||||||
* To create a single executable jar, execute the Maven goal `package -Djar`.
|
|
||||||
This will compile a jar to `target/opsu-${version}.jar` with the libraries,
|
|
||||||
resources and natives packed inside the jar. Setting the "XDG" property
|
|
||||||
(`-DXDG=true`) will make the application use XDG folders under Unix-like
|
|
||||||
operating systems.
|
|
||||||
|
|
||||||
### Gradle
|
|
||||||
Gradle builds are built to the `build` directory.
|
|
||||||
* To run the project, execute the Gradle task `run`.
|
|
||||||
* To create a single executable jar, execute the Gradle task `jar`.
|
|
||||||
This will compile a jar to `build/libs/opsu-${version}.jar` with the libraries,
|
|
||||||
resources and natives packed inside the jar. Setting the "XDG" property
|
|
||||||
(`-PXDG=true`) will make the application use XDG folders under Unix-like
|
|
||||||
operating systems.
|
|
||||||
|
|
||||||
## 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.**
|
**This software is licensed under GNU GPL version 3.**
|
||||||
You can find the full text of the license [here](LICENSE).
|
You can find the full text of the license [LICENSE](here).
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user