Adaptive Performance Tweaks (APTweaks)

12.x - текущая унифицированная версия. Старые гайды могут описывать устаревшую 11.x с раздельными модулями.

Сделайте бэкап мира и конфигов перед обновлением. 12.x ещё на стадии раннего релиза, и некоторые настройки могут меняться.

Известные ограничения до стабильного релиза: пока нет графического интерфейса для конфигурации в игре. 12.x работает по принципу "сначала конфиг", и крупным серверам обычно требуется подкрутка спавна.

Обновляетесь с 11.x? Удалите все старые jar-файлы APTweaks перед установкой 12.x. Не мешайте 11.x и 12.x в одной папке mods/.

Adaptive Performance Tweaks - это серверный оптимизационный мод для Forge, Fabric и NeoForge. Он следит за нагрузкой на серверную часть Майнкрафт и автоматически подстраивает отдельные системы, чтобы снизить лаги на выделенных серверах, в одиночной игре и по LAN.

То есть APTweaks не только для публичных или выделенных серверов. Он помогает и в обычных клиентских мирах, потому что одиночная игра и LAN-сессии всё равно используют те же серверные системы для спавна, тиков, игровых правил, предметов, сфер опыта и симуляционной дистанции.

Вместо того чтобы собирать отдельные модули, 12.x объединяет основные функции в одном моде:

• Контроль спавна и пресеты спавна
• Адаптация игровых правил
• Очистка предметов, сфер опыта и стрел
• Защита игроков при входе и для новичков
• Адаптивная симуляционная дистанция с учётом движения
• Опциональные продвинутые троттлы для ИИ, генерации чанков и дистанции просмотра
• Инструменты мониторинга и бенчмаркинга

Что APTweaks умеет лучше всего

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

• слишком большим количеством мобов или частыми попытками спавна
• кучей выброшенных предметов, сфер опыта или застрявших стрел
• перегруженным исследованием мира и генерацией чанков
• мирами или серверами, которым нужны мягкие автоматические реакции вместо жёстких лимитов

Мод особенно полезен для:

• выделенных серверов, которым нужна адаптивная защита при меняющейся нагрузке от игроков
• сборок модов с большим количеством сущностей
• одиночных миров с фермами, исследованием или кучей выпавшего лута
• LAN-миров, где хост-машина еле тянет встроенный сервер

Он менее эффективен, если проблемы вызваны:

• тяжёлым редстоуном или машинной логикой
• одним конкретным сломанным модом или сущностью
• повреждением мира или узким местом хранилища

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

1. Удалите все старые jar-файлы APTweaks 11.x из mods/.
2. Установите APTweaks 12.x через CurseForge или Modrinth. Ручная установка: скачайте jar для вашего загрузчика и поместите в mods/.
3. Запустите игру, мир или сервер один раз.
4. Посмотрите сгенерированные файлы в config/adaptive_performance_tweaks/.
5. Оставьте настройки по умолчанию для первого тестового запуска.
6. Если у вас крупный сервер, проверьте лимиты спавна заранее. Стандартные настройки рассчитаны примерно на 4 игроков.

Пресеты спавна загружаются из:

• config/adaptive_performance_tweaks/spawn_presets/
• data/<namespace>/aptweaks/spawn_presets/

Если хотите настроить пресеты, начните с шаблонов и примеров в вики.

Обзор функций

Функция	Что делает
Спавн	Ограничивает нагрузку от мобов с учётом загрузки, логики области просмотра и настраиваемых пресетов
Игровые правила	Меняет выбранные геймрулы при стрессе сервера
Предметы	Объединяет или удаляет лишние выброшенные предметы
Сферы опыта	Группирует XP-сферы для снижения количества сущностей
Стрелы	Убирает застрявшие стрелы, не трогая активные снаряды
Защита игроков	Защищает игроков при входе и помогает новичкам
Симуляционная дистанция	Автоматически снижает затраты на симуляцию под нагрузкой и может временно сильнее ограничивать при активном исследовании
Дистанция просмотра	Опциональный продвинутый клапан для тяжёлых серверов
Троттлинг ИИ	Опциональное замедление ИИ у далёких мобов
Троттлинг генерации чанков	Опциональное замедление работы по генерации чанков
Мониторинг	Опциональная видимость нагрузки и давления сущностей через логи
Бенчмарк	Встроенный набор сценариев для базового и активного измерения на реальных мирах, серверах и сборках

Симуляционная дистанция остаётся чувствительной к нагрузке, но теперь может сильнее зажиматься при активном исследовании на уровне MEDIUM+ и постепенно восстанавливаться после того, как игроки остановятся или закончат вход.

Команды

Основная команда - /aptweaks.

Полезные команды:

• /aptweaks status
• /aptweaks load
• /aptweaks stats
• /aptweaks stats items
• /aptweaks stats xp_orbs
• /aptweaks stats arrows
• /aptweaks stats reset
• /aptweaks entities overview
• /aptweaks feature <id> <true|false>
• /aptweaks playerPositions
• /aptweaks kill all_dropped_items
• /aptweaks reload
• /aptweaks debug
• /aptweaks benchmark
• /aptweaks benchmark start
• /aptweaks benchmark start scenario <general|items|xp|entities|recovery>

Если что-то пошло не так, сначала выполните эти четыре команды:

• /aptweaks status
• /aptweaks load
• /aptweaks stats
• /aptweaks debug <module> true

Важно про перезагрузку:

• /aptweaks reload перезагружает .cfg файлы
• изменения в JSON пресетов спавна безопаснее применять через ванильный /reload или перезапуск
• включение/отключение функций может потребовать перезапуска для полного эффекта