gosu

README

gosu

Classic rhythm games written in go with Ebitengine

Latest version: 0.6 (July 23rd, 2023)

Game play preview

Click thumbnails to watch at YouTube.

How to play

1. Select the song with Enter.
2. Press matching keys with notes.
3. Change the Speed with PageUp / PageDown

4 Key: S, D, J, K
7 Key: S, D, F, Space, J, K, L

Feature

• osu! files supported

  • .osu (osu! beatmap file)
  • .osr (osu! replay file)

• Practical score and level system

  • The motivation of gosu dev.
  • WIP: Level calculation

• Customize in-game sprites

  • Put your favorite skin in asset/ with matching name.

• Quick input listener

  • WINAPI is used in Windows.
  • Others is currently depending on ebiten.IsKeyPressed .

• Codebase with high readability

Build

1. For MacOS and Linux users, install Ebitengine dependencies first by referring to the documentation(Ebitengine/Install).

2. Go to root directory of the repository and type:

go build .

Web version

Version: 0.4.1

https://gosu-web-orcin.vercel.app

Game structure

Package flow

Introduction of gosu development

Will also post details at wiki.

License

Codebase: Apache License 2.0

Most skin images and music tracks are from osu-resources, licensed under CC-BY-NC 4.0.