Feedback on new Directory structure in 1.1 Alpha3b
by Josh Williams · in Torque Game Builder · 01/19/2006 (6:39 pm) · 13 replies
Hello all,
We'd love to get some feedback on the new directory structure we've included in the Alpha3b build of T2D 1.1.
We put a lot of thought into trying to make the directory structure easier to learn and use. But that of course doesn't mean we got it right. ;)
If you guys have any feedback on it, please let me know. I definitely think the existing directory structure needs to be re-vamped. So, I'm most interested in hearing things we might've made more difficult to figure out, and new ideas people have for additional structuring.
Note that in the actual Alpha3b build, a couple things got goofed up just a little. For example, the GettingStarted.pdf tutorial is supposed to be in the documentation directory above the tutorials and references directory... but we accidentally just removed it entirely. Woops! So, just imagine it's there please. We also haven't updated the top-level ReadMe yet. And we forgot to include the opengl2d3d and glu2d3d DLLs. But, imagine the stuff that's supposed to be there is all updated and correct.. and let us know what you think of the overall structure.
Thanks guys!
-Josh
We'd love to get some feedback on the new directory structure we've included in the Alpha3b build of T2D 1.1.
We put a lot of thought into trying to make the directory structure easier to learn and use. But that of course doesn't mean we got it right. ;)
If you guys have any feedback on it, please let me know. I definitely think the existing directory structure needs to be re-vamped. So, I'm most interested in hearing things we might've made more difficult to figure out, and new ideas people have for additional structuring.
Note that in the actual Alpha3b build, a couple things got goofed up just a little. For example, the GettingStarted.pdf tutorial is supposed to be in the documentation directory above the tutorials and references directory... but we accidentally just removed it entirely. Woops! So, just imagine it's there please. We also haven't updated the top-level ReadMe yet. And we forgot to include the opengl2d3d and glu2d3d DLLs. But, imagine the stuff that's supposed to be there is all updated and correct.. and let us know what you think of the overall structure.
Thanks guys!
-Josh
#2
01/19/2006 (9:30 pm)
The new directory structure is mainly changing the oblique names inherited from TGE, such as all the scripts being under client... the locations of images and assets are fairly different, might double check your scripts and GUIs that reference that. Also the client.cs has been changed to game.cs and the scripts structure has been cut down a bit, some things you might want to look for :)
#3
We changed the SDK folder, and the default game / script set-up. So, for your games, you'll have to make sure things your referencing from the common and t2d folders are modified to look at the new structure. It should be really easy to determine though... either look at the console and see what's failing to be found / loaded, or search through your scripts and change folder references appropriately.
We tested it out, and changing stuff to reflect the new proposed folder layout only took a few minutes for our example games. Also, obviously, you can structure your own game scripts however you see fit... you needn't use our rules! We just wanted to provide a cleaner, easier to understand and navigate folder structure by default.
01/19/2006 (10:25 pm)
Hi Tom,We changed the SDK folder, and the default game / script set-up. So, for your games, you'll have to make sure things your referencing from the common and t2d folders are modified to look at the new structure. It should be really easy to determine though... either look at the console and see what's failing to be found / loaded, or search through your scripts and change folder references appropriately.
We tested it out, and changing stuff to reflect the new proposed folder layout only took a few minutes for our example games. Also, obviously, you can structure your own game scripts however you see fit... you needn't use our rules! We just wanted to provide a cleaner, easier to understand and navigate folder structure by default.
#4
the new directory structure is much better than the old. Now everything is where i assume it would be. :)
01/20/2006 (5:18 am)
Yep, the new directory structure is much better than the old. Now everything is where i assume it would be. :)
#5
And thankyou (very much) for don't breking my code and
give me the1.3a release!!
Even when could be more easy and cleaner
I have my svn paths and batchs files aiming
to this files, and it would take a time to update everything...
Please don't break the "a" support :)
01/20/2006 (9:08 am)
Hi thank you for this new release.And thankyou (very much) for don't breking my code and
give me the1.3a release!!
Even when could be more easy and cleaner
I have my svn paths and batchs files aiming
to this files, and it would take a time to update everything...
Please don't break the "a" support :)
#6
01/20/2006 (11:41 am)
I love the new structure, makes more sense.
#7
01/21/2006 (10:41 pm)
It's great! thanks again
#8
... then I realised I was being completely stupid and I would have done it almost exactly the same way.
;-)
T.
01/22/2006 (2:09 am)
My first reaction to the new directory structure was "omg! its different! it sucks!" ...... then I realised I was being completely stupid and I would have done it almost exactly the same way.
;-)
T.
#9
01/22/2006 (2:25 am)
Quote:Also the client.cs has been changed to game.cs*Eek* I have a game.cs already. I use game.cs to store stuff that relates to core game mechanics, so I'm going to have to recode around that. At least I found it mentioned in this thread before accidently overwriting it.
#10
I like the new directory structure a lot. Much more orderly and easier to understand. The only thing I've changed over the current defaults is to delete the content folder move the datablock scripts back to the gameScripts folder, as I like to have all my non-main .cs scripts in one folder. While I understand why they were moved over to the data folder, it felt a bit "out of place" to me.
01/22/2006 (4:36 am)
Thanks for the new release!I like the new directory structure a lot. Much more orderly and easier to understand. The only thing I've changed over the current defaults is to delete the content folder move the datablock scripts back to the gameScripts folder, as I like to have all my non-main .cs scripts in one folder. While I understand why they were moved over to the data folder, it felt a bit "out of place" to me.
#11
If we are making radical directory changes, might as well fix the file extension stuff once and for all. Any takers?
For that matter, we should probably rename ".dso" to ".ggo" since you are not Dynamix any more.
01/22/2006 (8:55 am)
I've got a bigger change that will probably cause everyone to come unglued. Can we change the default file extension for TorqueScript files from ".cs" to ".ts" or even better, ".torquescript"? I get pretty frustrated because I need to do C# work for other projects (so Visual Studio kicks open on those), but I want UltraEdit for my TorqueScript files.If we are making radical directory changes, might as well fix the file extension stuff once and for all. Any takers?
For that matter, we should probably rename ".dso" to ".ggo" since you are not Dynamix any more.
#12
There's no reason why you can't make those changes in your personal project. Torque doesnt care what the file extension is. I think it would be extremely annoying for the vast majority of people if the official extensions were to change.
T.
01/22/2006 (1:41 pm)
@Jason,There's no reason why you can't make those changes in your personal project. Torque doesnt care what the file extension is. I think it would be extremely annoying for the vast majority of people if the official extensions were to change.
T.
#13
01/22/2006 (4:06 pm)
Changing to another extension is really easy, 6 lines of code, IIRC. We did this because of the same reason, C#. Only issue is the IDE's that are out have an issue with .ts files, but that minor.
Torque 3D Owner Tom Ogburn
Starlit Sky Games
On that note, I like it. It is much easier to find stuff and seems more logically organized.