说在之前

本工具支持环境为Windows10以上,Winserver版本2016以上
有很多使用Fvtt的朋友,应该遇到过PC电脑浏览器各异,访问方式各异等问题,每次给PC提供地址访问都很困扰,服务器性能较差,PC加载体验不行等诸多问题。现在是时候Fvtt本地映射工具包来一次性解决这些问题了。
本工具可以前往Fvtt中文社区QQ群:716573917 从群共享中下载,在群中反馈bug和学习使用。
也可以从 此处 下载一次性离线工具包。


更新历史

Release v1.04

  • 现在提供了一部分常用的小工具,包括路由跟踪、nat检测。
  • 现在新增了【Fvtt-Local-status】字段来判断是否命中本地数据,可以和【Fvtt-Cache-status】来协同判断工作情况。
  • 修复了Localhost本地WS无法升级的偶发性问题,以及本地路径被错误缓存的请求性问题。
  • 分离了普通资源缓存【Cache】以及动态资源缓存【RTCache】。

Release v1.03

  • 现在新增了Fvtt-Cache缓存机制,多次请求后会在本地留下缓存文件以减少相同文件的服务器请求。
  • 现在可以通过字段【Fvtt-Cache-status】来判断是否命中工具缓存或者本地数据。
  • 若出现缓存问题,请手动删除【Cache】目录下的所有文件,保留空目录即可。

DM&服务器管理员操作说明

根据服务器情况配置工具

找到本工具目录中的【nginx\conf\nginx.conf】文件,打开并修改【set $fvtturl 】字段。
修改你FVTT服务器对应的IP地址和端口,注意要包含【http://】和端口后要以半角【;】结尾。(注意,此处的地址可以是域名,但是不支持部署了SSL的HTTP2.0)
修改工具配置

拷贝本地映射文件

将服务器上【用户数据目录】中你认为所需要的文件,拷贝到工具目录中【Data】文件夹对应的目录里,可以是【systems】【modules】【worlds】等。
上传需要的映射文件

确认工具能否正常工作

打开工具中的【开启nginx本地反代.bat】
执行脚本测试
按任意键打开工具自带的【纯净版chromium】,检查映射是否建立,然后点击下方的【Return to FoundryVTT】返回,查看服务器是否建立链接。
确认工具工作正常

整理打包与分发

确认完毕后使用【关闭nginx本地反代.bat】关闭本地服务,然后将工具整体打包发放给PC即可。


PC使用手册

获取配置完毕的工具

从你的DM拿到经过配置的本工具,解压缩到设备上任意位置。

启动工具并正常游玩

执行【开启nginx本地反代.bat】启动工具
执行脚本

启动chromium浏览器

在命令行中按任意键,等待chromium软件弹出,点击【Return to FoundryVTT】连接到服务器,就可以正常使用。
确认工具工作正常

不小心关闭chromium了

执行【重新启动Chromium.bat】,即可重新打开。

跑团结束了

执行【关闭nginx本地反代.bat】,结束服务。


注意事项

  • 本工具无法取代服务器,也无法解决内网穿透问题,仅为提升性能的一种方式。
  • 本工具是非侵入式工具,不会影响服务器上原有部署内容,使不使用本工具皆不会影响以直接访问服务器方式使用FVTT
  • 本工具中的【nginx】文件夹内的文件,除了上方说明的内容,如无技术知识储备,切勿随意修改。
  • 本脚本只仅将服务器上的【用户数据目录】重定向到脚本文件夹中的【Data】目录,所有文件皆会匹配。
  • 本工具目前已经不要求完整拷贝,也不要求每次变更后重新制作。但未被放置进本工具【Data】目录的文件,会自行向服务器上请求,与直接访问服务器性能一致。
  • 本脚本启动后将自动调用浏览器打开检查链接以确认本地映射是否正常,请查看是否有映射完成提示。
  • 目前proxy_pass不支持HTTP2.0反代,所以只能映射不带有SSL的http链接,若之前服务器上部署了具有SSL的Fvtt,可以配置为原始Fvtt的端口号+ip地址
  • 如果有部分静态动态文件不属于静态和动态的文件名,管理员可以根据自己的需要,将后缀名加入到静态或者动态分组,以实现缓存。
  • 如果页面出现缓存错误,请删除【RTCache】文件夹内所有文件(文件夹不可删除)后重启本工具以清除本地缓存。