Last Updated on the 13th of December, 2024

1. Make sure that you're using the most recent version of Magic Storage and
1.4 tModLoader before reporting any bugs! The most recent Magic Storage
version is v0.6.0.3, the most recent 1.4.3 Legacy tModLoader version is
v2022.9.47.87 and the most recent 1.4.4 Stable tModLoader version is
v2024.10.3.0.

2. If you can't find your bug after searching this document, check the
#magic-storage-changelog channel in the absoluteAquarian Mods Discord to
make sure that it's not already fixed or going to be fixed. If you can't find that
channel, make sure that you have the Magic Storage channels visible in the
Channels & Roles section in the channel list.

3. More recent bugs are at the bottom of the bugs list!

4. When looking for errors, ignore this part about mismatched versions! This
text is boilerplate and is almost always not the cause of the issue.

Enable the Google Docs Outline to quickly browse

through this document by category.
You can also search with tags, e.g. [CRASH],
[UI], [STORAGE] or [CRAFT].
Please wait for the entire document to load before
searching for a bug!

Information
[SAVES DIRECTORY]
Saves (players, worlds, mod configs, etc.) are stored at one of the following paths:

Windows:
C:\Documents\My Games\Terraria\tModLoader
C:\Users\<username>\Documents\My Games\Terraria\tModLoader
C:\Users\<username>\OneDrive\Documents\My Games\Terraria\tModLoader
%UserProfile%\Documents\My Games\Terraria\tModLoader
%UserProfile%\OneDrive\Documents\My Games\Terraria\tModLoader

(Note: <username> refers to your username. Do not use this text verbatim when searching for the folder.)

Mac:
~/Library/Application support/Terraria/tModLoader

Linux:
~/.local/share/Terraria/tModLoader
%XDG_DATA_HOME/Terraria/tModLoader

[RESTORE A BACKUP]
World backups are located in the Worlds/Backups folder in your [SAVES
DIRECTORY] in the form of .zip folders for each of your worlds. Extract the most
recent .zip for your world into the Worlds folder and try to load the world again.

[INSTALL DIRECTORY]
Game files used to launch the game are stored at one of the following paths:

Windows:
C:\Program Files (x86)\Steam\steamapps\common\tModLoader
%ProgramFiles(x86)%\Steam\steamapps\common\tModLoader

Mac:
~/Library/Application Support/Steam/steamapps/common/tModLoader/tModLoader.app/Contents/MacOS

Linux:
~/.local/share/Steam/steamapps/common/tModLoader
~/.steam/steam/steamapps/common/tModLoader
[FORCE AN INSTALL/UPDATE]
Sometimes Steam has a difficult time detecting if workshop items have pending updates
that should be installed or whether a workshop item has even been installed. You can
force an update/install via the following steps:

1. Right click tModLoader in your Game Library

2. Click the Properties option
3. Click Installed Files
4. Click the Verify integrity of game files option
5. If the mod still won't install or update, do the following:
a. Get the ID for the mod's workshop item from its URL in the Steam
Workshop. You can find it after the /?id= text in the URL
b. Delete the folder with the same name as that ID in
Steam/steamapps/workshop/content/1281930 if it is present
c. Repeat steps 1-4

(Note: Any .tmod files located inside of the Mods folder in your [SAVES DIRECTORY] will override any of these
options.)

[MANUAL INSTALL]
To manually install a mod file, download its .tmod file, place it in the Mods folder in your
[SAVES DIRECTORY] then restart tModLoader or force a reload of mods ingame.
● Do note that manually installing mods to the aforementioned Mods folder will
make those mod files take priority over any mods you download from the Steam
Workshop for tModLoader.
● To delete a manual install, either delete the mod in the Manage Mods menu
ingame or delete the .tmod file in the aforementioned Mods folder.

[REPORT A BUG]
Please use the following steps when reporting bugs:
1. Close and reopen tModLoader
a. If the bug is happening in multiplayer, restart the server as well
2. Get the bug to happen again
3. Report what the problem is and the appropriate log files in the
#magic-storage-bug-help-read-pins channel in the Discord server mentioned
at the top of this document. If you can't find the channel, check if you've opted
into the Magic Storage channels in the Channels & Roles channel
Log files can be found in your [INSTALL DIRECTORY] in a folder named
tModLoader-Logs as the client.log (for singleplayer and multiplayer clients) and
server.log (for the server instance).

To post a log file, double left click the ⊕ icon next to the chat bar, find the file, then
double left click it. A helper bot in the discord will generate an https://hst.sh link
containing the log's contents, given that the log file is less than ~400 lines long.

(Note: the bot will only detect the first attachment for any given message. When reporting multiple log files, send
them in separate messages.)

Item Stacking
While this would normally be listed under the Bugs List, it's such a common occurrence
to the point that it needs to be given special treatment.

In tModLoader, stacking items in the player's inventory, a chest or private storage –

Piggy Bank, Safe, Defender's Forge and Void Vault – ignores any data present on the
items. As long as the stack isn't at the maximum, the item stacks are combined and
data is destroyed in the process.

However, Magic Storage is very strict when it comes to allowing items to stack together
in a storage system and the Storage UI. If the two stacks don't have the exact same
data, besides the stack quantity, the items are prohibited from stacking.

In order to remedy this, use the following steps as a guideline:

1. Set the Item debug information config in the Magic Storage Config to On
2. Bind the Print Item Data keybinding to a key, for example G
3. Open the Storage UI via any of the components and items that are able to view
storage
4. Hover an item stack, then press G
a. The item's data encoded as an ASCII string will be printed to the chat for
each GlobalItem present on the item
5. Repeat step 4) for the second item stack
6. Check the encoded data for each item. If there's any discrepancy, the two item
stacks will be prohibited from stacking
a. If some or all of GlobalItem data present is from
ModLoader/UnloadedGlobalItem, you can delete it via the Delete
Unloaded Mod Data button in the Controls tab of the Storage UI
 That control currently has a nasty bug which can result in crashes when
attempting to save the world (either from exiting it or the periodic
autosaving). An alternative stopgap to use in the meantime is to stack the
items together in your main inventory.
A mod that you had recently enabled is adding additional data into items,
which Magic Storage prohibits from stacking together. A new API is
planned for developers to opt into which would allow them to have some
control over the stacking behavior.

KNOWN INCOMPATIBILITIES THAT CAUSE THIS:

● Rarity Borders
○ uses data to track when an item is first picked up so that it can force the
border to the "rainbow" color
● Spiky's Lib / Better Inventory
○ Assigns UUIDs to items when crafting outside of storage, which don't get
applied when crafting in the Storage Crafting Interface

Bugs List
[WORLD] All storage components have disappeared from the world.
Solution: Check if any other modded tiles have also disappeared, such as the Abyss
from Calamity Mod. If they have also disappeared, you'll have to [RESTORE A
BACKUP] for the world.

[STORAGE] Every item in the Storage UI says that they "contain GlobalItem" data.
Solution: Disable the Item debug information config option in the Magic
Storage Config.

[CRAFT] Recipes are listed as not available even when all requirements have been
met.
Solution: Make sure that you actually have the necessary ingredients, crafting stations
and other "Required Objects" for the recipe. If you do, then it's possible that another
mod is causing problems. For any recipes that have special crafting conditions (e.g.
"Near water"), disable recursion crafting by setting the Recipe recursion depth
option in the Magic Storage Config to zero.

[CRAFT] A System.EntryPointNotFoundException error is being printed to the

chat when trying to open the Crafting Access.
Solution: Close tModLoader, go into your [INSTALL DIRECTORY] and delete the
dotnet folder. If that doesn't help, try installing .NET 6.0 from the official installer.
[CRASH] [LOADING] [CLOUD] Trying to load Magic Storage causes a
System.IO.IOException: Failed to read NBT file –-->
System.IO.IOException: The cloud file provider is not running.
error to be thrown.
Solution: Turn on OneDrive and sign into it. After doing that, navigate to your [SAVES
DIRECTORY], go back one folder to end up in the Terraria folder, left click and then
right click the tModLoader folder and then select the Always keep on this
device option. This will force OneDrive to download any files that end up in your
saves directory to your computer.

[UI] The mass crafting buttons have disappeared.

Solution: Disable the Use old Craft buttons config option in the Magic
Storage Config.

[CRASH] [LOADING] [MOD INCOMPATIBILITY] Loading certain mods causes a

System.Exception: Mod "X" added or modified a recipe to be in an
invalid state. error to be thrown.
Solution: None. The mod mentioned in the above error message is using outdated
practices for creating item recipes which are not supported by Magic Storage. Report
the error to the mod's developers.

[CRASH] [LOADING] Attempting to load the mod causes a

System.NullReferenceException: Object reference not set to an
instance of an object at System.Object.GetType() error to be thrown.
Solution: Close tModLoader, go into your [INSTALL DIRECTORY] and delete the
dotnet folder.

[UI] [SEARCH] [MOD INCOMPATIBILITY] Attempting to search by tooltip in the search

bars (e.g. #no) causes a System.ArgumentOutOfRangeException: Index must
be within the bounds of the List. (Parameter 'index') error to be
printed to the chat.
Solution: Disable the TRAE Project and Builder Essentials [Beta] mods.

[UI] [SEARCH] [MOD INCOMPATIBILITY] Attempting to search by tooltip in the search

bars (e.g. #no) causes a System.NullReferenceException: Object
reference not set to an instance of an object. error to be printed to the
INGAME CHAT.
Solution: Disable the Elemental Hearts mod.
[UI] [SEARCH] [MOD INCOMPATIBILITY] Attempting to search by tooltip in the search
bars (e.g. #no) causes a
System.Collections.Generic.KeyNotFoundException: The given key
'pinkymod' was not present in the dictionary. error to be printed to the
chat.
Solution: Disable the AFK's PETS and more(Early Alpha) mod.

[UI] [MOD INCOMPATIBILITY] Using an item with a prefix causes all item tooltips to
disappear.
Solution: None. This is due to a conflict between the Dictionary of Prefixes, Calamity
Mod and Secrets of the Shadows mods.

[REMOTE] [PYLON] [MOD INCOMPATIBILITY] The "pylon network" feature which

increases the range of the Portable Access items sometimes fails to work, even though
the pylon can be teleported to and the Storage Heart or a linked Remote Access
component is close enough to a valid pylon.
Solution: Update to v0.6 or later. Keep in mind that Magic Storage uses the vanilla
Terraria constraints for pylon teleportation, so any mods which modify that will not affect
the remote access ranges.

[CRASH] [LOADING] [MOD INCOMPATIBILITY] Attempting to load a world on a

server causes a System.NullReferenceException: Object reference not
set to an instance of an object exception to be thrown.
Solution: Disable the Alchemist NPC Reborn mod.

[UI] [CRAFT] [MOD INCOMPATIBILITY] The Crafting UI is missing its filter icons,
crafting station slots, recipe information panel and most of the recipe slots, with the last
recipe slot being empty.
Solution: Disable the DormantDawnMOD and Teleport All NPC Home mods.

[STORAGE] [MOD INCOMPATIBILITY] Upgrading a placed Storage Unit via the

upgrade orbs causes all nearby Storage Units to disappear.
Solution: Disable the Dynamic Lights and Faster UI mods.

[CRAFT] [UI] [FREEZE] Trying to open the Storage Crafting Interface results in a
massive game freeze before the UI opens OR recipe refreshing takes a significant
amount of time to finish.
Solution: Disable the recursion crafting feature by setting the Recipe recursion
depth option in the Magic Storage Config to zero. v0.7 should hopefully fix the
problems that this system has.
[STORAGE] [CRAFT] [UI] [MOD INCOMPATIBILITY] Armor items are appearing in
both the Filter Armor and Filter Equipment filter results.
Solution: Disable the Armor Modifiers & Reforging mod.

[LOADING] [MOD INCOMPATIBILITY] Trying to load Magic Storage in 1.4.4

tModLoader results in a System.NullReferenceException: Object reference
not set to an instance of an object. at
Census.Census.Call(Object[] args) error being thrown.
Solution: Disable the Census mod. Magic Storage is currently using outdated code for
adding its support for Census and it will need to update to the new API.

[CRAFT] [DUPE] [MOD INCOMPATIBILITY] Taking certain items from the Crafting
Interface's item slots duplicates them.
Solution: Disable the Quality of Life mod.

[LOADING] [FREEZE] [MOD INCOMPATIBILITY] Trying to load Magic Storage results

in the game being stuck in the mod loading process with the Finishing Resource
Loading text.
Solution: Disable the Auto Trash, Auto Reforge and/or Boss Checklist mods.

[LOADING] Attempting to load Magic Storage in 1.4.3 tModLoader results in a

System.NullReferenceException: Object reference not set to an
instance of an object. at MagicStorage.MagicStorageMod.Load()
error being thrown.
Solution: This error is caused by a certain variable not being present in your build of
1.4.3 tModLoader when it should exist. Basically, your tModLoader install is corrupted
and needs to be reset. Delete the tModLoader folder at your [INSTALL DIRECTORY],
uninstall tModLoader and then reinstall it.

[STORAGE] [MOD INCOMPATIBILITY] Attempting to deposit, withdraw or craft items

from storage does nothing.
Solution: None. This is caused by a mod incompatibility, although the mod in question
has not been discerned yet. One known mod that causes problems is Fargo's Soul Mod
Extras, although disabling it has not been shown to completely fix this issue.

[CRAFT] Recipes that require special conditions – e.g. Near water – cannot be crafted,
even when a Bucket of Water or Sink is in a station slot.
Solution: Disable recursion crafting by setting the Recipe recursion depth option
in the Magic Storage Config to zero. There's currently a bug in the recursion
crafting logic which causes special recipe conditions to always fail to be met.

[CRAFT] Blocking an ingredient from being used for crafting causes a recipe to become
unavailable, even if other items of the same type are present in storage.
Solution: None. This is a bug/oversight caused by a discrepancy between ingredient
blocking and the logic responsible for showing if an item is blocked. Ingredient blocking
ignores prefixes on items, whereas the UI does not.

[CRAFT] [SOUND] [MOD INCOMPATIBILITY] Trying to open the Crafting UI or refresh

the recipes – either automatically or manually – causes tons of sound spam which lasts
until recipes finish refreshing, which takes forever to finish OR chat gets spammed with
messages OR any odd behavior not mentioned here happens.
Solution: Disable recursion crafting by setting the Recipe recursion depth config
option in the Magic Storage Config to zero. Some of the mods that you have
enabled have special "on item crafted" logic, which is mistakenly called when handling
the crafting simulations for recursion crafting.

[WORLD] [LOADING] Attempting to load a world results in a generic Magic

Storage: load failed! error message ingame and a
System.Collections.Generic.KeyNotFoundException:
Terraria.ModLoader.Default.UnloadedGlobalItem error in the client log.
Solution: One or more of the storage units in your world somehow contains empty
modded items – possibly due to their IDs being deprecated or their defaults setting their
type to zero – which should not have "global item data" on them. tModLoader attempts
and subsequently fails to assign the data on these items, resulting in the crash.

[MOD INCOMPATIBILITY] [CRAFT] Crafting vanilla armor items on a multiplayer

server causes the set bonus changes from Calamity Mod to be completely wrong or
missing.
Solution: Exit the world while holding the item in your inventory and then re-enter the
world or simply drop the bugged item and pick it up again to make it load the data
correctly. According to a Calamity Mod dev, the system that manages the changes isn't
coded correctly, which causes issues like this one.

[STORAGE] Using the Delete Unloaded Mod Data control causes most of the
Storage UI to fail to render.
Solution: Exit the world and re-enter it if you're playing a singleplayer world or restart
the server if you're playing a multiplayer world. This bug is caused by an oversight in
the control which causes the items it modifies to end up in an unstable state.

[STORAGE] [WORLD] Upgrading a Storage Unit causes it to lose all collision with the
player.
Solution: None. Due to a bug in the base game's logic for multitiles and the layout of
the spritesheet for the Storage Unit upgrades, only the basic Storage Unit has collision.
A hacky code injection has been implemented in v0.7 to fix this behavior.

[MOD INCOMPATIBILITY] [WORLD] Placed storage components load as the wrong

tiles in multiplayer OR storage components drop the wrong item when mined.
Solution: One of your enabled clientside mods is adding content, which causes ID
desyncs in multiplayer since your client and the server disagree on what modded
items/tiles are what. This results in the strange behavior mentioned in the question.
Project tRU is known to be a cause, although other problematic mods may exist.

[MOD INCOMPATIBILITY] [LOADING] Attempting to load a world results in the world

failing to load, with the client log showing a System.NullReferenceException:
Object reference not set to an instance of an object. at
Terraria.ModLoader.IO.ItemIO.Load(Item item, TagCompound tag)
error.
Solution: None. One of your enabled mods is causing certain item types to fail to be
initialized properly, resulting in a Storage Unit failing to load its items. This fails upward
all the way to world loading and causes it to completely fail. Magic Storage v0.7
introduces a band-aid fix that will automatically delete these invalid items upon loading
the world, although there's not much you can do in the meantime.
Wisplantern Mod is known to be a cause, although other problematic mods may exist.

[MOD INCOMPATIBILITY] [CRAFT] [UI] Selecting a recipe from the recipe list in the
Crafting UI causes the slot's item and the recipe panel's preview item to be offset
towards each other.
Solution: None. This is caused by an incompatibility with Naka's Inventory Tweaks.
The developer is aware of this issue and has made a fix, which will be present in the
release of that mod's v1.0 update.

Frequently Asked Questions

Q: What is SerousCommonLib?
A: That is the internal name for the dependency mod that Magic Storage uses, named
absoluteAquarian Utilities.

Q: What is the Server Operator status and how can I get it?
A: Use the /reqop command in chat, then follow its instructions. It will tell you to
check the server's console for a "key" and then you will have to enter that key as your
next message. If you mistyped the key, just use the command again.

Q: When will the old UI from v0.5.6.5 return?

A: It won't. The code for UIs was changed too much to reasonably implement the old
UI as a config option. Please just get used to the new UI.

Q: What does the Storage Configuration Interface do?

A: The Storage Configuration Interface is a storage component that allows other mods
to easily change how crafting is handled in a Crafting Access.

Q: I don't want the Automaton to take up town NPC housing. How do I prevent it from
moving in?
A: Magic Storage's Server config has an option for preventing the Automaton from
moving into housing. You will still have to kill the NPC before another town NPC can
move into that housing.

Q: What are the preferences for the Automaton town NPC?

A: The preferences for the Automaton are listed below:
Loves: the Mechanic, the Snow
Likes: the Witch Doctor, the Forest
Dislikes: the Wizard, the Desert
Hates: the Tax Collector, the Hallow

Q: Where did the DPS tooltips go? Will they return in a future update?
A: DPS tooltips will not return. The code responsible for calculating them was only
accurate for true melee weapons and basic guns – everything else was wildly
inaccurate. A proper implementation would require doing actual simulations of the
weapon, which would be outside of the scope for the mod.

Q: The "Deposit All" button won't deposit items OR it won't Quick Stack items!
A: Hover over the button to see what each feature is bound to.

Q: How do I get a Crafting Access to use items from my inventory when crafting?
Q: How do I get a Crafting Access to use items from my Journey research menu?
A: Place a Storage Configuration Interface component next to your storage system.
The component's item tooltip mentions which "modules" are available for usage in its UI.

Q: I can't destroy a Crafting Access!

A: Make sure that no items are in its station slots.

Q: I can't destroy a Storage Heart!

A: Close the Storage or Crafting UI that you have open. If you're on a multiplayer
server, the other clients will also have to close the Storage or Crafting UI as well.

Q: I can't destroy a Storage Unit!

A: A Storage Unit can only be removed if it contains no items.

Q: What are the drop chances for the Radiant Jewel from the Moon Lord?
Q: Why is the Moon Lord not dropping any Radiant Jewels?
A: The Moon Lord has the following chances to drop a Radiant Jewel either directly in
Normal Mode or from his Treasure Bag in Expert/Master Mode:
Normal Mode: 10%
Expert Mode: 18%
Master Mode: 25%

Q: Do I have to destroy a Storage Unit in order to upgrade it?

Q: How can I upgrade a placed Storage Unit?
A: You can right click a Storage Unit with the Upgrade orb item for the next tier in order
to upgrade it. The Upgrade orb items mention which tier they can upgrade in their
tooltips.