Terrastorage

Terrastorage

🔴 重要提示：主要兼容性问题

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

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

---

Terrastorage 是一个可定制的服务端和客户端模组，将泰拉瑞亚中令人惊叹的存储选项带到 Minecraft，包括非常有用的快速堆叠至附近箱子功能。它目前支持 Fabric 和 Quilt。

请注意，Terrastorage 需要同时安装在客户端和服务端才能正常工作。 闲话少叙，让我们来看看功能展示：

功能

拾取所有战利品和存入所有物品：

• 拾取所有战利品 - 将所有物品从存储容器转移到玩家物品栏。
• 存入所有物品 - 将所有物品从玩家物品栏转移到存储容器。

⏺️ 物品会首先与目标容器中的已有物品堆叠，然后才会被移动到空槽位。

⏺️ 收藏物品不会受到存入所有物品的影响。

---

快速堆叠和补充：

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

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

  • 填满 - 将物品添加到已有堆叠中，直到达到其最大容量，保持目标容器中的空槽位不受影响。

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

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

✳️ 快速堆叠模式可以通过选项界面中的存储容器快速堆叠模式选项进行配置。

---

物品收藏：

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

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

⏺️ 收藏物品被保护，不会被：

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

---

整理物品和重命名：

• 整理物品 - 整理存储容器中的物品。
• 重命名 - 重命名存储容器方块。

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

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

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

---

整理物品栏和快速堆叠至附近存储容器：

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

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

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

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

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

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

自定义

客户端：

客户端有一个选项界面，可以通过模组菜单或命令 /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
#==========
#是否启用物品收藏功能。禁用此功能可确保与原始客户端的兼容性。
#默认值：true
enable_item_favoriting = true
#==========
#物品在被抛落为物品实体时，是否保留其收藏状态。
#默认值：true
keep_favorites_on_drop = true

兼容性

支持的存储容器

Terrastorage 可以流畅地与所有原版存储方块配合使用，例如箱子、木桶、潜影盒，甚至包括运输矿车和运输船等。

与模组添加的存储方块的兼容性各不相同。有些可以无问题运行，而另一些可能无法立即兼容。如果你发现来自其他模组的存储方块无法与 Terrastorage 配合使用，请在 GitHub 上提交 issue，我会看看能做些什么！

功能限制

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

致谢

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

俄语翻译由 Demzy123 提供。

反馈与支持

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

请注意：从2024 年 12 月 2 日开始，我已开始学业，未来几年将会非常繁忙。这意味着我用于积极开发 Terrastorage 或回复反馈和问题的时间将大大减少。

我仍会尽力处理重要的问题并在可能的情况下考虑建议，但响应时间可能会变慢。