Syncmoney — надёжная синхронизация экономики для Minecraft-сетей
Если вы держите не один сервер, а целую сеть, то наверняка сталкивались с классической головной болью: игрок заработал деньги на выживании, зашёл в лобби — а баланс обнулился. Syncmoney решает именно эту проблему. Это плагин, заточенный под безопасную и консистентную синхронизацию балансов между нодами сети, а не под что-то абстрактное вроде прав или произвольных команд.
Проще говоря, Syncmoney для Minecraft — это мост между экономиками Vault и VaultUnlocked, работающий поверх Redis Pub/Sub и реляционной базы данных. В памяти держится кэш, а на страже стоят многоуровневые предохранители, аудит и теневые бэкапы. Звучит серьёзно — и это действительно enterprise-подход к деньгам на сервере.
Что умеет Syncmoney
Плагин не пытается быть универсальным комбайном. Его задача — балансы, валютные операции и собственные команды администрирования. Всё остальное — не сюда. Зато в своей нише он закрывает вопросы полностью.
- Совместимость с экономикой: бесшовная интеграция с Vault 1.7 и VaultUnlocked (Vault2 API).
- Гибкие режимы: standalone SQLite (local), синхронизация только через Redis (local_redis), Redis + SQL (sync) и режим с авторитетом CMI (cmi).
- Распределённая синхронизация: Redis Pub/Sub с атомарными Lua-скриптами, монотонным версионированием и подавлением эха — гонки данных исключены.
- Производительность: чтение баланса за O(1) прямо из памяти, запись в хранилище — асинхронно, вне тика.
- Многослойный circuit breaker: лимиты на транзакцию в реальном времени, детект аномалий и отдельный guard на игрока (состояния L1–L4).
- Аудит и аналитика: высокопроизводительный асинхронный лог с поиском, статистикой, автоочисткой и экспортом.
- Теневые бэкапы: фоновая синхронизация аккаунтов для холодных снапшотов и отслеживания состояния.
- Встроенная веб-панель: современный интерфейс (Vue 3 / Undertow) для телеметрии, конфигов, аудита и мониторинга экономики.
Отдельно стоит сказать про безопасность планировщика: плагин проверен на Paper 1.20.4 и 26.2, Folia 26.2 BETA и Canvas 26.2, а границы планировщика спроектированы под region-threaded архитектуры. Обычный Spigot, увы, не поддерживается.
Поддерживаемые версии и загрузчики
Syncmoney работает на Paper 1.20.4+ (это базовая линия Build API), а также на Folia и Canvas. Требуется Java 21 для Paper 1.20.4 – 1.20.6 и Java 25 для Paper 26.1+. Обязателен мост экономики: Vault (legacy 1.7) либо VaultUnlocked (2.20.0+). Не загружайте оба одновременно под одним именем. Для режимов sync, local_redis и cmi нужен Redis 5.0+, а база данных — MySQL 8.0+, MariaDB 10.5+, PostgreSQL 13+ или локальный SQLite.
Если вы привыкли ставить всё через лаунчер, обратите внимание: в каталоге дополнений foxygame.net Syncmoney появляется сразу с пометкой о совместимости версий, так что несовместимый билд вы просто не выберете. Установка в один клик избавляет от ручного перетаскивания JAR-файлов и путаницы с зависимостями.
Как установить Syncmoney
Перед любыми действиями остановите сервер и сделайте полный бэкап конфигов, баз экономики и персистентности Redis. Дальше — по шагам.
- Поместите Syncmoney-1.3.0.jar и выбранный провайдер Vault в папку plugins/. Удалите старые версии JAR.
- Запустите сервер один раз, чтобы сгенерировались конфиги, затем остановите его.
- В plugins/Syncmoney/config.yml задайте уникальный server-name (например, survival-01, lobby-01) и выберите economy.mode. Для синхронизируемых режимов пропишите доступы к Redis и SQL.
- Запустите сервер и убедитесь в логах, что Syncmoney и Vault зарегистрировались. Проверьте операции через /money и /pay.
- Для PlaceholderAPI скопируйте SyncmoneyExpansion-1.3.0.jar в plugins/PlaceholderAPI/expansions/ и выполните /papi reload.
Режимы экономики
Режим local — это одиночный SQLite-файл без Redis, для автономных серверов. local_redis хранит экономику в Redis без SQL. sync — это Redis Pub/Sub плюс центральная SQL-база, стандарт для мультисерверных сетей. cmi оставляет авторитет за CMI, а изменения расходятся через Redis. SQLite здесь только для локального и теневого хранения, не для общей базы.
Команды и права
Игрокам доступны /money, /pay, /pay confirm для крупных транзакций и /baltop с проверкой личной позиции. Администраторам — целый арсенал: /syncmoney admin give|take|set|reset, /syncmoney breaker status|reset|unlock, /syncmoney audit, /syncmoney monitor, /syncmoney econstats, /syncmoney shadow, /syncmoney web и /syncmoney migrate. Права разбиты на уровни: observe, reward, general и full с настраиваемыми дневными лимитами.
Веб-панель и интеграции
Встроенный Web Admin поднимает лёгкий Undertow-сервер с готовым фронтендом. Привяжите его к 127.0.0.1, поставьте reverse proxy с HTTPS, замените плейсхолдерный API-ключ на криптостойкий токен и закройте порт файрволом. Для разработчиков Syncmoney регистрируется как обычный Vault-провайдер и на VaultUnlocked дополнительно поднимает сервисы Vault2, а событие PostTransactionEvent позволяет строить собственную телеметрию.
PlaceholderAPI-расширение даёт плейсхолдеры вроде %syncmoney_balance%, %syncmoney_rank%, %syncmoney_top_<n>% и %syncmoney_total_supply%. Кэш-промахи для офлайн-игроков резолвятся асинхронно и возвращают N/A, не подвешивая основной поток.
Итог
Syncmoney — это не про «поставить и забыть», а про предсказуемость денег в сети. Если у вас несколько нод, общая экономика и требования к аудиту, плагин закрывает задачу целиком: от атомарной синхронизации до веб-мониторинга. Скачать Syncmoney стоит тем, кто устал от рассинхрона балансов и хочет enterprise-надёжность без самодельных костылей. Главное — тестируйте обновления на стейджинге, прежде чем трогать боевые балансы.