Synchro

Synchro v1.7.0

This is a major stability and quality update focused on safer shared-state synchronization, fewer inventory edge-case issues, configurable modules, admin tooling, and update notifications.

Highlights

- Added config.yml with per-module synchronization toggles - Added /synchro reload, /synchro restore, /synchro debug <on|off>, /synchro version - Added /synchro sync [module] for targeted manual synchronization - Added tab completion for /synchro - Added update notifications for admins via Modrinth and GitHub checks - Added shared-state versioning to prevent stale delayed sync tasks from overwriting newer state - Improved inventory synchronization for crafting, furnace extraction, hoppers, pickups, drops, buckets, vehicles, item frames, and /give - Improved XP synchronization, including level progress bar - Improved armor, hotbar, item durability, and item break synchronization - Improved health, hunger, fire ticks, death, respawn, ender chest, and advancement synchronization - Improved Folia-aware scheduling paths - Reworked README and cleaned generated files from the repository

New Commands

- /synchro enable - /synchro disable - /synchro sync [module] - /synchro status - /synchro reload - /synchro restore - /synchro debug <on|off> - /synchro version Supported modules for /synchro sync [module]: all, inventory, armor, effects, potion-effects, health, hunger, experience, xp, ender-chest, fire-ticks

Configuration

A new config.yml is generated automatically.

sync:
  inventory: true
  armor: true
  potion-effects: true
  health: true
  hunger: true
  experience: true
  death: true
  ender-chest: true
  advancements: true
  one-player-sleep: true
  fire-ticks: true

debug:
  enabled: false

update-checker:
  enabled: true
  check-interval-minutes: 60
  notify-permission: synchro.admin
  modrinth-project: "I0rM9fEI"
  github-repo: "St1ch/Synchro"

Notes

- Players with synchro.admin will be notified on join if a newer version is available. - The update checker uses cached checks and does not call remote APIs on every join. - This version is intended for Minecraft 1.18 to 1.21.x on Bukkit, Spigot, Paper, and Folia. - Java 17 or newer is required.

Installation

1. Download Synchro-1.7.0.jar. 2. Place it in your server's plugins folder. 3. Restart the server. 4. Review plugins/Synchro/config.yml if you want to disable specific sync modules.