0x01 基本概念

首先需要理解以下基本概念:

手动安装的本质

手动安装虽然于FVTT系统解析安装逻辑一致,但由于依旧属于直接修改系统目录,所有以手动形式安装的组件包均需要重启FVTT软件后方可生效。

用户数据路径是什么

指(FoundryVTT)后台设置项)中的(用户数据路径)文件夹
用户数据路径位置

用户目录文件夹结构

如图片所示,需要区分(system)系统文件夹、(modules)额外插件文件夹、(worlds)游戏世界文件夹。
用户路径数据结构


0x02 手动安装FVTT组件包(以Modules插件为例)

获取组件包的方式

打开官方网站,进入(System、Modules、and Worlds)页面,并选择(Add-On Modules)选项。
官网数据库

寻找你需要的组件包的版本

找到你需要安装的插件包,比如这里是(Dice So Nice),并点击标题进入Modules详情页面。
选择你想要的插件

确认自己系统对应的组件包版本的安装脚本

将页面拉到底,选择符合我们上限符合对应版本的版本链接,这举例用的是V9版本,所以我们选择支持版本号中右侧compatibility为V9且最新的版本(如果同时有compatibility和verified字段,需要看verified字段),点击Manifest URL。获取安装脚本。【本节易错点:选择下载了不符合版本的Modules文件】
确认插件对应版本安装脚本

解析安装配置脚本

将安装脚本下载到本地打开,或者直接用浏览器打开。(若无法下载,或者提示找不到文件,则需要一个加速器)如果成功打开会看到具体的脚本内容。其中对我们有用字段的是Name(即文件夹名称,在V10及以后中字段更改为Id)Download(modules包下载的具体地址)【本节易错点:没使用文件中对应的Download连接下载。】
安装脚本解析

建立对应的组件包文件夹并复制

在服务器对应的文件夹建立一个以上方图片中的(文件夹名称) 的文件夹。比如这里我们就要在 (用户数据路径\Data\modules) 下建立一个文件夹(dice-so-nice),然后使用工具(Windows使用远程桌面、Linux使用SFtp、宝塔面板使用面板上传工具)将刚才下载的安装包解压并上传。并且将文件放在 (dice-so-nice) 根目录下,保证有(module.json)这个文件。如果只有一个文件夹,所要求的文件。则有可能module.json在下一级文件夹,需要将全部内容复制到外层文件夹中。如果是system,则是(system)文件夹和(system.json)文件;世界包则是(worlds)文件夹和(worlds.json)文件。【本节易错点:未按照要求先新建,后放置文件夹,或者文件夹名称不正确】
手动安装至系统

确认安装并重启

最后重启服务器上的(FoundryVTT)主程序。重启以后就可以在系统里看见刚才手动安装的Mod包。【本节易错点:安装后未重启服务】

启动对应组件包

进入对应符合要求的世界,在设置中开启这个Mod【本节易错点:未在世界中开启mod】


0x03 当你拿到一个组件包但是缺不知道如何使用怎么办?

确认组件包类型

将文件解压到一个空目录中,并且观察文件检查目录内是否有配置文件(system.json、modules.json、worlds.json)。如果有,则属于对应的组件。

查看配置文件是否有问题

打开对应的配置文件,首先查找MinimumCoreVersion和compatibleCoreVersion确认版本号是否相符,然后再查找manifest和download字段,检查其路径是否正常。同上方第四点。

解析安装配置脚本

查找name字段(V10版本以后为id字段),并将其复制。

建立组件包文件夹并复制

同上方第5点将对应的文件夹创建,并将内容上传到对应文件夹中。

收尾工作

同上方6、7点,重启系统并在世界中启动对应的组件包。