==================================================
=               CLAN MOD UNLIMITED               =
=------------------------------------------------=
=      UNLEASH THE FULL POWER OF THE FORCE!      =
==================================================

Alright, since apparently people liked my mod =^_^= I've gotten around to making a Clan Mod version.  This version is intended for use with Clan Mod v1.19.  Any earlier or later versions may or may not function properly; either may crash, and later versions are likely to be missing features if this version of the mod is used.  I will try to keep up with Clan Mod releases as they come out, but if I fall behind, feel free to email me and let me know.  I don't play Clan Mod (in fact, I barely play MP at all) so I'm quite likely to miss any updates that are made.

Note that this mod requires the latest version of Clan mod, version 1.19.  It may or may not work with any earlier versions; trying to do so may well cause a crash.  You can get the latest version of Clan Mod from http://clanmod.org/forums/viewtopic.php?f=7&t=369

==================================================

So what is Clan Mod Unlimited?

Well, I can tell you straight off that it's no where NEAR as cool as it sounds.  All this does is extend the capabilities for Jedi Academy (Multiplayer only) to handle models and other addons - it removes limitations; thereby, Jedi Academy becomes "unlimited."  In all truthfulness, the name is probably a little misleading... but who ever said cool names represented cool things, right?

There was a mod released a long time ago for base JKA in the filefront forums that was supposed to do the same thing, but by the time I found it, it had disappeared.  Besides which, when I actually tried the method that the author posted, it was incomplete, and didn't function fully as promised, so I decided to redo it my own way, and ended up taking it a little farther.

This version coincides with my base JKA version 1.1, which added support for unlimited maps, unlimited .vwp extensions, and unlimited species (customizable characters).

==================================================

OK, but what does it DO???

It does a number of things:
-It removes the limit on pictures displayed in the profile menu, so no matter how many player models you have in your base folder, ALL of them will show up in the selection menu.
-It removes the limit on the number of species (customizable characters) you can have, which was previously 32.  
-It removes the limit on the number of sabers that show up in the selection menu, so, again, no matter how many sabers you've downloaded, they should all show up there.
-It also removes the annoying limit on the number of sabers you can HAVE.  Previously, if you were over the saber limit, not only would your saber not show up in the saber selection menu, but it wouldn't even be obtainable through the console.  No longer an issue.
-It removes the limit number of maps available to you.
-It removes the limit on .sab files.  You can have as many and as large of .sab files as you choose to have now.
-The same goes for .npc files - have as many as you like, there's no longer a need to delete the .npc file from a model to keep it in your base folder.
-And, surprise surprise, it removes the limit on .veh files, as well!  I know that part's already been released in a separate mod, but, unfortunately, there's no way to make the two mods compatible, so this mod handles that, as well.
-And as if that wasn't enough, it even removes the limit on the .vwp (vehicle weapon) files!

I've also included an optional mod that will decrease the size of the pictures in that menu so that you can scroll faster - if you're like me, you have well over 200 models and skins to choose from, not counting team skins, and scrolling through pictures in a 6x3 box takes a while.  Thumbnailshrink_clanmod.pk3 will reduce the pictures to half size, displaying a 12x6 box instead of a 6x3, and, for those of you with a tiny fetish, thumbnailshrink_clanmod_more.pk3 will take it even further and display your icons in a 16x8 box.  If you'd prefer not to have the thumbnail size changed, simply leave both of these out.  If you install them both, it will default to 16x8.

Since Raven hasn't released source code for SP, and probably never will, this mod is MP only.  Most of it isn't needed in SP, anyway, but the problems of not being able to access some of your sabers if you have too many is still there.  This also applies to oversized .npc/.sab/.veh/.vwp extensions, so you will probably have to take some of your files out of your base directory if you want to play SP again.  There are ways to keep separate folders for SP and MP without having two copies of the game, but this readme isn't the place to put them, so email me if you'd like some help with it. =^_^=

==================================================

Sounds great.  How do I install it?

Easy!  Simply open up the zip file and dump z_ja_unlimited.pk3 into your ***clanmod*** folder (not base), and optionally include thumbnailshrink_clanmod.pk3 or thumbnailshrink_more_clanmod.pk3 with it.  If you place the file in your base folder, it WILL NOT WORK with Clan Mod, and may cause base JKA to behave strangely. (Most likely, that means "to crash".) Then start up JA, and you're done!

==================================================

And now, the ****important**** disclaimer/bug report:

The makers of Jedi Academy put a limit on the number of models and sabers shown for a reason: namely, the more data the game has to load, the more memory it takes up, and the more data you want to ALLOW it to load, the more memory you have to reserve, so Raven's decision to put these limiters in place was made for a reason.  It's fine if you're just seeing pictures and names, but even on an extremely high-end PC, it causes memory build up.

You know those times when you're loading a game and it says "Awaiting snapshot..."?  From what I've been able to tell from experimenting and looking over the code (though I only looked at that section in passing, and don't think it's worth the time to try and actually follow it), that is the point when all of the models you've looked at are cleared from memory.  And so, the more things you look at, whether it be sabers, models, species, or whatever, the longer it takes to load the next level.  I once looked at every single saber I have in my base directory in one sitting; loading the next level took about 5 minutes, and my computer is, to be honest, quite a monster.  So those of you with slower computers, beware, for you may end up sitting through some VERY long wait times.

Other than that, I haven't noticed any adverse effects, but, like I said, my computer is extremely high-end.  I can make no guarantees that your computer will continue to run smoothly under these conditions.  It's most likely comparable to overclocking - you get more out of your hardware, but you also strain it more, so it can potentially cause problems, but probably won't if you do it properly and carefully.  Nevertheless, if your computer crashes, or you are forced to restart due to looking at too many sabers all at once, I take no liability or responsibility for any data or hardware that is damaged or destroyed.  You have been warned, use at your own risk, and use responsibly.

Also of note: With this, you can now have a virtually unlimited number of mods. (I say virtually because there IS still a cap, but hopefully it's been increased enough that no one will ever get to it... if you do, that's what email is for, I'll make an updated version for you.)  As with all good things, this carries a downside, as well.  If you exceed a certain number of .pk3 files in your base directory, you will not be allowed to create a pure server - you'll be kicked out of it, with an error saying you referenced an "invalid .pk3 file."  Because of this, this mod automatically turns off pure servers, and you won't be able to start a game if you enable that option.  This isn't related to the mod in any way except that the "unlimitedness" opens an option to have that many .pk3 files.  And if you have enough files to get that error, you won't be joining any pure server other than your own, anyway, so it's not a big deal.

Finally, I'm obliged to state that I am not affiliated with LucasArts, Raven, Activision, or any other company affiliated with Star Wars: Jedi Academy, and this mod is neither supported nor endorsed by any of the so mentioned entities.  Star Wars, Jedi Academy, and all related trademarks belong to their respective companies, all rights reserved.

==================================================

As for credits, I would like to thank }HOK{ Deathspike.  A small snippet of code he posted back in 2005 went a long way toward guiding me to the changes that needed to be made, even though I didn't use any of it in the long run, save one line.  If nothing else, it was enough of a start to get me at least a little bit familiar with the file structure of JA's source code, and that can make a big difference in the time it takes to get something like this accomplished.  I would also like to thank Newage and the developers behind Clan Mod.  A great deal of code presented with this is theirs entirely; it's just a set of modified .dll files built from the code they released, which adds in the features of JA Unlimitation.

==================================================

So, I hate your mod, it blew up my computer, and now I want to yell at you in person over it.  How do I do it?
 -or-
I'd like to thank you for your mod.  How can I contact you?

To the first group of questioners:

I live at the bottom of the nearest cliff to you that is at least a 50-foot drop and has sharp rocks at the bottom.  You can only reach me by car; please drive straight off the cliff, and I'll catch you at the bottom.  Promise!!! >.>

To the second group:

You can email me at kasu.dorepa@gmail.com.  Questions, comments, bug reports, feature requests, and constructive criticism are all welcome.

==================================================

Thanks for trying my mod, and I hope you enjoy it!  Hopefully this will ease the concerns of a lot of people, particularly now that the mod from the forums isn't available anymore.
Perhaps some day I'll get around to finishing that map...

=^_^=Kat Angel=^_^=