Terrastorage

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 into existing stacks in the storage.
• Restock - Transfers items from the storage into existing stacks in the player's inventory.

⏺️ Items are combined up to their max stack size, so empty slots in the receiving inventory remain unaffected.

⏺️ Favorite items will not be affected by Quick Stack.

---

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 with a hotbar item 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.

⏺️ 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.

✳️ 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 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.

• Buttons Style - Controls the style of the buttons added to storage inventory screens. It can be set to:

  • Default - The standard Minecraft button style.
  • Text Only - Displays only the button text without a background, similar to Terraria’s storage buttons.

• Buttons Placement - Controls which side of the screen the storage option buttons are added to, and can be set to:

  • Right - Buttons are placed on the right side of storage screens.
  • Left - Buttons are placed on the left side of storage screens.

• 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).

In addition to the options screen, these settings can be directly modified through the client configuration file. This file, designed for easy manual editing, is located at .\config\terrastorage_client.toml. Below are its default contents:

#Whether to display the options button in the storage screens
#Default: true
display_options_button = true
#==========
#Whether to protect hotbar items from the storage options
#Default: true
hotbar_protection = true
#==========
#The style of the storage option buttons
#Default: DEFAULT
buttons_style = "DEFAULT"
#==========
#The placement of the storage option buttons
#Default: RIGHT
buttons_placement = "RIGHT"
#==========
#The property by which items will be sorted
#Default: ITEM_GROUP
sort_type = "ITEM_GROUP"

---

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

• 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. 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 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 LockableContainerBlockEntity or modded storage entities that do not extend VehicleInventory is currently not supported. This is a limitation that would be difficult to overcome and is likely to remain for the foreseeable future.

Feedback & Support

If you've got a question, a suggestion, or run into any issues, don't hesitate to submit an issue!

I’ll do my best to get back to you as quickly as possible!