ModSync

ModSync is a Hytale server plugin that synchronizes mod lists from various sources (CurseForge implemented, extensible to others). It allows server administrators to manage and synchronize mods via in-game commands.

1.1 тысяча загрузок

Обновлён 9 дней назад

Утилиты Улучшение Качества Жизни

Скачать последнюю версию (262.1 КБ)

Скриншоты

Описание

Модсинк

Ранняя стадия развития - Этот плагин находится в очень ранней разработке. Используйте на свой страх и риск. Разработка продолжается - пожалуйста, будьте добры с отзывами и сообщениями об ошибках!

Плагин управления модулями на стороне сервера для выделенных серверов Hytale, который позволяет легко добавлять, устанавливать, обновлять и удалять модули непосредственно из команд игры или консоли.

Особенности

Несколько источников CurseForge (требуется ключ API), CFWidget (обратная связь для CurseForge без ключа API) и Modtale (требуется ключ API). Еще немного.
Однокомандная установка Установите все управляемые моды одновременно
Полный жизненный цикл Мод Добавление, установка, обновление, удаление модов с помощью команд
Обновление управления Проверьте наличие обновлений, обновления отдельных модов или все сразу
Каналы выпуска Выберите версии Release, Beta или Alpha (глобальные + per-mod)
Импорт существующих модов Сканирование и импорт неуправляемых модов с автоматическим сопоставлением
Постоянное отслеживание Ваш список модов сохраняется и сохраняется при перезагрузке сервера. Поделитесь своим списком с друзьями, как модпак!
Самосовершенствование Обновление ModSync из GitHub
Поддержка консоли Все команды работают от игровой и серверной консоли

Быстрый старт

скачать modsync-<version>.jar отсюда или GitHub выходит
Место на вашем сервере модс/ папка
Запуск сервера
(необязательно) Установите ключ API CurseForge: /modsync config key curseforge <key>
Добавить мод: /modsync Добавить https://curseforge.com/hytale/mods/example

Получите ключ API от Консоль CurseForge или Modtale API Докс

Примечание: Без ключа API ModSync использует CFWidget в качестве резервной копии URL-адресов CurseForge. CFWidget поддерживает поиск на основе URL, но не соответствие импорта на основе поиска. Примечание: Поддержка Modtale является экспериментальной и требует API-ключа.

командование

Командование	Описание
`/modsync Добавить <url>`	Добавить мод от CurseForge URL
`/modsync список`	Показать все управляемые моды со статусом установки
`/modsync установка`	Установите все моды из вашего списка
`/modsync install <name>`	Установите конкретный мод
`/modsync удалить <name>`	Удалить мод по имени, слизняку или идентификатору
`/modsync удаляет все`	Удалить все моды
`/modsync проверка`	Проверьте доступные обновления
`Модернизация /modsync`	Обновление всех установленных модов
`Модификации /modsync <name>`	Обновление конкретного мода
`/modsync сканирование`	Список неуправляемых модов в папке модов
`/modsync импорт`	Автоматизация и импорт всех неуправляемых модов
`/modsync импорт <target>`	Автоматизация и импорт конкретного мода
`/modsync import <target> --url=<url>`	Импорт с определенным URL CurseForge
`/modsync config`	Показать все настройки
`/modsync config channel <value>`	Настройка канала выпуска по умолчанию
`/modsync config key <provider> <key>`	Установите API-ключ для провайдера
`/modsync config welcome <on \|off>`	Включить или отключить приветственное сообщение администратора
`/modsync setchannel <mod> <channel>`	Настройка канала релиза per-mod
`/modsync самоулучшение`	Проверьте обновления плагинов ModSync
`/modsync самоулучшение`	Скачать и установить последнюю версию ModSync
`/modsync статус`	Показать текущую конфигурацию и версию
`/modsync перезагрузка`	Перезагрузка конфигурации с диска

Совет: Используйте цитаты для имен с пробелами: /modsync инсталляция «Мой мод»

Каналы выпуска

Контроль, какие типы выпуска рассматриваются для установки и обновления:

Канал	Включенные версии
`освобождение`	Стабильные релизы (по умолчанию)
`бета`	Бета- и стабильные релизы
`альфа`	Все версии, включая альфа

/modsync config канал бета Установить глобальный дефолт
/modsync setchannel MyMod альфа Переопределение для конкретного мода
/modsync setchannel MyMod по умолчанию # Удалить оверрайд, использовать глобально

Автоматический Fallback: Если в моде нет релизов для вашего настроенного канала (например, только бета-версии, но вы находитесь в релизе), ModSync автоматически возвращается в бета-версию. Предупреждение показано, чтобы вы знали, какой тип версии использовался.

Как это работает

Установка модов

The /modsync Добавить и /modsync установка командовать

Когда вы устанавливаете мод, плагин:

Добавить мод в управляемый список через URL
Скачать мод из источника мод и проверить манифест
Обнаруживает тип плагина (обычный плагин или ранний плагин) из категории CurseForge
Сохранит его в соответствующей папке:
- Регулярные плагины модс/
- Ранние / Bootstrap плагины ранние плагины/ (конфигурируемый)
Регистрирует мод в установленном реестре модов

Примечание: Серверный перезапуск необходим для загрузки вновь установленных модов.

Удаление модов

The /modsync скачать командовать

Когда вы удаляете мод, плагин:

Разгружает мод, если в настоящее время загружен
Попытки удалить файл mod
Если файл заблокирован (Windows), он выстраивает очередь для удаления при следующем перезапуске. Установите плагин bootstrap для обработки удаления при перезапуске.

Примечание: Если файл заблокирован (Windows), он выстраивает очередь для удаления при следующем перезапуске. Плагин bootstrap обрабатывает удаленные очереди перед загрузкой сервером модов.

Проверка и установка обновлений

The /modsync проверка командующий:

Показывает, какие моды имеют обновления, доступные для сравнения версий (например, 1.0.1 -> 1.0.2).

The Модернизация /modsync командующий:

Обновление всех установленных модов или конкретного мода.

Примечание: Для загрузки обновленных модов требуется перезагрузка сервера.

Импорт существующих модов

Использовать /modsync сканирование Чтобы найти неуправляемые моды, /modsync импорт Чтобы привести их под контроль ModSync с автоматическим сопоставлением.

Примечание: Импорт и сканирование в настоящее время требуют проклятия. Формирование API-ключа для автоматического сопоставления. CFWidget и Modtale не поддерживают импорт, основанный на поиске.

Bootstrap Plugin (необязательно)

В Windows файлы JAR блокируются при загрузке JVM. Это предотвращает удаление старых версий модов во время обновлений.

Плагин Bootstrap является Ранний плагин Это происходит до того, как обычные плагины загружаются:

читать _deletions.json
Удалите файлы в очередь, прежде чем они загружаются
Нормальная загрузка плагина продолжается

Установка (только если у вас есть проблемы с удалением):

Скачать из модсинк-ботстрап
Место в ранние плагины/ папка
Запуск сервера с ранние плугины -принять-ранние плагины флаги

Примечание: На выделенных серверах Linux блокировка файлов, как правило, не является проблемой, и плагин загрузочного шлема обычно не требуется.

Местоположение файлов

Все данные хранятся в Моды/Onyxmoon_ModSync/:

config.json - API-ключи и настройки
mods.json Ваш список модов (совместимых между серверами)
mods.lock.json Состояние установки (машиноспецифическое, не совместно используемое)
_deletions.json Файлы, стоящие в очереди для удаления при перезапуске (только когда есть заблокированные файлы и требуется плагин bootstrap)

Важные заметки

Требуется перезагрузка сервера В настоящее время нет возможности запустить перезагрузку сервера через API Mod. После установки, обновления или удаления модов вы должны вручную перезагрузить сервер. Если сервер автоматически запускается, вы можете использовать команду /stop для запуска перезапуска.
Распределение модов Моды можно загрузить только в том случае, если автор включил «Разрешить распространение модов» в настройках проекта CurseForge.
Откат поставщика Без ключа API CurseForge ModSync использует CFWidget, который поддерживает поиск по URL, но не поиск.
Блокировка файлов (Windows)Файлы JAR блокируются при загрузке. Плагин bootstrap обрабатывает удаление при перезапуске.
Поддерживаемые источникиПоддерживаются CurseForge, Modtale (альфа) и CFWidget. CFWidget использует общедоступный API виджетов и не требует ключа API, но не поддерживает импорт на основе поиска.
Приветственное сообщение администратора Отключить приветственное сообщение администратора через config.json с Отключить AdminWelcomeMessage: true

Поддержка

Показать оригинальное описание (English)

ModSync

Early Development Stage - This plugin is in very early development. Use at your own risk. Development is ongoing - please be kind with feedback and bug reports!

A server-side mod management plugin for Hytale dedicated servers that lets you easily add, install, update, and remove mods directly from in-game or console commands.

Features

Multiple Sources - CurseForge (API key required), CFWidget (fallback for CurseForge with no API key) and Modtale (alpha, API key required). More to come.
One-command install - Install all managed mods at once
Full Mod Lifecycle - Add, install, update, remove mods via commands
Update Management - Check for updates, upgrade individual mods or all at once
Release Channels - Choose Release, Beta, or Alpha versions (global + per-mod)
Import Existing Mods - Scan and import unmanaged mods with auto-matching
Persistent tracking - Your mod list is saved and persists across server restarts. Share your list with friends like a modpack!
Self-Upgrade - Update ModSync itself from GitHub Releases
Console Support - All commands work from in-game and server console

Quick Start

Download modsync-<version>.jar from here or GitHub-Releases
Place in your server's mods/ folder
Start server
(Optional) Set your CurseForge API key: /modsync config key curseforge <key>
Add mods: /modsync add https://curseforge.com/hytale/mods/example

Get your API key from CurseForge Console or Modtale API Docs

Note: Without an API key, ModSync uses CFWidget as fallback for CurseForge URLs. CFWidget supports URL-based lookups but not search-based import matching. Note: Modtale support is experimental/alpha and requires an API key.

Commands

Command	Description
`/modsync add <url>`	Add mod from CurseForge URL
`/modsync list`	Show all managed mods with install status
`/modsync install`	Install all mods from your list
`/modsync install <name>`	Install a specific mod
`/modsync remove <name>`	Remove mod by name, slug, or identifier
`/modsync remove all`	Remove all mods
`/modsync check`	Check for available updates
`/modsync upgrade`	Upgrade all installed mods
`/modsync upgrade <name>`	Upgrade a specific mod
`/modsync scan`	List unmanaged mods in the mods folder
`/modsync import`	Auto-match and import all unmanaged mods
`/modsync import <target>`	Auto-match and import a specific mod
`/modsync import <target> --url=<url>`	Import with a specific CurseForge URL
`/modsync config`	Show all configuration settings
`/modsync config channel <value>`	Set default release channel
`/modsync config key <provider> <key>`	Set API key for a provider
`/modsync config welcome <on\|off>`	Enable or disable the admin welcome message
`/modsync setchannel <mod> <channel>`	Set per-mod release channel
`/modsync selfupgrade`	Check for ModSync plugin updates
`/modsync selfupgrade apply`	Download and install latest ModSync
`/modsync status`	Show current configuration and version
`/modsync reload`	Reload configuration from disk

Tip: Use quotes for names with spaces: /modsync install "My Mod"

Release Channels

Control which release types are considered for installation and updates:

Channel	Versions Included
`release`	Stable releases only (default)
`beta`	Beta and stable releases
`alpha`	All versions including alpha

/modsync config channel beta       # Set global default
/modsync setchannel MyMod alpha    # Override for specific mod
/modsync setchannel MyMod default  # Remove override, use global

Automatic Fallback: If a mod has no releases for your configured channel (e.g., only Beta versions but you're on Release), ModSync automatically falls back to Beta, then Alpha. A warning is shown so you know which version type was used.

How It Works

Installing Mods

The /modsync add and /modsync install command

When you install a mod, the plugin:

Add the mod to the managed list via an URL
Downloads the mod from the mod source and validates the manifest
Detects the plugin type (regular plugin or early plugin) from the CurseForge category
Saves it to the appropriate folder:
- Regular plugins → mods/
- Early/Bootstrap plugins → earlyplugins/ (configurable)
Registers the mod in the installed mods registry

Note: A server restart is required to load newly installed mods.

Removing Mods

The /modsync remove command

When you remove a mod, the plugin:

Unloads the mod if currently loaded
Attempts to delete the mod file
If the file is locked (Windows), it queues the file for deletion on next restart. Install the bootstrap plugin to handle deletion on restart.

Note: If the file is locked (Windows), it queues the file for deletion on next restart. The bootstrap plugin handles queued deletions before the server loads mods.

Checking and installing upgrades

The /modsync check command:

Shows which mods have updates available with version comparison (e.g., 1.0.1 -> 1.0.2).

The /modsync upgrade command:

Upgrades all installed mods or a specific mod.

Note: A server restart is required to load upgraded mods.

Importing Existing Mods

Use /modsync scan to find unmanaged mods, then /modsync import to bring them under ModSync control with auto-matching.

Note: Import and scan currently require a CurseForge API key for auto-matching. CFWidget and Modtale do not support search-based imports.

Bootstrap Plugin (Optional)

On Windows, JAR files are locked while loaded by the JVM. This prevents deletion of old mod versions during upgrades.

The bootstrap plugin is an early plugin that runs before normal plugins load:

Reads pending_deletions.json
Deletes queued files before they get loaded
Normal plugin loading proceeds

Installation (only if you have deletion issues):

Download from modsync-bootstrap
Place in earlyplugins/ folder
Start server with --early-plugins --accept-early-plugins flags

Note: On Linux dedicated servers, file locking is typically not an issue and the bootstrap plugin is usually not needed.

File Locations

All data is stored in mods/Onyxmoon_ModSync/:

config.json - API keys and settings
mods.json - Your curated mod list (shareable between servers)
mods.lock.json - Installation state (machine-specific, not shareable)
pending_deletions.json - Files queued for deletion on restart (only when there are locked files and the bootstrap plugin is required)

Important Notes

Server restart required - Currently, there is no way to trigger a server restart via the Mod API. After installing, upgrading, or removing mods, you must manually restart the server. If you server is auto-restarting, you may use the /stop command to trigger a restart.
Mod distribution - Mods can only be downloaded if the author has enabled "Allow Mod Distribution" in their CurseForge project settings
Provider fallback - Without a CurseForge API key, ModSync uses CFWidget which supports URL lookups but not search
File Locking (Windows): JAR files are locked while loaded. The bootstrap plugin handles deletion on restart.
Supported Sources: CurseForge, Modtale (alpha), and CFWidget are supported. CFWidget uses the public widget API and does not require an API key, but does not support search-based imports.
Admin welcome message - Disable the admin welcome message via config.json with disableAdminWelcomeMessage: true