AllowSliderBallTint and SliderBallFlip: when the osu! slider ball should take colour (and when it should not)

The slider ball is both a moving target and a piece of artwork. Two skin.ini flags decide whether it stays as you drew it or becomes part of the combo-colour system: AllowSliderBallTint and SliderBallFlip. Getting these wrong is why a carefully painted ball turns brown in-game, or why a simple ball never faces the direction of travel.

AllowSliderBallTint

Under [General] (some older references also discuss it next to slider options):

Tint is not a light overlay on top of a full painting. Dark pixels stay dark, and already-saturated art becomes muddy. If you want both a detailed ball and combo colour, a simple tintable core plus a separate un-tinted additive layer is easier than turning tint on for a finished drawing.

SliderBallFlip

When this is enabled, the ball can flip or orient to follow the slider path, which matters on sharp corners and backwards sections. A ball with a clear front (an arrow, a face, a pointed shape) usually needs this on. A perfectly symmetric ball does not, and flipping it can reveal assumed-left shadows on the opposite side.

If you animate the ball (sliderb0, sliderb1, and so on), flip applies to the whole sequence. A walk-cycle that is drawn only facing right may look correct on rightward sliders and broken on leftward ones unless you designed the frames for the flip.

How to test

  1. Place a long, winding slider on a test map, or play a map with many direction changes.
  2. Toggle tint off and on without changing the PNG. If the ball becomes a flat stain, leave tint off and redesign, or replace the art with a tintable shape.
  3. Watch kiai sections if tint is on — the ball will flash with the combo pulse.
  4. Confirm @2x frames stay aligned with the unscaled ones.

Completed skins on osuskins.org are useful references if you open skin.ini and look at these two lines next to the slider-ball files. Copying only the PNGs without the flags is how a good ball ends up looking like a different object in your folder.


Notes by ZentaoLabs. Skin library: osuskins.org.