The Great Mod Rewrite, V2.0 is here!
This release completely rewrites how the mod was coded, mostly on the back end. This also brought many new features that will be listed here, as well as better preformance across the board.
Items used to be stored in a single TagCompound (used to save the data by TMod), and everything researched was in it. Not anymore! Now, Items are divided into Hand-researched (the ones you place in the research slot or shift-click in), Craft-researched (crafted automatically by the research system), Part researched (by compatiblity with Rare Item Swap) and partially researched (Items you researched only some of the total). There is also a temporary Unknown Items section internally, where items researched from disabled mods are stored. Only Hand-researched, partially researched and unknown items are saved (separately) by the game. The rest is automatically regenerated when joining a world, as long as the config still allows it.
As for your current save, it will be converted to the new system by placing all items you have in the hand-research section. If you really want to take advantage of the above item split, either start a new character, or keep playing and only have new items fit in. If you want any newly Craft-research or Part-research items into the hand-researched ones, there is a way.
So, the new features are as follows:
- New Favorite System, that allows you to "favorite" an item, to have it show in the new default category, "Favorites". You favorite a researched item by middle-mouse clicking it in the researched panel. The background for favorited items are green instead of gray. Items favorited (or once favorited and then defavorited by middle-mouse clicking them again) will be moved to the Hand-researched section, and will be saved with the player on regular Terraria (tmod) save.
- New categories for hand-researched, craft-researched and part-researched items. (the categories will be there even if you have their config options disabled, or even if there is no Rare Item Swap mod present). If you disable crafting or part researches in the config, the items there will disappear after the game refreshes the research, or you can do it yourself by using the research sharing book.
- New Partial category, that allows you to recover partially-researched items in a bind. Completely multiplayer safe with the team-share mode. You cannot favorite partials.
- Team-Share was improved, by allowing you to share both hand-researched and partial items obtained after joining the team. Note that sharing full research only happens after researching (even partially) an item, so if you don't want to wait, just use the good old Research-sharing book.
- Speaking of which, with the new division of things, Hand-researched items are much fewer in number, and can mostly be saved with the book item. So it is finally possible to share knowledge between two characters in just single player. This change, however, made the book Dangerous to keep in the inventory if more than ~5000 items are saved there, as tMod cannot sync the player inventory to the server with such a large number. So, in those cases, just throw the book away or store it in a chest or other such inventory.
- The book only shares hand-research items, and causes the player to refresh the other sections when used, so feel free to use it if you think a crafted item is missing.
As with any major rewrites, there may be new bugs popping up, but overall it should be much easier to load and play with this mod, with most of it being multi-threaded so that your game is free to run as it pleases. Do be wary, however that researching something before the mod has time to reload will log that in the client.log, but can be safely ignored.
Known Bugs:
- Sometimes, when starting a new character, the character will have the research from the last character in your player list. Trying to fix it just made it (much) worse, so for now, if it happens to you, just use the knowledge-erasing book and you'll be all set. This only affects characters without any saved data, so after playing and erasing the errored research, you should have no more problems.
- If you reload your mods and change some, Rare Item Swap will sometimes mess up the old itemIDs with the new itemIDs and, by extension, if you have part-research, it may teach you some wrong items. Worse still is if those items are Parts on themselves, as this leads to learning things you definitely shouldn't have (this bug was first found when adding a new mod to a Thorium/Calamity/Spirt playthrough, and in pre-hardmode we gained access to Calamitas and Aquatic Scourge Parts...)
- The solution: Always reload terraria after changing mods. I tried my darndest to find all the places not being unloaded in my mods, and fixed most of them, so hopefully this does not happen anymore. But, to be safe, try that.
