Synchro

Synchronizes inventory, armor, health, hunger, XP, effects, ender chests, advancements, sleep, and death into one configurable shared co-op survival state.

Загрузки: 541
Подписчики: 4
Обновлён: 28 мая 2026 г.
Лицензия: MIT

Опубликован 14 июня 2025 г.

Исходный код Сообщить об ошибке

Synchro

Synchro turns multiplayer survival into one shared player state. Inventories, armor, health, hunger, effects, XP, advancements, ender chests, fire state, sleep, and death can all be synchronized so a group plays as one combined character.

If you want a co-op challenge where every action matters for everyone, Synchro is built for that exact server style.

Highlights

Shared inventory, armor, ender chest, advancements, health, hunger, saturation, XP, and potion effects
One-player sleep for skipping night without requiring the whole group to enter beds
Synchronized fire ticks, death, respawn handling, and post-death inventory state
Race-condition protection with versioned shared state and delayed-apply guards
Safer inventory handling for crafting, furnace extraction, hoppers, pickups, drops, buckets, vehicles, item frames, and /give
Per-module config.yml toggles with /synchro reload
Admin tools for force sync, restore, debug logging, status, and version checks
Optional update notifications from Modrinth and GitHub for players with admin permission
Folia-aware scheduling paths with Bukkit/Paper fallback

Commands

/synchro enable
/synchro disable
/synchro sync [module]
/synchro status
/synchro reload
/synchro restore
/synchro debug <on|off>
/synchro version

Supported sync modules are all, inventory, armor, effects, potion-effects, health, hunger, experience, xp, ender-chest, and fire-ticks.

Permissions

synchro.admin - Use Synchro admin commands and receive update notifications

Configuration

Every module is enabled by default. Set a module to false in config.yml and run /synchro reload to disable only that part of synchronization.

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"

Typical Workflow

Install Synchro and start the server once to generate config.yml.
Join with two or more players and run /synchro status.
Use /synchro sync to initialize the shared state if needed.
Adjust module toggles in config.yml for the type of co-op challenge you want.
Run /synchro reload after config changes.
Use /synchro debug on while testing edge cases, then turn it off for normal play.

Update Notifications

When a newer version is found, players with synchro.admin are notified when they join. Modrinth checks use project I0rM9fEI, and GitHub release checks use St1ch/Synchro.

The checker is cached by update-checker.check-interval-minutes, so it does not call remote APIs on every join.

API Usage

Other plugins can use Synchro's API:

import org.redstone.SynchroAPI;

if (SynchroAPI.isSyncEnabled()) {
    // Do something.
}
SynchroAPI.setSyncEnabled(false);
SynchroAPI.manualSync();

Development

Build the plugin with:

.\gradlew.bat build

The built jar will be available in build/libs.

Compatibility

Minecraft: 1.18 to 1.21.x
Cores: Bukkit, Spigot, Paper, Folia
Java: 17

Notes

Synchro is designed around shared survival state, not per-player independent inventories.
The update checker uses Modrinth and GitHub public APIs and only notifies players with the configured permission.
Some complex inventory behavior depends on server tick timing; debug logging can help diagnose unusual plugin-stack interactions.

License

This project is distributed under the MIT License.

Ченджлог

1.7.0Релиз1.21.9, 1.21.10, 1.21.11 · 28 мая 2026 г.

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

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

1.5.0Релиз1.21.9, 1.21.10, 1.21.11 · 22 января 2026 г.

Added

One‑player sleep to skip night
Shared ender chest
Shared advancements

Fixed

Armor sync reliability (faster and more consistent)
/synchro disable now stops all synchronization
Fire extinguishing sync
Death drops duplication (only the first death drops items)

Changed

Drowning synchronization removed due to inconsistent visuals and damage

1.4.0Релиз1.21.6, 1.21.7, 1.21.8 · 19 июля 2025 г.

Synchro v1.4.0

Fixed a critical item duplication bug (dupe) when two players simultaneously moved the same item stack.
Implemented master inventory and armor sync — now only one true state is shared between all players, preventing any race conditions and exploits.
Synchronization is instant and event-based for inventory, armor, potion effects, health, hunger, and experience.
Improved overall stability and reliability.

Update is highly recommended for all servers!

1.3Релиз1.21.5, 1.21.6, 1.21.7 · 10 июля 2025 г.

What's new in Synchro 1.3

Instant synchronization for:
- Inventory
- Armor
- Potion effects
- Health
- Hunger & saturation
- Experience and level (NEW!)
Synchronization is now event-based and instant — all player states are updated immediately after any change.
No more timer — all sync is handled by Minecraft events for maximum performance and accuracy.
Improved stability for death and respawn sync.
Bugfixes and optimizations.

No configuration needed — just install and play!

If you find any bugs or have suggestions, please open an issue on GitHub or Modrinth!

1.2Релиз1.21.4, 1.21.5, 1.21.6 · 28 июня 2025 г.

v1.2

Armor Synchronization: All players now share the same armor in real time.
Potion Effects Synchronization: All active potion effects are now synchronized between all players.

Admin Commands:

/synchro enable — Enable synchronization
/synchro disable — Disable synchronization
/synchro sync — Force manual synchronization
/synchro status — Show current sync status

Public Java API: Other plugins can now check and control synchronization programmatically.

Improved stability and code cleanup.

Removed PlaceholderAPI integration (will be added back in a future update).

Synchro

Synchro

Highlights

Commands

Permissions

Configuration

Typical Workflow

Update Notifications

API Usage

Development

Compatibility

Notes

License

Ченджлог

Synchro v1.7.0

Highlights

New Commands

Configuration

Notes

Installation

Added

Fixed

Changed

Synchro v1.4.0

What's new in Synchro 1.3

v1.2

Admin Commands:

Комментарии

Открытый код