Terrastorage - 地脉存储

Terrastorage

🔴 重要：主要兼容性问题

目前，将 Terrastorage 与 Sophisticated Storage/Backpacks 和 Traveler's Backpack 一起使用时存在显著问题。我正在积极修复，但由于现实生活非常忙碌，可能需要一些时间。

对于造成的不便深表歉意，感谢您的耐心！

Terrastorage 是一个可定制的服务器和客户端模组，它将泰拉瑞亚中出色的存储选项带到了 Minecraft 中，包括极其有用的 快速堆叠到附近容器 功能。目前支持 Fabric 和 Quilt。

请注意，Terrastorage 需要安装在客户端和服务器两端才能正常工作。

说完这些，让我们深入了解功能展示：

功能

全部拾取与全部存入：

• 全部拾取 - 将存储容器中的所有物品转移到玩家的物品栏中。
• 全部存入 - 将玩家物品栏中的所有物品转移到存储容器中。

⏺️ 物品会先与目标物品栏中已有的堆叠合并，然后再移动到空槽位。

⏺️ 已收藏的物品不受全部存入影响。

快速堆叠与补充：

• 快速堆叠 - 使用以下两种模式之一，将物品从玩家的物品栏转移到存储容器中：

• 智能存入 - 类似于填满，但也会将所有匹配的物品移动到空槽位，根据需要创建新的堆叠。

• 填满 - 将物品添加到现有堆叠中，直到达到最大容量，不影响接收物品栏中的空槽位。

• 补充 - 将存储容器中的物品转移到玩家物品栏中已有的堆叠里。

⏺️ 已收藏的物品不受快速堆叠影响。

✳️ 快速堆叠模式可以通过选项屏幕中的存储快速堆叠模式选项进行配置。

物品收藏：

• 物品收藏 - 你可以通过按住物品收藏的修饰键（默认为左 Alt）并左键点击物品来收藏它们。

✳️ 修饰键可通过控制菜单自定义。

⏺️ 已收藏的物品受到保护，不会被：

• 从物品栏中丢弃。
• 通过 Shift 点击转移到其他容器。
• 在按下热键栏快捷键时从热键栏交换到其他容器。
• 在创造模式物品栏界面中删除。
• 被全部存入或整理物品栏移动。
• 被快速堆叠或快速堆叠到附近容器修改。

整理物品与重命名：

• 整理物品 - 对存储容器中的物品进行排序。
• 重命名 - 重命名存储方块。

✳️ 整理物品和整理物品栏的排序方法由同一个可配置设置控制。

⏺️ 整理物品也可以通过将鼠标悬停在槽位上并按整理物品栏快捷键（默认为 R，可在控制菜单中自定义）来激活。

⏺️ 重命名的存储方块会在其上方显示名称标签，如果上方有方块，则显示在面向玩家的一侧。

整理物品栏与快速堆叠到附近容器：

• 整理物品栏 - 对玩家物品栏中的物品进行排序。
• 快速堆叠到附近容器 - 查找所有附近的存储容器，并对每个容器执行快速堆叠操作。

✳️ 整理物品和整理物品栏的排序方法由同一个可配置设置控制。

⏺️ 整理物品栏也可以通过将鼠标悬停在槽位上并按整理物品栏快捷键（默认为 R，可在控制菜单中自定义）来激活。

✳️ 默认情况下，快速堆叠到附近容器功能只考虑玩家视线范围内的存储容器，这是可配置的。

✳️ 快速堆叠到附近容器功能包含一个物品从玩家飞向存储容器的动画。动画长度和飞行物品之间的时间间隔都是可配置的。

⏺️ 已收藏的物品不会被整理物品栏移动，也不会被快速堆叠到附近容器修改。

自定义

客户端：

客户端提供了一个选项屏幕，可以通过 mod menu 或使用 /tsclient options 命令访问，它允许配置以下设置：

• 选项按钮 - 控制是否在存储界面中添加一个“选项”按钮，该按钮会将玩家带到选项屏幕。
• 热键栏保护 - 决定热键栏是否排除在存储操作之外。
• 收藏边框可见性 - 控制在何时为存放已收藏物品的槽位绘制收藏边框。可以设置为：
• 总是 – 始终绘制边框。
• 按下修饰键时 – 仅当按住修饰键（默认为左 Alt）时绘制边框。
• 非热键栏 – 在热键栏以外的所有地方绘制边框。
• 按下修饰键且非热键栏 – 仅当按住修饰键时，并且仅在热键栏以外绘制边框。
• 从不 – 从不绘制边框。
• 排序依据 - 决定使用整理物品或整理物品栏时，物品按何种属性排序。可以设置为：
• 物品组 - 按物品组排序。
• 物品数量 - 按数量排序（从多到少）。
• 物品稀有度 - 按稀有度排序（从高到低）。
• 物品名称 - 按名称字母顺序排序。
• 物品 ID - 按 ID 排序（从低到高）。
• 存储快速堆叠模式 - 配置用于单个存储操作的快速堆叠模式。（详见快速堆叠与补充。）
• 附近容器快速堆叠模式 - 配置用于附近容器的快速堆叠模式。（详见快速堆叠与补充。）
• 按钮纹理 - 控制物品栏存储按钮使用的纹理。

除了选项屏幕，还有一个专门的按钮自定义屏幕，允许自定义存储物品栏界面中显示的存储选项按钮的外观。

⏺️ 所有这些选项都可以通过客户端配置文件进行自定义，该文件位于 .\config\terrastorage_client.toml。该文件设计用于方便的手动编辑，并包含每个属性的默认值以及整数属性的取值范围。

服务器端

以下服务器设置可以通过游戏内命令修改。要更改设置，请使用命令 /terrastorage [选项] [新值]。要查看当前值，请使用 /terrastorage [选项]。

可用选项有：

• action-cooldown

设置所有存储操作的冷却时间，单位为游戏刻。

默认值：10

• line-of-sight-check

决定快速堆叠到附近容器功能是否只考虑玩家视线范围内的存储容器。

默认值：true

• quick-stack-range

指定快速堆叠到附近容器功能的范围，单位为方块。

默认值：8

• item-animation-length

设置使用快速堆叠到附近容器时飞行物品动画的长度，单位为游戏刻。

默认值：20

• item-animation-interval

指定动画飞行物品之间的时间间隔，单位为刻。

默认值：5

• enable-item-favoriting (仅限 1.21+ 服务器)

决定在专用服务器上是否启用物品收藏功能。设置为 false 以确保与原版客户端兼容。不适用于单人游戏。

默认值：true

• keep-favorites-on-drop

决定物品在被丢弃为物品实体后是否保留其收藏状态。

默认值：true

⏺️ 这些设置可以直接通过配置文件修改，该文件位于 .\config\terrastorage.toml。就像客户端配置文件一样，它设计用于方便的手动编辑。以下是其默认内容：

#所有存储操作的冷却时间，单位为游戏刻
#范围：2 到 100，包含
#默认值：10
action_cooldown = 10
#==========
#快速堆叠到附近容器功能是否只考虑玩家视线范围内的存储容器。
#默认值：true
line_of_sight_check = true
#==========
#快速堆叠到附近容器功能的范围，单位为方块
#范围：3 到 16，包含
#默认值：8
quick_stack_range = 8
#==========
#使用快速堆叠到附近容器时发生的飞行物品动画的长度，单位为游戏刻
#范围：10 到 200，包含
#默认值：20
item_animation_length = 20
#==========
#动画飞行物品之间的间隔，单位为游戏刻
#范围：0 到 20，包含
#默认值：5
item_animation_interval = 5
#==========
#是否启用物品收藏功能。禁用此功能以确保与vanilla客户端兼容。
#默认值：true
enable_item_favoriting = true
#==========
#物品在被丢弃为物品实体后是否保留其收藏状态。
#默认值：true
keep_favorites_on_drop = true

兼容性

支持的存储容器

Terrastorage 可以流畅地与所有原版存储方块配合使用，如箱子、木桶、潜影盒，甚至像运输矿车和运输船这样的东西。

与模组存储方块的兼容性各不相同。有些可以毫无问题地工作，而另一些可能无法立即兼容。如果你遇到来自其他模组的存储方块似乎无法与 Terrastorage 一起工作，请在 GitHub 上提交问题，我会看看能做什么！

功能限制

目前不支持重命名不继承 LockableContainerBlockEntity 的模组存储方块或不继承 VehicleInventory 的模组存储实体。这是一个难以克服的限制，并且很可能在可预见的未来保持不变。

致谢

快速堆叠到附近容器和整理物品栏按钮的 Minecraft 风格纹理由 Ventgirl_Joanne 慷慨提供。

俄语翻译由 Demzy123 提供。

反馈与支持

如果你有任何问题、建议或遇到任何问题，请随时提交问题！

请注意：自 2024年12月2日 起，我已开始我的学业，这将在未来几年内让我非常忙碌。这意味着我将有更少的时间来积极开发 Terrastorage 或回应反馈和问题。

我仍将尽力处理重要问题并在可能时考虑建议，但响应时间可能会较慢。