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

📌 Отказ от ответственности за исходный код репозитория: Документация в этой Вики отражает текущее состояние исходного кода в репозитории, которое может содержать недавние невыпущенные коммиты или разрабатываемые функции, опережающие публичные сборки на CurseForge и Modrinth.

---

❓ Часто задаваемые вопросы

В1: Почему в существующих мирах не применяются настройки из config/stack-size-adjuster.json?

О: Глобальный файл конфигурации (stack-size-adjuster.json) задает базовые значения только для вновь создаваемых миров. В существующих мирах настройки хранятся внутри level.dat. Измените их в игре через команду /gamerule:

/gamerule stack-size-adjuster:items_64_limit 256

В2: Что произойдет, если установить лимит выше 39,768,215?

О: Значения выше $39,768,215$ несут риск целочисленного переполнения большого сундука. Большой сундук на 54 слота с полными стаками превысит предел знакового 32-битного числа ($2,147,483,647$), что вызовет уход в отрицательные значения и удаление предметов при перемещении. Рекомендуется удерживать лимиты $\le 39,768,215$.

В3: Почему при разрушении сундука выпадает только 8 стопок предметов вместо тысяч?

О: Это оптимизация производительности, управляемая правилом stack-size-adjuster:max_drop_entities (по умолчанию: 8). Она защищает сервер от краша. В связке с Item Clumps эти 8 стопок мгновенно сливаются в одну.

---

🛠️ Диагностика типичных неполадок

Симптом	Причина	Решение
В инвентаре отображаются ванильные лимиты	Не прошел сетевой пакет или несовпадение версий	Убедитесь, что мод установлен и на клиенте, и на сервере.
Команда Give пишет "слишком много предметов"	Превышен порог $100 \times \text{maxStackSize}$	Запрашивайте меньше предметов за раз или используйте несколько команд.
Экран YACL не открывается в ModMenu	Отсутствует ModMenu или библиотека YACL	Установите ModMenu и YetAnotherConfigLib (YACL v3) на клиент.