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.