Sable Quota

Sable Quota is a server-side physical structure quota mod for Minecraft 1.21.1, NeoForge, and Sable. It tracks Sable Sub-Level ownership and counts by player UUID, limiting excessive physical structure creation that may cause performance and storage pressure while providing query, locating, and management tools.

Sable Quota 是面向 Minecraft 1.21.1、NeoForge 与 Sable 的服务端物理结构配额模组。它按玩家 UUID 记录 Sable Sub-Level 的归属和数量，限制玩家持续创建物理结构造成的性能与存储压力，并提供查询、定位和管理工具。

---

Features

核心功能

• Configure default structure limits for normal players and operators. -1 means unlimited.

• 支持为普通玩家和 OP 分别设置默认结构上限，-1 表示无限。

• Support per-player quota overrides by UUID. Data is preserved after logout and server restart.

• 支持按玩家 UUID 设置个人上限，玩家离线或服务器重启后仍然保留。

• Track structure UUID, owner, and last known location. Normal unloading does not release quota.

• 记录结构 UUID、所有者和最后已知位置，普通卸载不会释放或误减额度。

• Integrate with supported Sable creation paths including Simulated assemblers, rotation bearings, and single structure assembly.

• 覆盖 Simulated 物理装配器、旋转轴承和受支持的 Sable 单结构装配命令。

• Cancel creation when quota is exceeded and display current count and limit through Action Bar.

• 创建达到上限时直接取消操作，并通过 Action Bar 提示当前数量和上限。

• Predict structure splitting before block destruction to prevent quota bypass.

• 在玩家破坏方块前预测结构断裂结果，避免通过批量碎片生成绕过额度。

• Automatically split structures inherit ownership and consume quota separately.

• Sable 自动拆分出的新结构继承原结构所有者，并分别占用额度。

• Provide structure listing, coordinate lookup, and UUID based deletion.

• 提供结构列表、坐标查询和按 UUID 强制删除功能。

• Provide API for third-party mods to safely create structures on behalf of players.

• 提供第三方模组 API，用于安全地代表玩家创建 Sable 结构。

• Fix Create continuous OBB collision crashes caused by null separating axis in degenerate cases.

• 修复 Create 连续 OBB 碰撞在退化情况下分离轴为 null 导致的崩溃。

---

Installation and Compatibility

安装与兼容性

• Minecraft: 1.21.1

• Minecraft：1.21.1

• NeoForge: 21.1.233+

• NeoForge：21.1.233+

• Sable: 2.0.3+ (Required)

• Sable：2.0.3+（必需）

• Simulated: Integration target 1.3.0

• Simulated：以 1.3.0 为集成目标。

• Create: Collision compatibility fix targeting 6.0.10

• Create：包含针对 6.0.10 的退化碰撞防崩兼容。

Sable Quota is server-required and client-optional.

Sable Quota 服务端必装、客户端可选。

Quota logic, ownership data, commands, and messages are handled by the server.

配额判断、所有权数据、管理指令和文本均由服务器处理。

Create collision protection requires the same mod version installed on clients.

如果希望客户端也避免 Create 碰撞崩溃，需要客户端安装相同版本。

---

Configuration

配置

Config file:

配置文件：

config/sable_quota-common.toml

Default:

默认：

[quota]
maxStructuresPerPlayer = 3
maxStructuresPerOperator = -1

[messages]
creationBlocked = ""

Quota priority:

额度优先级：

Personal quota > Operator default quota > Normal player default quota

个人上限 > OP 默认上限 > 普通玩家默认上限

---

Commands

指令

---

Command Permission Description

---

/sablequota get Player View own quota / 查看自己的额度

/sablequota list Player View own structures / 查看自己的结构

/sablequota set <player> <amount> 2 Set personal quota / 设置个人上限

/sablequota add <player> <amount> 2 Increase quota / 增加额度

/sablequota remove <player> <amount> 2 Reduce quota / 减少额度

/sablequota reset <player> 2 Reset quota / 删除个人上限

/sablequota delete <uuid> 2 Delete structure / 删除结构

/sablequota reload 2 Reload config / 重载配置

---

---

Data and Performance

数据与性能

Data is stored in:

数据保存于：

<world>/data/sable_quota_structures.dat

Runtime indexes provide O(1) structure counting.

运行时维护玩家到结构集合的反向索引，因此结构计数为 O(1)。

The mod does not scan all structures every tick.

本模组不会每 Tick 扫描所有结构。