VortexFileSync 1.0.0

VortexFileSync

VortexFileSync is a high-performance file synchronization plugin built for modern Minecraft networks.
It enables seamless sharing of configuration files, scripts, and data across multiple server instances via a centralized database, ensuring absolute consistency across your entire network without manual intervention.

It's designed to automate the tedious process of updating multiple servers, allowing you to edit a file on one "master" server and have it automatically propagate to all others in real time.
(More preview images can be found on the wiki page, contact support on our discord server)

What can you do with it?
You can create synchronization tasks that:

1. Sync Entire Folders: Effortlessly share directories like plugins/Skript/scripts, plugins/LuckPerms, or custom config folders.
2. Auto-Detect Changes: Uses advanced SHA-256 hashing to monitor file changes and only sync when an actual update is detected.
3. Trigger on Commands: Automatically upload changes when specific in-game or console commands are executed, e.g., after reloading a config.
4. Apply YAML Overrides: Keep files synced while maintaining server-specific values like database credentials or server names using a powerful override system.
5. Execute Post-Sync Commands: Automatically run console commands like /sk reload all or /lp reload after a server receives a file update.

Important: Scope & World Files

VortexFileSync is designed for configuration and data synchronization.
It is not intended for synchronizing active world files like level.dat or region files.
Attempting to sync world folders while a server is running will result in corruption or incomplete transfers.
Please only use this plugin for plugin configurations, scripts, and static data.

MySQL Configuration Requirement
Since all files are stored in your database, you must ensure your MySQL or MariaDB server is configured to handle the size of your folders.
If your upload fails, it is likely due to the max_allowed_packet limit.

Recommended setting: 128MB
Supports large plugin directories and script libraries.

How to update it:

1. Locate your MySQL configuration file, usually my.cnfon Linux or my.ini on Windows.
2. Find the [mysqld] section or add it.
3. Add or modify the following line:
   [mysqld]
max_allowed_packet=128M
4. Restart your MySQL service for the changes to take effect.

Flexible Sync Methods
VortexFileSync adapts to your network's specific needs with granular control over how and when files move.

1. Timed Intervals: Set a custom heartbeat for servers to check the global database for updates.
2. Command Triggers: Link uploads to existing admin commands so changes are pushed the moment you execute them.
3. Manual Control: Use dedicated admin commands to force uploads or check sync status across the network.
4. Filtered Syncing: Use detailed ignore lists to exclude specific files, file types, or subdirectories from synchronization.

Advanced Features

1. Atomic Updates: Ensures file integrity using zip-based transfers and verify-before-apply logic.
2. Selective YAML Overrides: Change only specific keys in a YAML file per server, perfect for server-specific values like IDs or local paths.
3. Conflict Prevention: Intelligent locking and hashing prevent partial downloads or race conditions during multi-server updates.
4. Database Backed: Leverages the reliability of MySQL and MariaDB for global state management.

Commands & Permissions

1. /vfs upload: Manually trigger an upload of configured folders to the network database.
2. /vfs: Display usage and plugin information.
3. Permission: vortexfilesync.admin Required for all commands and administrative actions.

Compatibility & Performance
Supported versions: Paper and compatible forks 1.18.2+

Zero NMS Usage
Since the plugin uses no NMS, updates are smooth and consistent.
Your server can usually update Minecraft versions without needing a plugin update.

Database Support
Fully supports MySQL and MariaDB.
When first launcing the plugin you will need to set the database type for one of them in the database.yml file in order to be used across multiple servers!

Configuration & Documentation

Every configuration file is meticulously documented to ensure a smooth setup experience.
Whether you are defining complex YAML overrides, setting up file filters, or configuring command triggers, you'll find clear explanations for every option in config.yml.
You can find more details on the wiki page.

Stop fighting your plugins. Start running your server.