Special Aircraft Service

Individual Mod Downloads for IL-2 1946 => SAS Essentials / Basic Mods => Topic started by: SAS~Storebror on April 25, 2014, 12:07:16 PM

Title: SAS Common Utils 1.13 [UPDATE 2021-07-14] [4.09] [4.10] [4.11] [4.12] [4.13] [4.14]
Post 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.13 (https://www.sas1946.com/downloads/essentialsas/common_utils/SAS_Common_Utils_113.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_113.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
Title: Re: SAS Common Utils
Post by: SAS~Tom2 on April 25, 2014, 02:42:18 PM
Thanks a lot Mike, I know you worked your back off the past 2 days. :)
 :D
Cheers

T.
Title: Re: SAS Common Utils
Post by: Royzewic on April 26, 2014, 05:48:09 AM
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?
Title: Re: SAS Common Utils
Post by: SAS~Malone on April 26, 2014, 08:22:39 AM
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. ;)
Title: Re: SAS Common Utils
Post by: shardana on April 26, 2014, 11:06:49 AM
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!
Title: Re: SAS Common Utils
Post by: Full Metal Jacket on April 28, 2014, 04:59:30 AM
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!
Title: Re: SAS Common Utils
Post by: SAS~Storebror on April 28, 2014, 05:03:06 AM
this mod adds an SAS approved beer tap in your favorite airplane
...but only for those doing the ride naked.

Best regards - Mike
Title: Re: SAS Common Utils
Post by: shardana on April 28, 2014, 08:13:19 AM
well i guess i'll pass then..... hahaha
Title: Re: SAS Common Utils
Post by: SAS~Storebror on April 28, 2014, 08:48:19 AM
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
Title: Re: SAS Common Utils
Post by: PO_MAK_249RIP on April 28, 2014, 10:46:37 AM
My guess would be  - if you dont know what this means leave well alone !! LOL
Title: Re: SAS Common Utils
Post by: shardana on April 28, 2014, 11:04:46 AM
I guess I'll have a cold Ichnusa, Sardinian Lager, instead..... haha
Title: Re: SAS Common Utils
Post by: Mick on April 28, 2014, 11:09:37 AM
... very nice reading Mike, but it is so hairy that even a mother cootie wouldn't find her kids ...!  :D

Definitely not for me ...  :'(
Title: Re: SAS Common Utils
Post by: SAS~Storebror on April 28, 2014, 11:31:37 AM
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
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: SAS~Storebror on June 17, 2014, 06:17:35 AM
*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:
Code: [Select]
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
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: The Radge on June 17, 2014, 06:54:54 AM
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 :)
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: OberstDanjeje on June 18, 2014, 01:47:34 AM
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 ;)
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: SAS~Malone on June 18, 2014, 05:44:01 AM
nice! :D
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: SAS~Tom2 on June 18, 2014, 06:31:44 PM
Mike aka Mister code himself. :)
Title: Re: SAS Common Utils 1.04 [UPDATE 2014-06-16]
Post by: The Radge on June 18, 2014, 06:48:14 PM
Mike aka Mister code himself. :)
No doubt! :)
Title: Re: SAS Common Utils 1.05 [UPDATE 2014-07-02]
Post by: SAS~Storebror on July 02, 2014, 03:42:40 AM
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
Title: Re: SAS Common Utils 1.06 [UPDATE 2014-07-30]
Post by: SAS~Storebror on July 30, 2014, 08:58:00 AM
*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
Title: Re: SAS Common Utils 1.07 [UPDATE 2014-09-17]
Post by: SAS~Storebror on September 17, 2014, 09:54:26 AM
*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
Title: Re: SAS Common Utils 1.08 [UPDATE 2015-06-30] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on June 30, 2015, 10:17:38 AM
*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
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on July 02, 2015, 06:41:18 AM
*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
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: bomberkiller on July 02, 2015, 06:57:50 AM
Hallo Mike,

vielen Dank!  ;)

Gerhard  :)
Title: Re: SAS Common Utils 1.09
Post by: hello on July 03, 2015, 12:36:12 AM
Thanks!
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: Katson Watson on July 09, 2015, 05:48:25 AM
Good work Mike!!!
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: just champi on December 06, 2015, 05:17:35 AM
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!
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: vulix14 on December 20, 2015, 09:54:13 PM
How does one go about installing this?
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on December 20, 2015, 10:36:46 PM
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
Title: Re: SAS Common Utils 1.09
Post by: SAS~Malone on February 03, 2016, 09:58:17 PM
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...
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: Sharkzz on March 21, 2016, 09:12:09 PM
LOL  :o 8)
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: mikojan3 on May 20, 2016, 06:19:59 PM
wonderfull job vpmodpack worked super but only with the common utils
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SPEKTRE76 on October 10, 2016, 09:04:33 PM
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.
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on October 11, 2016, 01:48:00 AM
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) (http://www.sas1946.com/main/index.php/topic,40490.msg453321.html#msg453321)


Best regards - Mike
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SPEKTRE76 on October 11, 2016, 06:53:27 PM
Okay condescending point taken.  :)


I guess I and just to low on the totem pole to enjoy a MOD.
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on October 12, 2016, 02:49:30 AM
(https://s16.postimg.cc/et75uk6at/don_t_be_a_sissy.gif)
Title: Re: SAS Common Utils 1.09 [UPDATE 2015-07-02] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: max_thehitman on October 12, 2016, 04:12:46 PM

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.


Title: Re: SAS Common Utils 1.10 [UPDATE 2017-10-27] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on October 27, 2017, 05:51:02 AM
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
Title: Re: SAS Common Utils 1.11 [UPDATE 2019-09-30] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on September 30, 2019, 07:34:18 AM
New Version 1.11 of our SAS Common Utils has been released in 1st post.

Changes:

As always, normal players don't need to update unless explicitely told so.

]cheers[
Mike
Title: Re: SAS Common Utils 1.11 [UPDATE 2019-09-30] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: Epervier on September 30, 2019, 07:58:33 AM
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!
Title: Re: SAS Common Utils 1.11 [UPDATE 2019-09-30] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on September 30, 2019, 08:55:49 AM
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
Title: Re: SAS Common Utils 1.11 [UPDATE 2019-09-30] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: bomberkiller on September 30, 2019, 08:58:55 AM
Hallo Mike,

danke Dir!

 ]cheers[

Gerhard
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on October 15, 2019, 09:20:39 AM
SAS Common Utils 1.12 have been released in 1st post.

Changes:

]cheers[
Mike
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: bomberkiller on October 15, 2019, 10:24:24 AM
Hallo Mike,

vielen Dank.  8)

 ]cheers[

Gerhard
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: Kelso on October 15, 2019, 11:56:25 AM
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'?
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on October 15, 2019, 12:12:39 PM
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
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: wave04 on December 07, 2020, 01:29:56 PM
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?
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: Epervier on December 07, 2020, 04:30:27 PM
Does the link not work anymore or am I stupid?
Work fine !
Or try : clic right... save as...
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: wave04 on December 08, 2020, 03:52:20 AM
yep the link's working again, don't know why it didn't want to redirect me before but whatever, it works now.
Title: Re: SAS Common Utils 1.12 [UPDATE 2019-10-15] [4.09] [4.10] [4.11] [4.12] [4.13]
Post by: SAS~Storebror on July 14, 2021, 05:48:49 AM
SAS Common Utils 1.13 have been released in 1st post.

Changes:

]cheers[
Mike
Title: Re: SAS Common Utils 1.13 [UPDATE 2021-07-14] [4.09] [4.10] [4.11] [4.12] [4.13] [4.14]
Post by: bomberkiller on July 23, 2021, 09:14:25 AM
Some things can never be too late:

Many thanks!

Best regards,

Gerhard                            (https://i.ibb.co/khTPgtX/Haegar-Hauwegden-Humpen.png)
Title: Re: SAS Common Utils 1.13 [UPDATE 2021-07-14] [4.09] [4.10] [4.11] [4.12] [4.13] [4.14]
Post by: Matz on August 18, 2021, 12:54:51 PM
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
Title: Re: SAS Common Utils 1.13
Post by: Griffon_301 on August 18, 2021, 01:29:57 PM
Ehm... Your game should be version 4.12.2
Or do you expect it to be v 1.13? 😳🤣
Title: Re: SAS Common Utils 1.13 [UPDATE 2021-07-14] [4.09] [4.10] [4.11] [4.12] [4.13] [4.14]
Post by: Matz on August 18, 2021, 02:36:47 PM
OK - my bad - I was thinking it referred to the Utils version. Solved . User error - going back under my stone now. o_O
Title: Re: SAS Common Utils 1.13
Post by: Griffon_301 on August 18, 2021, 02:41:19 PM
No need to... Keeping track of all the different versions of mods and tools can get difficult at times :)
Title: Re: SAS Common Utils 1.13 [UPDATE 2021-07-14] [4.09] [4.10] [4.11] [4.12] [4.13] [4.14]
Post by: SAS~Storebror on August 18, 2021, 11:37:31 PM
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