#Skinning the Gameplay Interface

The following are the list of elements to customize the gameplay interface. This includes: sharedk, 1k-10k folder names referenced as "{keymode}", along with judgements, grades, numbers, healthbar, scoreboards, combo alerts, and multiplayer.

#Column

#Column Lighting

/{keymode}/Lighting/column-lighting.png

Notes:

• The sprite that is displayed that lights up the column when holding down the respective input key.
• When there is no assigned value for the ColumnLightingOffsetY, the default position will be at the top of receptor.

#Lane Cover

#Top Lane Cover

/{keymode}/LaneCover/cover-top.png

Notes:

• The sprite that is displayed moves up and down depending on corresponding setting's value.

#Bottom Lane Cover

/{keymode}/LaneCover/cover-bottom.png

Notes:

• The sprite that is displayed moves up and down depending on corresponding setting's value.

#Lighting

#Hit Lighting

/{keymode}/Lighting/hitlighting.png

Notes:

• Spritesheet animation name: /{keymode}/Lighting/hitlighting@{rows}x{columns}.png
• When hitting an object, an animation will play to give feedback to the user.
• If animation frames are given, it is played at 180 FPS.
• If no animation frames are given, a default animation is played.

#Hold Lighting

/{keymode}/Lighting/holdlighting.png

Notes:

• Spritesheet animation name: /{keymode}/Lighting/holdlighting@{rows}x{columns}.png
• When holding a long note, a looping animation will play to give feedback to the user.
• If animation frames are given, it is played at 180 FPS.
• If no animation frames are given, a default animation is played.

#Notes

#HitObjects

/{keymode}/HitObjects/note-hitobject-{1-11}.png

Notes:

• The note that falls down the screen for non-hold objects.
• There's an extra texture for the scratch lane, for example: note-hitobject-8.png for 7k.

#HoldHitObjects

/{keymode}/HitObjects/note-holdhitobject-{1-11}.png

Notes:

• The note that falls down the screen for hold objects.
• There's an extra texture for the scratch lane, for example: note-holdhitobject-8.png for 7k.

#HoldBodies

/{keymode}/HitObjects/note-holdbody-{1-11}.png

Notes:

• Spritesheet animation file name: /{keymode}/HitObjects/note-holdbody-{1-11}@{rows}x{columns}.png
• The body of a hold (long) note.
• If animation spritesheet is specified, frames animate at a speed of 30 FPS.
• There's an extra texture for the scratch lane, for example: note-holdbody-8.png for 7k.

#HoldEnds

/{keymode}/HitObjects/note-holdend-{1-11}.png

Notes:

• The image displayed at the end of a hold (long) note.
• There's an extra texture for the scratch lane, for example: note-holdend-8.png for 7k.

#Hit-Object Sheets

/{keymode}/HitObjects/note-hitobject-sheet@{rows}x{columns}.png

Notes:

• The note that falls down the screen for both non-hold and hold objects.
• This can be used by toggling the skin.ini values: UseHitObjectSheet and ColorObjectsBySnapDistance to True.
• If UseHitObjectSheetand UsePerLaneSpriteSheets are set to True, then you define lane by note-hitobject-sheet-{lane}@{rows}x{columns}.png.
• The expected size for a sheet is 9x1.

#Hold-Object Sheets

/{keymode}/HitObjects/note-holdobject-sheet@{rows}x{columns}.png

Notes:

• The note that falls down the screen for hold objects.
• This can be used by toggling the skin.ini values: UseHitObjectSheet and ColorObjectsBySnapDistance to True.
• If UseHitObjectSheetand UsePerLaneSpriteSheets are set to True, then you define lane by note-holdobject-sheet-{lane}@{rows}x{columns}.png.
• If a sheet is not supplied, the HitObject sheet will be used in its place.
• The expected size for a sheet is 9x1.

#Mines

#Mines

/{keymode}/HitObjects/note-mine-{1-11}.png

Notes:

• The mine that falls down the screen for non-hold objects.
• There's an extra texture for the scratch lane, for example: note-mine-8.png for 7k.

#Mine Starts

/{keymode}/HitObjects/note-minestart-{1-11}.png

Notes:

• The mine that falls down the screen for hold (long) objects.
• There's an extra texture for the scratch lane, for example: note-minestart-8.png for 7k.

#Mine Bodies

/{keymode}/HitObjects/note-minebody-{1-11}.png

Notes:

• Spritesheet animation file name: /{keymode}/HitObjects/note-minebody-{1-11}@{rows}x{columns}.png
• The body of a hold (long) mine.
• There's an extra texture for the scratch lane, for example: note-minebody-8.png for 7k.

#Mine Ends

/{keymode}/HitObjects/note-mineend-{1-11}.png

Notes:

• The image displayed at the end of a hold (long) mine.
• There's an extra texture for the scratch lane, for example: note-mineend-8.png for 7k.

#Mine Sheets

/{keymode}/HitObjects/note-mine-sheet@{rows}x{columns}.png

Notes:

• The mine that falls down the screen for mines.
• This can be used by toggling the skin.ini value: UseHitObjectSheet and ColorObjectsBySnapDistance to True.
• If UseHitObjectSheetand UsePerLaneSpriteSheets are set to True, then you define lane by note-mine-sheet-{lane}@{rows}x{columns}.png.
• The expected size for a sheet is 9x1.

#Minestart Sheets

/{keymode}/HitObjects/note-minestart-sheet@{rows}x{columns}.png

Notes:

• The mine that falls down the screen for mine-start.
• This can be used by toggling the skin.ini value: UseHitObjectSheet and ColorObjectsBySnapDistance to True.
• If UseHitObjectSheetand UsePerLaneSpriteSheets are set to True, then you define lane by note-minestart-sheet-{lane}@{rows}x{columns}.png.
• The expected size for a sheet is 9x1.

#Receptors

#Receptors (Up)

/{keymode}/Receptors/receptor-up-{1-11}.png

Notes:

• The image displayed when the input key is not pressed.
• There's an extra texture for the scratch lane, for example: receptor-up-8.png for 7k.

#Receptors (Down)

/{keymode}/Receptors/receptor-down-{1-11}.png

Notes:

• The image displayed when the input key is pressed.
• There's an extra texture for the scratch lane, for example: receptor-down-8.png for 7k.

#Stage

#Stage BG Mask

/{keymode}/Stage/stage-bgmask.png

Notes:

• The stage's background. Notes fall in front of this area.

#Stage Distant Overlay

/{keymode}/Stage/stage-distant-overlay.png

Notes:

• Displayed at the top center of the stage. Commonly used for covering notes at the top of the screen.

#Stage Hit Position Overlay

/{keymode}/Stage/stage-hitposition-overlay.png

Notes:

• An image that is directly over the hitposition, used to indicate where the player should hit.

#Stage Left Border

/{keymode}/Stage/stage-left-border.png

Notes:

• Displayed at the left of the stage. Used purely for aesthetics.

#Stage Right Border

/{keymode}/Stage/stage-right-border.png

Notes:

• Displayed at the right of the stage. Used purely for aesthetics.

#Grades

#Grade Small A

/Grades/grade-small-a.png

Notes:

• The sprite that is displayed next to the accuracy when having 90-94%.
• Displayed in the song select screen leaderboards.

#Grade Small B

/Grades/grade-small-b.png

Notes:

• The sprite that is displayed next to the accuracy when having 80-89%.
• Displayed in the song select screen leaderboards.

#Grade Small C

/Grades/grade-small-c.png

Notes:

• The sprite that is displayed next to the accuracy when having 70-79%.
• Displayed in the song select screen leaderboards.

#Grade Small D

/Grades/grade-small-d.png

Notes:

• The sprite that is displayed next to the accuracy when having less than 70%.
• Displayed in the song select screen leaderboards.

#Grade Small F

/Grades/grade-small-f.png

Notes:

• The sprite that is displayed next to the accuracy when failing a map.
• Displayed in the song select screen leaderboards.

#Grade Small S

/Grades/grade-small-s.png

Notes:

• The sprite that is displayed next to the accuracy when having 95-98%.
• Displayed in the song select screen leaderboards.

#Grade Small SS

/Grades/grade-small-ss.png

Notes:

• The sprite that is displayed next to the accuracy when having 99%.
• Displayed in the song select screen leaderboards.

#Grade Small X

/Grades/grade-small-x.png

Notes:

• The sprite that is displayed next to the accuracy when having 100% accuracy (all marvelous).
• Displayed in the song select screen leaderboards.

#Health Bar

#Health Bar Background

/Health/health-background.png

Notes:

• Spritesheet animation file name: /Health/health-background@{rows}x{columns}.png
• Displayed as the background health bar. This one does not change and only serves as the background of the health gauge.

#Health Bar Foreground

/Health/health-foreground.png

Notes:

• Spritesheet animation file name: /Health/health-foreground@{rows}x{columns}.png
• Displayed in the foreground. This is the healthbar that crops according to the current health.

#Hit Bubbles

#Hit Bubbles Background

/HitBubbles/bubbles-background.png

Notes:

• Spritesheet animation file name: /HitBubbles/bubbles-background@{rows}x{columns}.png
• Displayed as the background hit bubbles.

#Hit Bubble

/HitBubbles/bubble.png

#Judgements

#Judgement Overlay

/Judgements/judgement-overlay.png

Notes:

• Container image that displays the current judgements the player has.
• Can be skinned per judgement: /Judgements/judgement-overlay-{marv, perf, great, good, okay, miss}.png
• Colored according to the JudgeColors skin.ini value when not using per judgement images.
• Setting JudgementCounterFadeToAlpha value to True changes the element's animation to fade with alpha instead of fading with color.

#Judgement Overlay Background

/Judgements/judgement-overlay-background-{marv, perf, great, good, okay, miss}.png

Notes:

• The elements are blank by default.
• Used as a background per judgement overlay.

#Judgement (Marv)

/Judgements/judge-marv.png

Notes:

• Spritesheet animation name: /Judgements/judge-marv@{rows}x{columns}.png
• Displayed when a judgement is received after hitting an object.
• If no spritesheet is specified, it will perform a default animation.

#Judgement (Perf)

/Judgements/judge-perf.png

Notes:

• Spritesheet animation name: /Judgements/judge-perf@{rows}x{columns}.png
• Displayed when a judgement is received after hitting an object.
• If no spritesheet is specified, it will perform a default animation.

#Judgement (Great)

/Judgements/judge-great.png

Notes:

• Spritesheet animation name: /Judgements/judge-great@{rows}x{columns}.png
• Displayed when a judgement is received after hitting an object.
• If no spritesheet is specified, it will perform a default animation.

#Judgement (Good)

/Judgements/judge-good.png

Notes:

• Spritesheet animation name: /Judgements/judge-good@{rows}x{columns}.png}
• Displayed when a judgement is received after hitting an object.
• If no spritesheet is specified, it will perform a default animation.

#Judgement (Okay)

/Judgements/judge-okay.png

Notes:

• Spritesheet animation name: /Judgements/judge-okay@{rows}x{columns}.png
• Displayed when a judgement is received after hitting an object.
• If no spritesheet is specified, it will perform a default animation.

#Judgement (Miss)

/Judgements/judge-miss.png

Notes:

• Spritesheet animation name: /Judgements/judge-miss@{rows}x{columns}.png
• Displayed when a judgement is received after missing a hitobject.
• If no spritesheet is specified, it will perform a default animation.

#Numbers

#Combo Display Numbers

/Numbers/combo-{0-9}.png

Notes:

• Represents the number {0-9} that displays the player's current combo.

#Score/Accuracy/KPS/Rating Numbers

/Numbers/score-{0-9}.png

Notes:

• Represents the number {0-9} that displays the player's current score, accuracy, rating and keys per second.

#Score Display Percent

/Numbers/score-percent.png

Notes:

• Represents the % symbol in the user's accuracy.

#Score Display Decimal

/Numbers/score-decimal.png

Notes:

• Represents the . symbol in the user's accuracy.

#Song Time Display Numbers

/Numbers/song-time-{0-9}.png

Notes:

• Numbers that display the current song time and time left.

#Song Time Display Colon

/Numbers/song-time-colon.png

Notes:

• Displays the : character in the song time display.

#Song Time Display Minus

/Numbers/song-time-minus.png

Notes:

• Displays the - character in the song time display.

#Scoreboard

#Scoreboard User

/Scoreboard/scoreboard.png

Notes:

• Background image is displayed for the current player on the scoreboard.

#Scoreboard Other

/Scoreboard/scoreboard-other.png

Notes:

• Background image is displayed for the all other players in the scoreboard (not including the player themself)

#Scoreboard Avatar Mask

/Scoreboard/scoreboard-avatar-mask.png

Notes:

• The alpha mask for user avatars on the scoreboard.

#Skip Display

#Skip

/Skip/skip.png

Notes:

• Animatable spritesheet file name: /Skip/skip@{rows}x{columns}.png
• Displayed when the player is on a break and is eligible to skip to the next object.

#Combo Alerts

#Combo Alert

/Combo/combo-alert-1.png

Notes:

• Displayed every 100x combo
• You can add multiple combo alerts by adding another file /Combo/combo-alert-1,2,3.....etc and they will be played in the order of the file name.

#Pause Screen

#Pause Continue Button

/Pause/pause-continue.png

Notes:

• The button to continue the map in the pause screen.

#Pause Retry Button

/Pause/pause-retry.png

Notes:

• The button to retry the map in the pause screen.

#Pause Back Button

/Pause/pause-back.png

Notes:

• The button to quit the map in the pause screen.

#Pause Background

/Pause/pause-background.png

Notes:

• Background image that displayed during the pause screen. If none is specified, it will dim to black.

#Background

#Backgrounds

/Backgrounds/*.{png, jpg, jpeg}

Notes:

• Any image in the Backgrounds folder will be loaded.
• Backgrounds are selected based on map hash.
• Images larger than 2560x1440 will be ignored.

#Warnings

#Epilepsy Warning

/Warnings/epilepsy-warning.png

Notes:

• Displayed at the beginning of a map if is tagged with "sv".