#Configuring skin.ini

Sometimes the default configuration for skins may not be good enough and you want to adjust them. By making a skin.ini file in the root directory of the skin folder, you are allowed to manipulate some of the values to change the look of the game.

Important note: If you are modifying the RGBA Colors and if you left the Alpha(opacity of the color) unassigned, it will use the default value, which is 255.

#General

The [General] section of the config file contains metadata about the skin—who it's by, what it's called, and the version—as well as non keymode-specific properties. It's mainly to let people know what your skin is all about.

#Main Menu

The [MainMenu] section contains the modifications of the main menu's colors and the opacity of the audio and note visualizer. The values below may provide effects to the specific textures.

#Navigation

#Affected Textures: navigation-button.png, navigation-button-selected.png, navigation-button-hovered

#Tip Panel

#Affected Textures: tip-panel.png

#News Post Panel

#Affected Textures: news-panel.png

#Footer Jukebox

#Affected Textures: jukebox-overlay.png

#Audio Visualizer & Note Visualizer Values:

#Affected Textures: note-visualizer.png

#Menu Border

The [MenuBorder] section contains modifications for the menu border background. The values below may provide effects for specific textures.

#Menu Borders

#Affected Textures: menu-border-background.png

#Song Selection

The [SongSelect] section contains the possible modifications of song selection menu including the leaderboard panel's color, personal best panel's color, mapset panel's color, mapset banner size, enabling or disabling the map background, and adjusting the map background's brightness. The values below may provide effects for specific textures.

#Leaderboard Panel Values:

#Affected Textures: leaderboard-panel.png

#Personal Best Panel Values:

#Affected Textures: personalbest-panel.png

#Mapset Panel

#Affected Textures: mapset-deselected.png, mapset-selected.png, mapset-hovered.png, mapset-banner-mask.png, status-ranked.png, status-unranked.png, status-notsubmitted.png, status-status-osu.png, status-status-sm.png, game-mode-4k.png, game-mode-7k.png, game-mode-4k7k.png, game-mode-other.png

#Results Screen

The [Results] section contains the possible modifications of results screen background.

#Results Screen Background

#Affected Textures: background.png, background-filter.png

#Gameplay

This section is to manipulate the elements for the Keys game modes

• To start manipulating elements for a specific keymode or sharedk, create a section in the file titled with the format [{keymode}] and have all of your config properties under it.
• Relevant titles: [SHAREDK], [1K],[2K],[3K],[4K],[5K],[6K],[7K],[8K],[9K],[10K]

#Fallbacks

Fallbacks are a great way to make a skin efficently with as few textures as possible, especially across multiple keymodes, as you can re-use the same texture multiple times instead of duplicating with a different filename.

To get started: Use the sharedk folder for all your gameplay textures and [SHAREDK] in skin.ini for all your keymode configuration. Have UseFallback to True and all *Fallbacks = Integer List under each keymode title except for [SHAREDK].

You can overwrite what you've written in [SHAREDK] under each keymode title. For example ColumnSize = 50 in [SHAREDK] with ColumnSize = 100 in [3K] will result in a ColumnSize of 100 in the 3K gamemode.

The integer lists work by starting at lane 1 with subsequent lanes separated by a comma, the number referencing the suffix to the texture in the sharedk folder. For example HoldBodyFallbacks = 1,3 in [1K] will use note-holdbody-1.png for the first lane and note-holdbody-3.png for the scratch lane in the 1K gamemode.

#Notes

#Affected Textures: note-hitobject-{1-11}.png, note-holdhitobject-{1-11}.png, note-holdbody-{1-11}.png, note-holdend-{1-11}.png, note-hitobject-sheet@{rows}x{columns}.png, note-mine-{1-11}.png, note-minestart-{1-11}.png, note-minebody-{1-11}.png, note-mineend-{1-11}.png, note-mine-sheet@{rows}x{columns}.png, note-minestart-sheet@{rows}x{columns}.png

#Playfield

#Affected Textures: column-lighting.png, receptor-up-{1-11}.png, receptor-down-{1-11}.png, stage-bgmask.png, stage-distant-overlay.png, stage-hitposition-overlay.png, stage-left-border.png, stage-right-border.png

#Judgement Burst and Hit Error

#Affected Textures: judge-marv.png, judge-perf.png, judge-great.png, judge-good.png, judge-okay.png, judge-miss.png

#Lighting

#Affected Textures: hitlighting.png, holdlighting.png

#Health Bar

#Affected Textures: health-background.png, health-foreground.png

#Hit Bubbles

#Affected Textures: bubbles-background.png, bubble.png

#Numbers

#Affected Textures: combo-{0-9}.png, score-{0-9}.png, score-percent.png, score-decimal.png

#Combo

#Rating

#Accuracy

#Affected Textures: grade-small-a.png, grade-small-b.png, grade-small-c.png, grade-small-d.png, grade-small-f.png, grade-small-s.png, grade-small-ss.png, grade-small-x.png

#KPS

#Score

#Judgement Counter

#Affected Textures: judgement-overlay.png, judgement-overlay-background-{marv, perf, great, good, okay, miss}.png

Additional Notes:

• JudgeColor{Marv, Perf, Great, Good, Okay, Miss} values also affects: Hitlighting tint if enabled in settings, hiterror and hitbubbles.

#Stage Timing Bar

#Mini song progress bar

#Skip

#Affected Textures: skip.png, skip@{rows}x{columns}.png