osu!
Personal tools
Namespaces
Variants
Actions

Skinning

From osu!wiki
Jump to: navigation, search


Other Languages

Français Русский Español Bahasa Indonesia 中文 Deutsch 日本語 Português Italiano 


Skinning is one of the fundamentals of all osu! game modes. It enables users to derive from the "original" skin elements and to create their own!

Contents

Skins

Over the years here at osu!, skins have changed dramatically in style. There are various different ways that you can skin, with a few guides on the forums to start you off on how!

Skins vary from "for-fun" skins with some central theme (i.e some anime) that are nigh impossible to play with (such as this) to more serious "pro" skins that maximize play field visibility, minimize visual obtrusions (e.g replacing hitbursts with blank images or star2.png with blank images).

The Basic of Skinning

Skin Versions

Version Changes
1.x 1.0 2007~2013 initial release.
2.x 2.0 2013 global redesign, featuring new spinners, ranking screen alignment changes and overall improvements.
2.1 Same as 2.0, but includes Taiko @2x support as well as Taiko alignment changes to match.
2.2 Introduction of new beatmap panel layout. Includes rotating and scaled stars (rather than "half" stars), thumbnails and improved alignment of all elements.
2.3 Same as 2.2, but includes the new CtB mascot Yuzu, changes in CtB catcher behaviour as well as new CtB-exclusive combobursts.
2.4 Scales the mania combo counter, score, lights and warning arrows when the overall size of the mania stage is decreased.
2.5 Changed the way how osu!mania was skinned in skin.ini file.
Misc. latest Use this in distributed skins that require the latest version of skinning. (different from labeling the skin folder "User")

Label your skin folder "User" if you only want to change a skin element or two (or a few) for your own purposes!

Skin Sets

If your beatmap has any of the elements included in here, all elements of the set must be included even if you need to use default skin elements to complete it. If all sets are included, then you may alternatively just force default skin.

Note: Since 2.0+ (HD* images were supported) use the suffix @2x in the image name to let osu! know that its an HD image! (for example: selection-mod-autoplay@2x.png)

*any @2x images, as the suffix gives it away, should be ONLY twice the height and twice the width of the original![Citation Needed]

Interface

Skin Set Skin Elements Is Animatable? Is Beatmap Skinnable?
(?)
Additional Notes
Welcome Screen menu-background.jpg Unknown
(Likely no)
No osu!Supporter required
menu-snow.png No No By default, will display current game mode icon
triangle.png Unknown
(Likely no)
No osu!Supporter required
As of Jun 10, '15, this was disabled!
options-offset-tick.png No Unknown
(Likely no)
You'll find this image in the offset wizard
Cursor cursor.png No Yes Rotatable and expandable in skin.ini
cursortrail.png No Yes Rotatable in skin.ini
cursormiddle.png No Yes Not rotatable/expandable
cursor.png is required
cursor-smoke.png No Yes
Button button-left.png No No
button-middle.png No No This image is stretched
button-right.png No No
Song Selection menu-back.png Yes No Since 2.4[Citation Needed], new images were used to replace this image.

The problem is, I forgot what the file names were!

menu-button-background.png No Yes Button size is dependent on image!
selection-mode.png No No
selection-mode-over.png No No
selection-random.png No No
selection-random-over.png No No
selection-tab.png No No
selection-mods.png No No
selection-mods-over.png No No
star.png No No Found in: Star Ratings
star2.png No Yes Found in: cursor, kiai time, combobursts
Mode Select mode-osu.png No No
mode-taiko.png No No
mode-fruits.png No No
mode-mania.png No No
mode-osu-small.png No No
mode-taiko-small.png No No
mode-fruits-small.png No No
mode-mania-small.png No No
mode-osu-med.png No No
mode-taiko-med.png No No
mode-fruits-med.png No No
mode-mania-med.png No No
Mod icons
Image here
selection-mod-autoplay.png No Yes Button size is dependent on image!
selection-mod-cinema.png No Yes Click "Auto" Mod once more
Button size is dependent on image!
selection-mod-doubletime.png No Yes Button size is dependent on image!
selection-mod-easy.png No Yes Button size is dependent on image!
selection-mod-fadein.png No Yes Button size is dependent on image!
selection-mod-flashlight.png No Yes Button size is dependent on image!
selection-mod-halftime.png No Yes Button size is dependent on image!
selection-mod-hardrock.png No Yes Button size is dependent on image!
selection-mod-hidden.png No Yes In osu!mania, click "FadeIn" once more
Button size is dependent on image!
selection-mod-key1.png No Yes Button size is dependent on image!
selection-mod-key2.png No Yes Button size is dependent on image!
selection-mod-key3.png No Yes Button size is dependent on image!
selection-mod-key4.png No Yes Button size is dependent on image!
selection-mod-key5.png No Yes Button size is dependent on image!
selection-mod-key6.png No Yes Button size is dependent on image!
selection-mod-key7.png No Yes Button size is dependent on image!
selection-mod-key8.png No Yes Button size is dependent on image!
selection-mod-key9.png No Yes Button size is dependent on image!
selection-mod-keycoop.png No Yes Doubles the [current] keys
Button size is dependent on image!
selection-mod-nightcore.png No Yes Click "Double Time" twice
Button size is dependent on image!
selection-mod-nofail.png No Yes Button size is dependent on image!
selection-mod-perfect.png No Yes Button size is dependent on image!
selection-mod-random.png No Yes Button size is dependent on image!
selection-mod-relax.png No Yes Relax
Button size is dependent on image!
selection-mod-relax2.png No Yes Autopilot
Button size is dependent on image!
selection-mod-spunout.png No Yes Button size is dependent on image!
selection-mod-suddendeath.png No Yes Button size is dependent on image!
selection-mod-target.png No Yes Cutting-Edge Builds Only
Button size is dependent on image!
Scorebar scorebar-bg.png No Yes
scorebar-colour.png Yes Yes
scorebar-ki.png No Yes This is transparent in Version 2.0+
The passing zone
scorebar-kidanger.png No Yes This is transparent in Version 2.0+
The warning zone
scorebar-kidanger2.png No Yes This is transparent in Version 2.0+
The critical zone
scorebar-marker.png No Yes Version 2.0+
This is more prioritized than ki (3 above) elements
Countdown count1.png No Yes Version 1: positioned middle
Version 2: Centered
count2.png No Yes Version 1: positioned top right
Version 2: Centered
count3.png No Yes Version 1: positioned top left
Version 2: Centered
go.png No Yes
ready.png No Yes
Pause Screen pause-overlay.png No Yes This image is scaled (unknown reason)
fail-background.png No Yes
pause-back.png No Yes
pause-continue.png No Yes
pause-replay.png No Yes This replaces ranking-replay.png in Version 2.0
pause-retry.png No Yes This replaces ranking-retry.png in Version 2.0
Score numbers score-0.png No Yes Also used for Combo numbers
score-1.png No Yes
score-2.png No Yes
score-3.png No Yes
score-4.png No Yes
score-5.png No Yes
score-6.png No Yes
score-7.png No Yes
score-8.png No Yes
score-9.png No Yes
score-comma.png No Yes
score-dot.png No Yes
score-percent.png No Yes
score-x.png No Yes
Playfield comboburst-n.png No Yes osu! and CtB only use these.
Should face RIGHT (Could be reflected)
Bottom-Left is the anchor
You can have as many as you want.
Replace n with a consecutive number.
play-skip.png Yes Yes
play-unranked.png No Yes
play-warningarrow.png No Yes Tinted blue (Pause Screen)
Tinted Red (Exiting breaks)
arrow-generic.png Unknown Unknown Unknown use (sugguested to be used in multi-tag games)
Overrides

play-warningarrow.png

arrow-pause.png Unknown Unknown Uncolored
Overrides play-warningarrow.png
arrow-warning.png Unknown Unknown Uncolored
Overrides play-warningarrow.png
masking-border.png Unknown Unknown Pillarboxes for games running storyboards with aspect ratio > 4:3
multi-skipped.png Unknown 'Unknown Seen when a player skips the intro of a map (in multiplayer)
section-fail.png No Yes
section-pass.png No Yes
Input Overlay inputoverlay-background.png No Yes Used in osu! and CtB
Rotated 90° clockwise and streched (x1.05) ingame
inputoverlay-key.png No Yes Used in osu! and CtB
Ranking Panel ranking-accuracy.png No No These got realigned in Version 2.0+
ranking-graph.png No No
ranking-maxcombo.png No No
ranking-panel.png No No
ranking-perfect.png No No
ranking-replay.png No No Version 1.0
This was replaced with
pause-replay.png
ranking-retry.png No No Version 1.0
This was replaced with
pause-retry.png
ranking-title.png No No
ranking-winner.png Unknown No Found in: Multiplayer
Ranking Grades ranking-A.png No No
ranking-A-small.png No Yes
ranking-B.png No No
ranking-B-small.png No Yes
ranking-C.png No No
ranking-C-small.png No Yes
ranking-D.png No No
ranking-D-small.png No Yes
ranking-S.png No No S
ranking-S-small.png No Yes
ranking-SH.png No No Silver S
ranking-SH-small.png No Yes
ranking-X.png No No SS
ranking-X-small.png No Yes
ranking-XH.png No No Silver SS
ranking-XH-small.png No Yes

osu!standard

Skin Set Skin Elements Is Animatable? Is Beatmap Skinnable?
(?)
Additional Notes
Hitcircle Numbers default-0.png No Yes Appears too be x0.8th of their size, ingame
default-1.png No Yes
default-2.png No Yes
default-3.png No Yes
default-4.png No Yes
default-5.png No Yes
default-6.png No Yes
default-7.png No Yes
default-8.png No Yes
default-9.png No Yes
Hitobjects approachcircle.png No Yes
hitcircle.png No Yes
hitcircleoverlay.png Yes Yes Animation runs at 2FPS
hitcircleselect.png No Yes Found in Editor
followpoint.png Yes Yes
lighting.png Unknown Yes Used in osu! and CtB
Shows in kiai time
Slider set sliderbn.png Yes You can have as many as you want.
Replace n with a consecutive number.
Yes
sliderb-nd.png No No background layer of default sliderb
Not skinnable when a custom

sliderb is included

sliderb-spec.png No No lighting layer of default sliderb in fixed position
Not skinnable

when a custom sliderb is included

sliderfollowcircle.png Yes Yes
sliderpoint10.png Unknown Yes Version 1.0
This image is transparent.
sliderpoint30.png Unknown Yes
sliderscorepoint.png Unknown Yes osu! and Taiko uses this
reversearrow.png No Yes Rotated and mirrored to follow sliderpath
Hitbursts hit0.png Yes Yes Animation is fast
Ranking screen will use the 0th

image, if animation is included.

hit50.png Yes Yes
hit100.png Yes Yes
hit100k.png Yes Yes
hit300.png Yes Yes
hit300g.png Yes Yes
hit300k.png Yes Yes
Particle particle50.png No Yes Will work if hitbursts are included!
particle100.png No Yes
particle300.png No Yes
Spinner spinner-background.png No Yes Old style
Using this will enforce the old style, in Version 2.0+
spinner-circle.png No Yes Old style
Also used in Taiko
spinner-metre.png No Yes Old style
This image is transparent.
spinner-osu.png No Yes Version 1.0
spinner-glow.png No Yes New style
Version 2.0+
Always tinted cyan
spinner-bottom.png No Yes New style
Version 2.0+
spinner-middle.png No Yes New style
Version 2.0+
spinner-middle2.png No Yes New style
Version 2.0+
spinner-top.png No Yes New style
Version 2.0+
spinner-approachcircle.png No Yes Also used in Taiko
spinner-clear.png No Yes
spinner-rpm.png No Yes Revolutions (Full Spins) Per Minute
spinner-spin.png No Yes

Taiko

Skin Set Skin Elements Is Animatable? Is Beatmap Skinnable?
(?)
Additional Notes
pippidon pippidonclearn.png Yes Yes You can have as many as you want.
Replace n with a consecutive number.
pippidonfailn.png Yes Yes You can have as many as you want.
Replace n with a consecutive number.
pippidonidlen.png Yes Yes You can have as many as you want.
Replace n with a consecutive number.
pippidonkiain.png Yes Yes You can have as many as you want.
Replace n with a consecutive number.
taiko-slider.png No No
taiko-slider-fail.png No No
taiko-flower-group.png No Yes
Drum taiko-bar-left.png No No
taiko-bar.right.png No No
taiko-bar-right-glow No No
taiko-drum-inner.png No No Since Version 2.1, these elements were realigned
This

image is mirrored for alternative buttons.

taiko-drum-outer.png No No
Hitobjects taikobigcircle.png No No
taikobigcircleoverlay.png Yes No Animation speed dependent of BPM
taikohitcircle.png No Yes Used for finisher/big notes
taikohitcircleoverlay.png Yes Yes Animation speed dependent of BPM
Used for finisher/big notes
taiko-glow.png No Yes Always tinted yellow
Slider taiko-roll-end.png No Yes
taiko-roll-middle.png No Yes Must be 1px wide (2px for @2x)
sliderscorepoint.png No Yes This image was already listed in osu!Standard
Spinner spinner-warning.png No No
spinner-circle.png No No This image was already listed in osu!Standard
spinner-approachcircle.png No No This image was already listed in osu!Standard
Hitbursts taiko-hit0.png Yes Yes
taiko-hit100.png Yes Yes
taiko-hit100k.png Yes Yes Used for finisher/big notes
taiko-hit300.png Yes Yes
taiko-hit300k.png Yes Yes Not shown on ranking screen
taiko-hit300g.png No Yes Only shown on ranking screen

Catch the Beat

Skin Set Skin Elements Is Animatable? Is Beatmap Skinnable?
(?)
Additional Notes
Catcher/Playfield comboburst-fruits-n.png No Yes Combobursts, just for CtB...
You can have as many as you want.


Replace n with a consecutive number.
Should face RIGHT.

fruit-ryuuta.png Yes Yes Version 1.0 - 2.2
Should face RIGHT.
fruit-catcher-fail.png Yes Yes Version 2.3+
Should face RIGHT.
fruit-catcher-idle.png Yes Yes
fruit-catcher-kiai.png Yes Yes
lighting.png No Yes This image was already listed in osu!Standard
Fruits fruit-apple.png No Yes
fruit-apple-overlay.png No Yes
fruit-bananas.png No Yes This image is ALWAYS tinted yellow
fruit-bananas-overlay.png No Yes
fruit-drop.png No Yes
fruit-drop-overlay.png No Yes This image is transparent
fruit-grapes.png No Yes
fruit-grapes-overlay.png No Yes
fruit-orange.png No Yes
fruit-orange-overlay.png No Yes
fruit-pear.ong No Yes
fruit-pear-overlay.png No Yes

osu!mania

Advanced/Detailed article: osu!mania

Since Version 2.5, osu!mania elements are completely customizable, refer to skin.ini for help/reference.

Note: The table below is the default skin and what osu! will look for (for undefined skin.ini)!

Skin Set Skin Elements Is Animatable? Is Beatmap Skinnable?
(?)
Additional Notes
mania hit mania-hit0.png Yes Yes Ranking screen will use the 0th image, if animation is included.
mania-hit50.png Yes Yes
mania-hit100.png Yes Yes
mania-hit200.png Yes Yes
mania-hit300.png Yes Yes
mania-hit300g.png Yes Yes
mania note mania-note1.png Yes No
mania-note2.png Yes No
mania-noteS.png Yes No
mania-note1H.png Yes No Head of hold notes
mania-note2H.png Yes No
mania-noteSH.png Yes No
mania-note1L.png Yes No Body of hold notes
mania-note2L.png Yes No
mania-noteSL.png Yes No
mania-note1T.png Yes No Tail of hold notes
mania-note2T.png Yes No
mania-noteST.png Yes No
mania key mania-key1.png No No Idle State
mania-key2.png No No
mania-keyS.png No No
mania-key1D.png No No Pressed [D]own State
mania-key2D.png No No
mania-keySD.png No No
Stage mania-stage-left.png Yes No
mania-stage-right.png Yes No
mania-stage-bottom.png Yes No This image is transparent
Will not be streched!
mania-stage-light.png Yes No
mania-stage-hint.png No No
mania-warningarrow.png No No This image is transparent
Should face DOWNWARDS
lightingL.png Yes No For hold notes
lightingN.png Yes For single notes

Sounds

Skin Set Skin Elements Is Beatmap Skinnable?
(?)
Additional Notes
Welcome Screen welcome.wav No Supporter required to modify
seeya.wav No Supporter required to modify
heartbeat.wav No
Clicks check-on.wav No
check-off.wav No
select-expand.wav No
select-difficulty.wav No
click-close.wav No
click-short-confirm.wav No
menuback.wav No
menuhit.wav No
Hovers click-short.wav No
menuhit.wav No
Drags whoosh.wav No
sliderbar.wav No
Multiplayer Sounds match-join.wav No
match-leave.wav No
match-ready.wav No
match-notready.wav No
match-confirm.wav No all players are ready
match-start.wav No chat highlight sound
Countdown readys.wav Yes
count3s.wav Yes
count2s.wav Yes
count1s.wav Yes
gos.wav Yes
count.wav No This can be used in place of count#s + gos
This is also the

metronome for target practice mod

Metronome metronomehigh.wav No
metronomelow.wav No
Gameplay comboburst.mp3 Yes Like images, multiple sounds can be included
Appearance can be on

set combo counts

combobreak.wav Yes Plays when player has 20+ combo
sectionpass.wav Yes
sectionfail.wav Yes
failsound.wav Yes
applause.wav Yes
Hitsounds: Drum Set drum-hitnormal.wav Yes mapped as D:C1
drum-hitclap.wav Yes
drum-hitfinish.wav Yes
drum-hitwhistle.wav Yes
drum-sliderslide.wav Yes
drum-slidertick.wav Yes
drum-sliderwhistle.wav Yes
Hitsounds: Normal Set normal-hitnormal.wav Yes mapped as N:C1
normal-hitclap.wav Yes
normal-hitfinish.wav Yes
normal-hitwhistle.wav Yes
normal-sliderslide.wav Yes
normal-slidertick.wav Yes
normal-sliderwhistle.wav Yes
Hitsounds: Soft Set soft-hitnormal.wav Yes mapped as S:C1
soft-hitclap.wav Yes
soft-hitfinish.wav Yes
soft-hitwhistle.wav Yes
soft-sliderslide.wav Yes
soft-slidertick.wav Yes
soft-sliderwhistle.wav Yes
Hitsounds: Spinner Set spinnerspin.wav Yes
spinnerbonus.wav Yes
Taiko Hitsounds: Normal Set taiko-normal-hitnormal.wav Yes mapped as N:C1
taiko-normal-hitclap.wav Yes
taiko-normal-hitfinish.wav Yes
taiko-normal-hitwhistle.wav Yes
Taiko Hitsounds: Soft Set taiko-soft-hitnormal.wav Yes mapped as S:C1
taiko-soft-hitclap.wav Yes
taiko-soft-hitfinish.wav Yes
taiko-soft-hitwhistle.wav Yes
Taiko Hitsounds: Drum Set taiko-normal-hitnormal.wav Yes mapped as D:C1
Only played when mapped and included
taiko-drum-hitclap.wav Yes
taiko-drum-hitfinish.wav Yes
taiko-drum-hitwhistle.wav Yes

Note: you can also use file with format *.mp3 and *.ogg (Although it is sugguested to use *.wav[Citation Needed])

Related articles

References

This article was checked with these two external lists

-Thanks! 123MegaApple123 (talk) 16:59, 25 June 2015 (UTC)