VortexFileSync

插件

· 作者 VortexDevelopment

通过 MySQL/MariaDB 在 Minecraft 服务器之间同步配置、脚本和静态数据。支持自动检测、触发器、覆盖以及同步后命令。

0 本站下载 0 关注 更新于 3 个月前

最新 2.1.1 · 26.2 · Paper / Purpur

一键开服(送7天)

插件描述

文本描述

VortexFileSync

面向现代 Minecraft 网络的高性能文件同步工具

VortexFileSync 是一款专为现代 Minecraft 网络打造的高性能文件同步插件。它通过集中式数据库实现配置、脚本和数据在多个服务器实例间的无缝共享,确保整个网络绝对一致,无需人工干预。

它旨在自动化更新多台服务器的繁琐过程:允许你在一个“主”服务器上编辑文件,并实时自动将其传播到其他所有服务器。


它能做什么?

你可以创建以下类型的同步任务:

  • 同步整个文件夹:轻松共享目录,例如 plugins/Skript/scripts、plugins/LuckPerms 或自定义配置文件夹。
  • 自动检测更改:使用高级 SHA-256 哈希算法监控文件变化,仅在检测到实际更新时才进行同步。
  • 触发命令执行:当执行特定的游戏内或控制台命令(例如重载配置后)时,自动上传更改。
  • 应用 YAML 覆盖:保持文件同步的同时保留服务器特定值(如数据库凭证或服务器名称),通过强大的覆盖系统实现。
  • 执行同步后命令:服务器接收文件更新后,自动运行控制台命令,例如 /sk reload all 或 /lp reload。

重要提示:范围与世界文件

VortexFileSync 专为配置和数据同步设计。 它不用于同步活跃的世界文件,例如 level.dat、区域文件或类似的世界数据。

尝试在服务器运行时同步世界文件夹会导致损坏或不完整的传输。请仅将此插件用于插件配置、脚本和静态数据。


MySQL 配置要求

由于所有文件都存储在数据库中,你必须确保 MySQL 或 MariaDB 服务器已配置为处理你的文件夹大小。如果上传失败,很可能是由于 max_allowed_packet 限制所致。

推荐设置:128MB

这支持大型插件目录和脚本库。

如何更新:

  1. 找到你的 MySQL 配置文件,通常在 Linux 上是 my.cnf,Windows 上是 my.ini。
  2. 找到 [mysqld] 部分。
  3. 添加或修改以下行:
[mysqld]
max_allowed_packet=128M
  1. 重启 MySQL 服务以使更改生效。

灵活的同步方法

FileSync 适应你网络的特定需求,对文件的移动方式和时机提供细粒度控制。

  • 定时间隔:为服务器设置自定义心跳,以检查全局数据库中的更新。
  • 命令触发:将上传链接到现有的管理员命令,以便在执行命令的瞬间推送更改。
  • 手动控制:使用专用管理员命令强制上传或检查整个网络的同步状态。
  • 过滤同步:使用详细的忽略列表排除特定文件、文件类型或子目录,使其不同步。

高级功能

  • 原子更新:通过使用基于 zip 的传输和“先验证后应用”逻辑来确保文件完整性。
  • 选择性 YAML 覆盖:按服务器更改 YAML 文件中的特定键,非常适合服务器特定的值(如 ID 或本地路径)。
  • 冲突预防:智能锁定和哈希机制防止在多服务器更新期间出现部分下载或竞态条件。
  • 基于数据库:利用 MySQL 和 MariaDB 的可靠性进行全局状态管理。

命令与权限

  • /vfs upload:手动触发配置的文件夹上传到网络数据库。
  • /vfs:显示用法和插件信息。
  • 权限:vortexfilesync.admin - 所有命令和管理操作必需。

兼容性与性能

支持版本:Paper 及兼容分支 1.18+


零 NMS 使用

由于该插件不使用任何 NMS 代码,更新流畅且一致。你的服务器通常可以在不需要插件更新的情况下升级 Minecraft 版本。


数据库支持

完全支持 MySQL 和 MariaDB,强烈建议以获得最佳性能。该插件使用稳健的存储库模式,确保即使在大型网络上也能高效处理数据。


配置与文档

每个配置文件都经过精心记录,以确保顺畅的设置体验。无论是定义复杂的 YAML 覆盖、设置文件过滤器还是配置命令触发器,你都将在 config.yml 中找到每个选项的清晰说明。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源