JA+ Mod V2.4 Build 7
By Slider
Date: 12-20-2011
Screenshots
Readme
******************************************
Jedi Academy Multiplayer Game Modification
******************************************
//////////////////////
Title: JediMoves JA+ Mod v2.4 Build 7
//////////////////////
Authors : Slider
E-Mail : slider744@hotmail.com
website : http://www.japlus.net/
Date Released : 16/10/2011
Description : This version of JA+ Mod is designed for Jedi Academy 1.0.1
OS : Windows and Linux and Mac
Mod Type : Server Side but capability to have client side plugin
Testing Team Leader : SiLink
Screenshots : http://www.japlus.net/screen.php
Movie Trailer : http://www.japlus.net/trailer.php
JA+ is the official name for the JediMoves.com Mod Project.
This server side Mod for Windows/Linux/Mac is designed to add cool features and enable admin commands
to help ensure your rules are respected and to make your server more configurable. This mod will not drastically change
the general feel of the game, it will simply add fun features or enhance features in order to satisfy Jedi Academy
clans. When all the new options are turned OFF, the gameplay becomes unchanged.
The main goal of this mod is to add or enhance a lot of features in a total configurable ''Plus'' JediAcademy version (that is why i called it JA+).
This is the full distribution pack. It includes the clientside JA+ Plugin as well as some helpful tools to aid server administrators.
For full documentation of the plugin itself, please download the plugin and its readme separately.
Example of features ==>
--Compatibility with all OS Windows, Linux and Mac
--Support for the New JA+ GLA animations(yes i know it adds 8Mo to the mod)
--High speed URL AutoDownload Redirect for needed Pk3 when connecting a server.
--Multiple duels at once
--Full force Duels
--Duel Isolation (Non interference)
--No Rules Alternate Dimension
--Flipkicks without altering wall run
--Admin commands + Admin Abuse Detection
--Speak mod (admin, clan and team)
--Clan Tag Protection
--Team gametypes auto-balance (teams with the same number of players)
--MultiTaunt Sound, and multiCustom player sounds.
--AutoReplier integrated working with all foreign versions of the game.
--Easy saber change without respawning
--Tons of new emotes
--Fake player name detection system based on IP detection
--All SP attacks added + completely new attacks and new DFA + SP force moves with new extended effects
--Extended Melee attacks
--New items (melee, jetpack, flameThrower,grapple hook )
--Model size scaling system
--Configurable saber Damages
--New Vote system management + AntiVoteSpam
--Capability of activating a real JK2 gameplay with moves and damages
--Profanity Filter
--Chat GOD (attack immunity while in console or chat mode) + Inactivity AutoProtect
--Highlander ffa gametype modification
--JediVsMerc mod enhancement
--Client Side Plugin for players
--RGB clothes and sabers + various saber core/line/trails styles effects.
--Extensive Anti cheat system ( Macro scan , models exploit, yawspeed....etc...)
--Client scripts that bind keys to improve accessibility and more...
--gender support for missing skins (replaced by a default male or a female model)
--JA+ BitValue calculator to compute all bit value CVars.
--BaseJKA vehicle limit of 16 modified to allow a maximum of 32 distinct vehicles to be spawned in a map.
--Maximum size of .veh & .vwp files increased to allow the loading of a lot more pk3 vehicle files (more than 50).
--JA+ server tracker for website (server info in real time, who's playing, rcon cmds, server configs....viewable in a web page)
-- JA+ sabers Support : a great saber pack included, new hilts...etc.. with extended sabers features like holstering animations and holsters model.
--Many lot of corrected basejka Bugs
JA+ is a server-side Mod which is made even better by a client-side plugin containing separate .pk3 files..
This plugin is designed to give UI, animation and feature enhancement to your client side game.
You are not obligated to install the plugins with the JA+ server side part to run a JA+ server.
This Mod contains a number of powerful admin commands that must be executed by a real human player as well as
automatic admin systems executed by the server. However, in order to be sure not to punish the wrong person or
to decrease a player's personal liberties, the automatic admin system is "light" coded. (For example the fake name detection
system will just warn players). The automatic admin system will not make the decision to kick, or ban players.
With this mod, i preferred to give full admin power and let the server owner detect admin abuse/autoBan abusers
with the admin abuse detection system. These commands are not abusive, people are.
Now if you want to abuse with those admin features, think about the fact that all players will tend to play on better servers.
There are enough servers for that.... :)
***********************************************
Quick Install
**********************************************
- just delete all pk3 files in your gamedata/japlus folder.
- then unzip this zip file into your gamedata folder. It should place all needed pk3 files into your gamedata folder. It will also create or update your japlus and base (only for the animation pk3) folder.
- then load the mod using the load mod menu of your game, or directly execute the script play_japlus.bat inside gamedata folder.
PS : the japlus_gla_anims.pk3 must be installed in BASE folder and not in japlus folder on both server and clients in order to use them.
for detailed info, go in japlusjaplus_doc
For detailed notes about the plugin, read the Plugin_readme.rtf
PS: For MAC users, all the dll are now integrated in the PK3 of the mod. You need the MAC Patch1.01E to make it working.
you can get this patch from http://www.macgamefiles.com/detail.php?item=17967
You will find a detailed MAC install howTo made by DarthZappa in japlus/japlus_doc/japlusmac-howto.zip
***********************************************
DOCUMENTATION and Tools And Distrib
**********************************************
You will find :
*** all the server distrib for windows and linux and Mac of the japlus Mod in the japlus folder.
( *.pk3 files, .so file, server.cfg and all client side scripts like admin.cfg, chat.cfg, saber.cfg)
*** all the client side JA+ plugin clientPlugin_vX.X.pk3 for windows and Mac. This PK3 can be obtained on its own, separate from this main pack. Please keep up to date on your plugins.
- in this case you will have to delete this old pk3 and replace it with the newer one.
For detailed notes about the plugin, read the Plugin_readme.rtf
*** a saber pack japlus_saber.pk3 that contains some nice sabers hilts with JA+ extensions to show what you can do with JA+ and saber moding.
Remember that both player and server have to install this pk3 if you want to use it.
but you are not obligated to install it.
** japlus_gla_anims.pk3 in base folder : a new JA+ GLA animations pack. It must be installed in base folder and not japlus folder on both server and clients in order to use them.
If a player does not have this file, he will not be able to use the new animations
if the server does not have this file the new animations will be automatically turned OFF.
*** all the documenation in several files in japlusjaplus_doc folder
** a FAQ faq.txt
** a model list with their URL so that u can find good model or skin which are configured in the model scale system like for example Yoda
*** Tools in JAplus_Tools folder:
** the BitRate Calculator japlus_bitValueCalculator.html :It will calculate the admin command disable, poll disable, lock team, force power disable,
and weapon disable, and all bit value cvars in the mod japlus.
*** JA+ server tracker monitoring for website (server info in real time, who's playing, rcon cmds, server configs....viewable in a web page)
japlus_tracker.html
It does not require any plugin or php. You just need a Website with HTML.
You can find it and use it by going on the JA+ Website (see the URL in top of the readme.rtf file) or use the japlus_tracker.html
*** Startup server file that you must move to your gamedata folder .
One of these .bat files is a secure startup that will autorestart the server if it crashes. (open it with notepad to learn how to install it)
this secure startup script is available for both windows and linux dedicated servers.
(they requiere the raven dedicated server pack that u need to dowload on the official website like
http://www.lucasfiles.com/ http://www.lucasfiles.com/index.php?s=&action=category&id=62
or http://www.jk3files.com/ http://www.jk3files.com/sort.files?game=JK3&cat=2537&ref=2536)
*** an UnOfficial patch for the windows and linux raven dedicated server pack which fix the UDP server overflow Vulnerability(which crashes the servers)
see the dedicated PATCH_ded_server1.011_readme.rtf
***********************************************
Note about the client plugin
**********************************************
-Client Side Plugin for client playing on JA+ server:
this plugins is included in the Main server side ZIP mod but can also be available as a separate file for all players.
this plugins enable players to take benefit from the UI, animation, and feature enhancement provided by the main server side JA+ Mod.
You are not obligated to install the plugins with the JA+ server side part to run a JA+ server.
For example, the grappling hook is much better if you have installed the pk3 plugin in your client game JAplus folder.
You will find all informations on this plugin in a dedicated readme provided with it.
How it works?
** in server config sv_pure 1 : you will be able to use this pk3 plugin only if the server has this file installed.
if it is the case every player will have to install the pk3 client side in their client gamedata/japlus folder in order to play on this server.
And so the server is not server side any more.
** in server config sv_pure 0 : the server remains server side. every players will be able to join your server (if they have the plugin or Nor have it)
and you are not obligated to install the pk3 plugin on the server.
the players who have the pk3 plugin will take advantage of the UI, animations, feature enhancement.
the other players won't see the difference.
the server will recognize the players who have the plugins and will make them take advantage of it to have better animation, Ui and features.
PS: in sv_pure 0, all pk3 at client side can be used by the client: SO if the client has to many pk3, he may have problem with missing textures or joining the server.
**************************************************************
Server Side
What is new since v2.3 ?
More details on each feature in the whole documentation in japlusjaplus_doc
**************************************************************
- improvement of the cvar g_teamForceBalance(3, 2 , 1 or 0 default 3) : used to balance the number of players in each team.
if > 0, in team gametype except siege, at the end of level (timelimit, fraglimit, capture limit hit...etc ), the server will balance the teams for the nextmap based on player's scores.
the 1st ranked player go in a team, the 2nd in another, the 3rd in team of the 1st player, the 4st go in the other team,.....etc.....
if 0 , this is desactivated
if 1 : default basejka value : players can't join a team if it unbalances the number of players in each team.
if 2 :same as for 1 but, when a player disconnect, it may unbalance teams. So at respawn, the youngest connected player will be moved in the other team to balance the number of players.
if 3 : same as for 1 but, when a player disconnect, it may unbalance teams. So at respawn, the lowest or the best ranked player will be auto moved in the other team to balance the number of players depending on the team scores.
- High speed URL AutoDownload Redirect for needed Pk3 when connecting a server:
this feature enable players to download with high speed the needed pk3 files (like maps, npc, vehicles, sabers...etc...) to be able to play on your server.
new cvar jp_DlBaseURL ( URL default value "" ex: value "http://www.japlus.net/japlus/" )
// jp_DlBaseURL is the equivalent to your gamedata folder.
// so if your server have a pk3 test.pk3 under the base folder and if you want people to be able download it, your Website must contain
// this file at [jp_DlBaseURL]base/test.pk3 Exemple : http://www.japlus.net/japlus/base/test.pk3 .
// remember the server will only make player download the real needed files and not all files.
// PS : Player need the lastest JA+ Plugin 1.4 or above for this feature.
// example of working redirect with a lot of maps already uploaded : seta jp_DlBaseURL "http://japlus.newboyzgaming.com/files/"
- Wall ledge Grab improvement: you now must press 2 times the Jump button to grab the wall/ledge. So the wallLedge grab feature is now much more under your entire control.
you need the lastest plugin 1.4 or above for this improvement.
- jp_startMapVoteTimer ( integer in second default 60 ) : when a level start, player will have to wait this time before to callVote. This is ideal to prevent people from calling for exemple
a change of map just at entering the level because it tend to disconnect a lot of connecting players.
- jp_maxConnFromIP (integer default 2): max number of connections per IPs. It prevent your server from beeing attacked with a fake player Denial of Service.
the use of those kind of Server attacks can lag your server (based on quake3 engine) terribly and even crash it.
Since this DoS attack program was released ( i prefer not to say where to find it for evident reason), server owners reported that some immature players are more and more
using it to lag and crash servers.
This anti fake player system has been improved compaired to version JA+2.4beta2 in order to detect the most used tools to create fake players DoS attack.
- ingame level fix Editor (for wall glitches and map holes) : It is for both rcon users and normal allowed players.
** RCON USER :
-Rcon user can allow a player to access the ingame level fix editor with BlockWallGrantEditor.
-Rcon user can draw (with red lines) all created blocking boxes with BlockWallDraw.
-Rcon user can write and save the created blocking boxes in a file directly on the server with BlockWallWrite ( *_holes.cfg files).
** A Granted selected player must go in spectator to access the following cmds in order to edit the level fixes:
-Editing Blocking Boxes: BlockWallCreate (use it 2 times to define 2 opposite point/Corner Box Point), BlockWallDel (Delete the current boxes where the player is)
-Navigating through blocking boxes : BlockWallPrev, BlockWallNext (teleport the player from one box to another)
The Mod comes with a set of files already defining several fixes for CTF maps.
- dmflags cvar improved by adding the item DF_NO_FIXED_ANIMS . It controls the ability of fixing some weakness in animations allowing player to cross map brushes
- Non interference system now supports all weapons :
Big Improvement in the Non Interference system for private duel isolation and alternate dimension :
all the missiles, weapons fires, saber throw can now cross a players if he is not in the same dimension or not in duel with the missile's owner.
- Improvement of the grapple Hook System in order to give a more realistic feeling:
the hook rope is now cuttable with all missiles and saber throw.
A fuel system has been also added. Fuel is used to repair the cut rope or when you are pulled toward your hook and when the hook is firing. The more the hook speed is high and the more fuel is decreasing.
those new feature are controllable with the dmflags cvar with the Item DF_NO_REALISTIC_HOOK.
- jp_allowSamePlayerNames : improvement of this cvar in the way it searches for already in use player names. When this cvar is 0, it also prevents players from using blank names (invisible in console and scoreboard)
- Improvement in the new attacks management (gameplay and damages).
- new nice star wars models from neomarz parametered in the modelscale.cfg
- Improvement of the /ignore cmd : it now displays the list of ignored players when you type the cmd without any arguments.
- /clansay cmd added in order to speak to the clan channel directly using the game console.
(a new UI interface for all message modes is added in the JA+ plugin interface: you must bind a new key in the JA+ control menu
Look at Plugin Readme)
- the use of /kill suicide now gives the point to the attacker.
- jp_siegeItemTime ( time in minutes default 3) : if not 0, when a player is carrying a siege item (objective), he has this time to complete this partial objective before this item returns to its initial position
- jp_userInfoAntiSpam (integer default 3) set to 0 to cancel the antispam of fast user info change. It controls the number of max fast user info changed to prevent spamming which may lead to client disconnection. When a player is trying to make a denial of service with fast user info changed, the player will be blocked. For admins, set up a higher value if you meet issues with client desynchronization with the server.
-The memory server Pool size is increased.
- A silenced player cannot change his name any more.
- Fix : basejka exploit : Several ways of hacking a server giving full control over the whole server including the ability of getting and changing the rconpassword as well as corrupting remotly pk3 files at server side. This is a basejka exploit known to exploit the call vote cmds.
This is one of the most serious exploit seen related to quake3 engine. An attacked server has to be totally reinstalled when pk3 files are corrupted.
- Fix : the dedicated server has been patched (jampded.exe and linuxjampded) using q3infoboom (win0.1.3 / linux0.1.2a) and q3unban (0.1) patches of Luigi Auriemma . It is adviced to update those files on your servers.
- Fix : the basejka exploit allowing an attacker to crash your server using a malformed forcepower string.
-Fix : the banned player exploit allowing a banned player to remotly make a Denial Of service attack with reconnecting the server until its crash.
- Fix: the jp_pushAll 2 (CTF Flags Pushable/Pullable) is now fixed. A flag that is falling into a Pit will respawn correctly.
- Fix : correction of the bugs on the / model and the sabersNotUsuable in MP when jp_allowDmgSpeedScale is On (modelScale System).
- Fix: Some of the sabers lengths in the japlus_saber.pk3 were shorter than the basejka sabers. So it is now fixed.
- Fix: amprotected players are now unprotected when doing a melee kata.
- Fix : the vehicle basejka exploit when players could become invisible to others players.
- Fix : the possibility of using emotes to sometimes get up quickly.
- Fix : the kicked player bug when spectating a bot which is auto removed by the server (bot_minplayers). This bug is an old bug and was primeraly fixed in JA+ a long time ago. But not completly as it seems.
- Fix : the basejka siege exploit that enables player to hack and activate locked doors by blocking them once they opened them thanks to the teamallow feature.
- Fix: the basejka detpack, mines, missiles exploit (when changing team or disconnecting ) allowing team kill and siege objective team hacks.
- Fix: the basejka bug for g_teamForceBalance allowing people to bypass team balance protection when spectating a player from the supposed blocked team.
- Fix : you now can use /kill when amsilenced in team gametypes.
- Fix: the basejka bug ( with g_friendlyFire ON ) preventing player from fighting against a Grip from teamate by using push/pull
- Fix: the basejka bug where a player can carry an invisible CTF flag.
- Fix: the possibility to bypass the clanTag protection in Player name.
- Fix: the possibility of engaging duel while sleeped
- Fix: the hit box of player doing a static emote is now fixed. So it is now better also when you target a player with the crosshair
- Fix: the basejka bug when player can cross map brushes because of some animations exploits. It causes many problem for exemple when player hide with the flag in CTF outside of the map area. see the updated dmflags
- Fix : the basejka siege bug when a tech class player couldn't heal (+use button) a teamate whose player slot ID was 0 (other ID was working but not the 0 one)
- Fix : when an empowered player was switching to spectator, when he was coming back to game, he was loosing some of the force powers and the force level were not at max (level_3)
- Fix : the elevator bug allowing a player to crush another player by jumping into his head when this player is in another dimension or in isolation (private duel).
-Fix ; the trace for admin guns which wasn�t starting at viewpoint for people who don�t have the JA+ Plugin. But even with this fix, the JA+ Plugin is much more accurate.
- Fix : and also many other fixes at JA+ Client Plugin which can be seen in the dedicated Plugin readme.
**************************************************************
Client Side Plugin
What is new since Plugin v1.3 ?
**************************************************************
-Support for the High speed URL AutoDownload Redirect for needed pk3 when connecting a server
Look in your game Options Menu to configure it.
You can also use the cmd /pluginDisable to configure it.
PS: Sorry for MAC user but this feature is not yet available for the MAC JA+ Plugin version.
- better plugin feature management with the /plugindisable cmd and cp_pluginDisable cvar with new config item:
Plugin_AllowDownloadURL_Redirect, // disable or enable the URL AUtoDownload Redirect for needed pk3 Files when connecting a server
- Wall ledge Grab improvement: you now must press 2 times the Jump button to grab the wall/ledge. So the wallLedge grab feature is now much more under your entire control.
you need to play on a server v2.4 or above for this improvement.
- new plugin cmd => /showPlayerID => it shows the real player id playing on the server. the basejka cmd /serverStatus is buggy when showing player ID.
- increase of the number of displayed player models icons and displayed saber hilts names in the menu.
- the plugin UI is now able to display all hidden skins : so you are not forced any more to open your pk3 files to find them.
- Improved UI for player model selection: it displays now also the model you selected in a rotation for a better look of your model :)
- some cool effects added on CTF Flags when you carry it and also when watching at a someone carrying it.
-New PLugin CMd : -ui_openmenu modsay : it brings the Interface for message mod (clansay, amsay, private talk, ampsay...etc...): Use the plugin JA+ Control menu section to bind this key.
-addition of an extension human male clothes skin pack that demonstrates shader capabilities in JKA. My close friend Show7 made this skin pack externally but it contains in particular my personal skin made by him for myself.
- Fix: player score board were buggy when player name are too large and also with kill/death info too large.
- Fix : some modded lightsabers when bolted in back could have problem of invisibility.
- Fix : the basejka bug when displaying player names in crossHair : the special chars were removed from the name.
- Fix : the basejka bug which creates a shaking screen when spectating a player which rides a vehicle and then stoping following him.
- Fix: the random client crash occurring mainly in map change.
THIS MODIFICATION IS NOT MADE, DISTRIBUTED, OR SUPPORTED BY ACTIVISION, RAVEN, OR
LUCASARTS ENTERTAINMENT COMPANY LLC. ELEMENTS TM & LUCASARTS
ENTERTAINMENT COMPANY LLC AND/OR ITS LICENSORS.
**********************************
SPECIAL THANKS
**********************************
THanks to all people who help me by finding bugs and exploits....
THanks to all servers which has installed the MOD....
Special thks to Accident the author of the first version of the BitValue Calculator.
Special thanks to Nox the admin of the main windows betaTest server for his good and appreciated help.
Special thanks to jaii der herr and Phoenix, the authors of the JK2 mod Gen-X. Phoenix game me his Duel Non interference code and also the pushAll code.
the pushAll and the duel isolation code here is based on theirs code......
Thanks to the duelers mod for the anti cheat macro scan system.
Special Thanks to Show7,Zuger SEXPrince, Freddub, #include for his great help in beta testing.
Thanks to Wraith for his MAC detailed Install note.
Special thanks to all clans that support the mod and tests it in order to help me to find bugs...
===> _SA_, [V], EDJ, SSC, AJF, DSI, JFT, [-RO-], [SEX]
Special thks also to the clan Crypt Keepers because they had the idea of a gametype that they called eliminator in which you must kill everybody and when u die
you have to wait .......This has inspired me a lot for the HIGHLANDER FFA Modification in which i wanted to make a movie like ffa mod.....(with the ghost when u die
with the quickening and also the fact that you get the force power of your victimes......etc...)
Special thanks to [ONE]Mushroom for detecting and proposing a corection for the randFloat() function in linux library.
For those who didn't know it, i use in the admin cmd lists
several ideas (that i completly recoded) from another game JK2 in a mod called "JEdi Academy MOD" made by Choosen One.
Special Thanks to Brad Oliver for the release of the MAC port of the raven SDK and also all mac users that help me in testing the mac release of JA+.
Special thanks to the creators of saber mods pack like : Hatrus, {DX}Caladien, lostingamma, Wolrajh/Xantcha, leahcim000, Covax, Slice, Dice & Mince , Magnetixxx, Ages120,
, Laghima, Charmin Deluxe and BXpress, Sephiroth__VII and KOTORMRJay , Koloth Jar, Madjai, Darth Doughnut, Scarecrow, Antizac,
thanks also to Wolrajh for all the glm holster models he made for JA+.
Thanks also to Hatrus for some dedicated saber Hilt models.
Thanks to Racer_ for his nice weapons EFX.
Thanks to keshire for his animations(flamethrower anims and the 2 melee kicks anims). Thanks also to Wudan for his Dragon tool software to make animations.
it enable me to make new animations like for exemple amkiss, and beautiful new attacks and holsters animations.
Thanks to Ask for the glamerge tool.
Thanks also to Razorace from OJP for his wall ledge grab C Code using the keshire's animations.
Also special thanks to all people helping me to detect maps holes location mostly in CTF : Invasion, AgentZed, #include, and probably many other whose i don't remember the names.
**********************************
KNOWN BUGS
**********************************
- "Info string length exceeded" error server console message : due to too many "sets" or "set" cmd in your server.cfg
use fewer "set" or "sets" cmd or use only "seta" cmd in server.cfg to prevent your server from crash.
- "sv_maxclients" can't register and keep equal to 0 which produces the eror "Bad client Number".
no panic ! it is due to the same problem as "Info string length exceeded"
remove "set" and "sets" cmd from your server.cfg by replacing them with "seta" cmd.
- when i start my game all my settings are initialized with the default? see the FAQ to solve the problem
- the New japlus death messages are buggy. Start your game dirrectly with JA+ mod loaded to solve the problem. Use the start_japlus.bat file.