Auto Sable Physics

English

Overview

Auto Sable Physics is an event-driven automation addon for Sable. It watches normal block changes, detects finite unsupported structures, and converts them into Sable physics sub-levels automatically.

It is designed for survival and modpack gameplay: break support blocks, cut trees, collapse small unsupported structures, then let Sable handle the motion.

Requirements

Minecraft 1.21.1
NeoForge 21.1.x
Java 21
Sable 1.2.2
Sable Companion 1.6.0
Leaves Be Gone（Suggestion）
Passable Foliage 🌳（Suggestion）

Main features

Event-driven automatic physics conversion.
No full-world tick scan.
Affected-region system to avoid scanning untouched terrain.
Component-level scanning for unsupported connected structures.
Delayed Sable assembly to reduce synchronization pressure.
One-shot tree physics for logs, stripped logs, and mangrove roots.
Leaves, vines, cocoa, and similar weak tree blocks do not support trunks.
Unsupported single blocks can use vanilla FallingBlockEntity instead of creating tiny Sable sub-levels.
Falling blocks can crush weak no-collision or non-supporting blocks below them.
Sable sub-levels created by this mod can auto-restore after being idle.
Grid-aligned fast restore for settled physics objects.
Sable hammer item for pinning or manually restoring physics objects.
Block tags for modpack compatibility.

Tree behavior

When a trunk block near a broken block is detected, the mod collects the connected trunk through a 26-neighbor BFS. If the whole trunk set no longer has external bottom support, Auto Sable Physics forces the connected trunk and nearby leaves into one Sable object.

Leaves, vines, cocoa, and related weak tree blocks are treated as air for trunk support checks. Forced tree assembly only runs once per block-break scan, so the same leaf area will not be repeatedly forced into physics.

Restoration

The mod tracks sub-levels it creates. Idle objects can be restored to normal blocks automatically. Pinned objects are excluded. The Sable hammer can also restore a sub-level manually.

Configuration and compatibility

The mod exposes server config entries for scan budgets, affected-region size, delayed assembly, restoration, crush behavior, and tree physics.

Important block tags include:

autosablephysics:ignored
autosablephysics:immobile
autosablephysics:force_supporting
autosablephysics:non_supporting
autosablephysics:force_connecting
autosablephysics:non_connecting
autosablephysics:tree_trunks
autosablephysics:tree_leaves
autosablephysics:tree_airlike

Notes

This mod depends on Sable. Its behavior and stability are tied to the installed Sable and Sable Companion versions. For large modpacks, test block entity movement and custom block tags before public release.

中文

简介

Auto Sable Physics 是一个基于 Sable 的事件驱动物理化辅助模组。它监听正常的方块变化，识别失去支撑的有限结构，并自动把这些结构转换为 Sable 物理 sub-level。

它面向生存和整合包玩法：破坏支撑、砍树、让小型悬空结构坍塌，然后由 Sable 负责物理运动。

需求

Minecraft 1.21.1
NeoForge 21.1.x
Java 21
Sable 1.2.2
Sable Companion 1.6.0
Leaves Be Gone（建议）
Passable Foliage 🌳（建议）

主要功能

事件驱动的自动物理化。
不做全世界 tick 扫描。
affected 受影响区域系统，避免扫描未变化地形。
组件级扫描失去支撑的连通结构。
延迟创建 Sable sub-level，降低同步压力。
针对原木、去皮原木、红树根的一次性砍树物理化。
树叶、藤蔓、可可豆等弱树木方块不会给树干提供支撑。
单方块悬空结构可优先使用原版 FallingBlockEntity，而不是创建微型 Sable 物理体。
下落方块可压坏下方弱支撑或无碰撞方块。
本模组创建的 Sable sub-level 可在静止后自动还原。
已嵌入方块网格的物理体可快速还原。
Sable 锤子可保存/钉住物理体，或手动还原物理体。
提供方块标签接口，方便整合包兼容。

砍树行为

当被破坏方块附近检测到树干方块时，模组会通过 26 邻域 BFS 收集整棵连通树干。如果整棵树干已经没有外部底部支撑，就强制把连通树干和附近树叶组装成一个 Sable 物理体。

树叶、藤蔓、可可豆等弱树木方块在树干支撑判断中视为空气。强制砍树物理化每次破坏扫描只执行一次，不会让同一区域树叶反复被强制物理化。

还原

模组会追踪自己创建的 sub-level。静止一段时间后可自动还原成普通方块。被锤面保存的物理体不会自动还原。Sable 锤子齿面也可以手动还原 sub-level。

配置与兼容

模组提供服务器配置项，可调整扫描预算、affected 区域、延迟物理化、自动还原、压坏规则和砍树物理化。

重要方块标签包括：

autosablephysics:ignored
autosablephysics:immobile
autosablephysics:force_supporting
autosablephysics:non_supporting
autosablephysics:force_connecting
autosablephysics:non_connecting
autosablephysics:tree_trunks
autosablephysics:tree_leaves
autosablephysics:tree_airlike

注意

本模组依赖 Sable，实际稳定性与已安装的 Sable / Sable Companion 版本有关。大型整合包发布前，建议重点测试方块实体移动和自定义方块标签。