Skip to content

Legacy configuration reference (before 2.1.0-preview6) ​

Words
3782 words
Reading time

Version notice

This page describes the single-file settings.json used before 2.1.0-preview6. Starting with 2.1.0-preview6, the configuration is split into settings.json and system-settings.json; read the configuration reference first. This page is kept only for older versions, and the new game migrates old configurations automatically.

TIP

This page explains every setting in the configuration file settings.json item by item, and gives the default value of each one when it is generated automatically on first run.

WARNING

Make sure the game is fully closed before changing the configuration. Any file edited manually while the game is running will be overwritten the next time the game saves its settings. If you are not familiar with JSON, use an editor with syntax checking, such as VSCode.

Before reading the tables below, note the following:

  • Default value means the value built into the program (the initial value of each setting property in the code), which is the value generated on first run. The values in your file may differ from the tables below.
  • Some items differ by platform and are marked Windows or Mobile (Android / iOS) in their description. The tables below focus on the Windows version.
  • Items marked Hidden do not appear in the in-game settings interface and can only be changed in the configuration file.
  • Items marked Not written do not appear in settings.json.

Top-level structure ​

SectionMeaningContents
GameGame settingsNote speed, displayed information, retry / skip, random and mirror, and more
JudgeJudgment settingsVarious offsets and judgment modes
DisplayDisplay settingsSkin, judgment display, scaling, rendering and window
AudioAudio settingsVolume, audio backend and buffers
DebugDebugTouch simulation, render pools, log level, and more
OnlineNetworkingOnline account and API endpoints
IOInput / output devicesArcade controller, touch panel and LED
ModModNot written, applies only to the current chart

Game —— Game settings ​

ItemTypeDefault valueMeaning
TapSpeedFloat7.5Tap speed, adjusts note speed. Step 0.25, can be negative (notes fall in reverse)
TouchSpeedFloat7.5Touch speed, adjusts Touch note speed. Step 0.25
SlideFadeInOffsetFloat0.0Slide fade-in offset, adjusts Slide timing; increasing the value delays it
BackgroundDimFloat0.8Background dim, the larger the value, the darker. Range 0–1, step 0.05
StarRotationBooleantrueStar rotation, rotates the star head
BGInfoEnum"Combo"Center display, adjusts the information shown in the center of the screen
SecondaryBGInfoEnum"None"Additional info display, adjusts the information shown in the lower middle of the screen
SubScreenBGInfoEnum"Achievement"Sub-screen info display, adjusts the information shown on the sub-screen
TopInfoEnum"None"Outer frame display, the information shown at the top (between keys 1 and 8)
EnableJudgeTimingGaugeBooleanfalseShow judgment timing indicator, shows the real-time judgment offset and the average judgment position
TrackSkipBooleantrueSkip track, hold keys 2, 3, 6 and 7 to forcibly skip the track
EnforceGameFailureEnum"Disabled"Force track failure, automatically skip or retry when the goal cannot be reached
FastRetryBooleantrueFast retry, hold keys 3, 4, 5 and 6 to retry quickly
FastPracticeBooleanfalseFast practice, hold keys 1, 2, 7 and 8 to enter practice mode (starts 5 seconds before the section, extends 10 seconds after)
GameplaySubScreenClickBehaviorEnum"TrackSkip"Sub-screen click behavior during gameplay, adjusts what clicking the sub-screen does while playing. Defaults to "TrackSkip_1_Sec_Delay" on mobile
MirrorEnum"Off"Mirror, flips the chart horizontally / vertically
RotationInteger0Rotation, rotates the chart by an angle; a positive value is clockwise. Range -7–7
SlideSkippingBooleantrueSlide skipping, enables / disables the Slide skip mechanism
RandomEnum"Disabled"Random, shuffles notes randomly
RecordModeEnum"Disable"Record mode, only present on Windows / Linux / macOS
LeadInTimeInteger1Lead-in time, the number of seconds to wait after entering the gameplay screen before the game actually starts. Range 1–5
ManualStartGameBooleanfalseManual start, press a key to start after loading (used for competitions)

Game enum values ​

ItemValueMeaning
BGInfo / SecondaryBGInfo / SubScreenBGInfoCPComboCritical Perfect Combo
PComboPerfect Combo
ComboCombo
Achievement_101Achievement (101-)
Achievement_100Achievement (100-)
AchievementAchievement
AchievementClassicalFiNALE achievement
AchievementClassical_100FiNALE achievement (100-)
DXScoreDX score
DXScoreRankDX score rank
S_BorderDistance to S
SS_BorderDistance to SS
SSS_BorderDistance to SSS
MyBestDistance to best score
DiffJudgment error
NoneNone
TopInfoNoneNot shown
JudgeJudgment result
TimingFast / Late
EnforceGameFailureDisabledOff
TrackSkip_S / Retry_SSkip track / S, retry / S
TrackSkip_SS / Retry_SSSkip track / SS, retry / SS
TrackSkip_SSS / Retry_SSSSkip track / SSS, retry / SSS
TrackSkip_SSSPlus / Retry_SSSPlusSkip track / SSS+, retry / SSS+
TrackSkip_Best / Retry_BestSkip track / best score, retry / best score
TrackSkip_FC / Retry_FCSkip track / FC, retry / FC
TrackSkip_AP / Retry_APSkip track / AP, retry / AP
GameplaySubScreenClickBehaviorNoneNone
TrackSkipSkip track
TrackSkip_1_Sec_DelaySkip track (hold for 1 second)
FastRetryFast retry
FastRetry_1_Sec_DelayFast retry (hold for 1 second)
MirrorOffOff
LRMirrorLeft-right mirror
UDMirrorUp-down mirror
RandomDisabledDisabled
RANDOMRandom by track
S_RANDOMRandom for each note independently
RecordModeDisableDisabled
OBSTriggerConnect to the OBS WebSocket to trigger recording automatically

Judge —— Judgment settings ​

ItemTypeDefault valueMeaning
AudioOffsetFloat0.0Audio offset (A judgment), play by ear. Adjust when notes are out of sync with the music. If you get mostly Fast, decrease the value; if you get mostly Late, increase it. This item moves the answer sound, equivalent to &first in a chart
JudgeOffsetFloat0.0Judgment offset (B judgment), play by sight, compensates for device input latency. If you get mostly Fast, decrease the value; if you get mostly Late, increase it
AnswerOffsetFloat0.0Answer sound offset, adjusts when the answer sound plays (does not affect judgment). Decrease the value to play it earlier, increase it to play it later. Do not change this unless you are sure
TouchPanelOffsetFloat0.0Inner screen input offset, compensates for touch input latency. If you get mostly Fast, decrease the value; if you get mostly Late, increase it
ModeEnum"Modern"Judgment mode, selects the game's judgment and scoring mode (old frame / new frame)

Judge enum values ​

ItemValueMeaning
ModeClassicClassic (old frame)
ModernModern (new frame)

Display —— Display settings ​

ItemTypeDefault valueMeaning
LanguageString""Language. Empty by default in the source code; after the first run the program writes the current language, in the form "zh-CN - Majdata"
SkinString"default"Note skin, changes the note skin. If the configured skin does not exist, the program falls back to the first available skin
DisplayCriticalPerfectBooleanfalseShow Critical judgments, shows Critical judgments
DisplayBreakScoreBooleantrueShow Break score, shows the detailed score of Break notes
FastLateTypeEnum"Disable"Fast / Late display level, sets the condition for showing a note's Fast / Late. The text is only shown below this level
NoteJudgeTypeEnum"All"Note judgment display level, sets the condition for showing Note judgments. The text is only shown below this level
TouchJudgeTypeEnum"All"Touch judgment display level, sets the condition for showing Touch judgments. The text is only shown below this level
SlideJudgeTypeEnum"All"Slide judgment display level, sets the condition for showing Slide judgments. The text is only shown below this level
BreakJudgeTypeEnum"All"Break judgment display level, sets the condition for showing Break judgments. The text is only shown below this level
BreakFastLateTypeEnum"Disable"Break Fast / Late display level, sets the condition for showing a Break's Fast / Late. The text is only shown below this level
SlideSortOrderEnum"Modern"Slide sort order, Slide ordering: with Classic, older notes are on the bottom; with Modern, older notes are on top (affects star coloring)
OuterJudgeDistanceFloat1.0Outer judgment display distance, adjusts the display distance of outer judgment text (the smaller, the closer to the center). Range 0–1, step 0.05, 0 disables it
InnerJudgeDistanceFloat1.0Inner judgment display distance, adjusts the display distance of Touch judgment text (the smaller, the closer to the center). Range 0–1, step 0.05, 0 disables it
DisplayHoldHeadJudgeResultBooleanfalseShow Hold head judgment, shows the judgment result of the Hold head
TapScaleFloat1.0Tap scale, adjusts the size of Tap notes. Range 0–2, step 0.01
HoldScaleFloat1.0Hold scale, adjusts the size of Hold notes. Range 0–2, step 0.01
TouchScaleFloat1.0Touch scale, adjusts the size of Touch notes. Range 0–2, step 0.01
SlideScaleFloat1.0Slide scale, adjusts the size of Slide notes (does not affect Wifi Slide). Range 0–2, step 0.01
TouchFeedbackEnum"Outer_Only"Touch feedback, sets the condition for showing touch feedback
ResolutionString"1080x1920"Resolution Hidden, cannot be adjusted. Only present on Windows / Linux / macOS
MainScreenTransformBooleanfalseCustom screen aspect ratio, customizes the scale and position of the main screen. Defaults to true on mobile
MainScreenScaleFloat1.0Main screen scale, adjusts the overall size of the main screen. Range 0.05–1.5, step 0.01
MainScreenOffsetFloat1.0Main screen position offset, fine-tunes the position of the main screen. Range -1–1, step 0.01
MainScreenCachedScreenCenterYFloat960.0Main screen center Y (cached) Hidden, the cached vertical center coordinate of the main screen
SubDisplayOffsetFloat0.0Sub-screen position offset, fine-tunes the position of the sub-display area. Range -5–5, step 0.01
SubDisplayScaleFloat1.0Sub-screen scale, adjusts the size of the sub-display area. Step 0.01
GameplayScreenRotationAngleEnum"Zero"Gameplay screen rotation, rotates the gameplay screen
RenderQualityEnum"Medium"Render quality, the higher the value, the sharper the image. Defaults to "Low" on mobile
RenderScaleInteger100Render scale, adjusts the internal render resolution. 100 is the native resolution; lowering it reduces GPU load, but the image and text become blurry. It does not change the layout or judgment. Range 50–100, step 5. Defaults to 75 on mobile
TopmostBooleanfalseAlways on top Hidden, keeps the window on top. Only present on Windows / Linux / macOS
FPSLimitInteger120Frame rate limit, limits the maximum frame rate. Minimum -1 (-1 means unlimited), step 1
VSyncBooleantrueVertical sync, whether to enable vertical sync. Not present on mobile
SkipVideoDownloadBooleanfalseSkip video download, does not download videos for online charts

Display enum values ​

ItemValueMeaning
FastLateType / NoteJudgeType / TouchJudgeType / SlideJudgeType / BreakJudgeType / BreakFastLateTypeAllAll
BelowCPBelow Critical
BelowPBelow Perfect
BelowGRBelow Great
MissOnlyMiss only
DisableDisabled
SlideSortOrderClassicClassic order (older notes on the bottom)
ModernModern order (older notes on top)
TouchFeedbackAllAll
Outer_OnlyOuter only
Inner_OnlyInner only
DisableDisabled
GameplayScreenRotationAngleZero0°
_9090°
_180180°
_270270°
RenderQualityVeryLowVery low
LowLow
MediumMedium
HighHigh
VeryHighVery high
UltraUltra

Audio —— Audio settings ​

ItemTypeDefault valueMeaning
ForceMonoBooleanfalseForce mono, mixes the audio down to a mono output
VolumeObjectSee belowVolume settings, the volume of each track
WasapiObjectSee belowWASAPI settings, only present on Windows
AsioObjectSee belowASIO settings, only present on Windows
ChannelObjectSee belowChannel volume, only present on Windows / Linux / macOS
BassObjectSee belowBASS audio buffer settings, present on all platforms
BackendEnum"Wasapi"Audio backend. Defaults to "Wasapi" on Windows and "BassSimple" on mobile

Audio.Volume —— Volume ​

All items have a range of 0–2 with a step of 0.05.

ItemDefault valueMeaning
Global0.3Global, adjusts the master volume
BGM1.0Background music, adjusts the volume of background music outside gameplay (song select, results)
Track1.0Chart music, adjusts the volume of in-game music
Answer0.8Answer sound, adjusts the volume of the answer sound and the opening metronome
Tap0.3Tap / Hold judgment sound, adjusts the judgment volume of Tap / Hold
Ex0.3Ex judgment sound, adjusts the judgment volume of Ex notes
Break0.3Break judgment sound, adjusts the judgment volume of Break notes
Slide0.3Slide judgment sound, adjusts the volume of Slide sound effects
Touch0.3Touch judgment sound, adjusts the judgment volume of Touch / TouchHold
Hanabi0.3Hanabi sound effect, adjusts the volume of the Touch firework sound effect
Voice1.0Xiaoxiao Lanbai, adjusts the volume of the assistant voice

TIP

The built-in default of Global is 0.3; if your file contains a different value, the item has been changed (or comes from an earlier version's default).

Audio.Wasapi —— WASAPI settings (Windows only) ​

ItemDefault valueMeaning
ExclusivetrueExclusive mode, takes exclusive control of the audio device. Only when this is off can other programs such as OBS record / play audio at the same time
RawModetrueRaw mode, uses raw data that has not been processed by the system mixer
AsyncModetrueAsynchronous mode, uses asynchronous audio processing. Configuration files generated by some older versions may not contain this item; when it is missing, it is treated as true
BufferSize0.02Buffer size, in seconds
Period0.005Period, in seconds

Audio.Asio —— ASIO settings (Windows only) ​

ItemDefault valueMeaning
DeviceIndex0Device index, the ASIO device number
SampleRate44100Sample rate, the audio sample rate (Hz)

Audio.Channel —— Channel volume (desktop only) ​

ItemDefault valueMeaning
FrontVolume1.0Front channel (LF / RF) volume
CenterAndLFEVolume1.0Center and LFE channel (Center / LFE) volume
SideVolume1.0Side channel (LS / RS) volume
RearVolume1.0Rear channel (LR / RR) volume

Audio.Bass —— BASS buffer settings ​

ItemDefault valueMeaning
BufferLengthMs1000Buffer length, in milliseconds
UpdatePeriodMs200Update period, in milliseconds
DeviceBufferLengthMs64Device buffer length, in milliseconds. Defaults to 32 on mobile
DeviceUpdatePeriodMs16Device update period, in milliseconds. Defaults to 8 on mobile
EnableAAudiotrueEnable AAudio, only present on Android

Audio enum values ​

ItemValueMeaning
BackendUnityUnity built-in audio
WasapiWASAPI (Windows)
AsioASIO (low latency for professional sound cards)
BassSimpleBASS simplified backend (default on mobile)

Debug —— Debug ​

ItemTypeDefault valueMeaning
DisplaySensorBooleanfalseShow sensors, highlights the touch areas that are being triggered
TouchSimulationRadiusFloat0.5Simulated touch radius, the size of the simulated touch point; the larger the value, the larger the finger judgment area (only takes effect during gameplay). Range 0–2, step 0.05
TouchAAreaExtraRadiusFloat0.0Simulated touch area A radius, expands the trigger radius of touch area A. Range 0–2, step 0.05
TouchBAreaExtraRadiusFloat0.0Simulated touch area B radius, expands the trigger radius of touch area B
TouchCAreaExtraRadiusFloat0.25Simulated touch area C radius, expands the trigger radius of touch area C
TouchDAreaExtraRadiusFloat0.2Simulated touch area D radius, expands the trigger radius of touch area D
TouchEAreaExtraRadiusFloat0.1Simulated touch area E radius, expands the trigger radius of touch area E
TouchRadiusAdjustFloat0.0Touch area ratio, adjusts the touch trigger range according to the finger contact area; 0 disables it. Range 0–2
DisplayRuntimeInfoBooleantrueShow frame rate and version, shows the frame rate and version in the upper right corner
FullScreenBooleantrueForce full screen Hidden, only present on Windows / Linux / macOS
MenuOptionIterationSpeedInteger45Menu option repeat speed Hidden, the larger the value, the faster the scrolling
DisplayOffsetFloat0.0Frame offset, compensates for frame latency. Do not change this unless you are sure
NoteAppearRateFloat0.265Note fade-in offset, adjusts the note fade-in effect. Step 0.001
OffsetUnitEnum"Frame"Offset unit, adjusts the unit of the various offsets
HideCursorInGameBooleantrueHide cursor during gameplay Hidden, only present on Windows / Linux / macOS
NoteFoldingBooleantrueNote folding Hidden, folds the note display
DJAutoPolicyEnum"Strict"DJAuto policy, Strict: only one of keys or touch may be used. Permissive: the two may be mixed
MaxQueuedFramesInteger2Maximum queued frames Hidden, the maximum number of frames allowed to wait in the queue to be processed
TapPoolCapacityInteger96Tap object pool capacity Hidden, defaults to 48 on mobile
HoldPoolCapacityInteger96Hold object pool capacity Hidden, defaults to 48 on mobile
TouchPoolCapacityInteger64Touch object pool capacity Hidden
TouchHoldPoolCapacityInteger64TouchHold object pool capacity Hidden
EachLinePoolCapacityInteger48Object pool capacity per track Hidden, defaults to 24 on mobile
DebugLevelEnum"Info"Log level Hidden, the minimum level of the logs that are output

Debug enum values ​

ItemValueMeaning
OffsetUnitFrameFrame
SecondSecond
DJAutoPolicyStrictStrict
PermissivePermissive
DebugLevelDebug / Info / Warning / Error / FatalDebug / Info / Warning / Error / Fatal

Online —— Networking ​

TIP

Want to submit scores to leaderboards / save records? Want to play online charts directly in the game? Read Online services first.

The items in this section are Hidden in the in-game settings interface. On iOS, the corresponding settings are located in the system Settings app.

ItemTypeDefault valueMeaning
EnableBooleanfalseEnable networking, whether to enable online features
UseProxyBooleantrueUse proxy, only present on Windows / Linux / macOS
ProxyString""Proxy address, only present on Windows / Linux / macOS
ApiEndpointsArraySee belowAPI endpoint list, multiple servers can be configured

Online.ApiEndpoints[] —— Endpoints ​

Contains one MajdataNET entry by default:

ItemTypeDefault valueMeaning
NameString"MajdataNET"Name, the display name of the endpoint
UrlString"https://majdata.net/api3/api/"API address, the server's API root address
UsernameString"YourUsername"Username, the prefilled account
PasswordString"YourPassword"Password, the prefilled password
AutoLoginBooleanfalseAuto login, signs in automatically at startup

IO —— Input / output devices ​

This section is Hidden in the in-game settings interface and is mainly used for external arcade controllers and LEDs. See External devices for details.

ItemTypeDefault valueMeaning
ManufacturerEnum / nullnullDevice manufacturer, null means auto-detect. Only present on Windows / Linux / macOS
InputDeviceObjectSee belowInput device
OutputDeviceObjectSee belowOutput device. Only present on Windows / Linux / macOS

IO.InputDevice ​

ItemTypeDefault valueMeaning
PlayerInteger1Player number, the gamepad player index. Only present on desktop
ButtonRingObjectSee belowButton ring (arcade controller buttons). Only present on desktop
TouchPanelObjectSee belowTouch panel. Only present on desktop
ExternalButtonRingEnum"None"External button ring, only present on mobile. "None" none / "Keyboard" keyboard / "Gamepad" gamepad

IO.InputDevice.ButtonRing ​

ItemDefault valueMeaning
EnabletrueEnable, whether to enable button ring input
TypenullDevice type, null automatic; can be "Keyboard" keyboard / "HID" HID device
DebouncefalseEnable debounce, whether to enable key debounce
PollingRateMs0Polling interval, in milliseconds; 0 means unlimited
DebounceThresholdMs0Debounce threshold, in milliseconds
HidOptionsSee belowHID device parameters

IO.InputDevice.TouchPanel ​

ItemDefault valueMeaning
EnabletrueEnable, whether to enable touch panel input
DebouncefalseEnable debounce, whether to enable touch debounce
SensitivitiesA–E all 0Sensitivity, the touch sensitivity of areas A–E
PollingRateMs0Polling interval, in milliseconds
DebounceThresholdMs0Debounce threshold, in milliseconds
SerialPortOptionsSee belowSerial port parameters, Port / BaudRate both default to null
UsbOptionsSee belowUSB device parameters
CapacitivePanelOptionsSee belowCapacitive touch panel parameters

IO.InputDevice.TouchPanel.CapacitivePanelOptions ​

ItemDefault valueMeaning
TouchRadius30Touch radius, the capacitive touch judgment radius
RadiusOffsetA:0 B:20 C:0 D:0 E:25Radius offset, fine-tunes the radius of areas A–E

IO.OutputDevice.Led ​

ItemDefault valueMeaning
EnabletrueEnable, whether to enable LED output
Brightness1.0Brightness, the LED brightness
RefreshRateMs16Refresh interval, in milliseconds
ThrottlertrueThrottler, limits the LED refresh rate
SerialPortOptionsPort / BaudRate both nullSerial port parameters
HidOptionsSee belowHID device parameters

IO common parameters ​

HidOptions and UsbOptions have the same structure:

ItemDefault valueMeaning
DeviceNamenullDevice name, specifies the device name (leave empty to match automatically)
ProductIdnullProduct ID (PID)
VendorIdnullVendor ID (VID)
ExclusicefalseExclusive mode. The field name is spelled Exclusice in the configuration file

HidOptions additionally contains:

ItemDefault valueMeaning
OpenPriority"VeryHigh"Open priority, can be Idle / VeryLow / Low / Normal / High / VeryHigh (lowest / very low / low / normal / high / highest)

IO enum values ​

ItemValueMeaning
ManufacturerGeneralGeneral
YuanYuan controller
DaoDao controller
NovNov controller
nullAuto-detect

Appendix: Mod (not written to the configuration file) ​

Mod does not appear in settings.json; its values only take effect while playing the current chart (per-chart Mod settings are stored in the chart file). The defaults are listed here for reference.

ItemDefault valueMeaning
PlaybackSpeed1.0Playback speed, adjusts the game speed multiplier
AutoPlay"Disable"Auto play, Xiaoxiao Lanbai plays for you. Can be Disable disabled / Enable enabled / DJAuto_ButtonRing_First DJAuto (buttons first) / DJAuto_TouchPanel_First DJAuto (inner screen first)
JudgeStyle"DEFAULT"Judgment style, challenge yourself with stricter judgment. Can be DEFAULT / MAJI / GACHI / GORI
SubdivideSlideJudgeGradefalseSubdivide Slide judgment grades, allows Slides to receive a small Perfect judgment
AllBreakfalseAll Break, turns every note into a Break
AllExfalseAll Ex, turns every note into an Ex
AllTouchfalseAll Touch, turns every note into a Touch
SlideNoHeadfalseHeadless stars, removes Slide heads
SlideNoTrackfalseNo Slide track, removes Slide paths
ButtonRingForTouchfalseInner screen only experience, allows using the button ring to play Slides and Touches. Only present on desktop
NoteMask"Disable"Note mask, a masking cover for notes