Terrastorage
? 重要:已知的兼容性问题
版本 1.3.0 和 1.3.1 显著提高了与其他存储类模组的兼容性:
- ? Sophisticated Storage & Backpacks:目前兼容性基本稳定——仍存在排序和物品收藏(Item Favoriting)方面的一个小问题,但我没有遇到会导致物品复制丢失或物品损失的情况。
- ? Traveler's Backpack:仍然存在可能导致物品损失的问题,或者至少导致物品暂时消失。建议目前暂时不要将 Terrastorage 与该模组一起使用。
感谢您的耐心!
Terrastorage 是一款可定制的客户端与服务器端模组,它将《泰拉瑞亚》中出色的存储选项带入《Minecraft》,包括极具实用价值的快速堆叠至附近箱子功能。目前支持 Fabric 和 Quilt。
请注意,Terrastorage 需要同时在客户端和服务端安装才能正常工作。 言归正传,让我们来看看功能展示:
功能
拾取并存入全部:
- 拾取全部 (Loot All) - 将存储中的所有物品转移到玩家的背包中。
- 存入全部 (Deposit All) - 将玩家背包中的所有物品转移到存储中。
⏺️ 在移动物品到空槽位之前,会先尝试与目标槽位中的现有物品进行合并堆叠。
⏺️ 已收藏的物品不受存入全部影响。
快速堆叠与补充库存:
-
快速堆叠 (Quick Stack) - 使用以下两种模式之一将物品从玩家背包转移到存储中:
-
智能存入 (Smart Deposit) - 类似于“填满”,但也会将所有匹配的物品移动到空槽位中,并在需要时创建新的堆叠。
-
填满 (Fill Up) - 将物品添加到现有的堆叠中,直到达到最大容量,保持接收方背包中的空槽位不受影响。
-
-
补充库存 (Restock) - 将物品从存储转移到玩家背包中现有的堆叠里。
⏺️ 已收藏的物品不受快速堆叠影响。
✳️ 快速堆叠模式可以通过选项屏幕中的存储快速堆叠模式选项进行配置。
物品收藏:
- 物品收藏 - 按住物品收藏的修饰键(默认为左 Alt)并左击物品,即可将其设为收藏。
✳️ 修饰键可通过控制菜单自定义。
⏺️ 已收藏的物品受到保护,不会被:
- 丢弃出背包。
- Shift 键点击移动到其他背包。
- 在按下快捷栏快捷键期间从快捷栏交换到其他背包。
- 在创造模式的物品栏界面中删除。
- 由存入全部或整理背包移动。
- 被快速堆叠或快速堆叠至附近存储修改。
整理物品与重命名:
- 整理物品 (Sort Items) - 整理存储中的物品。
- 重命名 (Rename) - 重命名存储方块。
✳️ 整理物品和整理背包的排序方法由同一个可配置设置控制。
⏺️ 整理物品也可以通过悬停在槽位上并按下整理背包的快捷键(默认为 R,可在控制菜单中自定义)来激活。
⏺️ 重命名后的存储方块会在其上方显示名称标签,如果上方有方块阻挡,则显示在面向玩家的一侧。
整理背包与快速堆叠至附近存储:
- 整理背包 (Sort Inventory) - 整理玩家背包中的物品。
- 快速堆叠至附近存储 (Quick Stack To Nearby Storages) - 查找所有附近的存储,并对每个存储执行快速堆叠操作。
✳️ 整理物品和整理背包的排序方法由同一个可配置设置控制。
⏺️ 整理背包也可以通过悬停在槽位上并按下整理背包的快捷键(默认为 R,可在控制菜单中自定义)来激活。
✳️ 默认情况下,快速堆叠至附近存储功能仅考虑玩家视线范围内的存储,此设置可配置。
✳️ 快速堆叠至附近存储功能包含一个动画效果,物品会从玩家飞向存储。动画时长和物品飞行间隔时间均可配置。
⏺️ 已收藏的物品不会由整理背包移动,也不会被快速堆叠至附近存储修改。
自定义

客户端:
客户端提供了一个选项界面,可以通过 mod menu 或 /tsclient options 命令访问,允许配置以下设置:
- 选项按钮 - 控制是否在存储界面中添加一个“选项”按钮,该按钮会将玩家带到选项界面。
- 快捷栏保护 - 确定是否将快捷栏排除在存储操作之外。
- 收藏边框可见性 - 控制持有收藏物品的槽位中收藏物品边框的显示时机。可设置为:
- 始终 – 边框始终显示。
- 按下修饰键时 – 仅在按住修饰键(默认为左 Alt)时显示边框。
- 非快捷栏 – 边框在快捷栏以外的所有位置显示。
- 按下修饰键且非快捷栏 – 边框仅在按住修饰键且在快捷栏以外时显示。
- 从不 – 边框从不显示。
- 排序依据 - 确定使用 整理物品 或 整理背包 时对物品进行排序的属性。可设置为:
- 物品组 - 按物品组排序。
- 物品数量 - 按数量排序(从高到低)。
- 物品稀有度 - 按稀有度排序(从高到低)。
- 物品名称 - 按名称字母顺序排序。
- 物品 ID - 按 ID 排序(从低到高)。
- 存储快速堆叠模式 - 配置用于单次存储操作快速堆叠的模式。(详见快速堆叠与补充库存部分。)
- 附近存储快速堆叠模式 - 配置用于附近存储的快速堆叠模式。(详见快速堆叠与补充库存部分。)
- 按钮纹理 - 控制背包存储按钮使用的纹理。

除了 选项界面 外,还有一个专用的按钮自定义界面,允许自定义在存储背包界面中显示的存储选项按钮的外观。
⏺️ 所有这些选项都可以通过位于 .\config\terrastorage_client.toml 的客户端配置文件进行自定义。此文件旨在方便手动编辑,并包含每个属性的默认值以及整数属性的范围。
服务端
以下服务器设置可以通过游戏内命令进行修改。要更改设置,请使用命令 /terrastorage [option] [new value]。要查看当前值,请使用 /terrastorage [option]。
可用选项如下:
-
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 的配置文件直接修改。与客户端配置文件一样,它也旨在方便手动编辑。以下是其默认内容:
#The cooldown of all storage actions, in game ticks
#Range: 2 to 100, inclusive
#Default: 10
action_cooldown = 10
#==========
#Whether the Quick Stack To Nearby Storages feature only considers storages within the player's line of sight.
#Default: true
line_of_sight_check = true
#==========
#The range of the Quick Stack to Nearby Storages feature, in blocks
#Range: 3 to 16, inclusive
#Default: 8
quick_stack_range = 8
#==========
#The length of the flying item animation that occurs when Quick Stack To Nearby Storages is used, in game ticks
#Range: 10 to 200, inclusive
#Default: 20
item_animation_length = 20
#==========
#The interval between animated flying items, in game ticks
#Range: 0 to 20, inclusive
#Default: 5
item_animation_interval = 5
#==========
#Whether the item favoriting feature is enabled. Disable this to ensure compatibility with vanilla clients.
#Default: true
enable_item_favoriting = true
#==========
#Whether items will keep their favorite status once they are dropped as an item entity.
#Default: true
keep_favorites_on_drop = true
兼容性
支持的存储
Terrastorage 可以顺利配合所有原版存储方块工作,例如箱子、桶、潜影盒,甚至包括箱型矿车和箱型船。
与模组添加的存储方块的兼容性各不相同。有些可以毫无问题地工作,而另一些可能一开始并不兼容。如果您遇到来自其他模组的存储方块似乎无法与 Terrastorage 配合使用,欢迎在 GitHub 上提交 issue,我会尽力解决!
功能限制
目前不支持重命名未继承 BaseContainerBlockEntity 的模组存储方块或未继承 ContainerEntity 的模组存储实体。这是一个难以克服的限制,预计在未来一段时间内仍将存在。
致谢
快速堆叠到附近存储 和 整理背包 按钮的 Minecraft 风格纹理由 Ventgirl_Joanne 慷慨提供。
俄语翻译由 Demzy123 提供。
反馈与支持
如果您有任何问题、建议或遇到任何故障,请随时提交 Issue!
请注意:自 2024年12月2日 起,我已开始学业,未来几年将会非常忙碌。这意味着我将大幅减少用于积极开发 Terrastorage 或回复反馈与处理问题的时间。
尽管如此,我仍会在力所能及的范围内尽力解决重要问题并考虑各种建议,但响应时间可能会变慢。
Terrastorage
? IMPORTANT: Known Compatibility Issues
Version 1.3.0 and 1.3.1 significantly improved compatibility with other storage mods:
- ? Sophisticated Storage & Backpacks: Compatibility is mostly stable now - there's still a minor issue with sorting and one with item favoriting, but I didn't run into anything that could cause item duplication or item loss.
- ? Traveler's Backpack: Still has issues that can result in item loss, or at least in items temporarily disappearing. I'd recommend holding off on using Terrastorage alongside it for now.
Thanks for your patience!
Terrastorage is a customizable server and client-side mod that brings the amazing storage options from Terraria to Minecraft, including the incredibly useful Quick Stack To Nearby Chests feature. It currently supports Fabric and Quilt.
Note that Terrastorage needs to be installed on both the client and server to work properly. With that out of the way, let's dive into the feature showcase:
Features
Loot and Deposit All:
- Loot All - Transfers all items from the storage to the player's inventory.
- Deposit All - Transfers all items from the player's inventory to the storage.
⏺️ Items are first stacked with existing ones in the opposite inventory before being moved to an empty slot.
⏺️ Favorite items will not be affected by Deposit All.
Quick Stack and Restock:
-
Quick Stack - Transfers items from the player's inventory to the storage using one of two modes:
-
Smart Deposit - Similar to Fill Up, but also moves all matching items into empty slots, creating new stacks as needed.
-
Fill Up - Adds items to existing stacks until they reach their maximum capacity, keeping empty slots in the receiving inventory unaffected.
-
-
Restock - Transfers items from the storage into existing stacks in the player's inventory.
⏺️ Favorite items will not be affected by Quick Stack.
✳️ The Quick Stack mode can be configured through the Storage Quick Stack Mode option in the Options Screen.
Item Favoriting:
- Item Favoriting - You can favorite items in your inventory by holding the modifier key for Item Favoriting (Left Alt by default) and left-clicking them.
✳️ The modifier key is customizable via the controls menu.
⏺️ Favorite items are protected from being:
- Thrown out of the inventory.
- Shift-pressed to a different inventory.
- Swapped from the hotbar to a different inventory during a hotbar keybind press.
- Deleted in the creative inventory screen.
- Moved by Deposit All or Sort Inventory.
- Modified by Quick Stack or Quick Stack To Nearby Storages.
Sort Items and Rename:
- Sort Items - Sorts the items in the storage.
- Rename - Renames the storage block.
✳️ The sorting method for both Sort Items and Sort Inventory is controlled by a single configurable setting.
⏺️ Sort Items can also be activated by hovering over a slot and pressing the sort inventory keybind (R by default, customizable in the controls menu).
⏺️ Renamed storage blocks display nametags either above them or on the side facing the player if there’s a block above.
Sort Inventory and Quick Stack To Nearby Storages:
- Sort Inventory - Sorts the items in the player's inventory.
- Quick Stack To Nearby Storages - Finds all nearby storages and performs the Quick Stack operation on each.
✳️ The sorting method for both Sort Items and Sort Inventory is controlled by a single configurable setting.
⏺️ Sort Inventory can also be activated by hovering over a slot and pressing the sort inventory keybind (R by default, customizable in the controls menu).
✳️ By default, the Quick Stack To Nearby Storages feature only considers storages within the player's line of sight, this is configurable.
✳️ The Quick Stack To Nearby Storages feature includes an animation where items fly from the player to the storage. Both the animation length and the time interval between flying items are configurable.
⏺️ Favorite items will not be moved by Sort Inventory or modified by Quick Stack To Nearby Storages.
Customization

Client side:
The client side features an options screen that can be accessed with mod menu or with the /tsclient options command, it allows for the configuration of the following settings:
- Options Button - Controls whether an "Options" button, which takes the player to the options screen, is added to the storage screens.
- Hotbar Protection - Determines whether the hotbar is excluded from storage actions.
- Favorite Border Visibility - Controls when the favorite item border is drawn on slots holding favorite items. Can be set to:
- Always – The border is always drawn.
- On Modifier Press – The border is only drawn while the modifier key (Left Alt by default) is held.
- Non-Hotbar – The border is drawn everywhere except the hotbar.
- On Modifier & Non-Hotbar – The border is only drawn while the modifier key is held and only outside the hotbar.
- Never – The border is never drawn.
- Sort By - Determines the property by which items are sorted when using Sort Items or Sort Inventory. It can be set to:
- Item Group - Items are sorted by their group.
- Item Count - Items are sorted by quantity (from highest to lowest).
- Item Rarity - Items are sorted by their rarity (from higher to lower).
- Item Name - Items are sorted alphabetically by name.
- Item Id - Items are sorted by their ID (from lower to higher).
- Storage Quick Stack Mode - Configures the quick stack mode used for single storage operations. (See Quick Stack and Restock for details.)
- Nearby Storage Quick Stack Mode - Configures the quick stack mode used for nearby storages. (See Quick Stack and Restock for details.)
- Buttons Textures - Controls the textures used by the inventory storage buttons.

In addition to the Options Screen, a dedicated buttons customization screen allows for customizing the appearance of the storage option buttons displayed in storage inventory screens.
⏺️ All these options are customizable through the client configuration file, located at .\config\terrastorage_client.toml. This file is designed for easy manual editing and includes the default values of each property, as well as the range of integer properties.
Server Side
The following server settings can be modified via in-game commands. To change a setting, use the command /terrastorage [option] [new value]. To view the current value, use /terrastorage [option].
The available options are:
-
action-cooldown
Sets the cooldown for all storage actions, in game ticks.
Default: 10
-
line-of-sight-check
Determines whether the Quick Stack To Nearby Storages feature only considers storages within the player's line of sight.
Default: true
-
quick-stack-range
Specifies the range of the Quick Stack to Nearby Storages feature, in blocks.
Default: 8
-
item-animation-length
Sets the length of the flying item animation when Quick Stack to Nearby Storages is used, in game ticks.
Default: 20
-
item-animation-interval
Specifies the time interval between animated flying items in ticks.
Default: 5
-
enable-item-favoriting (1.21+ servers only)
Determines whether Item Favoriting is enabled on dedicated servers. Set to false to ensure compatibility with vanilla clients. Not available for singleplayer.
Default: true
-
keep-favorites-on-drop
Determines whether items will keep their favorite status once they are dropped as an item entity.
Default: true
⏺️ These settings can be directly modified through the configuration file, located at .\config\terrastorage.toml. Just like the client configuration file, it is designed for easy manual editing. Below are its default contents:
#The cooldown of all storage actions, in game ticks
#Range: 2 to 100, inclusive
#Default: 10
action_cooldown = 10
#==========
#Whether the Quick Stack To Nearby Storages feature only considers storages within the player's line of sight.
#Default: true
line_of_sight_check = true
#==========
#The range of the Quick Stack to Nearby Storages feature, in blocks
#Range: 3 to 16, inclusive
#Default: 8
quick_stack_range = 8
#==========
#The length of the flying item animation that occurs when Quick Stack To Nearby Storages is used, in game ticks
#Range: 10 to 200, inclusive
#Default: 20
item_animation_length = 20
#==========
#The interval between animated flying items, in game ticks
#Range: 0 to 20, inclusive
#Default: 5
item_animation_interval = 5
#==========
#Whether the item favoriting feature is enabled. Disable this to ensure compatibility with vanilla clients.
#Default: true
enable_item_favoriting = true
#==========
#Whether items will keep their favorite status once they are dropped as an item entity.
#Default: true
keep_favorites_on_drop = true
Compatibility
Supported Storages
Terrastorage works smoothly with all the vanilla storage blocks like chests, barrels, shulker boxes, and even things like chest minecarts and chest boats.
Compatibility with modded storage blocks varies. Some will work without any issues, while others might not be compatible right away. If you come across a storage block from another mod that doesn’t seem to work with Terrastorage, feel free to open an issue on GitHub, and I’ll see what I can do!
Feature Limitations
Renaming modded storage blocks that do not extend BaseContainerBlockEntity or modded storage entities that do not extend ContainerEntity is currently not supported. This is a limitation that would be difficult to overcome and is likely to remain for the foreseeable future.
Acknowledgments
The Minecraft-style textures for the Quick Stack To Nearby Storages and Sort Inventory buttons were generously provided by Ventgirl_Joanne.
The Russian translation was provided by Demzy123.
Feedback & Support
If you've got a question, a suggestion, or run into any issues, don't hesitate to submit an issue!
Please note: As of December 2nd, 2024, I’ve started my studies, which will keep me busy for the next few years. This means I will have significantly less time to actively work on the Terrastorage or respond to feedback and issues.
I’ll still do my best to address important issues and consider suggestions when possible, but response times may be slower.
下载 Terrastorage
下载 Terrastorage
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Terrastorage
下载 Terrastorage
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Terrastorage
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Terrastorage 1.3.2 for Minecraft 26.3
版本 1.3.2
本次小版本修复解决了一些问题。
Fabric 加载器
- 修复了一个可能导致 Terrastorage 较新版本(1.3.0 和 1.3.1)在 Fabric 加载器版本低于 0.19.5 时,于客户端启动期间崩溃的 bug。
Sinytra Connector
修复了在通过 Sinytra Connector 在 NeoForge 上运行 Terrastorage 时出现的以下崩溃问题:
- 修复了一个导致客户端在启动时崩溃的 bug,影响 1.21.1 版本的 Minecraft。
- 修复了一个导致在打开物品栏/容器时客户端崩溃的 bug(#62),影响 1.21.1 版本的 Minecraft。
- 修复了一个导致在 26.1.2 版本的 Minecraft 上启动时客户端崩溃的 bug。
快速堆叠到附近存储
- 修复了一个小 bug,该 bug 会导致即使没有实际转移任何物品时,也会触发飞行物品的动画效果。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧