tModLoader

tModLoader

6,725 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.774 KB
Mar 26, 2022 @ 1:55pm
Aug 20 @ 12:10pm
20 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
世界 Nov 18 @ 7:04am 
一个供模组开发者使用的 API,可轻松为他们的模组添加维度(称为子世界),完成所有必要的代码注入,处理多人游戏并管理每个子世界。
Joey Nov 15 @ 8:47am 
wait i havent checked with this but it works with multiplayer now?
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