Ok I am going to try my best to explain this since several people here have asked and we just get the same answers "go to the wiki" or "join our discord" some people honestly hate discord they dont like the setup since it feels more like a chat room then a Manuel etc (getting into all the reasons for dislike of discord would be detracting from my point though)
the question
How do we actually USE this ? the wiki/front page is VERY GOOD at getting us interested it tells us what it DOES but not how we USE this umm Program ? Mod ? Library ? is this a Modder tool ? honestly from what I have read this looks more like a tool for molders meaning moders would get this but it would not be all that accessible to average non coding non modding types who saw this cool thing and wanna try it, and I think that might be where the confusion comes from its either a loss in translation or really bad instructions and that's why people keep asking for instructions.
to quote the Wiki
Creating a Subworld
"Classes that derive from Subworld are automatically registered as subworlds. Display names are set with the following localization key: SubworldName.<subworld class name>
Below is a list of fields that can be overridden. Fields that are required are marked in bold."
as my wife said when I showed this to her "what is a class ?" she looked at those instructions as if they where hieroglyphics and that is how most PLAYERS who do not design mods will look at it. the next question is ... what UI is this in ? how do we access this UI your wiki is saying NOTHING about where we are when we are doing this is this in the code is it in the game is it in the chat window a player will not understand what program is even being used. the next part gives a field of commands you can use but again nobody even knows how to access the UI meaning they don't know where they are entering this information even.
and this is why people keep asking for instructions the use of this is unclear in the mod downloader it appears as ready to go you add it to your mods list type a command in a world and away you go but then they try and are confused as to why it doesn't work (and then either come here and ask getting directed to the wiki which just describes what it does not how to do it or remove it as they loose interest)
I love this idea and I can see a lot of crazy awesome things from this but it would be helpful to clear things up for people who are either new to modding or just not in the know and if this is a tool for modders ... maybe put that in the description so players know its not something they can use and is meant for those making cool stuff to make further cool stuff. and also remember lots of people dislike discord they see the discord link and get turned off its your choice to use it but its also the other persons choice to refuse to use it
please if you can understand this is not an attack I like your work but this needs to be said cas otherwise this question might keep coming up or people just might ignore this mod and I would hate to see that
Darmond
I feel as, one of the first people who has properly used Subworlds the way it was intented, to help give some more insight to what "this" is, who it's for, and some basic guide lines on when (yes, I said when) to use it.
Q: What is it?
A: This is a
Library, you know all those "Core" mods you were required to download in Minecraft? It's one of those: a mod that stores code that several other mods can use; this is done so the author can easily update the code and share it between their mods without creating alot of
Boilerplate Code in the process.
Subworlds however is a public Library intended to add functional (AKA Subworlds in this case) to the game, it was designed to make mutli-worlds as painless as possible for anyone who wishes to do so... More on that in a minute.
Q: Is it for me? Who's it for?
A: This is for mod-makers, it does NOT add any functionality of its own, it's only an API to be used by mod makers to easily add subworld/dimensions to Terraria. If you want a mod that lets you create a customized dimension, your going to have to wait til someone makes a mod to do that using that.
Q: 'When' can I use it?
A: This is often where alot of the complaining happens, this is honestly a pretty big deal. When I first discovered Subworlds, I wanted to be the first to take advantage of its features (after GaMeTerraria of course), it wasn't super clear at first and Snail got in contact with me when I had questions, but ultimately I figured it out and even expanded my subworlds with extra functionality.
Because here's the thing: I knew what I was doing. Alot of people who want to "use" this library, often don't even know the basics required to use it. These basics would include:
Writing a class to child from Subworld (Terraria doesn't do the best job of even explaining C# basics like "classes", as you'd stated above with your confusion)
Understanding Worldgen (There aren't alot of great worldgen examples out there for TML so this makes sense, it kinda clicked for me since I've done this kinda thing before to an extent)
Using Funcs and Delegates (will confuse you to no end if you don't know what your doing!)
Because of all the hype based around this concept being widely possible, it leads up to alot people who have no idea what their doing wanting to suddenly make dimensions, now there are some good ones coming... but that's just it, they're all WIPs with the exception of a few mods (Polarites, SGAmod, Markoth's Challenge I guess counts), so there really isn't "alot" out there you can play with subworlds yet sadly, but as one of those people (SGAmod in this case) I can tell you, it's good, real good, not perfect, a big buggy, but good!
And about discord, yeah well, as I stated in the final part above, you NEED to know a sizable ammount of C# knowledge before you start using Subworlds, when I started using Subworlds it was alot more bare-bones infomation wise, but the even the little infomation available on the wiki (at the time, there's alot more now) I was able to use Snail's Barebones subworld class to make all my dimensions since. So discord isn't really required for this.
It works, it's just often people who who want to use it aren't ready to use it, yet.