[size=85]The first thing you do is slow down, remain calm and at peace, and then go step by step along this process:[/size]
Archduke Astroâs TUTORIAL FOR HOW TO USE THE PROPER uisortpos VALUES FOR MODDED CONTENT
A) Firstly, just boot up GSB and go to the shipbuilding screen where you insert modules into a given empty hull. For purposes of this guide, pick a random cruiser hull from any official vanilla race.
B) Take a good look at the order in which official vanilla modules appear when youâre outfitting that hull. That exact order in which those module icons appear is defined by the numeric value within the uisortpos variable.
C) In nearly all cases, each official module in a given category (weapons, then defenses, engines and âotherâ [crew, power and etc.] ) has its value go up by 10 more than the uisortpos value of the module whose icon appears before that other module in the grid. Are you with me so far?
D) For sake of clarity as well as preserving the sanity of other players eventually using your mod, I strongly suggest that you assign a uisortpos number to each new Mass Effect module which is a fair bit higher than all other official modules in that same category (weapons, defenses, and so forth; see section C above). Not only does this avoid graphical conflicts with the many vanilla items, but it also allows you to keep all of your Mass Effect mod items together in a single convenient grouping within each category, the icons of which which will appear on the ship-building screen after the icons of all the vanilla modules.
D) Go to each category of official modules and observe exactly which module is the last one appearing in each of the categories. Make a list on a sheet of paper which starts with the name of that category of modules, and the name of that exact module which appears in last place at the bottom of each grid. Got that? You will ultimately need three separate lists, really â one each for fighter-sized hulls, one for frigates, and one for cruisers. This guide will stick to using the cruisers as an example.
E) Youâll now need to shut down the game.
F) Open up your GSB installâs main directory and find the âdataâ folder.
G) Then open the âmodulesâ folder within the âdataâ folder.
H) Scan down the lines until you find the individual textfile with the identity/filename (theyâre not always 100% obvious) of that same module which appears in last place within the first category of all official modules.
I) Open the textfile via the text-editor program of your choice.
J) Carefully scan down through the many attributes within that moduleâs textfile until you find that uisortpos value. The names of the attributes are generally in alphabetical order, though not always â so youâll generally find your goal near the bottom of a module textfile. All official uisortpos values are in the form of a four-digit number; NO DECIMALS (whole integers only).
K) Write down that number on the sheet of paper, next to the corresponding module.
L) Close the textfile after making sure you havenât accidentally typed anything into it, or worse: typing something and accidentally saving the darn file (youâll screw up your game if you did, lol).
M) Repeat steps H through L for each of those âlast-placeâ modules in the other main module categories.
N) When done, you will then have a master list of the uisortpos value which is the highest official value used within each module category.
O) Yet again, I strongly advise that you start from that highest official number per each category, and add a âbufferâ to it so that your very first Mass Effect mod item in that same category is somewhat higher.
âŚO-1) For exampleâ in the cruiser weapons category, the Cruiser Target Painter is at 1210, and itâs followed by the Cruiser EMP Cannon at 1220.
âŚO-2) 1220 is the highest uisortpos value used for any official cruiser weapon in the game.
âŚO-3) When adding your first Mass Effect mod weapon for cruiser hulls, start its uisortpos to be at least 1300 or higher.
âŚO-4) Give your second Mass Effect cruiser weapon uisortpos = 1310; the third, 1320, and so on. Just add 10 to the number of the one before it, and keep going.
âŚO-5) Keep careful track from your paper list exactly where that last official uisortpos is for the next module category in line, and then repeat steps O-1 through O-4 until youâre all done adding new all-original Mass Effect cruiser-sized stuff to GSB.
Congratulations; youâre done.
===================
Iâm tired as hell and am therefore now stumbling directly to bed.
If you encounter anything in this guide that youâre not sure of or does not seem to look like what a given step described for you, just stop where you are and nicely ask someone whoâs awake for a clarification. If I goofed-up a step due to lack of sleep, apologies in advance. I drafted all of this from memory so it is theoretically fallible, but I think that the logic of the guideâs workflow will work as advertised.
If Darkstar or any other learned colleague of mine has an error to point out, I will gladly make the necessary correction(s) before copying this tutorial into the Modding 101 Guide.
[size=85](âŚHa-ha-ha; I now see itâs MY turn to be ninjaâd. Sleepy typing is slow typing. Good night! )[/size]