Hyfixes
Includes patches to help fix critical bugs and reduce RAM consumption
Описание
HyFixs
Основные исправления ошибок для серверов раннего доступа Hytale. Предотвращает сбои и удары игрока, вызванные известными проблемами в основных системах Hytale.
БУГ-РЕПОРТЫ, ПРЕДСТАВЛЕННЫЕ НА КУРСЕФОРГЕ, НЕВОЗМОЖНЫ. Пожалуйста, используйте GITHUB. Если тебе нужно мое внимание, иди к Дискорду.
Поддержка
Нужна помощь? Присоединяйтесь к нашей поддержке сообщества!
Разногласия: https://discord.gg/6g7McTd27z
Нашёл жучок? Об этом сообщает GitHub:
Проблемы GitHub: https://github.com/John-Willikers/hyfixes/issues
установка
HyFixes состоит из двух плагинов, которые работают вместе:
Runtime Plugin (обязательно)
Основной плагин, который исправляет большинство сбоев.
- скачать
гификсы. банку - Место на вашем сервере
модс/папка - Перезагрузить сервер
Ранний плагин (рекомендуется)
Исправляет глубокие сетевые ошибки, которые вызывают десинхронизацию боя / взаимодействия.
- скачать
hyfixes-early.jar - Место на вашем сервере
ранние плагины/папка - Запустите сервер с одним из следующих вариантов:
- Установить переменную среды:
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
устранение неполадок
Плагин не загружается
-
Убедитесь, что JAR находится в правильной папке:
- Плагин Runtime:
mods/hyfixes.jar - Ранний плагин:
Ранние плагины/hyfixes-early.jar
- Плагин Runtime:
-
Проверьте журналы сервера на наличие ошибок при запуске
-
Проверить Java 21+:
Java-версия
Раннее предупреждение плагина при запуске
Это нормально! Hytale показывает предупреждение о безопасности для ранних плагинов, потому что они могут изменять игровой код. HyFixes только изменяет конкретные методы исправления ошибок.
Чтобы обойти предупреждение:
- Настройка
ACCEPT_EARLY_PLUGINS=1переменная среда - или пресс Входите, когда вас просят
По-прежнему видны аварии
- Проверьте, какая версия HyFixes у вас есть:
/гификсы - Обновление до последней версии
- Сообщите о крушении на 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.
- Download
hyfixes.jar - Place in your server's
mods/folder - Restart the server
Early Plugin (Recommended)
Fixes deep networking bugs that cause combat/interaction desync.
- Download
hyfixes-early.jar - Place in your server's
earlyplugins/folder - 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
- Set environment variable:
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
-
Check that the JAR is in the correct folder:
- Runtime plugin:
mods/hyfixes.jar - Early plugin:
earlyplugins/hyfixes-early.jar
- Runtime plugin:
-
Check server logs for errors during startup
-
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=1environment variable - OR press Enter when prompted
Still seeing crashes
- Check which version of HyFixes you have:
/hyfixes - Update to the latest version
- 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
hyfixes-bundle-v1.9.0.zip
hyfixes-bundle-v1.5.1.zip
hyfixes-1.3.8.jar
hyfixes-1.3.4.jar
Информация
Авторы:
Категории:
Версии игры:
Создан: 16.01.2026