# 全局控制插件

官网文档

### VTOY_MENU_LANGUAGE —— 菜单语言

选项设置 |
选项说明 | Ventoy 菜单的语言版本。默认是 "en_US"。
Option Description | Ventoy menu language. Default is "en_US",

### VTOY_DEFAULT_SEARCH_ROOT —— 指定搜索目录

选项设置 | 有效 无效
选项说明 | 指定搜索ISO文件的根目录。默认Ventoy会搜索U盘上的所有目录和子目录，当你U盘上有海量的文件时，这个过程会很慢。 这种情况下你可以把ISO文件单独放在某个子目录下，然后通过这个变量来指定搜索路径，此时Ventoy就只会搜索该目录及其子目录。 注意这里不能设置为U盘根目录，必须为一个子目录。
Option Description | The root path where to search the image files. By default, Ventoy will search all the directories and subdirectories in the USB. This will be very slow when you have huge number of files in the USB. In this case, you can put all the image files in one subdirectory and use this to specify the search path. After that Ventoy will only search this directory and its subdirectories for image files. Note: the path must not be the mountpoint of the first partition, but a subdirectory.

### VTOY_WIN11_BYPASS_CHECK —— 绕过Windows 11硬件检查

选项设置 | 0 1
选项说明 | `0` 不绕过Windows 11安装时的硬件检查。 `1` 绕过Windows 11安装时的硬件检查。 该选项只对标准Windows 11 ISO文件有效，对于其他镜像文件无效。 当设置为1时，Ventoy 会在安装时创建以下几个注册表项用来绕过 Windows 11 安装程序的硬件检查。 `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`
Option Description | `0` Do not bypass Windows 11 hardware check. `1` Bypass Windows 11 hardware check. This option only avaliable for standard Windows 11 ISO files. When set to 1, Ventoy will create the following registries to bypass Windows 11 hardware check when install. `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` `HKEY_LOCAL_MACHINE\SYSTEM\Setup\LabConfig\BypassStorageCheck`

### VTOY_WIN11_BYPASS_NRO —— 绕过Windows 11 在线账户需求

选项设置 | 0 1
选项说明 | `0` 不绕过Windows 11安装时的在线账户需求。 `1` 绕过Windows 11安装时的在线账户需求。 该选项只对标准Windows 11 ISO文件有效，对于其他镜像文件无效。 当设置为1时，Ventoy 会在安装时创建以下注册表项用来绕过 Windows 11 安装时对在线账户的需求。 `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\OOBE\BypassNRO`
Option Description | `0` Do not bypass Windows 11 online account requirement. `1` Bypass Windows 11 online account requirement. This option only avaliable for standard Windows 11 ISO files. When set to 1, Ventoy will create the following registry to bypass Windows 11 online account requirement when install. `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\OOBE\BypassNRO`

### VTOY_DEFAULT_MENU_MODE —— 菜单显示模式

选项设置 | 0 1
选项说明 | 启动菜单默认显示模式， `0` 列表模式 `1` TreeView（目录树） 模式
Option Description | Default boot menu display mode. `0` ListView Mode `1` TreeView Mode

### VTOY_MENU_TIMEOUT —— 启动倒计时

选项设置 |
选项说明 | 菜单倒计时（秒）。默认为0（即没有超时时间），设置之后，比如设置为10，则在倒计时10秒之后，会自动启动选中的镜像文件。在倒计时的过程中按任意键会停止倒计时，等待用户操作。
Option Description | Menu timeout (seconds). Default value is 0 (no timeout is set). When you set it to 10 for example, the selected image will be booted automatically after 10 seconds. During the countdown, pressing any key will stop the countdown and wait for user operation.

### VTOY_DEFAULT_IMAGE —— 默认选中的镜像文件

选项设置 | 有效 无效
选项说明 | 正常情况下默认选中的是第1个镜像文件。通过这个选项可以设置默认选中的镜像文件，一般和 VTOY_MENU_TIMEOUT 一起使用。 可以设置为 WIM/VHD/IMG 等支持的文件，必须是以 / 开始的全路径，ListView模式和TreeView模式都支持。 注意，当同时设置了 VTOY_DEFAULT_SEARCH_ROOT 以后，VTOY_DEFAULT_IMAGE 对应的文件必须位于 VTOY_DEFAULT_SEARCH_ROOT 对应的目录下，否则不会生效。
Option Description | Default selected image path. Normally used with VTOY_MENU_TIMEOUT. It can be ISO/WIM/VHD/IMG ... and supported in both ListView mode and TreeView mode. Attention that, when VTOY_DEFAULT_SEARCH_ROOT is set, VTOY_DEFAULT_IMAGE must be in the directory (or sub-directory) of VTOY_DEFAULT_SEARCH_ROOT, otherwise it will not take effect.

### VTOY_MAX_SEARCH_LEVEL —— 最大搜索目录深度

选项设置 |
选项说明 | 最大搜索子目录的层数，取值为：`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` 指定的目录作为根目录开始计算。
Option Description | Max subdirectory level when search for image files. It's value can be: `max` `0` `1` `2` `3` `...` default is : `max` By default, Ventoy will search all the directories and sub directories recursively no matter how deep the directory level is. You can use this parameter to set a max-depth for the search path. `max` : Maximum, search all the directories and subdirectories. This is Ventoy's default value. `0` : Only search files in the root and don't search any subdirectories. `1` : Search up to level 1 of subdirectories. `2` : Search up to level 2 of subdirectories. `3` : Search up to level 3 of subdirectories. `...` If `VTOY_DEFAULT_SEARCH_ROOT` is set at the same time. Then the level is counted from `VTOY_DEFAULT_SEARCH_ROOT` .

### VTOY_LINUX_REMOUNT —— Linux 启动后继续访问ISO文件所在分区

选项设置 | 0 1
选项说明 | `0` Linux启动后不需要继续访问ISO文件所在的分区。 `1` Linux启动后需要继续访问ISO文件所在的分区。 该选项只对 Linux 系统镜像有效。 默认情况下，受Linux内核相关功能的限制，对于Linux系统，在启动后无法继续访问ISO文件所在的分区。在mount的时候会提示 device busy。 如果这里选择 1，则 Ventoy 会尝试通过一些特殊的手段绕过内核的这个限制，但是这个功能是实验性质的，没有经过大规模和长时间的验证。
Option Description | `0` I don't need to access the image partition after boot. `1` I need to access the image partition after boot. This option is only avaliable for Linux distro image files. By default, the image partition where the ISO files locate can not be accessed after boot. When you try to mount it you will get device busy error. This is due to linux kernel restriction (device-mapper module). If you select 1 here, Ventoy will try to bypass the restriction with some special mechanism. But it should be noted that, this is an experimental feature and is not fully tested.

### VTOY_SECONDARY_BOOT_MENU —— 二级启动菜单显示开关

选项设置 | 0 1
选项说明 | 二级启动菜单控制开关 `0` 不显示 `1` 显示
Option Description | Secondary boot menu display option `0` Don't display `1` Display

### VTOY_SHOW_PASSWORD_ASTERISK —— 输入密码时显示星号

选项设置 | 0 1
选项说明 | 输入密码时是否显示星号 `0` 不显示 `1` 显示
Option Description | Display asterisk when typing password `0` Don't display `1` Display

### VTOY_SECONDARY_TIMEOUT —— 二级启动菜单倒计时

选项设置 |
选项说明 | 二级菜单倒计时（秒）。只有当 `VTOY_SECONDARY_BOOT_MENU` 设置为1时才有效。 默认不设置，设置之后，比如设置为10，则在倒计时10秒之后，会自动选择第一项，即：`Boot in normal mode` 在倒计时的过程中按任意键会停止倒计时，等待用户操作。
Option Description | Timeout seconds for the secondary boot menu. Only take effect when `VTOY_SECONDARY_BOOT_MENU` is 1. By default no timeout is set. When you set it to 10 for example, the first entry (`Boot in normal mode`) will be selected an run after 10 seconds.

### VTOY_DEFAULT_KBD_LAYOUT —— 默认键盘布局

选项设置 |
选项说明 | 键盘布局
Option Description | Keyboard Layout

### VTOY_TREE_VIEW_MENU_STYLE —— TreeView模式显示风格

选项设置 | 0 1
选项说明 | TreeView模式下的菜单风格。 `0` 显示DIR和文件大小 `1` 不显示DIR和文件大小。只在 VTOY_DEFAULT_MENU_MODE 为1时才有效。
Option Description | Menu style in TreeView mode. `0` with DIR and file size prefix `1` No DIR and file size. Default is 0.

### VTOY_FILT_DOT_UNDERSCORE_FILE —— 过滤以 ._ 开头的文件

选项设置 | 0 1
选项说明 | 过滤以 ._ 开头的文件。当使用苹果系统时，有时拷贝文件会产生一些 ._ 开头的文件，可以通过此选项过滤掉。 `0` 不过滤 `1` 过滤
Option Description | Filter for files with prefix ._ in name. This will be useful when you use macOS (a lot of ._xxx file generated when you copy files). `0` Don't filt `1` Filt

### VTOY_SORT_CASE_SENSITIVE —— 菜单排序时是否区分大小写

选项设置 | 0 1
选项说明 | 在菜单排序时是否大小写敏感。 `0` 不区分大小写 `1` 区分大小写
Option Description | Case sensitive when sort the ISO files or directories. `0` case insensitive `1` case sensitive

### VTOY_VHD_NO_WARNING

选项设置 | 0 1
选项说明 | `0` 启动Windows VHD(x)时，如果U盘分区不是NTFS格式，则显示告警信息。 `1` 不显示告警信息。
Option Description | `0` Show a warning message if the partition is not NTFS when booting VHD(x) file. `1` No warning message.

### VTOY_FILE_FLT_ISO —— 过滤 .iso 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .iso 文件 `1` 过滤掉 .iso 文件。 过滤之后 .iso 文件就不会显示在启动菜单中。
Option Description | `0` List .iso files. `1` Filter .iso files. The iso files will not be shown in the boot menu if set to 1.

### VTOY_FILE_FLT_WIM —— 过滤 .wim 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .wim 文件 `1` 过滤掉 .wim 文件。 过滤之后 .wim 文件就不会显示在启动菜单中。
Option Description | `0` List .wim files. `1` Filter .wim files. The wim files will not be shown in the boot menu if set to 1.

### VTOY_FILE_FLT_EFI —— 过滤 .efi 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .efi 文件 `1` 过滤掉 .efi 文件。 过滤之后 .efi 文件就不会显示在启动菜单中。
Option Description | `0` List .efi files. `1` Filter .efi files. The efi files will not be shown in the boot menu if set to 1.

### VTOY_FILE_FLT_IMG —— 过滤 .img 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .img 文件 `1` 过滤掉 .img 文件。 过滤之后 .img 文件就不会显示在启动菜单中。
Option Description | `0` List .img files. `1` Filter .img files. The img files will not be shown in the boot menu if set to 1.

### VTOY_FILE_FLT_VHD —— 过滤 .vhd(x) 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .vhd(x) 文件 `1` 过滤掉 .vhd(x) 文件。 过滤之后 .vhd(x) 文件就不会显示在启动菜单中。
Option Description | `0` List .vhd(x) files. `1` Filter .vhd(x) files. The vhd(x) files will not be shown in the boot menu if set to 1.

### VTOY_FILE_FLT_VTOY —— 过滤 .vtoy 文件

选项设置 | 0 1
选项说明 | `0` 不过滤 .vtoy 文件 `1` 过滤掉 .vtoy 文件。 过滤之后 .vtoy 文件就不会显示在启动菜单中。
Option Description | `0` List .vtoy files. `1` Filter .vtoy files. The vtoy files will not be shown in the boot menu if set to 1.