General Info / Disclaimer
Both listings focus on files present on the Stable (Latest) release stream and may include changes and additions from the cuttingedge release stream.
This listing is based on extensive research from multiple sources (old and current skins, changelog entries, ingame validation, or other threads).
Changes and additions will not always be added immediately when they go live.
Facts are "as it currently is!" Inconsistencies may be due to bugs, mistakes or oversights during coding.
Do not send any requests for access or download of the detailed list! The goal of that list is to have one centralized document with the correct facts and to prevent vandalism!
Reply here or send a PM if there are oversights, wrong facts or mistakes/typos. Suggestions for new tables or columns are welcomed. All of these will be checked and added to the list.
How to read the detailed list
Main navigation, each sheet is shown as a tab.
Coloured boxes are mainly used to seperate sections or files per game mode.
pink = osu! (Standard)
green = osu!taiko (Taiko)
blue = osu!catch (Catch the Beat)
purple = osu!mania (Mania)
orange = used in gameplay
grey = User Interface (UI) or shared stuff
These little markers on boxes can be hovered above and show additional information. They aren't shown if the sheets are viewed per html view.
Notes are infos, facts, or a small description on what this file will do or what attributes and behaviours it holds.
Some cells are merged to not repeat the same notes multiple times.
Legacy support means that these files still get loaded or supported to work for very old skins.
Files are sorted into categories by their usage.
Each image is sorted into these attributes, that show if they can be used on beatmaps, can be animated or on what skin versions they can be used on.
For Version: If there is a number followed by "+", it means that it will work on the listed version first and on all following versions. If there is a number only it will work for that version.
Origins are points where the images are positioned from on the screen or playfield. Some boxes also have notes with exact on screen positions.
Dimension sizes can be used freely, but there are some exceptions where images have a maximum area or minimum area. Measurements of the default images will therefore not be listed.
Measurements listed are recommendations that are free to be followed or ignored.
The blending mode describes how an image is rendered into the game.
"normal" indicates that images are overlaying the background how they are.
"multiplicative" indicates that images can be coloured or change colours during gameplay. If a image is multiplicated by white, it shows up like if it is a "normally" blended image.
"additive" indicates images that behave a bit different from the other two blending modes. The values are added to the layer(s) below the image. Darker colours of the image appear as if they are transparent. The images themselves can also be coloured by the game on a few occasions.
There are two types of lines:
- section header ("[Fonts]")
- normal line ("HitCirclePrefix")
All lines only work if they are placed under the correct section.
They don't need to follow any order.
In case of duplicate lines, only the first line found is used.
Any "[Mania]" section must include the line "Keys:" to work properly. Each keycount needs its own section.
All lines are questions shortened into one command. Values are the answers to these questions.
A value can be:
- a switch type (0/1),
- an RGB(a) colour code (255,128,0),
- an integer (whole/non-decimal number),
- a number,
- or a word.
Some osu!mania lines need a list of values to cover all columns.
Not every line needs to be defined. If a line is missing it will be filled out with the default values that are set by the default skin.
Help / Support
Skinning tutorial (+ skinning support) by MLGnom
RBRat3's element dump + primer on animations (RBRat3 is part of the osu! dev team)
Skinning F.A.Q. by Lyawi
Guide on how to adjust the skin.ini-file by Lyawi
Skinning Guidelines for the forum by deadbeat (global moderator)
Custom Taiko Characters + how they work by Roga-don
Custom Catch The Beat characters by Rolled
Haskorion's Templates (images and PSDs)