Plugin.control . Ventoy

Ventoy 全局控制插件

本插件用来配置一些Ventoy的全局设置。比如默认显示模式等。

Json 配置

推荐使用 VentoyPlugson 工具进行配置，无需手动创建、编辑json文件。请参考 VentoyPlugson
关于 ventoy.json 的位置以及相关说明，请首先参考插件入口（*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 control 数组来描述本插件，数组中的每个成员都是有一个字符串类型的键值对。
注意你不需要对这里列出来的每一项都做配置，可以只对其中的一项或几项做特殊配置，其他的会使用默认值.

{
    "control": [
        { "VTOY_MENU_LANGUAGE": "zh_CN" },
        { "VTOY_DEFAULT_MENU_MODE": "0" },
        { "VTOY_TREE_VIEW_MENU_STYLE": "0" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" },
        { "VTOY_SORT_CASE_SENSITIVE": "0" },
        { "VTOY_MAX_SEARCH_LEVEL": "max" },
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" },        
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "/ISO/debian_netinstall.iso" },
        { "VTOY_FILE_FLT_EFI": "1" },
        { "VTOY_DEFAULT_KBD_LAYOUT": "QWERTY_USA" },
        { "VTOY_WIN11_BYPASS_CHECK": "1" },
        { "VTOY_WIN11_BYPASS_NRO": "1" },
        { "VTOY_LINUX_REMOUNT": "0" },
        { "VTOY_SECONDARY_BOOT_MENU": "1" },
        { "VTOY_SECONDARY_TIMEOUT": "20" }
    ]
}

关键字	类型	描述
`VTOY_MENU_LANGUAGE`	`STRING`	启动菜单语言，可以设置为 "en_US"， "zh_CN" 等。默认是 "en_US"。具体支持哪些语言，以实际为准，可以在启动后的 Ventoy 界面上按 `L` 快捷键列出当前支持的语言列表。
`VTOY_DEFAULT_MENU_MODE`	`STRING`	默认显示模式，"0":列表模式 "1":TreeView 模式。默认值 “0” 列表模式。
`VTOY_TREE_VIEW_MENU_STYLE`	`STRING`	TreeView模式下的菜单风格，"0":显示DIR和文件大小 "1":不显示DIR和文件大小默认是 "0"
`VTOY_FILT_DOT_UNDERSCORE_FILE`	`STRING`	过滤以 ._ 开头的文件。当使用苹果系统时，有时拷贝文件会产生一些 ._ 开头的文件，可以通过此选项过滤掉。 "0": 不过滤 "1":过滤
`VTOY_SORT_CASE_SENSITIVE`	`STRING`	在菜单排序时是否大小写敏感。默认是 "0" （大小写不敏感） "0":大小写不敏感 "1":大小写敏感
`VTOY_MAX_SEARCH_LEVEL`	`STRING`	最大搜索子目录的层数，取值为：`max` `0` `1` `2` `3` `...` 默认值为：`max` 默认Ventoy会递归搜索磁盘上的所有目录和子目录，不管目录结构有多深都会搜索到底。你可以通过这个参数来控制搜索时的路径深度。 `max` : 最大层数，也就是搜索所有子目录的意思。这也是 Ventoy 的默认值。 `0` : 搜索0层子目录，只列出根目录下的文件，不去搜索任何一个子目录。 `1` : 搜索1层子目录，除了根目录下的文件以外，再搜索根目录下的1级子目录。但是不再搜索1级子目录下的子目录（2级子目录）。 `2` : 搜索2层子目录，除了根目录下的文件以外，再搜索根目录下的1级子目录以及1级子目录下的子目录（2级子目录）。 `3` : 搜索3层子目录，...... `...` 注意，如果 `VTOY_DEFAULT_SEARCH_ROOT` 参数也同时设置了的话，则就以 `VTOY_DEFAULT_SEARCH_ROOT` 指定的目录作为根目录开始计算。
`VTOY_DEFAULT_SEARCH_ROOT`	`STRING`	指定搜索ISO文件的根目录。默认Ventoy会搜索U盘上的所有目录和子目录，当你U盘上有海量的文件时，这个过程会很慢。这种情况下你可以把ISO文件单独放在某个目录下，然后通过这个变量来指定搜索路径，此时Ventoy就只会搜索该目录及其子目录。
`VTOY_MENU_TIMEOUT`	`STRING`	菜单倒计时（秒）。默认不设置，设置之后，比如设置为10，则在倒计时10秒之后，会自动选择启动第1个镜像文件。在倒计时的过程中按任意键会停止倒计时，等待用户操作。
`VTOY_DEFAULT_IMAGE`	`STRING`	正常情况下默认选中的是第1个镜像文件。通过这个选项可以设置默认选中的镜像文件，一般和 VTOY_MENU_TIMEOUT 一起使用。可以设置为 WIM/VHD/IMG 等支持的文件，必须是以 / 开始的全路径，ListView模式和TreeView模式都支持。注意，当同时设置了 VTOY_DEFAULT_SEARCH_ROOT 以后，VTOY_DEFAULT_IMAGE 对应的文件必须位于 VTOY_DEFAULT_SEARCH_ROOT 对应的目录下，否则不会生效。除此之外，还可以设置为一些特殊值，参考本页特殊 VTOY_DEFAULT_IMAGE 值。
`VTOY_VHD_NO_WARNING`	`STRING`	"0": 启动Windows VHD(x)时，如果U盘分区不是NTFS格式，则显示告警信息 "1": 不显示告警信息默认是 "0"，即显示告警信息
`VTOY_DEFAULT_KBD_LAYOUT`	`STRING`	默认键盘布局，默认是 `QWERTY_USA` 支持的键盘布局有： `QWERTY_USA` `AZERTY` `CZECH_QWERTY` `CZECH_QWERTZ` `DANISH` `DVORAK_USA` `FRENCH` `GERMAN` `ITALIANO` `JAPAN_106` `LATIN_USA` `PORTU_BRAZIL` `QWERTY_UK` `QWERTZ` `QWERTZ_HUN` `QWERTZ_SLOV_CROAT` `SPANISH` `SWEDISH` `TURKISH_Q` `VIETNAMESE`
`VTOY_FILE_FLT_ISO`	`STRING`	"0": 不过滤 .iso 文件 "1": 过滤掉 .iso 文件。默认值是 "0"，即不过滤。
`VTOY_FILE_FLT_WIM`	`STRING`	"0": 不过滤 .wim 文件 "1": 过滤掉 .wim 文件。默认值是 "0"，即不过滤。
`VTOY_FILE_FLT_EFI`	`STRING`	"0": 不过滤 .efi 文件 "1": 过滤掉 .efi 文件。默认值是 "0"，即不过滤。
`VTOY_FILE_FLT_IMG`	`STRING`	"0": 不过滤 .img 文件 "1": 过滤掉 .img 文件。默认值是 "0"，即不过滤。
`VTOY_FILE_FLT_VHD`	`STRING`	"0": 不过滤 .vhd(x) 文件 "1": 过滤掉 .vhd(x) 文件。默认值是 "0"，即不过滤。
`VTOY_FILE_FLT_VTOY`	`STRING`	"0": 不过滤 .vtoy 文件 "1": 过滤掉 .vtoy 文件。默认值是 "0"，即不过滤。
`VTOY_WIN11_BYPASS_CHECK`	`STRING`	"0": 不绕过Windows 11安装时的硬件检查。 "1": 绕过Windows 11安装时的硬件检查。默认值是 "1"，绕过。当设置为1时，Ventoy会创建以下几个注册表项用来绕过 Windows 11 安装时的硬件检查。只对标准Windows 11 ISO文件有效，其他无效。 `HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassRAMCheck` `HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassTPMCheck` `HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassSecureBootCheck` `HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassCPUCheck`
`VTOY_WIN11_BYPASS_NRO`	`STRING`	"0": 不绕过Windows 11安装时的在线账户需求。 "1": 绕过Windows 11安装时的在线账户需求。默认值是 "1"，绕过。当设置为1时，Ventoy会创建以下注册表项用来绕过 Windows 11 安装时的线账户需求。只对标准Windows 11 ISO文件有效，其他无效。 `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\OOBE\BypassNRO` 注意：安装时必须临时禁用网络或者拔掉网线才会有本地账户的提示。
`VTOY_LINUX_REMOUNT`	`STRING`	"0": Linux启动后不需要继续访问ISO文件所在的分区。 "1": Linux启动后需要继续访问ISO文件所在的分区。默认值是 "0"。该选项只对 Linux 系统镜像有效。默认情况下，受Linux内核相关功能的限制，对于Linux系统，在启动后无法继续访问ISO文件所在的分区。在mount的时候会提示 device busy。如果这里选择 1，则 Ventoy 会尝试通过一些特殊的手段绕过内核的这个限制，但是这个功能是实验性质的，没有经过大规模和长时间的验证。
`VTOY_SECONDARY_BOOT_MENU`	`STRING`	"0": 不显示二级启动菜单 "1": 显示二级启动菜单。默认值是 "1"
`VTOY_SHOW_PASSWORD_ASTERISK`	`STRING`	"0": 输入密码时不显示星号 "1": 输入密码时显示星号。默认值是 "1"
`VTOY_SECONDARY_TIMEOUT`	`STRING`	二级菜单倒计时（秒）。只有当 `VTOY_SECONDARY_BOOT_MENU` 设置为1时才有效。默认不设置，设置之后，比如设置为10，则在倒计时10秒之后，会自动选择第一项，即：`Boot in normal mode` 在倒计时的过程中按任意键会停止倒计时，等待用户操作。

特殊 VTOY_DEFAULT_IMAGE 值

你可以使用一些的特殊的 VTOY_DEFAULT_IMAGE 值来实现一些特殊功能。例如：
VTOY_EXIT: Ventoy 在超时之后会自动退出
Fn>xx>xx: Ventoy 自动执行 Fn 热键内的子菜单，比如 F4>Search and boot Windows

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "VTOY_EXIT" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Power>Halt" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Search and boot Windows" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Boot the 1st local disk" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Check plugin json configuration (ventoy.json)>Check theme plugin configuration" }
    ]
}

多模式选项

支持。可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式做不同的设置。详细说明请参考多模式选项