Special Aircraft Service
Individual Mods and Packs for IL-2 1946 => SAS Essentials / Basic Mods => Topic started by: SAS~Storebror on April 25, 2014, 12:07:16 PM
-
Dear Members,
This is the so called "SAS Common Utils" mod.
For the moment you don't need to install this mod unless you're explicitely asked to do so (e.g. from installation instructions of some other mod which depends on this basic mod).
Download Link for "normal" Users:
SAS Common Utils 1.15 (https://www.sas1946.com/downloads/essentialsas/common_utils/SAS_Common_Utils_115.zip)
Installation Instruction:
Extract the file.
Copy the contained folder "! SAS Common Utils" to your modded games folder, whatever it's name may be, e.g. #SAS, #WAW, #DBW, #UP# or just MODS.
Copy the contained file "SAS Common Utils.dll" to your base game folder (that's where il2fb.exe is).
For modders / Java Coders only:
When you use this mod you have to point your users to this thread once you release a mod relying on the SAS Common Utils.
Please do not ship the SAS Common Utils together with any other mod. Let's keep them here in one place, otherwise we can't ensure that everyone is always using the latest version.
All public interfaces are "final" and will not change in the future, only additional content may be added and implementations might differ.
This is the jar package of the SAS Common Utils, you can add it to your java project like you do with base game classes too:
https://www.sas1946.com/downloads/essentialsas/common_utils/SAS_Common_Utils_115.jar
This is the regarding documentation of the SAS Common Utils API:
https://www.sas1946.com/downloads/essentialsas/common_utils/doc/
End of modders / Java Coders only Block
Best regards - Mike
-
Thanks a lot Mike, I know you worked your back off the past 2 days. :)
:D
Cheers
T.
-
is this means i can use mods, what are made for only 1 mod pack(like HSFX or any other) and with this i can use it good with any other mod packs like SAS?
-
no, it means nothing like that.
please read the first post, specifically this part - For the moment you don't need to install this mod unless you're explicitely asked to do so
so, it will not do anything like magically make a mod work on a version that it didn't work on before...
my advice is to not even use this mod unless you are specifically instructed to. ;)
-
Mike I hate you, now I'm burning with curiousity..... please someone post a mod that requires this strange mod so we can understand a little more....
hahaha only joking, thank you, I'm sure it must be something very useful anyway. ciao!
-
Mike I hate you, now I'm burning with curiousity..... please someone post a mod that requires this strange mod so we can understand a little more....
hahaha only joking, thank you, I'm sure it must be something very useful anyway. ciao!
this mod adds an SAS approved beer tap in your favorite airplane ;D have fun!
-
this mod adds an SAS approved beer tap in your favorite airplane
...but only for those doing the ride naked.
Best regards - Mike
-
well i guess i'll pass then..... hahaha
-
To all of you who are that keen to know what this is all about and for those who have some Java knowledge, you can have a very first glance at it in the Documentation provided in the first post of this thread.
It's no User Documentation, just for Modders.
As a matter of fact there will be no User Documentation despite the usual "how to install? Drop into your MODS folder" thing as this mod is primary a mod created to make life easier for modders.
Best regards - Mike
-
My guess would be - if you dont know what this means leave well alone !! LOL
-
I guess I'll have a cold Ichnusa, Sardinian Lager, instead..... haha
-
... very nice reading Mike, but it is so hairy that even a mother cootie wouldn't find her kids ...! :D
Definitely not for me ... :'(
-
Yep that's what I said. If you're not into Java it will tell you nothing.
Basically it makes life easier for Java coders and if one of them utilizes this mod, you'll have to install the user version of the mod to your game in order to be able to run those mods.
Time will tell but it's really no big deal from "Joe User"'s point of view.
Best regards - Mike
-
*bump*
Updated version 1.04 available in first post.
ATTENTION MODDERS:
You'll love this once you tried it, trust me.
This version brings the good old method "weaponsRegister" back to life.
You know what I'm talking about? The one which can be found in many aircraft classes, e.g. like this:
weaponsRegister(class1, "default", new String[] { "MGunBrowning50si 250", "MGunBrowning50si 250", "MGunBrowning50k 250", "MGunBrowning50k 250" });
Unfortunately with IL-2 1946 this method was removed and replaced by an empty method, that's why many modders would have to rewrite their weapon slots manually, which means that the above mentioned single line of code would be bloated to 20-30 lines of java code, which repeats for each and every weapon slot on each and every modded aircraft unless you know how to do the proprietary "cod" type encrypted weapon compilation.
This is history now. Since version 1.04 the SAS Common Utils introduce the class "AircraftTools". This class contains the method "weaponsRegister" which acts exactly like the old stock method, plus it adds the possibility to precede each weapon definition by it's desired trigger index.
Questions? Just ask.
Best regards - Mike
-
Yeaaaah Mike, that is very cool, thanks a lot!
I just learned now how to make classes and know what are you talking about - weapons register!
Thank you again, this old method will reduce the class weight significantly :D :)
-
Wow, Mike, this is great.
I'm not a Java programmer but I know something about programming and those API are great.
Just BaseGameVersion class Worth 1000 thank you ;)
-
nice! :D
-
Mike aka Mister code himself. :)
-
Mike aka Mister code himself. :)
No doubt! :)
-
New version 1.05 release in first post.
Just minor changes to the Javadoc comments in this version since the previous version 1.04 contained some explanations which were plain wrong.
Best regards - Mike
-
*bump*
New version 1.06 available in first post.
This version fixes a nasty typo in the "AircraftTools" class which caused weapon loadout assignments to fail.
I urge all users of the SAS Common Utils to update to the new version.
Best regards - Mike
-
*bump*
New version 1.07 available in first post.
This version fixes a bug in the "AircraftTools" class for aircrafts with empty ordnance option (i.e. no weapons, no triggers, no hooks).
I urge all users of the SAS Common Utils to update to the new version.
Best regards - Mike
-
*bump*
New version 1.08 available in first post.
This version allows modders to query the currently used IL-2 Selector Version from within the running IL-2 game.
Best regards - Mike
-
*bump*
New version 1.09 available in first post.
This version fixes a glitch where the game might throw errors in special situations when you updated the Common Utils but use an outdated IL-2 Selector.
Best regards - Mike
-
Hallo Mike,
vielen Dank! ;)
Gerhard :)
-
Thanks!
-
Good work Mike!!!
-
Now that I've finally tested... and checked what was all about...
BIG thank you for saving us so much time, and making our life easier with such a great tools!
Thanks!
-
How does one go about installing this?
-
Just drop the "! SAS Common Utils" folder, which you find inside the downloaded zip file, into your game's mod folder.
That folder can have several names depending on your game version, e.g.
#DOF, #WAW and #JTW for C.U.P.
#SAS for Modact 3/4/5/6
#DBW for DBW
#UP# for Ultrapack 3
MODS for Modact 2, HSFX 4/5/6/7 and Ultrapack 2
Best regards - Mike
-
seriously?
warning number 2 coming your way for posting completely irrelevant, OT stuff in a mod thread.
use the Lounge area if you want to post up any old rubbish, do NOT use a mod thread.
you are now at 50% warning level - you have one more warning in hand. use that one up, and you won't be able to post again, at all.
might be some kind of record for quickest amount of warnings for a new member....
tread lightly, is all i can say...
-
LOL :o 8)
-
wonderfull job vpmodpack worked super but only with the common utils
-
I downloaded the Jugs Reloaded pack. I did what it said to do with the air.ini file. But where the heck do I drop the "SAS_Common_Utils_109.jar" file? The game just starts and then crashes back to desktop.
-
where the heck do I drop the "SAS_Common_Utils_109.jar" file?
Ask yourself whether you're really a Modder / Java Coder or rather a Normal User:
(https://s18.postimg.cc/ug3w0qxe1/common_utils.jpg) (https://www.sas1946.com/main/index.php/topic,40490.msg453321.html#msg453321)
Best regards - Mike
-
Okay condescending point taken. :)
I guess I and just to low on the totem pole to enjoy a MOD.
-
(https://s16.postimg.cc/et75uk6at/don_t_be_a_sissy.gif)
-
Name your folder file to
! SAS Common Utils
It should be placed inside your #SAS folder, and with this name it will show up in first order.
-
New Common Utils Version 1.10 available in first post.
Users only need to update in case they are using dedicated mods created after this release date.
BAT users don't need to do anything at all, the BAT developers will take care to keep you up to date.
Modders will want to update the next opportunity.
Documentation has been updated too, deprecated methods have been removed from the documentation (to avoid confusion) but are still part of the classes themselves.
TL;DR: Update if you want. SAS Common Utils don't create any conflict with any base game class or mod, therefore installing or updating them is always safe.
Best regards - Mike
-
New Version 1.11 of our SAS Common Utils has been released in 1st post.
Changes:
- The BaseGameVersion class has been updated to reflect latest changes to our newer IL-2 Core versions.
- There's a new "CommonTools" class available, holding a couple of useful methods e.g. to convert values from one range to another (like the "Aircraft.cvt" method found in certain stock game versions, just a little more sophisticated) and checking strings for similarity/"distance" to each other.
For details, Java Coders will want to refer to the corresponding JavaDoc pages of the new CommonTools class (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/index.html?com/maddox/sas1946/il2/util/CommonTools.html).
As always, normal players don't need to update unless explicitely told so.
]cheers[
Mike
-
Thanks you very much !
But I have little question : Does Class CommonTools replace Class CommonUtils (used by He-177) ? :-|
[Edit]
I don't think so!
They are very different!
These two Classes have nothing in common!
-
Exactly Gabriel.
The class "CommonUtils" has once been made for the He-177 as a kind of predecessor to the SAS Common Utils.
Due to the fact that this class existed, and since we care a lot for backward compatibility, you will never find a class with the same name and package in our SAS Common Utils.
]cheers[
Mike
-
Hallo Mike,
danke Dir!
]cheers[
Gerhard
-
SAS Common Utils 1.12 have been released in 1st post.
Changes:
- New "equals" methods in "CommonTools" class, useful for comparing floats and doubles for equality.
You may ask "why", but just face the fact that "==" and "!=" don't give reliable results for floats and doubles. - New methods "getTimeZoneBiasHours" and "getTimeZoneBiasMinutes" in "CommonTools" class.
These methods can be used to gather information about the local timezone of the PC running the game - this information so far was inaccessible from within the IL-2 Java VM. - New Class "FileTools" holding "isSymbolicLink" and "resolveSymbolicLink" methods.
These methods give limited SymLink awareness to our trusty/rusty game, where the Java VM used by IL-2 doesn't provide such functionality. - New Class "HighPrecisionTimer" can be used to measure timespans less than one millisecond, useful e.g. for net packet synchronization.
- New native DLL "SAS Common Utils.dll", belongs to the base game folder, holding native code to overcome limitations of the IL-2 Java VM.
]cheers[
Mike
-
Hallo Mike,
vielen Dank. 8)
]cheers[
Gerhard
-
Maybe not a good place but I will ask ...
Does Java Wall fix only work in version 4.12.2?
Is there a chance that Java Wall fix will be made public as a separate 'mod'?
-
Indeed totally unrelated, anyway...
Does Java Wall fix only work in version 4.12.2?
No, it's independent of the game version.
Is there a chance that Java Wall fix will be made public as a separate 'mod'?
Impossible as you need to touch Java Code all across the set of base game classes, there's no way to isolate certain "Java Wall Fix" mod classes from other untouched core classes.
]cheers[
Mike
-
Does the link not work anymore or am I stupid? I click it, a new page opens, it lingers for a second, closes itself, no new downloads appear. Is there another link?
-
Does the link not work anymore or am I stupid?
Work fine !
Or try : clic right... save as...
-
yep the link's working again, don't know why it didn't want to redirect me before but whatever, it works now.
-
SAS Common Utils 1.13 have been released in 1st post.
Changes:
- New updateExternalWeaponHooks (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/AircraftTools.html#updateExternalWeaponHooks-com.maddox.il2.objects.air.Aircraft-) method in AircraftTools (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/AircraftTools.html) class, useful for keeping external weapons on wing stores visible during wing folding operation.
- A premature logging issue in SAS Common Utils.dll has been fixed.
]cheers[
Mike
-
Some things can never be too late:
Many thanks!
Best regards,
Gerhard (https://i.ibb.co/khTPgtX/Haegar-Hauwegden-Humpen.png)
-
Greetings Mike,
I have updated Common Utils to version 1.13 but checking by logfile (for a separate query) I have noticed it says:
SAS Common Utils Game Version = 4.122
I have re-downloaded and reinstalled - still have 4.122. All the files seem correct and in the right place: Folder in #SAS and the dll file in the main folder (the dll file shows as created 14 Jul 21 and modified 24 Oct 19 !?! - but I guess that is a Windows thing).
Is this just a "feature" ? (Everything appears to be functional btw)
Cheers
Matz
-
Ehm... Your game should be version 4.12.2
Or do you expect it to be v 1.13? 😳🤣
-
OK - my bad - I was thinking it referred to the Utils version. Solved . User error - going back under my stone now. o_O
-
No need to... Keeping track of all the different versions of mods and tools can get difficult at times :)
-
I’m sorry for the confusion.
That log line was intended to show the Stock base game engine as it’s being detected by SAS Common Utils.
This was to fight teething issues where users pretend to have installed everything “to the letter” and months later we figured that they didn’t even start from the right Patch Level.
]cheers[
Mike
-
SAS Common Utils 1.14 have been released in 1st post.
Changes:
- New getFileSizes (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.html#getFileSizes-java.lang.String-java.lang.String-boolean-) method in FileTools (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.html) class.
This class improves scanning folders (and subfolders, if requested) for files and their corresponding file sizes, i.e.:
* In contrast to Java's File Class, this method deals with Symbolic Links, Junctions and other kind of reparse points accordingly - Java's File Class treats reparse points as files of 0 bytes erratically.
* Scanning speed is much improved (appr. 10 times faster) since instead of scanning file by file, this method queries the underlying file system information blockwise instead.
* All known file system types are being dealt with accordingly, even if it's a file system remotely mounted from a network share. - New FileSizeRecord (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.FileSizeRecord.html) Class corresponding to the new getFileSizes (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.html#getFileSizes-java.lang.String-java.lang.String-boolean-) method.
- Javadoc and compiler levels have been updated to current versions.
]cheers[
Mike
-
SAS Common Utils 1.15 have been released in 1st post.
Changes:
- New getFileSizes (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.html#getFileSizes-java.lang.String-java.lang.String-boolean-boolean-boolean-) method added to FileTools (https://www.sas1946.com/downloads/essentialsas/common_utils/doc/com/maddox/sas1946/il2/util/FileTools.html) class which returns the list of files found in sorted (case sensitive / insensitive selectable) order.
- Error handling improved, getFileSizes now internally checks folder names and scan patterns for invalid characters and returns an empty list of files found in case of any error (instead of crashing the game)
]cheers[
Mike
-
Thank you very much, Mike 8).
Best Regards,
Piotrek
-
A very noob question....but I'm starting a fresh installation for my new rig and I'm trying to build it with inside BAT 4.2.2hf4 , UP 3.4 , HSFX 7.03 , (maybe VP) and TOAS....have I to install last common utils in each one or not?
-
BAT4.2.2 and UP3.4 have common utils by default In the other install it may be useful for specific mods
-
You only have to install SAS Common Utils manually if a mod explicitly asks you to do so.
As mentioned by Frankiek, BAT and UP3 ship with suitable versions of the Common Utils.
You can, however, update your Common Utils to the latest version in this thread at any time if you want to.
That's because we do care for compatibility: No newer SAS Common Utils version will ever break a game, whether or not any version has been installed to the said game before.
]cheers[
Mike
-
Thanks Mike and Frankiek!
Got it!