skin.ini

Original 2007 - 2013 skin

If your skin.ini does not specify a Version, it will default to this version.

• Hit circle numbers are part of hitburst explosions.
• Large expansion of hitlighting (lighting.png).
• Old styled spinner (spinner-circle.png, spinner-background.png, and spinner-metre.png).
• Segmented countdown image build-up.
• Smaller selection bar images (87px height max).
• Uncoloured play-warningarrow during end of breaks.
• Version exclusive ranking screen buttons (ranking-replay.png and ranking-retry.png).
• Version exclusive sliderpoints display (sliderpoint10.png and sliderpoint30.png).

UI: positioning changes / osu!: visibility update (reduced clutter).

• High definition skins
  • Use the suffix @2x.png in the skinning element to let osu! know that the skinning element is higher in quality.
• New style spinner (spinner-middle.png, spinner-middle2.png, spinner-top.png, spinner-bottom.png, and spinner-glow.png).
• Countdown sequence instead of segmented image.
  • Countdowns are now centred.
• Hitcircle numbers are no longer part of hitburst explosions.
• Red coloured play-warningarrow during end of breaks.
• Smaller expansion of lighting.png.
• Anchor changes of selectionbar images.
• Positioning changes of ranking screen images (generally, it is shifted down).

osu!taiko positioning changes

• taiko-bar-right.png and taiko-bar-right-glow.png directly sits under taiko-bar-left.png.
• Taiko drum postion changes (allows larger areas).

interface/UI changes

• Thumbnail support.
  • Must be enabled by the user in the Options and be supported by the skin in the skin.ini file.
• Changes star rating display to scaling star.png instead of partially widthed star.png.
• Panel text alignment optimisations.

osu!catch changes

• fruit-ryuuta.png will no longer work from this point forward.
• New catcher states (and images).
• New osu!catch specific combobursts (comboburst-fruits.png).
  • osu! combobursts will no longer be used for osu!catch.

osu!mania stage scaling adjustments

• Downscale combo counter and hitbursts.
• Column lines are drawn on both sides of the column when columns are spaced.
• Introduction of hold note tails on release (works for all versions).

osu!mania column and upscroll adjustments

• New commands:
  • KeyFlipWhenUpsideDown and NoteFlipWhenUpsideDown
  • NoteBodyStyle (stretch, cascade from top, cascade from bottom)
  • LightingNWidth and LightingLWidth

Allow per-type skinning of arrows

• Adds arrow-generic.png, arrow-warning.png and arrow-pause.png.
• Deprecates play-warningarrow.png in favor of the above.

osu!mania specific combobursts

• Adds comboburst-mania.png.
  • Displays on the right side of the stage.

Always the newest version

If your skin folder does not contain a skin.ini file, it will default to this version.

• Never use this when distributing skins! (if a new skin version releases, a skin with its version set to latest might break).
• Always uses the latest version the game supports.

This is not a version, but a special skin folder that is created when the default skin is modified, e.g. by dragging in a custom menu background into the game window (with osu!supporter) or when attempting to modify osu!mania keybinds for the default skin from the options.

A skin in a folder named User will always use the latest skin version, regardless of any speification in skin.ini or otherwise.

After exporting the skin, the filename is <Name>.osk.

• In osu!(lazer), the filename is <Name> (<Author>).osk.

The skin selector uses folder names, not the names given by this option.

• In osu!(lazer), the skin selector options are in the format <Name> (<Author>), or <Name> [<.osk filename>] (<Author>) if the name in skin.ini differs from the name of the .osk file.

In osu!(lazer), after exporting the skin, the filename is <Name> (<Author>).osk.

• In osu!(lazer), the skin selector options are in the format <Name> (<Author>), or <Name> [<.osk filename>] (<Author>) if the name in skin.ini differs from the name of the .osk file.

If the skin.ini file is not present, latest will be used.

If the skin.ini file is present, but does not use the Version command, 1.0 will be used (legacy support).

This will set the framerate of most animations.

Exceptions: circleoverlays, sliderball, pippidon, osu!mania notes and lighting

The default sliderball will always get tinted, if enabled in options.

This is not for osu!taiko.

0 = top-left corner

1 = centred

This is not for osu!taiko.

This only affects the combo burst sounds, not the milestones.

This is for osu! only.

Old command: HitCircleOverlayAboveNumer (with typo) still works for legacy support

This is not for osu!taiko.

This is for osu! only.

Should the spinner add black bars during spins?

Should the spinnerspin sound pitch up the longer the spinner goes?

Should the highest bar of the metre stay visible all the time?

This is used if beatmap skin is disabled or uses default colours.

This appears last.

This is used if beatmap skin is disabled or uses default colours.

This appears first.

This is used if beatmap skin is disabled or uses default colours.

This appears second, if defined.

This is used if beatmap skin is disabled or uses default colours.

This appears third, if defined.

This is used if beatmap skin is disabled or uses default colours.

This appears fourth, if defined.

This is used if beatmap skin is disabled or uses default colours.

This appears fifth, if defined.

This is used if beatmap skin is disabled or uses default colours.

This appears sixth, if defined.

This is used if beatmap skin is disabled or uses default colours.

This appears seventh, if defined.

This is for osu! and osu!catch only..

This tints the numbers shown on the input overlay.

osu!supporter required

This is for osu!.

Default sliderball’s colour if tinting is disabled in options.

This is for osu! only.

This is for osu! only.

Using this will make all slider track colours the same.

colour of star2 during breaks

You can use a custom path

Negative integers will add a gap.

Negative integers will add a gap.

Negative integers will add a gap.

osu! will use a default alpha value.

This is the colour of the catcher itself.

osu! will use a default alpha value.

This is the colour outlining the fruit.

osu! will use a default alpha value.

This is the colour of the images following the catcher after obtaining the hyperdash fruit.

This is required per key set

This is the spacing between the columns

The gap will be transparent.

It is suggested to keep this thin if high keycounts or wide keys are used.

If not defined, the height scale of the smallest column width is used

StageHint, LightingN, and LightingL are drawn at this position

This is only for StageLight.

The hitbursts will be vertically centred on the stage.

The combo counter will be vertically centred on the stage.

This is the hint for when the keys should be pressed.

0 = none

1 = (left (SP) or outer (DP) lane)

2 = (right (SP) or inner (DP) lane)

For even keycounts, more than 4.

For DP, the centre between the stages is used for determining positions.

0 = Left

1 = Right

2 = Both (random)

You can use the words or values, both are accepted.

Combobursts will be flipped on the right stage half.

This value is forced, if defined.

0 = no splitting / forced SP

Each keycount higher than 1 can be split (or merged, if count is higher than 9).

The distance between the two stages, if split.

0 = shows on both stages at the same time

1 = shows when hit on specific stage

For DP, each stage gets shown its own judgement or of both stages

should be used depending on note and key designs.

Act like DDR/StepMania?

Requires skin version 2.5 or higher.

This applies for all columns.

Requires skin version 2.5 or higher.

This applies for the specified column.

Replace # with a valid column index (from 0 to 17).

Requires skin version 2.5 or higher.

This applies for all columns.

Requires skin version 2.5 or higher.

This applies for the specified column’s pressed key state.

Requires skin version 2.5 or higher.

Column specific (for notes)

Requires skin version 2.5 or higher.

Column specific (for head parts)

Requires skin version 2.5 or higher.

Column specific (for length parts)

Requires skin version 2.5 or higher.

Column specific (for tail parts)

Requires skin version 2.5 or higher.

All columns.

Requires skin version 2.5 or higher.

Column specific (for notes)

For the specific column’s background.

# starts at 1

Column specific (StageLight).

# starts at 1

These are the lines that separate the columns.

A bar is one full measure.

This is the colour of the keybindings check before the game starts

This is the colour of the combo counter during holds.

This is the colour of combo counter during a combobreak.

This is for the specific column’s idle key image.

This is for the specific column’s pressed key image.

This is for the specific column’s note image.

This is for the specific column’s hold note head image.

This is for the specific column’s hold note body image.

This is for the specific column’s hold note tail image.

This is the left border.

This is the right border.

This will not be stretched to fit

This is the graphical judgement line.

This is the column lighting.

This appears three barlines before the map starts, if there is enough time.