插件双模式选项

Ventoy 会为每一个插件定义一个 json 配置项用来设置与此插件功能相关的属性。
比如全局控制插件的 control,主题插件的 theme,菜单别名插件的 menu_alias,自动安装插件的 auto_install 等。

所有这些选项都支持 Legacy BIOS 和 UEFI 双模式配置。

什么意思呢?以主题插件 theme 为例,你可以在 json 文件中配置一个 theme 选项,此时这个配置在 Legacy BIOS 模式和 UEFI 模式下都生效。

{
    "theme": {
        "file": "/ventoy/theme/theme.txt",
        "gfxmode": "1920x1080"
    }
}

你也可以分别配置 theme_legacytheme_uefi 两个选项,分别在 Legacy BIOS 模式和 UEFI 模式下生效。 当然这两种方式不能同时配。

{
    "theme_legacy": {
        "display_mode": "CLI"        
    },
    "theme_uefi": {
        "file": "/ventoy/theme/theme.txt",
        "gfxmode": "1920x1080"
    }
}

同样的,control 对应 control_legacycontrol_uefiauto_install 对应 auto_install_legacyauto_install_uefi 等。

说明

1. 对于配置项 xxx 对应的双模式配置项即为 xxx_legacyxxx_uefi (注意字母全小写)
2. 两种方式不能同时配置,比如配置了 control 就不能再配置 control_legacycontrol_uefi,反之亦然
3. 双模式配置项你可以只配置其中1个,比如你可以只配置 theme_uefi 但不配置 theme_legacy 这样就只会在UEFI模式下生效,Legacy BIOS保持默认
4. 配置项内部的子选项定义和使用方式都是一样的


ventoy.json 示例

{
    "control_legacy": [
        { "VTOY_DEFAULT_MENU_MODE": "1" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }
    ],
    
    "control_uefi": [
        { "VTOY_DEFAULT_MENU_MODE": "0" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }
    ],
    
    "theme_legacy": {
        "display_mode": "CLI"        
    },
    
    "theme_uefi": {
        "file": "/ventoy/theme/theme.txt",
        "gfxmode": "1920x1080"
    }
}