Skip to content

旧版配置详解 (2.1.0-preview6 之前) ​

字数
5538 字
阅读时间
24 分钟

版本提示

本页描述 2.1.0-preview6 之前的单文件 settings.json. 从 2.1.0-preview6 起, 配置已拆分为 settings.json 与 system-settings.json, 请优先阅读 配置详解. 本页仅用于查阅旧版本, 新版游戏会自动迁移旧配置.

TIP

本文逐项解释 配置文件 settings.json 中的全部设置项, 并给出每项在首次运行自动生成时的默认值.

WARNING

修改配置时请确保游戏已完全关闭. 在游戏运行中手动改动的文件, 会在游戏保存设置时被覆盖. 若你不熟悉 JSON, 建议使用 VSCode 等带语法检查的编辑器.

阅读下表前请先了解:

  • 默认值指程序内置默认值 (代码中各设置属性的初始化值), 也就是首次运行时生成的值. 你文件里的值可能与下表不同.
  • 部分项因平台而异, 会在说明中标注 Windows 或 移动端 (Android / iOS). 下表以 Windows 版为主.
  • 标有 隐藏 的项不会出现在游戏内设置界面, 只能改配置文件.
  • 标有 不写入 的项不会出现在 settings.json 中.

顶层结构 ​

节中文含义内容
Game游戏设定音符速度、显示信息、重开 / 跳过、随机与镜像等
Judge判定设定各类偏移与判定模式
Display显示设定皮肤、判定显示、缩放、渲染与窗口
Audio音频设定音量、音频后端与缓冲区
Debug调试触摸模拟、渲染池、日志等级等
Online联网在线账号与 API 端点
IO输入 / 输出设备手台、触摸板与 LED
ModMod不写入, 仅作用于当前谱面

Game —— 游戏设定 ​

项类型默认值中文含义
TapSpeed浮点7.5Tap 速度, 调整音符速度. 步进 0.25, 可为负数 (反向下落)
TouchSpeed浮点7.5Touch 速度, 调整 Touch 音符速度. 步进 0.25
SlideFadeInOffset浮点0.0Slide 淡入偏移, 调整 Slide 时机, 右调推迟
BackgroundDim浮点0.8背景亮度, 值越大越暗. 范围 0~1, 步进 0.05
StarRotation布尔true星星旋转, 星星头旋转
BGInfo枚举"Combo"中央显示, 调整屏幕中央显示的信息
SecondaryBGInfo枚举"None"额外信息显示, 调整屏幕中下方显示的信息
SubScreenBGInfo枚举"Achievement"副屏信息显示, 调整副屏显示的信息
TopInfo枚举"None"外框显示, 顶部信息显示 (1 和 8 键之间)
EnableJudgeTimingGauge布尔false显示判定偏移指示器, 显示实时判定偏移与平均判定位置
TrackSkip布尔true跳过乐曲, 按住 2、3、6、7 键强制跳过乐曲
EnforceGameFailure枚举"Disabled"强制乐曲失败, 当无法达到目标时自动跳过或重试
FastRetry布尔true快速重开, 按住 3、4、5、6 键快速重开
FastPractice布尔false快速练习, 按住 1、2、7、8 键进入练习模式 (开始前 -5 秒, 按住后 +10 秒)
GameplaySubScreenClickBehavior枚举"TrackSkip"游戏时副屏点击行为, 调整游玩时点击副屏的行为. 移动端默认为 "TrackSkip_1_Sec_Delay"
Mirror枚举"Off"镜像, 谱面左右 / 上下对称翻转
Rotation整数0旋转, 旋转谱面角度, 正数顺时针. 范围 -7~7
SlideSkipping布尔trueSlide 跳区, 开启 / 关闭 Slide 跳区机制
Random枚举"Disabled"随机, 随机打乱音符
RecordMode枚举"Disable"录制模式, 仅 Windows / Linux / macOS 存在
LeadInTime整数1等待时间, 进入游戏界面后, 正式开始游戏之前的等待秒数. 范围 1~5
ManualStartGame布尔false手动开始游戏, 加载后手动按键开始 (用于比赛)

Game 枚举取值 ​

项取值中文含义
BGInfo / SecondaryBGInfo / SubScreenBGInfoCPCombo极致完美 Combo
PCombo完美 Combo
ComboCombo
Achievement_101达成率 (101-)
Achievement_100达成率 (100-)
Achievement达成率
AchievementClassicalFiNALE 达成率
AchievementClassical_100FiNALE 达成率 (100-)
DXScoreDX 分数
DXScoreRankDX 分数等级
S_Border距 S
SS_Border距 SS
SSS_Border距 SSS
MyBest距最佳成绩
Diff判定误差
None无
TopInfoNone不显示
Judge判定结果
TimingFast / Late
EnforceGameFailureDisabled关闭
TrackSkip_S / Retry_S跳关 / S、重试 / S
TrackSkip_SS / Retry_SS跳关 / SS、重试 / SS
TrackSkip_SSS / Retry_SSS跳关 / SSS、重试 / SSS
TrackSkip_SSSPlus / Retry_SSSPlus跳关 / SSS+、重试 / SSS+
TrackSkip_Best / Retry_Best跳关 / 最佳成绩、重试 / 最佳成绩
TrackSkip_FC / Retry_FC跳关 / FC、重试 / FC
TrackSkip_AP / Retry_AP跳关 / AP、重试 / AP
GameplaySubScreenClickBehaviorNone无
TrackSkip跳过乐曲
TrackSkip_1_Sec_Delay跳过乐曲 (按住 1 秒)
FastRetry快速重开
FastRetry_1_Sec_Delay快速重开 (按住 1 秒)
MirrorOff关闭
LRMirror左右镜像
UDMirror上下镜像
RandomDisabled禁用
RANDOM按轨道随机
S_RANDOM每个音符独立随机
RecordModeDisable禁用
OBSTrigger连接 OBS WebSocket 自动触发录制

Judge —— 判定设定 ​

项类型默认值中文含义
AudioOffset浮点0.0音频偏移 (A 判), 音押. 音符与音乐不同步时调整. Fast 多向左调, Late 多向右调. 该项会移动正解音, 相当于谱面中的 &first
JudgeOffset浮点0.0判定偏移 (B 判), 目押延迟, 补偿设备输入延迟. Fast 多向左调, Late 多向右调
AnswerOffset浮点0.0正解音偏移, 调整正解音播放时机 (不影响判定). 左调提前, 右调延后. 不确定请勿调整
TouchPanelOffset浮点0.0内屏输入偏移, 补偿触摸输入延迟. Fast 多向左调, Late 多向右调
Mode枚举"Modern"判定模式, 选择游戏判定和分数模式 (旧框 / 新框)

Judge 枚举取值 ​

项取值中文含义
ModeClassic旧框 (Classic)
Modern新框 (Modern)

Display —— 显示设定 ​

项类型默认值中文含义
Language字符串""语言. 源码默认空; 首次运行后由程序按当前语言写入, 形如 "zh-CN - Majdata"
Skin字符串"default"Note 皮肤, 更换音符皮肤. 若配置的皮肤不存在, 程序会回退到第一个可用皮肤
DisplayCriticalPerfect布尔false显示 Critical 判定, 显示 Critical 判定
DisplayBreakScore布尔true显示 Break 分数, 显示 Break 音符的详细分数
FastLateType枚举"Disable"Fast / Late 显示等级, 设置 Note 的 Fast / Late 显示条件, 低于此级别才显示判定文字
NoteJudgeType枚举"All"Note 判定显示等级, 设置 Note 判定显示条件, 低于此级别才显示判定文字
TouchJudgeType枚举"All"Touch 判定显示等级, 设置 Touch 判定显示条件, 低于此级别才显示判定文字
SlideJudgeType枚举"All"Slide 判定显示等级, 设置 Slide 判定显示条件, 低于此级别才显示判定文字
BreakJudgeType枚举"All"Break 判定显示等级, 设置 Break 判定显示条件, 低于此级别才显示判定文字
BreakFastLateType枚举"Disable"Break Fast / Late 显示等级, 设置 Break 的 Fast / Late 显示条件, 低于此级别才显示判定文字
SlideSortOrder枚举"Modern"Slide 排列顺序, Slide 排序: Classic 旧在下, Modern 旧在上 (影响星星变色)
OuterJudgeDistance浮点1.0外圈判定显示距离, 调整外部判定文字显示距离 (越小越靠中心). 范围 0~1, 步进 0.05, 0 为关闭
InnerJudgeDistance浮点1.0内圈判定显示距离, 调整 Touch 判定文字显示距离 (越小越靠中心). 范围 0~1, 步进 0.05, 0 为关闭
DisplayHoldHeadJudgeResult布尔false显示 Hold 头判判定, 显示 Hold 头的判定结果
TapScale浮点1.0Tap 缩放级别, 调整 Tap 大小. 范围 0~2, 步进 0.01
HoldScale浮点1.0Hold 缩放级别, 调整 Hold 的大小. 范围 0~2, 步进 0.01
TouchScale浮点1.0Touch 缩放级别, 调整 Touch 大小. 范围 0~2, 步进 0.01
SlideScale浮点1.0Slide 缩放级别, 调整 Slide 大小 (不影响 Wifi Slide). 范围 0~2, 步进 0.01
TouchFeedback枚举"Outer_Only"触摸反馈, 设置触摸反馈显示条件
Resolution字符串"1080x1920"分辨率 隐藏, 不可调整. 仅 Windows / Linux / macOS 存在
MainScreenTransform布尔false自定义画面比例, 自定义主画面的缩放和位置. 移动端默认为 true
MainScreenScale浮点1.0主屏缩放, 调整主画面整体大小. 范围 0.05~1.5, 步进 0.01
MainScreenOffset浮点1.0主屏位置偏移, 微调主画面位置. 范围 -1~1, 步进 0.01
MainScreenCachedScreenCenterY浮点960.0主屏中心 Y (缓存) 隐藏, 缓存的主屏垂直中心坐标
SubDisplayOffset浮点0.0副屏位置偏移, 微调副显示区域位置. 范围 -5~5, 步进 0.01
SubDisplayScale浮点1.0副屏缩放, 调整副显示区域大小. 步进 0.01
GameplayScreenRotationAngle枚举"Zero"游戏画面旋转, 旋转游戏画面
RenderQuality枚举"Medium"渲染质量, 渲染质量, 值越高画面越清晰. 移动端默认为 "Low"
RenderScale整数100渲染比例, 调整内部渲染分辨率. 100 为原始分辨率; 降低可减轻 GPU 负载, 但画面和文字会变模糊, 不改变布局或判定. 范围 50~100, 步进 5. 移动端默认为 75
Topmost布尔false窗口置顶 隐藏, 保持窗口置顶. 仅 Windows / Linux / macOS 存在
FPSLimit整数120帧率限制, 限制最高帧率. 最小 -1 (-1 表示不限制), 步进 1
VSync布尔true垂直同步, 是否开启垂直同步. 移动端不存在该项
SkipVideoDownload布尔false跳过视频下载, 在线谱面不下载视频

Display 枚举取值 ​

项取值中文含义
FastLateType / NoteJudgeType / TouchJudgeType / SlideJudgeType / BreakJudgeType / BreakFastLateTypeAll全部
BelowCPCritical 以下
BelowPPerfect 以下
BelowGRGreat 以下
MissOnly仅 Miss
Disable禁用
SlideSortOrderClassic旧框排序 (旧音符在下)
Modern新框排序 (旧音符在上)
TouchFeedbackAll全部
Outer_Only仅外部
Inner_Only仅内部
Disable禁用
GameplayScreenRotationAngleZero0°
_9090°
_180180°
_270270°
RenderQualityVeryLow极低
Low低
Medium中
High高
VeryHigh极高
Ultra最高

Audio —— 音频设定 ​

项类型默认值中文含义
ForceMono布尔false强制单声道, 将音频混合为单声道输出
Volume对象见下表音量设定, 各音轨音量
Wasapi对象见下表WASAPI 设定, 仅 Windows 存在
Asio对象见下表ASIO 设定, 仅 Windows 存在
Channel对象见下表声道音量, 仅 Windows / Linux / macOS 存在
Bass对象见下表BASS 音频缓冲设定, 所有平台存在
Backend枚举"Wasapi"音频后端. Windows 默认 "Wasapi", 移动端默认 "BassSimple"

Audio.Volume —— 音量 ​

所有项范围均为 0~2, 步进 0.05.

项默认值中文含义
Global0.3全局, 调整主音量
BGM1.0背景音乐, 调整非游戏场景 (选曲、结算) 的背景音乐音量
Track1.0谱面音乐, 调整游戏内音乐音量
Answer0.8正解音, 调整正解音和开场节拍器的音量
Tap0.3Tap / Hold 判定音, 调整 Tap / Hold 的判定音量
Ex0.3Ex 判定音, 调整 Ex 音符的判定音量
Break0.3Break 判定音, 调整 Break 的判定音量
Slide0.3Slide 判定音, 调整 Slide 音效音量
Touch0.3Touch 判定音, 调整 Touch / TouchHold 的判定音量
Hanabi0.3Hanabi 音效, 调整 Touch 烟花音效音量
Voice1.0小小蓝白, 调整助手语音音量

TIP

Global 的内置默认为 0.3; 你文件中若为其他值, 说明该项被修改过 (或来自较早版本的默认值).

Audio.Wasapi —— WASAPI 设定 (仅 Windows) ​

项默认值中文含义
Exclusivetrue独占模式, 独占音频设备. 关闭后 OBS 等程序才能同时录制 / 播放声音
RawModetrue原始模式 (Raw Mode), 使用未经系统混音处理的原始数据
AsyncModetrue异步模式, 使用异步音频处理. 部分旧版本生成的配置文件中可能没有该项, 缺失时按 true 处理
BufferSize0.02缓冲区大小, 单位为秒
Period0.005周期, 单位为秒

Audio.Asio —— ASIO 设定 (仅 Windows) ​

项默认值中文含义
DeviceIndex0设备索引, ASIO 设备序号
SampleRate44100采样率, 音频采样率 (Hz)

Audio.Channel —— 声道音量 (仅桌面端) ​

项默认值中文含义
FrontVolume1.0前置声道 (LF / RF) 音量
CenterAndLFEVolume1.0中置与低音声道 (Center / LFE) 音量
SideVolume1.0侧置声道 (LS / RS) 音量
RearVolume1.0后置声道 (LR / RR) 音量

Audio.Bass —— BASS 缓冲设定 ​

项默认值中文含义
BufferLengthMs1000缓冲区长度, 单位毫秒
UpdatePeriodMs200更新周期, 单位毫秒
DeviceBufferLengthMs64设备缓冲区长度, 单位毫秒. 移动端默认为 32
DeviceUpdatePeriodMs16设备更新周期, 单位毫秒. 移动端默认为 8
EnableAAudiotrue启用 AAudio, 仅 Android 存在

Audio 枚举取值 ​

项取值中文含义
BackendUnityUnity 内置音频
WasapiWASAPI (Windows)
AsioASIO (专业声卡低延迟)
BassSimpleBASS 简化后端 (移动端默认)

Debug —— 调试 ​

项类型默认值中文含义
DisplaySensor布尔false显示传感器, 高亮显示触发的触摸区域
TouchSimulationRadius浮点0.5模拟触摸半径, 模拟触摸点大小, 值越大手指判定越大 (仅游戏中生效). 范围 0~2, 步进 0.05
TouchAAreaExtraRadius浮点0.0模拟触摸 A 区半径, 扩大 A 触摸区的触发半径. 范围 0~2, 步进 0.05
TouchBAreaExtraRadius浮点0.0模拟触摸 B 区半径, 扩大 B 触摸区的触发半径
TouchCAreaExtraRadius浮点0.25模拟触摸 C 区半径, 扩大 C 触摸区的触发半径
TouchDAreaExtraRadius浮点0.2模拟触摸 D 区半径, 扩大 D 触摸区的触发半径
TouchEAreaExtraRadius浮点0.1模拟触摸 E 区半径, 扩大 E 触摸区的触发半径
TouchRadiusAdjust浮点0.0触摸面积比例, 根据手指接触面积调整触摸触发范围, 0 为禁用. 范围 0~2 。不要调的过于离谱,赛博灯泡.gif
DisplayRuntimeInfo布尔true显示帧率和版本号, 在右上角显示帧率和版本号
FullScreen布尔true强制全屏 隐藏, 仅 Windows / Linux / macOS 存在
MenuOptionIterationSpeed整数45菜单选项连按速度 隐藏, 值越大滚动越快
DisplayOffset浮点0.0帧偏移, 补偿帧延迟. 不确定请勿调整
NoteAppearRate浮点0.265Note 淡入偏移, 调整音符淡入效果. 步进 0.001
OffsetUnit枚举"Frame"偏移单位, 调整各类偏移的单位
HideCursorInGame布尔true游玩时隐藏光标 隐藏, 仅 Windows / Linux / macOS 存在
NoteFolding布尔trueNote 折叠 隐藏, 折叠音符显示
DJAutoPolicy枚举"Strict"DJAuto 策略, 严格: 只能使用按键或触摸之一. 宽容: 可混合使用
MaxQueuedFrames整数2最大排队帧数 隐藏, 允许排队等待处理的最大帧数
TapPoolCapacity整数96Tap 对象池容量 隐藏, 移动端默认为 48
HoldPoolCapacity整数96Hold 对象池容量 隐藏, 移动端默认为 48
TouchPoolCapacity整数64Touch 对象池容量 隐藏
TouchHoldPoolCapacity整数64TouchHold 对象池容量 隐藏
EachLinePoolCapacity整数48每条轨道对象池容量 隐藏, 移动端默认为 24
DebugLevel枚举"Info"日志等级 隐藏, 输出日志的最低等级

Debug 枚举取值 ​

项取值中文含义
OffsetUnitFrame帧
Second秒
DJAutoPolicyStrict严格
Permissive宽容
DebugLevelDebug / Info / Warning / Error / Fatal调试 / 信息 / 警告 / 错误 / 致命

Online —— 联网 ​

TIP

想传分打榜 / 记录? 想直接在游戏内游玩在线谱面? 请先阅读 联网.

该节中的项在游戏内设置界面里隐藏, iOS 版对应设置位于系统"设置" App 中.

项类型默认值中文含义
Enable布尔false启用联网, 是否启用在线功能
UseProxy布尔true使用代理, 仅 Windows / Linux / macOS 存在
Proxy字符串""代理地址, 仅 Windows / Linux / macOS 存在
ApiEndpoints数组见下表API 端点列表, 可配置多个服务器

Online.ApiEndpoints[] —— 端点 ​

默认包含一项 MajdataNET:

项类型默认值中文含义
Name字符串"MajdataNET"名称, 端点显示名
Url字符串"https://majdata.net/api3/api/"接口地址, 服务器 API 根地址
Username字符串"YourUsername"用户名, 预填账号
Password字符串"YourPassword"密码, 预填密码
AutoLogin布尔false自动登录, 启动时自动登录

IO —— 输入 / 输出设备 ​

该节在游戏内设置界面里隐藏, 主要用于外接手台与 LED. 详见 外置设备.

项类型默认值中文含义
Manufacturer枚举 / nullnull设备制造商, null 表示自动识别. 仅 Windows / Linux / macOS 存在
InputDevice对象见下输入设备
OutputDevice对象见下输出设备. 仅 Windows / Linux / macOS 存在

IO.InputDevice ​

项类型默认值中文含义
Player整数1玩家编号, 手柄玩家索引. 仅桌面端存在
ButtonRing对象见下按键圈 (手台按键). 仅桌面端存在
TouchPanel对象见下触摸板. 仅桌面端存在
ExternalButtonRing枚举"None"外接按键圈, 仅移动端存在. "None" 无 / "Keyboard" 键盘 / "Gamepad" 手柄

IO.InputDevice.ButtonRing ​

项默认值中文含义
Enabletrue启用, 是否启用按键圈输入
Typenull设备类型, null 自动; 可选 "Keyboard" 键盘 / "HID" HID 设备
Debouncefalse启用去抖, 是否开启按键去抖
PollingRateMs0轮询间隔, 单位毫秒, 0 表示不限
DebounceThresholdMs0去抖阈值, 单位毫秒
HidOptions见下HID 设备参数

IO.InputDevice.TouchPanel ​

项默认值中文含义
Enabletrue启用, 是否启用触摸板输入
Debouncefalse启用去抖, 是否开启触摸去抖
SensitivitiesA~E 均为 0灵敏度, A~E 各区触摸灵敏度
PollingRateMs0轮询间隔, 单位毫秒
DebounceThresholdMs0去抖阈值, 单位毫秒
SerialPortOptions见下串口参数, Port / BaudRate 默认均为 null
UsbOptions见下USB 设备参数
CapacitivePanelOptions见下电容触摸板参数

IO.InputDevice.TouchPanel.CapacitivePanelOptions ​

项默认值中文含义
TouchRadius30触摸半径, 电容触摸判定半径
RadiusOffsetA:0 B:20 C:0 D:0 E:25半径偏移, A~E 各区半径微调

IO.OutputDevice.Led ​

项默认值中文含义
Enabletrue启用, 是否启用 LED 输出
Brightness1.0亮度, LED 亮度
RefreshRateMs16刷新间隔, 单位毫秒
Throttlertrue限流, 限制 LED 刷新频率
SerialPortOptionsPort / BaudRate 均为 null串口参数
HidOptions见下HID 设备参数

IO 通用参数 ​

HidOptions 与 UsbOptions 结构相同:

项默认值中文含义
DeviceNamenull设备名称, 指定设备名 (留空自动匹配)
ProductIdnull产品 ID (PID)
VendorIdnull厂商 ID (VID)
Exclusicefalse独占模式. 字段名在配置文件中即拼写为 Exclusice

HidOptions 额外包含:

项默认值中文含义
OpenPriority"VeryHigh"打开优先级, 可选 Idle / VeryLow / Low / Normal / High / VeryHigh (最低 / 很低 / 低 / 普通 / 高 / 最高)

IO 枚举取值 ​

项取值中文含义
ManufacturerGeneral通用
Yuan源台
DaoDao台
NovNov台
null自动识别

附录: Mod (不写入配置文件) ​

Mod 不会出现在 settings.json 中, 其值仅在游玩当前谱面时生效 (谱面内 Mod 设置保存在谱面文件中). 此处列出默认值供参考.

项默认值中文含义
PlaybackSpeed1.0游玩速度, 调整游戏速度倍率
AutoPlay"Disable"自动游玩, 小小蓝白帮你打. 可选 Disable 禁用 / Enable 开启 / DJAuto_ButtonRing_First DJAuto (按键优先) / DJAuto_TouchPanel_First DJAuto (内屏优先)
JudgeStyle"DEFAULT"判定风格, 用更严的判定挑战自己. 可选 DEFAULT / MAJI / GACHI / GORI
SubdivideSlideJudgeGradefalse细分 Slide 判定等级, 允许 Slide 出现小 P 判定
AllBreakfalse全 Break, 所有音符变为 Break
AllExfalse全 Ex, 所有音符变为 Ex
AllTouchfalse全 Touch, 所有音符变为 Touch
SlideNoHeadfalse无头星星, 移除 Slide 头
SlideNoTrackfalse去掉 Slide, 移除 Slide 轨迹
ButtonRingForTouchfalse纯内屏体验, 允许按键操作 Slide 和 Touch. 仅桌面端存在
NoteMask"Disable"Note 遮罩, 音符遮罩挡板