Hyfixes

Hyfixes

Includes patches to help fix critical bugs and reduce RAM consumption

11.4 тысяч загрузок
Обновлён 12 дней назад

Описание

HyFixs

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

БУГ-РЕПОРТЫ, ПРЕДСТАВЛЕННЫЕ НА КУРСЕФОРГЕ, НЕВОЗМОЖНЫ. Пожалуйста, используйте GITHUB. Если тебе нужно мое внимание, иди к Дискорду.

Поддержка

Нужна помощь? Присоединяйтесь к нашей поддержке сообщества!

Разногласия: https://discord.gg/6g7McTd27z

Нашёл жучок? Об этом сообщает GitHub:

Проблемы GitHub: https://github.com/John-Willikers/hyfixes/issues


установка

HyFixes состоит из двух плагинов, которые работают вместе:

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

Основной плагин, который исправляет большинство сбоев.

  1. скачать гификсы. банку
  2. Место на вашем сервере модс/ папка
  3. Перезагрузить сервер

Ранний плагин (рекомендуется)

Исправляет глубокие сетевые ошибки, которые вызывают десинхронизацию боя / взаимодействия.

  1. скачать hyfixes-early.jar
  2. Место на вашем сервере ранние плагины/ папка
  3. Запустите сервер с одним из следующих вариантов:
    • Установить переменную среды: ACCEPT_EARLY_PLUGINS=1
    • или пресс Войдите, когда увидите предупреждение о ранних плагинах при запуске

Что становится фиксированным

Плагин Runtime

  • Скачать игру Item Crash Мировой поток падает, когда игрок отключается во время сбора предмета
  • Обсуждение RespawnBlock Crash Игрок ударил ногой при разбивании кровати / спального мешка
  • ПроцессингBench Crash Игрок пинается, когда скамейка разрушается, когда открыта
  • Crash Выход из положения Игрок получил удар при выходе из подземелья с поврежденными данными
  • Обсуждение Chunk Memory Bloat Сервер исчерпал память из незагруженных кусков
  • CraftingManager Крушение Игрок ударил ногой при открытии крафтовой скамейки
  • Обсуждение InteractionManager Crash Игрок получает удар во время определенных взаимодействий
  • Обсуждение Quest Objective Crash Система поиска падает, когда цель деспауна
  • Крушение SpawnMarker Мировой крах во время нереста сущности

Ранний плагин (Bytecode Fixes)

  • Синхронизация Buffer Overflow Исправления боевой/пищевой/инструментальной десинхронизации (400-2500 ошибок за сеанс)
  • Синхронизация позиции Gap Исправление исключения «вне порядка», которое пинает игроков
  • Портальная гонка Instance Исправления крушения «игрок уже в мире» при входе в порталы
  • Null Spawn Контроллер Исправляет мир, когда нерестовые маяки загружаются
  • Нулевые параметры Spawn Исправления мировых аварий в вулканических / пещерных биомах
  • Дублирующие компоненты блока - Исправляет удары игрока при использовании телепортеров
  • Null npcReferences (удаление) - Устранение нерестовых маркеров
  • Null npcReferences (Конструктор) ROOT CAUSE FIX: инициализирует массив в конструкторе SpawnMarkerEntity
  • BlockCounter не сокращается - Лимит телепортера фиксируется на уровне 5
  • Крушение WorldMapTracker Iterator Исправления сервера падают каждые ~ 30 минут на популярных серверах

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

Плагин Runtime

Ищите эти сообщения в журнале вашего сервера при запуске:

[HyFixes | P] Плагин включен - HyFixes vX.X.X
[HyFixes | P] [PickupItemSanitizer] Active - мониторинг поврежденных пикапов
[HyFixes | P] [ChunkCleanupSystem] Активный на главном 

Ранний плагин

Ищите эти сообщения в журнале вашего сервера при запуске (10 трансформаторов):

[HyFixes-Early] Преобразование взаимодействия Цепной класс...
[HyFixes-Early] Взаимодействие Цепная трансформация завершена!

[HyFixes-Early] Преобразование мирового класса...
[HyFixes-Early] Мировая трансформация полна!

[HyFixes-Early] Преобразование SpawnReferenceSystems$BeaconAddRemoveSystem
[HyFixes-Early] SpawnReferenceSystems Transformation Полный!

[HyFixes-Early] Преобразование BeaconSpawnController
[HyFixes-Early] Преобразование BeaconSpawnController COMPLETE!

[HyFixes-Early] Преобразование BlockComponentChunk
[HyFixes-Early] Блок-компонент Преобразование кусков Полный!

[HyFixes-Early] Преобразование SpawnReferenceSystems$MarkerAddRemoveSystem
[HyFixes-Early] MarkerAddRemoveПреобразование системы Полный!

[HyFixes-Early] Преобразование SpawnMarkerEntity
Преобразование SpawnMarkerEntity COMPLETE!

[HyFixes-Early] Трансформация TrackedPlacement$OnAddRemove
[HyFixes-Early] Отслежено Трансформация мест размещения Полный!

[HyFixes-Early] Преобразование WorldMapTracker
[HyFixes-Early] Преобразование WorldMapTracker Полный! 

Административные команды

Командование Описание
/гификсы Показать статистику HyFixes и показатели предотвращения аварий
/chunkstatus Показать загруженные подсчеты кусков и информацию о памяти
/unkunload Немедленная уборка мусора
/ixcounter Телепортатор Fix/View Значения BlockCounter

Алиасы: /hfs, /interactionstatus, fc, /lockcounter


устранение неполадок

Плагин не загружается

  1. Убедитесь, что JAR находится в правильной папке:

    • Плагин Runtime: mods/hyfixes.jar
    • Ранний плагин: Ранние плагины/hyfixes-early.jar
  2. Проверьте журналы сервера на наличие ошибок при запуске

  3. Проверить Java 21+: Java-версия

Раннее предупреждение плагина при запуске

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

Чтобы обойти предупреждение:

  • Настройка ACCEPT_EARLY_PLUGINS=1 переменная среда
  • или пресс Входите, когда вас просят

По-прежнему видны аварии

  1. Проверьте, какая версия HyFixes у вас есть: /гификсы
  2. Обновление до последней версии
  3. Сообщите о крушении на GitHub:
    • Полный журнал сервера, показывающий ошибку
    • Способы размножения (если известно)
    • Версия HyFixes

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

  • Хитэйл: Ранний доступ (2025+)
  • Java: 21 или выше
  • Сбоку: Только на стороне сервера (не требуется установка клиента)

Больше информации

Для подробной технической документации, исходного кода и руководящих принципов вклада:

Репозиторий GitHub: https://github.com/John-Willikers/hyfixes

Полная документация: https://github.com/John-Willikers/hyfixes/blob/main/BUGS_FIXED.md


Поддержать проект

  • Звезда репо на GitHub
  • Сообщите об ошибках, с которыми вы сталкиваетесь
  • Присоединяйтесь к нашему сообществу Discord
  • Поделитесь HyFixes с другими администраторами сервера!

Разногласия: https://discord.gg/6g7McTd27z

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

HyFixes

Essential bug fixes for Hytale Early Access servers. Prevents crashes and player kicks caused by known issues in Hytale's core systems.

BUG REPORTS SUBMITTED ON CURSEFORGE WILL BE IGNORED. PLEASE USE GITHUB. IF YOU NEED MY ATTENTION GO TO DISCORD.

Support

Need help? Join our Discord for community support!

Discord: https://discord.gg/6g7McTd27z

Found a bug? Report it on GitHub:

GitHub Issues: https://github.com/John-Willikers/hyfixes/issues


Installation

HyFixes consists of two plugins that work together:

Runtime Plugin (Required)

The main plugin that fixes most crashes.

  1. Download hyfixes.jar
  2. Place in your server's mods/ folder
  3. Restart the server

Early Plugin (Recommended)

Fixes deep networking bugs that cause combat/interaction desync.

  1. Download hyfixes-early.jar
  2. Place in your server's earlyplugins/ folder
  3. Start the server with one of these options:
    • Set environment variable: ACCEPT_EARLY_PLUGINS=1
    • OR press Enter when you see the early plugins warning at startup

What Gets Fixed

Runtime Plugin

  • Pickup Item Crash - World thread crash when player disconnects while picking up item
  • RespawnBlock Crash - Player kicked when breaking bed/sleeping bag
  • ProcessingBench Crash - Player kicked when bench is destroyed while open
  • Instance Exit Crash - Player kicked when exiting dungeon with corrupted data
  • Chunk Memory Bloat - Server runs out of memory from unloaded chunks
  • CraftingManager Crash - Player kicked when opening crafting bench
  • InteractionManager Crash - Player kicked during certain interactions
  • Quest Objective Crash - Quest system crashes when target despawns
  • SpawnMarker Crash - World crash during entity spawning

Early Plugin (Bytecode Fixes)

  • Sync Buffer Overflow - Fixes combat/food/tool desync (400-2500 errors per session)
  • Sync Position Gap - Fixes "out of order" exception that kicks players
  • Instance Portal Race - Fixes "player already in world" crash when entering portals
  • Null SpawnController - Fixes world crashes when spawn beacons load
  • Null Spawn Parameters - Fixes world crashes in volcanic/cave biomes
  • Duplicate Block Components - Fixes player kicks when using teleporters
  • Null npcReferences (Removal) - Fixes crash on spawn marker removal
  • Null npcReferences (Constructor) - ROOT CAUSE FIX: Initializes array in SpawnMarkerEntity constructor
  • BlockCounter Not Decrementing - Fixes teleporter limit stuck at 5
  • WorldMapTracker Iterator Crash - Fixes server crashes every ~30 min on high-pop servers

Verifying Installation

Runtime Plugin

Look for these messages in your server log at startup:

[HyFixes|P] Plugin enabled - HyFixes vX.X.X
[HyFixes|P] [PickupItemSanitizer] Active - monitoring for corrupted pickup items
[HyFixes|P] [ChunkCleanupSystem] Active on MAIN THREAD

Early Plugin

Look for these messages in your server log at startup (10 transformers):

[HyFixes-Early] Transforming InteractionChain class...
[HyFixes-Early] InteractionChain transformation COMPLETE!

[HyFixes-Early] Transforming World class...
[HyFixes-Early] World transformation COMPLETE!

[HyFixes-Early] Transforming SpawnReferenceSystems$BeaconAddRemoveSystem...
[HyFixes-Early] SpawnReferenceSystems transformation COMPLETE!

[HyFixes-Early] Transforming BeaconSpawnController...
[HyFixes-Early] BeaconSpawnController transformation COMPLETE!

[HyFixes-Early] Transforming BlockComponentChunk...
[HyFixes-Early] BlockComponentChunk transformation COMPLETE!

[HyFixes-Early] Transforming SpawnReferenceSystems$MarkerAddRemoveSystem...
[HyFixes-Early] MarkerAddRemoveSystem transformation COMPLETE!

[HyFixes-Early] Transforming SpawnMarkerEntity...
[HyFixes-Early] SpawnMarkerEntity transformation COMPLETE!

[HyFixes-Early] Transforming TrackedPlacement$OnAddRemove...
[HyFixes-Early] TrackedPlacement transformation COMPLETE!

[HyFixes-Early] Transforming WorldMapTracker...
[HyFixes-Early] WorldMapTracker transformation COMPLETE!

Admin Commands

Command Description
/hyfixes Show HyFixes statistics and crash prevention counts
/chunkstatus Show loaded chunk counts and memory info
/chunkunload Force immediate chunk cleanup
/fixcounter Fix/view teleporter BlockCounter values

Aliases: /hfs/interactionstatus/fc/blockcounter


Troubleshooting

Plugin not loading

  1. Check that the JAR is in the correct folder:

    • Runtime plugin: mods/hyfixes.jar
    • Early plugin: earlyplugins/hyfixes-early.jar
  2. Check server logs for errors during startup

  3. Verify Java 21+ is installed: java -version

Early plugin warning at startup

This is normal! Hytale shows a security warning for early plugins because they can modify game code. HyFixes only modifies the specific buggy methods to fix them.

To bypass the warning:

  • Set ACCEPT_EARLY_PLUGINS=1 environment variable
  • OR press Enter when prompted

Still seeing crashes

  1. Check which version of HyFixes you have: /hyfixes
  2. Update to the latest version
  3. Report the crash on GitHub with:
    • Full server log showing the error
    • Steps to reproduce (if known)
    • HyFixes version

Compatibility

  • Hytale: Early Access (2025+)
  • Java: 21 or higher
  • Side: Server-side only (no client install needed)

More Information

For detailed technical documentation, source code, and contribution guidelines:

GitHub Repository: https://github.com/John-Willikers/hyfixes

Full Bug Documentation: https://github.com/John-Willikers/hyfixes/blob/main/BUGS_FIXED.md


Support the Project

  • Star the repo on GitHub
  • Report bugs you encounter
  • Join our Discord community
  • Share HyFixes with other server admins!

Discord: https://discord.gg/6g7McTd27z

Последние версии

hyfixes-bundle-v1.9.7.zip

Early Access 20.01.2026 652.8 КБ
Скачать

hyfixes-bundle-v1.9.0.zip

Early Access 19.01.2026 626.9 КБ
Скачать

hyfixes-bundle-v1.5.1.zip

Early Access 18.01.2026 531.5 КБ
Скачать

hyfixes-1.3.8.jar

Early Access 17.01.2026 77.7 КБ
Скачать

hyfixes-1.3.4.jar

Early Access 17.01.2026 66.8 КБ
Скачать