tModLoader

tModLoader

6,761 ratings
Subworld Library
6
3
5
2
6
2
2
2
2
2
   
Award
Favorite
Favorited
Unfavorite
Mod Features: Library
Mod Side: Both
tModLoader Version: 1.4.3, 1.4.4
File Size
Posted
Updated
229.228 KB
Mar 26, 2022 @ 1:55pm
Nov 24 @ 8:35am
21 Change Notes ( view )

Subscribe to download
Subworld Library

Description
An API for modders to easily add dimensions (referred to as subworlds) to their mods, making all the necessary code injections, handling Multiplayer and managing every subworld.

Report issues on the forum page or GitHub:
https://forums.terraria.org/index.php?threads/86283
https://github.com/jjohnsnaill/SubworldLibrary/issues

Wiki:
https://github.com/jjohnsnaill/SubworldLibrary/wiki

HOW IT WORKS
Subworld Library does a LOT of code injection, as Terraria was not made with subworlds in mind.
Subworlds are highly customisable; from how big or small they are, to what ModSystems can update inside of them and even how they are lit.
Subworld Library removes Space, both Oceans and the Underworld from subworlds, allowing them to be extremely small without issues.

LOADING
Loading a subworld is straightforward. Loading screens can be as simple as text on a plain background, or something complex, like an item selection menu.

SAVING
Subworlds save to a directory named after the main world. A subworld and/or changes to players inside it can be temporary. Deleting a world deletes all of its subworlds as well.

MULTIPLAYER
Subworld Library works in Multiplayer with little to no extra work required from modders. A "subserver" is opened for every subworld being occupied.
Originally posted by tModLoader SubworldLibrary:
Developed By John Snail
413 Comments
John Snail  [author] 12 hours ago 
Fixed in the latest patch!
HT•Cerberus Supremacy!•KR Nov 21 @ 11:32pm 
hello, i have a issue in regards to a crash i encountered during my starlight river+stars above playthrough. i had went back and forth about it in between mods and they suspect it to be a compatibility issue between subworld and starlight river. i have the crash log with me if you want it just dont know where to put it
John Snail  [author] Nov 15 @ 4:47am 
The backgrounds and NPC spawns are hardcoded but you can override them.
VictorGD Nov 15 @ 4:21am 
The subworlds I make still have space and the oceans. I analyzed the code of subworlds from existing mods and found no mention of them even though they're often 100% one biome. The "hideUnderworld" option is easy to find but I see nothing that removes space. What am I doing wrong? Is this a problem with the library?
blindstreak Nov 13 @ 6:08pm 
To Skyring and one having a problem downloading this from tmodloaders mod menu a fixes for it
unsubscribe and resubscribe to the mod here
Skyrigs Nov 11 @ 7:17am 
this mod doesnt want to download, it just tells me that it cant download and thats it
John Snail  [author] Nov 4 @ 5:55am 
Sounds like a mod conflict, send a log and I'll try to forward it to the right people!
ImitationGold Nov 3 @ 11:14am 
I'm hoping to get some help as i'm unable to use the subworlds in the stars above in multiplayer. me and my buddy have about 40 mods including calamity infernum, stars above, advanced world generation (slightly larger world) BUT the subworlds work just fine in singleplayer.

the error im getting when joining or after attempting to go into a subworld is: "System.NullReferenceException: Object reference not set to an instance of an object." right before the recipes load. Meanwhile, my game is stuck on a loading screen "backing up Player File". after which ill get booted to the main world after about 2 minutes.

I can send the whole log if necessary, i'd appreciate if there's anything i can do to make this work on the server, thanks.
John Snail  [author] Oct 30 @ 3:05am 
oops
JamesTripleQ Oct 29 @ 10:32am 
heads up that using the "Current" mod call doesn't just return null when in the main world but also causes an error log