Gameplay

Options

Option	Type	Range	Description
HitErrorMeter	HitErrorMeter	N/A	See below
AimErrorMeter	AimErrorMeter	N/A	See below
Score	Score	N/A	See below
HpBar	HpBar	N/A	See below
ComboCounter	ComboCounter	N/A	See below
PPCounter	PPCounter	N/A	See below
HitCounter	HitCounter	N/A	See below
StrainGraph	StrainGraph	N/A	See below
KeyOverlay	KeyOverlay	N/A	See below
ScoreBoard	ScoreBoard	N/A	See below
Mods	Mods	N/A	See below
Boundaries	Boundaries	N/A	See below
Underlay	Underlay	N/A	Allows to set a texture that's under HUD. Always scaled to screen's height. See below
HUDFont	String	N/A	Path to custom PP/UR/hit counter .ttf/.otf font
ShowResultsScreen	Boolean	true/false	Shows the results screen after the play if set to true
ResultsScreenTime	Integer	N/A	The amount of time to show the results screen
ResultsUseLocalTimeZone	Boolean	true/false	Whether results screen should show UTC or user's local time
ShowWarningArrows	Boolean	true/false	Shows warning arrows before the next drain section to signal the resume of gameplay if set to true
ShowHitLighting	Boolean	true/false	Shows hit circle colored glow under the hit result
FlashlightDim	Decimal	0-1	The percentage of dim for the dim area when playing with the flashlight mod
PlayUsername	String	N/A	Username for -play mode
UseLazerPP	Boolean	true/false	Whether experimental lazer changes should be used. Not guaranteed to be up to date (pull requests are listed during launch)

HitErrorMeter

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the hit error meter
Scale	Decimal	≥0	Scale multiplier for the hit error meter
Opacity	Decimal	0-1	Opacity for the hit error meter
XOffset	Decimal	N/A	X offset of hit error meter
YOffset	Decimal	N/A	Y offset of hit error meter
PointFadeOutTime	Decimal	N/A	Time in seconds before error disappears
ShowPositionalMisses	Boolean	true/false	Shows/Hides positional misses (disabled for Relax mod)
PositionalMissScale	Decimal	N/A	How much taller positional miss should be compared to normal errors
ShowUnstableRate	Boolean	true/false	Shows/Hides the unstable rate
UnstableRateDecimals	Integer	≥0	How many decimal points UR text should have
UnstableRateScale	Decimal	0-1	Scale multiplier for the unstable rate
StaticUnstableRate	Boolean	true/false	Should UR text change instantly
ScaleWithSpeed	Boolean	true/false	Whether width of hit error bar should depend on speed modifiers

AimErrorMeter

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the aim error meter
Scale	Decimal	≥0	Scale multiplier for the aim error meter
Opacity	Decimal	0-1	Opacity for the aim error meter
XPosition	Decimal	N/A	X position of aim error meter
YPosition	Decimal	N/A	Y position of aim error meter
PointFadeOutTime	Decimal	N/A	Time in seconds before error disappears
DotScale	Decimal	N/A	Scale of error crosses
Align	String	See below	Origin of aim error meter
ShowUnstableRate	Boolean	true/false	Shows/Hides the unstable rate
UnstableRateScale	Decimal	0-1	Scale multiplier for the unstable rate
UnstableRateDecimals	Integer	≥0	How many decimal points UR text should have
StaticUnstableRate	Boolean	true/false	Should UR text change instantly
CapPositionalMisses	Boolean	true/false	Positional misses are capped at 1.2x of meter's radius
AngleNormalized	Boolean	true/false	Error is relative to positions of hitobjects

Score

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the score
Scale	Decimal	≥0	Scale multiplier for the score
Opacity	Decimal	0-1	Opacity for the score
XOffset	Decimal	N/A	X offset of score meter
YOffset	Decimal	N/A	Y offset of score meter
ProgressBar	String	Bar Pie BottomRight Bottom	Determines how the progress bar looks
ShowGradeAlways	Boolean	true/false	Shows/Hides grade in top right corner
StaticScore	Boolean	true/false	Should score change instantly like in McOsu
StaticAccuracy	Boolean	true/false	Should accuracy change instantly like in McOsu

HpBar

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the HP Bar
Scale	Decimal	≥0	Scale multiplier for the HP Bar
Opacity	Decimal	0-1	Opacity for the HP Bar
XOffset	Decimal	N/A	X offset of the HP Bar
YOffset	Decimal	N/A	Y offset of the HP Bar

ComboCounter

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the combo
Scale	Decimal	≥0	Scale multiplier for the combo
Opacity	Decimal	0-1	Opacity for the combo
XOffset	Decimal	N/A	X offset of the combo counter. Changing this value will disable sliding out on breaks
YOffset	Decimal	N/A	Y offset of the combo counter
Static	Boolean	true/false	Should combo change instantly. Turns off pop animations

PPCounter

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the PP Counter
Scale	Decimal	≥0	Scale multiplier for the PP Counter
Opacity	Decimal	0-1	Opacity for the PP Counter
XPosition	Decimal	N/A	Determines the X position for the PP counter
YPosition	Decimal	N/A	Determines the Y position for the PP counter
Color	HSV	H: 0-360 S: 0-1 V: 0-1	Determines the color for the PP counter in HSV
Decimals	Integer	≥0	How many decimal points PP texts should have
Align	String	See below	Determines alingment for the PP counter. (Example: "CentreLeft")
ShowInResults	Boolean	true/false	Determines if the PP counter will be shown on the results screen
ShowPPComponents	Boolean	true/false	Show Tap,Aim,Flashlight and Acc PP
Static	Boolean	true/false	Should PP change instantly

HitCounter

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the Hit Counter
Scale	Decimal	≥0	Scale multiplier for the Hit Counter
Opacity	Decimal	0-1	Opacity for the Hit Counter
XPosition	Decimal	N/A	Determines the X position for the Hit Counter
YPosition	Decimal	N/A	Determines the Y position for the Hit Counter
Color	List of HSV	H: 0-360 S: 0-1 V: 0-1	Determines the colors for the Hit counter in HSV. Each counter uses subsequent color from the list.
Spacing	Decimal	≥0	Spacing of counters
FontScale	Decimal	≥0	Self explanatory
Align	String	See below	Determines alingment for the Hit Counter. (Example: "CentreLeft")
ValueAlign	String	See below	Determines alingment for numbers. (Example: "CentreLeft")
Vertical	Boolean	true/false	Should subsequent values be shown downwards
Show300	Boolean	true/false	Should perfect hits be counted
ShowSliderBreaks	Boolean	true/false	Should slider breaks be counted

StrainGraph

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the Strain Graph
Scale	Decimal	≥0	Scale multiplier for the Strain Graph
Opacity	Decimal	0-1	Opacity for the Strain Graph
XPosition	Decimal	N/A	Determines the X position for the Strain Graph
YPosition	Decimal	N/A	Determines the Y position for the Strain Graph
Align	String	See below	Determines alingment for the Strain Graph. (Example: "CentreLeft")
Width	Decimal	N/A	Determines the width for the Strain Graph. Bigger value means more detailed graph
Height	Decimal	N/A	Determines the height for the Strain Graph
BgColor	HSV	H: 0-360 S: 0-1 V: 0-1	Determines the background color for the Strain Graph
FgColor	HSV	H: 0-360 S: 0-1 V: 0-1	Determines the progress color for the Strain Graph

KeyOverlay

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the key overlay
Scale	Decimal	≥0	Scale multiplier for the key overlay
Opacity	Decimal	0-1	Opacity for the key overlay
XOffset	Decimal	N/A	X offset of the key overlay
YOffset	Decimal	N/A	Y offset of the key overlay

ScoreBoard

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the scoreboard
Scale	Decimal	≥0	Scale multiplier for the scoreboard
Opacity	Decimal	0-1	Opacity for the scoreboard
XOffset	Decimal	N/A	X offset of the scoreboard
YOffset	Decimal	N/A	Y offset of the scoreboard
ModsOnly	Boolean	true/false	Mod leaderboards. For NM plays it will show only NM scores
AlignRight	Boolean	true/false	Should scoreboard look like 2nd multiplayer team
HideOthers	Boolean	true/false	Show only the player be shown in the scoreboard
ShowAvatars	Boolean	true/false	Show player avatars. May be bandwith intensive
ExplosionScale	Decimal	N/A	Scale of the explosions during overtakes

Mods

Option	Type	Range	Description
Show	Boolean	true/false	Shows/Hides the mods
Scale	Decimal	≥0	Scale multiplier for the mods
Opacity	Decimal	0-1	Opacity for the mods
XOffset	Decimal	N/A	X offset of the mod display
YOffset	Decimal	N/A	Y offset of the mod display
HideInReplays	Boolean	true/false	Shows mods at the beginning and hides them at the start of drain time in replays
FoldInReplays	Boolean	true/false	Mod icons are closer to each other like in play mode
AdditionalSpacing	Decimal	N/A	Additional X spacing between mod icons

Boundaries

Option	Type	Range	Description
Enabled	Boolean	true/false	Enables/Disables the boundaries
BorderThickness	Decimal	N/A	Thickness of the boundaries
BorderFill	Decimal	N/A	Determines the filling of the boundaries. (Max 1)
BorderColor	HSV	N/A	Determines the color for the boundaries in HSV
BorderOpacity	Decimal	0-1	Opacity for the boundaries
BackgroundColor	HSV	N/A	Determines the color of the inside of the boundaries
BackgroundOpacity	Decimal	0-1	Opacity of the inside of the boundaries.

Underlay

Option	Type	Range	Description
Path	String	N/A	Self explanatory
AboveHpBar	Bool	true/false	Should underlay be drawn above the health bar (which backgrounds can be obtrusive depending on skin)

Alignment values

• TopLeft
• Centre
• CentreLeft = Left
• TopRight
• BottomCentre = Bottom
• TopCentre = Top
• CentreRight = Right
• BottomLeft
• BottomRight

Default values

"Gameplay": {
	"HitErrorMeter": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0,
		"PointFadeOutTime": 10,
		"ShowPositionalMisses": true,
		"PositionalMissScale": 1.5,
		"ShowUnstableRate": true,
		"UnstableRateDecimals": 0,
		"UnstableRateScale": 1,
		"StaticUnstableRate": false,
		"ScaleWithSpeed": false
	},
	"AimErrorMeter": {
		"Show": false,
		"Scale": 1,
		"Opacity": 1,
		"XPosition": 1350,
		"YPosition": 650,
		"PointFadeOutTime": 10,
		"DotScale": 1,
		"Align": "Right",
		"ShowUnstableRate": false,
		"UnstableRateScale": 1,
		"UnstableRateDecimals": 0,
		"StaticUnstableRate": false,
		"CapPositionalMisses": true,
		"AngleNormalized": false
	},
	"Score": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0,
		"ProgressBar": "Pie",
		"ShowGradeAlways": false,
		"StaticScore": false,
		"StaticAccuracy": false
	},
	"HpBar": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0
	},
	"ComboCounter": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0,
		"Static": false
	},
	"PPCounter": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XPosition": 5,
		"YPosition": 150,
		"Color": {
			"Hue": 0,
			"Saturation": 0,
			"Value": 1
		},
		"Decimals": 0,
		"Align": "CentreLeft",
		"ShowInResults": true,
		"ShowPPComponents": false,
		"Static": false
	},
	"HitCounter": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XPosition": 5,
		"YPosition": 190,
		"Color": [
			{
				"Hue": 0,
				"Saturation": 0,
				"Value": 1
			}
		],
		"Spacing": 48,
		"FontScale": 1,
		"Align": "Left",
		"ValueAlign": "Left",
		"Vertical": false,
		"Show300": false,
		"ShowSliderBreaks": false
	},
	"StrainGraph": {
		"Show": true,
		"Opacity": 1,
		"XPosition": 5,
		"YPosition": 310,
		"Align": "BottomLeft",
		"Width": 130,
		"Height": 70,
		"BgColor": {
			"Hue": 0,
			"Saturation": 0,
			"Value": 0.2
		},
		"FgColor": {
			"Hue": 297,
			"Saturation": 0.4,
			"Value": 0.92
		}
	},
	"KeyOverlay": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0
	},
	"ScoreBoard": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0,
		"ModsOnly": false,
		"AlignRight": false,
		"HideOthers": false,
		"ShowAvatars": false,
		"ExplosionScale": 1
	},
	"Mods": {
		"Show": true,
		"Scale": 1,
		"Opacity": 1,
		"XOffset": 0,
		"YOffset": 0,
		"HideInReplays": false,
		"FoldInReplays": false,
		"AdditionalSpacing": 0
	},
	"Boundaries": {
		"Enabled": true,
		"BorderThickness": 1,
		"BorderFill": 1,
		"BorderColor": {
			"Hue": 0,
			"Saturation": 0,
			"Value": 1
		},
		"BorderOpacity": 1,
		"BackgroundColor": {
			"Hue": 0,
			"Saturation": 1,
			"Value": 0
		},
		"BackgroundOpacity": 0.5
	},
	"Underlay": {
		"Path": "",
		"AboveHpBar": false
	},
	"HUDFont": "",
	"ShowResultsScreen": true,
	"ResultsScreenTime": 5,
	"ResultsUseLocalTimeZone": false,
	"ShowWarningArrows": true,
	"ShowHitLighting": false,
	"FlashlightDim": 1,
	"PlayUsername": "Guest",
	"UseLazerPP": false
}