Installation
Содержание:
- Папки
- Choplifter HD (2012)
- Status
- Описание редакции
- Популярная ритм-игра для Nintendo DS получает свое продолжение.
- Сравнение альтернативных программ:
- Пользователи, которые скачивали Osu!, также скачивали:
- Contributing
- Participants
- Troubleshooting
- Installing osu!
- Match results
- Adding skins
- One of the most popular free rhythm games
- Adding beatmaps
- Running osu!
- Developing osu!
Папки
Chat
Папка Chat создаётся при включении опции «Вести логи личных сообщений», или когда пользователь выполняет команду в окне чата.
Файлы с логами сообщений могут быть открыты в любом текстовом редакторе и имеют формат названия . Пример:
Downloads
В папке Downloads хранятся карты, скачиваемые через osu!direct (для этого нужен osu!supporter). После скачивания они автоматически переносятся в папку Songs.
Exports
Папка Exports появляется при выборе операции «Экспортировать в .osk» в меню выбора скинов, или при выборе пункта меню «Экспортировать в .osz» в редакторе карт. В ней находятся экспортированные из osu! карты и скины.
Localisation
Папка Localisation появляется при изменении языка в настройках игры. В ней находятся текстовые файлы с переводом osu!, которые могут использоваться для замены английского текста на основе выбранной локализации.
Replays
Примечание: раньше реплеи записывались с низкой частотой кадров, которая потом была увеличена для более плавного воспроизведения.
В папке Replays находятся файлы реплеев, сохранённые пользователем. Их можно воспроизвести только при наличии карт, использовавшихся для записи. В каждом реплее содержится итоговая статистика игры, а также движения курсора и нажатия клавиш. Чтобы создать реплей, нажмите на экране с результатами или кликните по кнопке «Сохранить реплей» (есть только в одиночном режиме).
Примечание: для загрузки реплеев на YouTube может пригодиться Osr2mp4: автоматическая конвертация реплея в видео.
Названия реплеев имеют формат . Пример:
Screenshots
В папке Screenshots хранятся скриншоты, сделанные игроком. По умолчанию скриншоты имеют расширение , однако его можно изменить на в настройках клиента.
Примечание: чтобы сделать скриншот, нажмите горячую клавишу ( по умолчанию).
Названия скриншотов имеют формат , где «###» — номер скриншота.
Skins
В папке Skins хранятся скины, созданные другими игроками и предназначенные для смены оформления клиента. Их можно скачать из соответствующего форума и установить, кликнув два раза по скачанному скину в файловом менеджере. «osu! by peppy» — единственный скин, у которого нет отдельной папки и который нельзя удалить.
См. также: Создание скинов
Songs
В папке Songs хранятся карты для osu!. В каждой из них обычно находятся файлы форматов (сложности), / (аудиофайлы), // (фоновые изображения), (файлы со сторибордом) и / (видеофайлы). Карта также может содержать / (файлы с хитсаундами) и другие вложенные папки (например, со скином или спрайтами для сториборда).
Имена папок имеют формат . Пример: 57950 SOUND HOLIC — Drive My Life.
Обратите внимание, что если карта сделана очень давно (например, Kenji Ninuma — DISCO PRINCE или Dudelstudios — Angry Video Game Nerd Theme ) или в принципе не опубликована, имя её папки не будет соответствовать этому формату
Choplifter HD (2012)
Аркада Choplifter HD останется верна традициям оригинала, но предложит игрокам современную 3D-графику, а также более 30 миссий — начиная от спасения заключенных, и заканчивая эвакуаций населения из очага эпидемии вируса, превращающего всех в зомби. Спасательный вертолет вооружен пулеметом и ракетами, и по ходу дела пилоту придется стрелят …
Год выпуска: 2012Жанр: Arcade / 3DРазработчик: InXile EntertainmentИздательство: KonamiСайт разработчика: http://www.inxile-entertainment.com/Язык интерфейса: АнглийскийПлатформа: PC »Операционная система: Windows XP / Vista / 7 »Процессор: 1.5 GHz »Оперативная память: 512 mb » Место на жестком дискe: 1,7 Гб »
PC игры / Arcade
Подробнее
Status
This project is under heavy development, but is in a stable state. Users are encouraged to try it out and keep it installed alongside the stable osu! client. It will continue to evolve to the point of eventually replacing the existing stable client as an update.
IMPORTANT: Gameplay mechanics (and other features which you may have come to know and love) are in a constant state of flux. Game balance and final quality-of-life passes come at the end of development, preceded by experimentation and changes which may potentially reduce playability or usability. This is done in order to allow us to move forward as developers and designers more efficiently. If this offends you, please consider sticking to the stable releases of osu! (found on the website). We are not yet open to heated discussion over game mechanics and will not be using github as a forum for such discussions just yet.
We are accepting bug reports (please report with as much detail as possible and follow the existing issue templates). Feature requests are also welcome, but understand that our focus is on completing the game to feature parity before adding new features. A few resources are available as starting points to getting involved and understanding the project:
- You can learn more about our approach to project management.
Описание редакции
Популярная ритм-игра для Nintendo DS получает свое продолжение.
Известная японская ритм-игра для Nintendo DS теперь доступна в виде клона на ПК. Как и в оригинальной версии, в Osu! вам нужно следить за ритмом различных песен. Однако, в этой части есть некоторые дополнительные элементы, которых вы не найдете в оригинале. В целом, все работает практически как в оригинале. Главное отличие — в Osu! есть система онлайн-рейтингов и даже редактор для создания собственных уровней или композиций-битмэпов. Однако, в самой игре их нет.Вам нужно зарегистрироваться на официальном форуме и загрузить те песни, которые вам нравятся. И хотя эта версия полностью повторяет оригинал, играть на компьютере гораздо сложнее, чем на консоли. Управлять при помощи мыши сложнее, чем при помощи стилуса. В целом, игра превосходно адаптирована для ПК, и особенно радует возможность создавать битмэпы самому. Если вы любите музыку и сложные игры, обязательно попробуйте Osu!
скачать
Сравнение альтернативных программ:
anyMania |
DSS DJ |
Salsa Rhythm Machine |
salsacrazy |
|
Описание | Скачать anyMania, версия 1.0 | Профессиональный DJ-софт | Скачать Salsa Rhythm Machine, версия 3.1.0 | Скачать salsacrazy, версия salsacrazy 1.0 |
Рейтингу | ||||
Загрузки | 5 | 256 | 28 | |
Цена | $ 24.95 | $ 59.5 | $ 40 | $ 0 |
Размер файла | 0.23 MB | 2.16 MB | 7.00 MB | 1.50 MB |
Download |
Download |
Download |
Download |
Пользователи, которые скачивали Osu!, также скачивали:
Мы рады посоветовать вам программы которые понравились другим пользователям Osu!. Вот список программ, аналогичных Osu!:
x-app
6
Скачать x-app, версия 6
скачать
Аудио и музыка
Рейтинг пользователей
ThunderSoft Screen Recorder
8.3.0
Простой и легкий захват видео и аудио с помощью ThunderSoft Screen Recorder для Windows.
скачать
Аудио и музыка
Рейтинг пользователей
KineMaster
4.7.7.11911.GP
Создавайте видеоролики высочайшего качества при помощи профессиональных инструментов редактирования Kine Master.
скачать
Аудио и музыка
Рейтинг пользователей
YMusic
v2.4.8
Слушайте музыку из библиотеки Vimeo, не нагружая память девайса
скачать
Аудио и музыка
Рейтинг пользователей
Contributing
When it comes to contributing to the project, the two main things you can do to help out are reporting issues and submitting pull requests. Based on past experiences, we have prepared a list of contributing guidelines that should hopefully ease you into our collaboration process and answer the most frequently-asked questions.
Note that while we already have certain standards in place, nothing is set in stone. If you have an issue with the way code is structured, with any libraries we are using, or with any processes involved with contributing, please bring it up. We welcome all feedback so we can make contributing to this project as painless as possible.
Participants
Country | Members | |
---|---|---|
Argentina | Emiru Ikuno 2, Amuro, Emiru Ikuno, Lexalia, SlowBurn, Penguo, R1cho, zeta | |
Australia | Jordan The Bear, mrekk, -Machine-, Dumii, jordanlr7, Vivace, suffix, Milo Milkshake | |
Austria | Sparkxei, Nekoyase, goosefedora, NuHaru, tomadoi, Alparabel, Farmist, Ccus | |
Belgium | Hanori, Fblade, 5joshi, MimiliaaMyMommy, Dabo, iblue, KyZzo, Meersu | |
Brazil | MouseEasy, Coreanmaluco, Dafonz, Mystia, Sanjilift, tones, xKirito, xxluizxx47 | |
Cambodia | Sambath, BlueMaster, iToxicShadow, RenaDesu, tsp648, YuuSakku | |
Canada | Zylice, xootynator, Frankie_, kurtis-, Vespirit, Jeremy_, MuffinSlayer14, nick1324 | |
Chile | Intercambing, Mathi, DanyL, Montenegro, xaxreid, NO37, tfge, Gonzah | |
China | Genshinphobia-, im_a_burger_fox, KuKu_QY, lolol233, striFE36, Garden, EmertxE, | |
Colombia | Ninther4, , Black Astro, ElMick13, ElMick21, GaaL50, Rushy, Yoari | |
Croatia | KarliXon, StrawFrog, Aox, Suki007, DragonCroc, Kek0, Fiilip, The Fart Lord | |
Czech Republic | PoggersCZ, BLooDBuRSTiNG, VilaZ, MrNobady, Daichi, NitroM_, Avenito, mnbvcxy12345678 | |
Denmark | iamVill, cat burger, Malach, Nordkild, Polle, Zeezus, Vandabe, P3RS3X | |
Estonia | Rev0, yasuha, cedru, Eminem, Save Me, mikn, Lotragon, blourgh | |
Finland | Ataraksia, Haadez, savilju, boleks, Xepei, apisedo, Amasetic, HENKSELI | |
France | Musty, Ekoro, ThePooN, justman, Thundur, NerO, Hifkil, KC Snorlaax | |
Germany | hallowatcher, WhiteCat, okinamo, Risiing, criller, khz, Umbre, Dustice | |
Hong Kong | Shiraha Yuki, mcy4, Dragbit 3, A21, Minecraft570, Rlsc, TiRa, Muji | |
Hungary | Lexion, B L A C K Y, Darnol, defii, Glasswave, JezusNE, RatinA0, Tralkke | |
Indonesia | Skydiver, Lifeline, Vinno, Crezz, rHO, Rexeez, deeto, Fuma | |
Israel | PaintedKoala, -Mikeyy, Accelerator, Creemi69, namewithnumber9, StormBrightNess, Jumbo, cihp | |
Italy | Ryuzaki, Arancino, dem27, Gigi8974, giulio, GYGY, leoanto, Matteo | |
Japan | rollpan, Varvalian, EIGER, KonKonKinakoN, haga1115, —-, Aotoleen, a_Blue | |
Kazakhstan | Ayya Novak, Calideon, Arnold576, FengShen, ace1ng, Akira, Kamensh1k, RinKonri | |
Latvia | waywern2012, AkitoshisNormal, Emula, kbwaaablya, MegaWhyNOPE, Piparkuucinsh, rihis123, TheBigDrop | |
Lithuania | noob pwner, ReusoL, Haganenno, Nitram, DJ Dalgis, mizhalas43, Merami Frog, PainSinger | |
Malaysia | ShaneLiang, wuhua, Rampax, haruchi, Shimon, seabee, Inugami Korone, Chiyuu | |
Mexico | -Wolfy-, -Hebel-, Flameshock, Jalepers, KevstracK, pundice, Riot, SaintSFT | |
Netherlands | Skyrovania, Viveliam, jackylam5, Manievat, Luciano, CosmicWolf, Dolter, Kushper | |
New Zealand | Zoomer, Big Z, shortpotato, catcat, VioIette, Saiyku, Feyyy, Dabble | |
Norway | YokesPai, -GN, Fjell, Markus, Melvr, ninerik, Njulsen, Pinguinzi | |
Peru | Arnold24x24, P r a h, RedLight748, Hasaki, Nkiad, Souen, Im_Alviin, ViniPvP | |
Philippines | zonelouise, Milkteaism, Kageno, Xyloz, hyeok2044, Rammu, LilyFlower, elki | |
Poland | maliszewski, Rafis, WubWoofWolf, laroxPL, Mastasz, MAREK MARUCHA, Burtpi, TWOJA STARA | |
Portugal | MakiDonalds, Takaga, Just2Gud, Legendz, GeneralSharkk, Netizz, My Angel Takaga, dat boi waffle | |
Romania | badeu, Lucrise, nanoya, _AfterWind, Chamosiala, L9 ELOVATOR, eternum, cristi2708 | |
Russian Federation | Vitya1437, Red_Pixel, Leva_Russian, MrFuture, TESTER PIVKA, Aoi Kiseki, Apostol, talala | |
Singapore | Tebi, Demonical, Loslite, megumic, emilia, SeeL, GSBlank, Rtyzen | |
Slovakia | Tikef, DogeDrxvmik, Hranolka, Igor156, PemiX, PeteX, TenIdiotZTelky, triiiiiple | |
South Korea | Karuna, FlyingTuna, Zeisen-, Doomsday fanboy, Nopekjk, RankAjae, , Maiaz | |
Spain | amborgesa, A N T O N I O, Estopa, AbejaIvan, NHarmonia, dariito0xx, -Hideki-, Bairechuu | |
Sweden | Saika0k1, , , -Masta-, scylla, Reedkatt, Andros, Jageko | |
Switzerland | Ayeka, ILikeManyBirds, Mizurii 2, -Spartan, Akani, Skellers, Sil, Niven | |
Taiwan | Shiina Noriko, Rucker, _Shield, DazzLE_Wind, NekoKamui, Spinesnight, , Diaostrophism | |
Thailand | Faken, -Kedama, chantat on osu, minecrafter, ChaiPhukChep, UltimaticCatz, Phirse, Yorocchi | |
Turkey | Raikouhou, Gilraen, heyronii, Misumena, Zeforex, egemenbsrms, Shinkir0, -Kemsyt | |
Ukraine | Kryterion, 1Max, gusniki, kug1, Endless Tilt, netwhynot, dench, magnatagamer123 | |
United Kingdom | Bubbleman, Karthy, bloo, Voss, majoreh, Jemzsee, Kingling, Malteser | |
United States | im a fancy lad, fieryrage, DigitalHypno, Aireu, Aricin, Exarch, Tekkito, Utami | |
Uruguay | daanit, Rebo, Kazuki K, FDX, Rondro, Saphity, El Milanga, Raby | |
Vietnam | Tuon, Ui chan, — Mel -, kiethao, , DaLat, _Kuroni_, Liyuchi |
Troubleshooting
If you are using a 64-bit Windows 7, you may have difficulties installing osu! correctly. Try to install the 64-bit version of .NET Framework, in case it doesn’t come with the osu! installer. Download it here
If game installer throws errors when attempting to install, you can try few things:
- Try reinstalling the latest version of .NET Framework. You can find it here.
- Clean your PC — Scan with anti-virus software, clean the registry. A good program for general clean up is CCleaner. Scan both your computer files and your registry. The installer can fail if there are registry entries from a previous copy of osu! still present on your system.
Installing osu!
- Go to the download page and download the installer.
- Locate and run the installer.
- While the installer is running, there is a ten second period to allow you to select the installation location.
- If you want to change it, click on the text underneath the word, and select the installation location.
- osu! will be installed to that location when the timer is done.
- When the installer is completed, osu! will start up. osu!direct will be used to download some starter beatmaps for you.
- osu! will prompt you to sign in or register.
- If you already have an account, sign in.
- If you need to register, see Registration.
Match results
Grand Finals
Detailed statistics for this round can be found here.
Saturday, November 27, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Germany | 7 | 6 | South Korea | #1 |
Sunday, November 28, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
United States | 7 | 5 | Germany | #1 |
Finals
Detailed statistics for this round can be found here.
Saturday, November 20, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Hong Kong | 2 | 7 | South Korea | #1 |
Canada | 7 | 4 | United Kingdom | #1 |
Sunday, November 21, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Canada | 5 | 7 | South Korea | #1 |
United States | 7 | 6 | Germany | #1 |
Semifinals
Detailed statistics for this round can be found here.
Saturday, November 13, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Japan | 2 | 6 | South Korea | #1 |
Poland | 3 | 6 | Romania | #1 |
United States | 6 | 2 | Hong Kong | #1 |
Sunday, November 14, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
United Kingdom | 6 | 3 | Taiwan | #1 |
Russian Federation | 4 | 6 | Australia | #1 |
Australia | 5 | 6 | United Kingdom | #1 |
Romania | 2 | 6 | South Korea | #1 |
Canada | 2 | 6 | Germany | #1 |
Quarterfinals
Detailed statistics for this round can be found here.
Saturday, November 6, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Australia | 6 | 3 | Singapore | #1 |
Indonesia | 5 | 6 | Romania | #1 |
Taiwan | 6 | 1 | Turkey | #1 |
South Korea | 6 | Norway | #1 | |
Finland | 5 | 6 | China | #1 |
Sweden | 6 | 5 | Philippines | #1 |
Brazil | 6 | 3 | Netherlands | #1 |
France | 6 | 5 | Chile | #1 |
United States | 6 | 3 | United Kingdom | #1 |
Sunday, November 7, 2021
Team A | Team B | Match link | ||
---|---|---|---|---|
Canada | 6 | 1 | Japan | #1 |
China | 3 | 6 | Taiwan | #1 |
Sweden | 3 | 6 | Australia | #1 |
Russian Federation | 5 | 6 | Hong Kong | #1 |
Romania | 6 | 4 | France | #1 |
South Korea | 6 | 3 | Brazil | #1 |
Germany | 6 | 2 | Poland | #1 |
Round of 16
Detailed statistics for this round can be found here.
Saturday, October 30, 2021:
Team A | Team B | Match link | ||
---|---|---|---|---|
Argentina | 1 | 5 | China | #1 |
Uruguay | 1 | 5 | Philippines | #1 |
United States | 5 | Brazil | #1 | |
Canada | 5 | 2 | Taiwan | #1 |
Indonesia | 2 | 5 | Hong Kong | #1 |
Spain | 5 | Romania | #1 |
Sunday, October 31, 2021:
Team A | Team B | Match link | ||
---|---|---|---|---|
Germany | 5 | 2 | Australia | #1 |
Malaysia | 2 | 5 | France | #1 |
Austria | 2 | 5 | Norway | #1 |
United Kingdom | 5 | 4 | South Korea | #1 |
Japan | 5 | 2 | Finland | #1 |
Singapore | 5 | 1 | Ukraine | #1 |
Poland | 5 | 3 | Sweden | #1 |
Czech Republic | 3 | 5 | Netherlands | #1 |
Chile | 1 | 5 | Russian Federation | #1 |
Mexico | 3 | 5 | Turkey | #1 |
Round of 32
Detailed statistics for this round can be found here.
Saturday, October 23, 2021:
Team A | Team B | Match link | ||
---|---|---|---|---|
Hong Kong | 5 | 2 | Turkey | #1 |
United Kingdom | 5 | 3 | Singapore | #1 |
Russian Federation | 5 | China | #1 | |
Indonesia | 5 | 1 | Mexico | #1 |
Romania | 3 | 5 | Taiwan | #1 |
Sunday, October 24, 2021:
Team A | Team B | Match link | ||
---|---|---|---|---|
South Korea | 5 | Ukraine | #1 | |
Brazil | 5 | 1 | Philippines | #1 |
Australia | 5 | 2 | Norway | #1 |
Japan | 5 | 4 | Malaysia | #1 |
Germany | 5 | Austria | #1 | |
Poland | 5 | 1 | Czech Republic | #1 |
Sweden | 5 | 1 | Netherlands | #1 |
France | 3 | 5 | Finland | #1 |
Canada | 5 | 2 | Spain | #1 |
United States | 5 | Uruguay | #1 | |
Chile | 5 | Argentina | #1 |
Qualifiers
The final standings for the Qualifier stage can be found at the following spreadsheet. Detailed statistics for this round can be found here.
Adding skins
See also: Skinning
- Go to the skinning forums and find a skin you like.
- Once you find a skin, download it.
- Depending on how the skinner has packaged their skin, you may need to do different things.
- If the skin is using :
- Open it or drag and drop it into osu!.
- osu! will process the skin and automatically select it for you.
- If the skin is compressed (using , , , etc.):
- Extract it.
- Move the extracted skin folder into the directory of the osu! installation path.
- If osu! is running, the skin will appear in the list only after you press + + + .
- In osu!, go to the Options and search for .
- Scroll down to the option and select the skin you have downloaded.
- If the skin is using :
One of the most popular free rhythm games
Osu! is a free music video game wherein you have to tap, slide, and hold to the rhythm of the song in order to win a high score. Originally created by Dean “peppy” Herbert, this 2D rhythm game features classic and dynamic music gameplay mechanics—being heavily community-oriented with fanmade songs and beatmaps that you can easily download.
Similar to games like StepMania, DJMax, DEEMO, and Cytus, Osu! offers songs from different genres, as well as different difficulty levels to challenge players in earning high scores and perfect runs. This game is available on both PC, mobile, and other gaming consoles.
Is OSU a free game?
Heavily inspired by other rhythm games such as Osu! Tatakae! Ouendan, O2Jam, and Elite Beat Agents, Osu! Is a free-to-play title that uses three basic gameplay mechanics: tapping hit circles, following the sliding of a ball on sliders, and spinning a circle within a large button as fast as you can. The goal is simple as you just have to do these mechanics in time to the beat of the song and the slowly shrinking circles on the buttons.
The interface is easy to follow during gameplay since there are visual cues you can follow such as the numbers on the buttons indicating the order in which you should tap them. The screen will also display UI elements like a health bar, your total score, accuracy, the timer, and the score multiplier. There are four game modes available: osu! or what’s unofficially called “osu!standard”, osu!taiko, osu!catch, and osu!mania.
The first one is simply the normal gameplay, with dynamic placements of the three mechanics to challenge your reflexes. The second is a special version of the rhythm game, Taiko no Tatsujin. The third is a mode that lets you catch fruits to the beat of the music instead of tapping circles. Lastly, osu!mania’s gameplay is similar to Beatmania by default—although you can customize the keys and orientation of the playfield.
Is OSU good for your brain?
What’s amazing about Osu! is that it’s highly popular due to its active online player base and the sheer amount of song selections available. This is all thanks to its competitive leaderboard, the option to play either Solo or Multi rounds with other players, and the innovative in-game editor. This makes the game heavily centered around its community fanbase, especially with the beatmap designers who create their own versions of levels for their chosen songs.
Not only that but you can even customize your experience further by activating in-game mods that decrease or increase the difficulty. However, this game’s most promising feature is its status as a player aid for cursor aim. Osu! is actually recognized as a helpful game recommended by professional gamers for warm-up practices since it primarily uses mouse controls. The only major issue to be found is that it doesn’t have direct access to its song database without the premium osu!direct feature.
Groove to the beat
All in all, Osu! is a popular music game for a good reason. It’s highly customizable and offers tons of content—all provided by its dedicated fanbase. It has various different game modes and even allows you to apply handicaps or score boosters via the in-game mod feature. While you can’t even browse or search for songs through it unless you purchased the premium service, the official website is easy enough to visit.
Adding beatmaps
See also: Beatmaps
There are two ways to add beatmaps, via the website or osu!direct (requires osu!supporter).
Website
- Go to the beatmap listing page and sign in to the website.
- Find a song you would like to play.
- Click on the download icon to save the beatmap on your computer.
- Locate and open the beatmap file, it has an extension.
- osu! will automatically handle the rest for you and load the beatmap.
osu!direct
Note: You need to have an osu!supporter tag and an internet connection to use osu!direct.
- Open osu!, and click the osu!direct button on the right side of the main screen.
- Find a song that you would like to play.
- Double click the the song on the list or click on the right to download it.
- When osu! is done downloading the beatmap, it will automatically load it.
Running osu!
If you are looking to install or test osu! without setting up a development environment, you can consume our binary releases. Handy links below will download the latest version for your operating system of choice:
Latest build:
The iOS testflight link may fill up (Apple has a hard limit of 10,000 users). We reset it occasionally when this happens. Please do not ask about this. Check back regularly for link resets or follow peppy on twitter for announcements of link resets.
If your platform is not listed above, there is still a chance you can manually build it by following the instructions below.
Developing osu!
Please make sure you have the following prerequisites:
- When running on Linux, please have a system-wide FFmpeg installation available to support video decoding.
Downloading the source code
Clone the repository:
git clone https://github.com/ppy/osu cd osu
To update the source code to the latest commit, run the following command inside the directory:
git pull
Building
Build configurations for the recommended IDEs (listed above) are included. You should use the provided Build/Run functionality of your IDE to get things going. When testing or building new components, it’s highly encouraged you use the project/configuration. More information on this is provided .
Visual Studio / Rider users should load the project via one of the platform-specific .slnf files, rather than the main .sln. This will allow access to template run configurations.
You can also build and run osu! from the command-line with a single command:
dotnet run --project osu.Desktop
If you are not interested in debugging osu!, you can add to gain performance. In this case, you must replace with in any commands mentioned in this document.
If the build fails, try to restore NuGet packages with .
Due to a historical feature gap between .NET Core and Xamarin, running CLI from the root directory will not work for most commands. This can be resolved by specifying a target or the helper project at . Configurations have been provided to work around this issue for all supported IDEs mentioned above.
Testing with resource/framework modifications
Sometimes it may be necessary to cross-test changes in osu-resources or osu-framework. This can be achieved by running some commands as documented on the osu-resources and osu-framework wiki pages.
Code analysis
Before committing your code, please run a code formatter. This can be achieved by running in the command line, or using the command in your IDE.
We have adopted some cross-platform, compiler integrated analyzers. They can provide warnings when you are editing, building inside IDE or from command line, as-if they are provided by the compiler itself.
JetBrains ReSharper InspectCode is also used for wider rule sets. You can run it from PowerShell with . Alternatively, you can install ReSharper or use Rider to get inline support in your IDE of choice.