Create-Aeronautics:Compatibility + Bug fixes

F**kSable

一个专门修 Sable 的 mod / Мод, который чинит Sable 因为 Sable 的作者挖坑不填，我来填 / Потому что автор Sable нарыл ям и не закопал — закапываю я

Sable 是个让 Minecraft 方块物理化的 mod，想法很酷。但 Rust + Java 的缝合架构嘛……你懂的。这个 mod 的存在就是为了补那些能让服务器血压直接拉满的洞。

Sable — это мод для Minecraft, который добавляет физику блокам. Идея крутая. Но гибридная архитектура Rust + Java... сами понимаете. Этот мод существует, чтобы залатать дыры, от которых у сервера давление подскакивает до предела.

前置 / Зависимости

• Sable — 不是可选，毕竟我存在的意义就是擦它的屁股 / Не опционально — в конце концов, весь смысл моего существования в том, чтобы подтирать за ним

版本说明 / О версиях

当你发现某个版本标记为 Alpha（例如 v1.0.0-alpha.1），那大概是一个存在已知问题但未被下架的版本。Alpha 版本可能包含未完成的功能、已知的崩溃风险或性能问题，主要用于早期测试和反馈收集。

Когда вы видите версию с пометкой Alpha (например, v1.0.0-alpha.1), скорее всего, это версия с известными проблемами, которую ещё не сняли. Alpha-версии могут содержать незаконченные функции, известные риски крашей или проблемы с производительностью — они в основном для раннего тестирования и сбора отзывов.

但请注意：Alpha 也包含 Beta 版本 —— 实际上某些 Beta 反而比 Alpha 更稳定。版本号只是个标签，不代表一切。

Но учтите: Alpha также включает Beta-версии — на самом деле некоторые Beta стабильнее иных Alpha. Номер версии — просто метка, он не говорит обо всём.

详细信息以 GitHub Releases 为准 —— 每个版本的发布说明都会清楚列出已知问题、适用范围和建议。不要只看版本号，看发布说明。也可从 OLKMO/FuckSable-Unofficial 获取。

Подробности смотрите в GitHub Releases — в описании каждого релиза чётко перечислены известные проблемы, область применения и рекомендации. Не смотрите только на номер версии, читайте описание релиза. Также доступно в OLKMO/FuckSable-Unofficial.

生产环境请优先选择经过充分测试的版本。如果你在 Alpha/Beta 版本中遇到了问题，请理解——测试版就是测试版，崩了别意外。

Для продакшена выбирайте тщательно протестированные версии. Если вы столкнулись с проблемами в Alpha/Beta-версии, поймите — тестовая версия есть тестовая версия, не удивляйтесь, если она упадёт.

When you see a version marked as Alpha (e.g., v1.0.0-alpha.1), it's probably a version with known issues that hasn't been taken down yet. Alpha releases may contain incomplete features, known crash risks, or performance problems — they're intended for early testing and feedback collection.

But note: Alpha includes Beta releases — in fact, some Betas are actually more stable than certain Alphas. Version numbers are just labels, they don't tell the whole story.

For detailed information, refer to GitHub Releases — each release's notes clearly list known issues, scope, and recommendations. Don't just look at the version number, read the release notes. Also available from OLKMO/FuckSable-Unofficial.

For production environments, choose thoroughly tested releases. If you encounter issues in an Alpha/Beta version, please understand — a test version is a test version, don't be surprised if it breaks.

修复项 / Исправления

默认全开，可通过配置文件单独关闭。依赖其他 mod 的修复项，缺 mod 会自动禁用。少数修复项因涉及前置依赖关系或基于 bug 的玩法，默认关闭（见下表标注）。

Включены по умолчанию, можно отключать по отдельности через конфиг. Исправления, зависящие от других модов, автоматически отключаются, если мод отсутствует. Несколько исправлений отключены по умолчанию из-за зависимостей или геймплея, основанного на багах (см. пометки в таблице ниже).

Enabled by default, can be disabled individually via config. Fixes that depend on other mods auto-disable if the mod is missing. A few fixes are disabled by default due to prerequisite dependencies or bug-based gameplay (see notes in the table below).

Sable 核心修复 / Основные исправления Sable

| constraint-self-fix | 抑制 Sable 物理管道中的自约束错误：当约束在 SubLevel 和自身之间创建时返回 null 而非抛出异常。自动适配 Sable 1.x（ServerSubLevel 参数）和 2.x（PhysicsPipelineBody 参数）。/ Suppresses self-constraint errors in Sable physics pipeline: returns null instead of throwing when a constraint is added between a SubLevel and itself. Auto-adapts to Sable 1.x (ServerSubLevel params) and 2.x (PhysicsPipelineBody params). | | sublevel-load-log-spam-fix | 限流 SubLevelStorage.attemptLoadSubLevel 在 sub-level 存储条目损坏/缺失时反复输出的 "Couldn't find sub-level" ERROR 日志：同一 chunk+index 每 60 秒只输出一次。/ Throttles repeated "Couldn't find sub-level" ERROR log spam from SubLevelStorage.attemptLoadSubLevel when a sub-level storage entry is corrupted/missing: logs once per chunk+index per 60s window. | | udp-invalid-packet-guard | 静默丢弃 packet ID 越界的 UDP 数据包（如 MC 旧版服务器列表 ping 的 packet ID 254），防止 SableUDPPacketDecoder.decode 抛 IOException 触发 "Server UDP channel caught exception" ERROR 日志刷屏。合法 ID 上界通过反射读取 SableUDPPacketType.VALUES 长度并缓存。/ Silently drops UDP packets whose first byte is an invalid Sable packet ID (e.g. legacy server list ping packet ID 254) instead of letting SableUDPPacketDecoder.decode throw IOException and spam "Server UDP channel caught exception" ERROR logs. Valid ID upper bound is read via reflection from SableUDPPacketType.VALUES and cached. | | entity-lookup-remove-guard | 拦截 PersistentEntitySectionManager.stopTracking 中的 EntityLookup.remove 调用，捕获 Int2ObjectLinkedOpenHashMap.fixPointers 抛出的 ArrayIndexOutOfBoundsException（index -1），防止 Sable 的 SubLevel 实体管理破坏 map 内部链表状态后导致整个 tick 崩溃。属治标修复，单次移除失败会被跳过并打 WARN 日志。/ Intercepts EntityLookup.remove inside PersistentEntitySectionManager.stopTracking, catches ArrayIndexOutOfBoundsException from Int2ObjectLinkedOpenHashMap.fixPointers (index -1) when Sable's SubLevel entity management corrupts the map's internal linked-list state. Prevents a single entity removal failure from crashing the entire tick. Symptomatic fix — failed removals are skipped with a WARN log. |

兼容性修复 / Compatibility Fixes

| frogport-extract-limit | Create | 防止洼港（FrogportBlockEntity）lazyTick 从超大相邻库存拉取物品时服务器卡死：当 IItemHandler 槽位数超过 256 时跳过 ItemHelper.extract，每 60 秒告警一次。/ Предотвращает зависание сервера, когда FrogportBlockEntity lazyTick вытягивает предметы из слишком больших соседних инвентарей: пропускает ItemHelper.extract, если количество слотов IItemHandler превышает 256, пишет в лог раз в 60 секунд. | | effortless-particle-fix | Effortless, Sable | 修 Effortless 对着 Sable 物理结构操作时客户端崩溃。Sable 射线检测返回 Plot 存储区域的远端坐标，Effortless 用该坐标生成粒子时客户端未加载该区块导致崩溃。修复方式：跳过未加载区块的粒子生成。/ Исправляет краш клиента Effortless при взаимодействии с физическими структурами Sable. Рейкаст Sable возвращает координаты удалённой области хранения Plot, Effortless использует их для генерации частиц, но клиент не загрузил эти чанки — отсюда краш. Исправление: пропускать генерацию частиц для незагруженных чанков. | | vista-camera-chunk-fix | Vista, Sable | 修 Vista 摄像头区块加载与 Sable 物理结构不兼容：ViewFinder 在物理结构上时，其坐标是 SubLevel 内部坐标，Vista 用该坐标在主世界 force-load 区块导致 TPS 掉 0 和无限加载循环。修复方式：force-load 前将坐标投影到主世界坐标。/ Исправляет несовместимость загрузки чанков камерой Vista с физическими структурами Sable: когда ViewFinder находится на физической структуре, его координаты — внутренние координаты SubLevel, Vista использует их для force-load чанков в основном мире, что приводит к падению TPS до 0 и бесконечному циклу загрузки. Исправление: проецировать координаты в координаты мира перед force-load. | | sable-scalablelux-incompat-bypass | Sable | 绕过 Sable 的 neoforge.mods.toml 中对 ScalableLux 的 type = "incompatible" 声明，防止 NeoForge ModSorter 在启动阶段直接拒绝加载。fs 启动时自动写入 fml.toml 的 [dependencyOverrides] 配置。默认关闭 —— 是 scalablelux-compat 的前置项，需先启用并重启。/ Обходит объявление type = "incompatible" против ScalableLux в neoforge.mods.toml Sable, не давая NeoForge ModSorter прервать запуск. fs автоматически записывает конфиг [dependencyOverrides] в fml.toml при запуске. Отключено по умолчанию — это предварительное условие для scalablelux-compat, нужно сначала включить и перезапустить. | | scalablelux-compat | ScalableLux, Sable | 修 ScalableLux 存在时 Sable SubLevel 光照完全失效：ScalableLux 清空了主世界 LevelLightEngine 的 blockEngine/skyEngine 字段，导致 Sable 误判 SubLevel 无方块光、无天空光。拦截 ServerLevelPlot 构造函数中的 new LevelLightEngine(...) 调用，通过 StarLightInterface 重新计算正确的光照参数。依赖 sable-scalablelux-incompat-bypass。/ Исправляет полный отказ освещения SubLevel в Sable при наличии ScalableLux: ScalableLux очищает поля blockEngine/skyEngine у LevelLightEngine основного мира, из-за чего Sable ошибочно считает, что в SubLevel нет блочного света и света неба. Перехватывает вызов new LevelLightEngine(...) в конструкторе ServerLevelPlot и пересчитывает корректные параметры освещения через StarLightInterface. Зависит от sable-scalablelux-incompat-bypass. | | block-destroy-coordinate-guard | Sable | 防止某些 mod 物品触发方块破坏时坐标计算溢出至 Integer.MIN_VALUE/MAX_VALUE，导致大量区块被加载、服务器卡死或崩溃（Issue #14）。拦截 Level.setBlock 和 Level.destroyBlock，坐标超出可配置范围时跳过操作。坐标范围可通过 config/fucksable/config.json 的 fixParams 调整，用 /fucksable block-destroy-coordinate-guard reset 恢复默认值。/ Предотвращает краш сервера, когда предметы из модов вызывают разрушение блоков по координатам с целочисленным переполнением (Integer.MIN_VALUE/MAX_VALUE), что приводит к массовой загрузке чанков и зависанию сервера (Issue #14). Перехватывает Level.setBlock и Level.destroyBlock, пропускает операции, если координаты выходят за настраиваемые пределы. Пределы настраиваются через fixParams в config/fucksable/config.json, сброс командой /fucksable block-destroy-coordinate-guard reset. |

调试命令 / Команды отладки

国际化 / Internationalization (i18n)

FuckSable поддерживает пользовательские языковые пакеты. Все выводимые сообщения (ответы команд, логи и т.д.) можно переопределить через языковые файлы.

FuckSable supports custom language packs. All printable messages (command feedback, logs, etc.) can be overridden via language files.

使用方法 / Usage

/fucksablelang <языковой файл>

• <языковой файл>: имя языкового файла (без пути, без расширения) / Language file name (without path, without extension)

Языковые файлы находятся в .minecraft/config/fucksable/lang/ (на сервере — config/fucksable/lang/).

Language files are located in .minecraft/config/fucksable/lang/ (or config/fucksable/lang/ for servers).

默认语言包 / Default Language Packs

创建自定义语言包 / Creating Custom Language Packs

1. Перейдите в каталог config/fucksable/lang/
2. Скопируйте en.yml или zh.yml как шаблон
3. Переименуйте в нужное имя языкового файла (например, ja.yml, es.yml, fr.yml)
4. Переведите значения в YAML-файле (ключи не менять)
5. В игре выполните /fucksablelang <имя файла> для переключения

1. Navigate to `config/fucksable/lang/`
2. Copy `en.yml` or `zh.yml` as a template
3. Rename it to your desired language file name (e.g., `ja.yml`, `es.yml`, `fr.yml`)
4. Translate the values in the YAML file (don't change the keys)
5. Run `/fucksablelang <filename>` in-game to switch

注意事项 / Notes

• Выводимых сообщений у FuckSable не так уж много — весь текст вместе занимает всего несколько десятков строк
• Можно просто скормить его GPT для перевода, займёт пару секунд
• Переключение языка применяется сразу, перезапуск сервера не нужен

• Если формат языкового файла неверный (невалидный YAML), произойдёт автоматический откат к языку по умолчанию (английскому)

• FuckSable's printable messages are not that many — all text combined is only a few dozen lines
• You can just throw it at GPT for translation, takes a few seconds
• Language switching takes effect immediately, no server restart required
• If a language file has invalid YAML, it will automatically fall back to default language (English)

示例：自定义语言文件结构 / Example: Custom Language File Structure

# zh.yml - 简体中文示例 / Simplified Chinese example

command:
  fucksable:
    title: "=== FuckSable 修复状态 ==="
    fix:
      enabled: "✓ %s 已启用"
      disabled: "✗ %s 已禁用"
      missing_dep: "⚠ %s 已禁用 (缺少依赖: %s)"
    invalid_fix: "无效的修复项: %s"
    set:
      enabled: "已将 %s 设置为 %s"
    lang:
      switched: "语言已切换至: %s"
      file_not_found: "语言文件不存在: %s"
      invalid_yml: "语言文件格式错误，已回退至默认语言"

# en.yml - 英文示例 / English example

command:
  fucksable:
    title: "=== FuckSable Fix Status ==="
    fix:
      enabled: "✓ %s is enabled"
      disabled: "✗ %s is disabled"
      missing_dep: "⚠ %s is disabled (missing dependency: %s)"
    invalid_fix: "Invalid fix: %s"
    set:
      enabled: "Set %s to %s"
    lang:
      switched: "Language switched to: %s"
      file_not_found: "Language file not found: %s"
      invalid_yml: "Invalid YAML format, falling back to default language"

为什么是 All-in-One？/ Why All-in-One?

В: Почему бы не написать отдельные моды для каждого исправления, а вместо этого всё упаковано вместе?

О: Потому что мне надоело искать патчи, устанавливать их по одному и разбираться с конфликтами ради исправления пары проблем.

Q: Why not write separate mods for each fix?

A: Because I'm tired of hunting down patches, installing them one by one, and debugging conflicts just to fix a few issues.

FuckSable — это всё в одном:

• Один мод, одна установка, все исправления работают одновременно
• Каждое исправление протестировано в реальной серверной среде, а не в теории
• В конфиге можно включать и выключать отдельные исправления — не нужно, не включай
• Не надо запоминать, какой баг к какому моду относится — одна команда показывает всё

FuckSable is all-in-one:

• One mod, one installation, all fixes work together
• Every fix has been tested on a real server environment, not just theory
• Config file lets you toggle individual fixes on/off
• No need to remember which bug belongs to which mod — one command shows everything

Проще говоря: меньше возни.

Simply put: Less hassle.

吐槽 / Rant

Архитектура Sable на Rust + Java сама по себе не проблема. Проблема в том, что обработки ошибок почти нет с обеих сторон:

Sable's Rust + Java architecture isn't the problem. The problem is the near-total lack of error handling on both sides:

• Паника на стороне Rust → сразу утаскивает за собой JVM
• Проверка возвращаемых значений Rust на стороне Java ≈ отсутствует
• Серверная сторона ссылается на клиентские классы? Это не边缘 case, это уровень «выделенный сервер падает сразу при запуске»

Управление зависимостями — тоже полный бардак: API-классы разбросаны по самым разным путям пакетов — SubLevelContainerHolder в mixinterface.plot, а не в api.sublevel, JOMLConversion в companion.math. Никогда не угадаешь, в каком пакете окажется следующий класс.

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

Дополнительно

Проверка обновлений получает информацию о последней версии через GitHub Releases API (HTTPS), автоматически проверяет при запуске и пишет уведомление в лог. По умолчанию отключена, включается через конфиг.

Код открыт, ждём Issue и PR.

• Основной репозиторий: https://github.com/XSY-Team/fuck-sable
• Личный репозиторий: https://github.com/OLKMO/FuckSable-Unofficial

Лицензия

MIT License — подробности в файле LICENSE.