English

AeroSync lets you share selected Minecraft data with a friend through one private P2P address. No dedicated server, public IP address, manual port forwarding, or direct IP entry is required.

Select the categories you want to share, wait for packaging to finish, and send the generated AEROSYNC:... address to your friend. AeroSync uses Iroh for encrypted connectivity, NAT traversal, and relay fallback when a direct route is unavailable.

CurseForge edition: AeroSync normally supports automatic mod synchronization, but this feature is intentionally disabled and its download code is not packaged in the CurseForge builds. This change is required to comply with CurseForge's file distribution requirements. All components required by this edition are already bundled inside the JAR; it does not download additional program components after installation.

Features

• Built-in in-game content catalog and manager for Mods, Resource Packs, and Shaders
• Instant hot-reloading for Resource Packs and Shader Packs without reopening menus
• Seamless one-click game restart button for applying loaded Java mods
• Page scrollbar auto-reset on navigation for clean list browsing
• Local content manager with enable/disable toggles and deletion controls
• Share a selected singleplayer world
• Share configs from config/
• Share shader packs from shaderpacks/
• Share resource packs from resourcepacks/
• Share screenshots from screenshots/
• Share options.txt, optionsof.txt, and optionsshaders.txt
• Choose worlds through a searchable vanilla-style list
• See packaging, transfer, and extraction progress
• Create a backup before an existing world is overwritten
• Protect extraction against Zip Slip paths
• Cancel transfers and handle connection timeouts
• Use the interface in English or Russian

Nothing is selected by default. The sender decides exactly which categories are included in each package.

Compatibility

Fabric installations require Fabric API. NeoForge installations have no additional mod dependencies.

AeroSync must be installed on both computers. Both players should use matching Minecraft, mod loader, and AeroSync versions.

How to use

Sender

1. Open AeroSync P2P from the title screen or pause menu.
2. Select the categories to share.
3. If world synchronization is enabled, click Select world and choose a save.
4. Click Send / Create address.
5. Wait until packaging and address generation are complete.
6. Copy the complete AEROSYNC:... address and send it privately to your friend.

Receiver

1. Open AeroSync P2P and select Receive.
2. Paste the complete AeroSync address.
3. Click Connect and download.
4. Keep Minecraft open until extraction finishes successfully.
5. Restart Minecraft after receiving configs, resource packs, shader packs, or settings.

Privacy and safety

• The address grants access to the active transfer, so share it only with the intended recipient.
• Selected data is transferred through Iroh P2P connectivity. Relay infrastructure may carry encrypted traffic when a direct path is unavailable.
• AeroSync does not provide permanent cloud storage.
• Back up important Minecraft data before using this early testing release.

Authors

• StandoffKitty75
• K2 Studio

Русский

AeroSync позволяет передавать выбранные данные Minecraft другу по одному приватному P2P-адресу. Выделенный сервер, публичный IP, ручное открытие портов и ввод IP-адреса не требуются.

Выберите нужные категории, дождитесь завершения упаковки и отправьте другу созданный адрес AEROSYNC:.... AeroSync использует Iroh для зашифрованного соединения, обхода NAT и ретрансляции, если прямое подключение недоступно.

Версия для CurseForge: обычно AeroSync поддерживает автоматическую синхронизацию модов, однако в сборках для CurseForge эта функция намеренно отключена, а код загрузки модов не включён в JAR. Это изменение необходимо для соблюдения требований CurseForge к распространению файлов. Все компоненты, необходимые этой версии, уже находятся внутри JAR; после установки она не загружает дополнительные программные компоненты.

Возможности

• Встроенный внутриигровой каталог и менеджер модов, ресурспаков и шейдеров
• Мгновенная горячая перезагрузка ресурспаков и шейдерпаков прямо из меню
• Кнопка бесшовного перезапуска игры в один клик для применения установленных модов
• Автоматический сброс позиций скроллбара при навигации по страницам
• Управление локальным контентом (включение/отключение и удаление элементов)
• Передача выбранного одиночного мира
• Передача конфигов из config/
• Передача шейдерпаков из shaderpacks/
• Передача ресурспаков из resourcepacks/
• Передача скриншотов из screenshots/
• Передача options.txt, optionsof.txt и optionsshaders.txt
• Выбор мира через список с поиском в стиле обычного меню Minecraft
• Отображение прогресса упаковки, передачи и распаковки
• Создание резервной копии перед заменой существующего мира
• Защита распаковки от путей Zip Slip
• Отмена передачи и обработка тайм-аутов соединения
• Интерфейс на русском и английском языках

По умолчанию ничего не выбрано. Отправитель самостоятельно определяет содержимое каждого пакета.

Совместимость

Для Fabric требуется Fabric API. Для NeoForge дополнительные моды не нужны.

AeroSync должен быть установлен на обоих компьютерах. Версии Minecraft, загрузчика и AeroSync у обоих игроков должны совпадать.

Как пользоваться

Отправитель

1. Откройте AeroSync P2P из главного меню или меню паузы.
2. Выберите категории для передачи.
3. Если включена передача мира, нажмите Выбрать мир и укажите сохранение.
4. Нажмите Отправить / Создать адрес.
5. Дождитесь окончания упаковки и создания адреса.
6. Скопируйте полный адрес AEROSYNC:... и отправьте его другу в личном сообщении.

Получатель

1. Откройте AeroSync P2P и выберите Получить.
2. Вставьте полный адрес AeroSync.
3. Нажмите Подключиться и скачать.
4. Не закрывайте Minecraft до успешного завершения распаковки.
5. После получения конфигов, ресурспаков, шейдерпаков или настроек перезапустите Minecraft.

Приватность и безопасность

• Адрес предоставляет доступ к активной передаче, поэтому отправляйте его только нужному получателю.
• Выбранные данные передаются через P2P-соединение Iroh. Если прямой маршрут недоступен, зашифрованный трафик может идти через ретранслятор.
• AeroSync не является постоянным облачным хранилищем.
• Перед использованием этой ранней тестовой версии создавайте резервные копии важных данных Minecraft.

Авторы

• StandoffKitty75
• K2 Studio