插件入口

所有的插件及其相关的文件都必须放在第1个分区(镜像分区)根路径中的 ventoy 目录下。
注意,镜像分区在刚安装完Ventoy的时候是空的,什么都没有,所以需要用户自己手动创建这个 ventoy 目录以及下面的 ventoy.json 文件。
另外,目录名、文件名都必须是全小写的,不要弄错。

ventoy 目录下创建一个 ventoy.json 文件作为所有插件的配置文件。 这个文件必须符合json的语法,同时最外层必须是一个 object( { } ) 的形式。
对于json的语法,你可以使用如下两个在线工具进行检查:
https://www.json.cn
http://json.parser.online.fr

从 Ventoy-1.0.13版本开始,增加了一个 F5 debug 菜单,你可以在这里检查ventoy.json文件的内容是否正确。

需要指出的是,Ventoy内部的json解析器比较简单,json文件必须为 UTF-8 编码格式,同时不支持注释。

一般情况下,一个插件会有一个目录(位于ventoy 目录下)来存放相关文件,同时在 ventoy.json 文件中定义一个 object 作为其配置参数。

ventoy.json 示例

{
    "control": [
        { "VTOY_DEFAULT_MENU_MODE": "1" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }
    ],
    
    "theme": {
        "file": "/ventoy/theme/blur/theme.txt",
        "gfxmode": "1920x1080"
    },
    
    "auto_install" : [
        {
            "image": "/ISO/cn_windows_server_2012_r2_vl_x64_dvd_2979220.iso",
            "template": "/ventoy/script/windows_unattended.xml"
        },
        {
            "image": "/000/centos.iso",
            "template": "/ventoy/script/centos_kickstart.cfg"
        }
    ]
}