Jedi Academy
Reloaded™

Overview

This mod is the official mod for the Jedi Academy. A server-side only modification designed to keep the peace and order on the servers. With that in mind, I set out and improved this mod with the way I wanted it to in the past. It's loaded with Admin Commands, Client Commands, Options, and cVars; Extremely modified to meet any clans expectations. This is truly the only mod you will ever need to use that doesn't alter the normal gameplay of Jedi Knight: Jedi Academy® Please visit us at http://www.thejediacademy.net, http://jamod.jk3files.com or chat with us on IRC at #jedi-academy or #ja-reloaded @ irc.quakenet.org.

1.4 - Final

• ---New Features---
• Return of Protect from the Jedi Academy Mod.
• Added amdmginfo which will display if the servers run a modified damage setting from basejk.
• Added ProtectGun/UnprotectGun.
• Added duel time to the Private Duel Stats, is in the format mm:ss.
• Added amteleme/jkteleme - teleports the admin who executed the command to the given x,y,z,yaw coordinates.
• Added amffduelchallenge, to allow for Full Force Private Duels.
• • Players in duel do not do damage, or absorb health/force when using force to any none dueler near them. The same goes for non duelers using force near two Full Forcer duelers.
  • Player not in a duel do not do damage, or absorb health/force when using force, and are near FF duelers.
  • g_mFFPrivateDuels MUST be set to 1 to use.
  • Recommended to bind amffduelchallenge to a key.
  •  
• Added a few emotes: amsit, amsit2, amwait, amjig, and amquiet. Enabled/Disable emotes with cVar.
• Added commands to add/removed and list both the Profanity List and Bad Names List.
• • maddprof, mremprof, mlistprof, maddname, mremname, mlistnames
  •  
• Extended the use of g_mDuelStats CVar, setting it to 1 shows stats to only the two duelers, setting it to 2 shows stats to all players.
• Extended the profanity filter that allows for it to be applied to names, using a cVar to enable the extention.
• Extended the use of the \tell command. It can now take in player's names instead of just client ids.
• Removed the g_mFlipKick, until I decide if I want it back in and 100% working.
• Removed mvstr, due to extreme exploit that existed in the command.
• Improved damage issues found in Linux and Windows servers.
• • The Linux version is now compiled with the tools used by Raven to make the base jampgamei386.so
  •  
• Improved kick and kick ban, made the <reason> argument optional, if a reason is not given the kick message cVar value is used instead. The client is notified that they are about to be kicked, and a CVar controlled time delay will show them the warning for that many seconds and count down, then kick them.
• Added an alias so admins no longer have to bring down the console to do amsay or mpsay.
• • To do mpsay from the chat modes, simply use the team chat mode, add a @ to the front of the message. example: "say @ hi admins" With out the "" and there MUST be a space after @.
  • To do amsay from the chat modes, simply use the normal chat mode, add a @ to the front of the message. example: "say_team @ hi admins" With out the "" and there MUST be a space after @.
  •  
• Fixed projectile deflection, thanks to Andrew "Mushroom" Kerr, for the fix.
• Fixed issue in Profanity Filter where it would filter out words like, "class", "bass", "Good Fight", "^1class".
• Fixed bug in Profanity Filter where it would no filter curse words with multipule colors.
• Fixed the bug with g_mAllowTeamSuicide not letting player \kill with this set to 1.
• Fixed the bug where doing "\ignore all" or "\mrename all <name>" would crash the server. Those commands are not ment to be used with the keyword 'all'.
• Fixed wall grab bug, where doing a grab on a incline would cause the player to slide up the surface.
• Fixed bug in a few commands where not giving all the arguments would cause a full screen message to still be printed.
• Fixed basejk bug with voting that cause to overwrite the lockteam values, so locking teams seemed to be broken.
• Fixed bug with sleep, where the player would not be ejected from a vehicle. Thanks to cHoSeN-oNe.
• Fixed bug with \ignore, someone not being ignored and just doing '\ignore' ignoring a random person.
• Fixed bug with spectators not being kicked until they leave spectator.
• Fixed bug where admin specing another player would result in message to admin been shown to person they are specing.
• Fixed bug where the locking and unlocking of a team would not be broadcasted to everyone in the server.
• Improved random team picking.
• Improved the wampa sounds. Thanks to cHoSeN-oNe.
• Players cannot change their names when they are silenced.
• Updated jar_admin.cfg to reflect the new admin gun additions.
• Made the number of vehicles to 64.

• ---New Cvars---
• g_mSilentWhois - To control whether admin's see who is logged in or both clients and admin's.
• g_mNoAdminSpec - Allows for clients to not spec admins.
• g_mMessageUnProtectEveryone - Message to broadcast when unprotecting all.
• g_mMessageUnProtectBroadcast - Message to broadcast when uprotecting a client, seen by all.
• g_mMessageUnProtectTarget - Message to broadcast when unprotecting a client, seen only by the client.
• g_mMessageProtectEveryone - Message to broadcast when protecting everyone.
• g_mMessageProtectBroadcast - Message to broadcast when protecting a client, seen by all.
• g_mMessageProtectTarget - Message to broadcast when protecting a client, seen only by the client.
• g_mDuelDistance - A value for how far the Duelers can get away from each other before the duel is broken.
• g_mFFPrivateDuels - Allows for Full Force Private Duels.
• g_mEmotes - Sets the allowed emotes for a server, using a bit mask value. Just like the g_mKnightCommands and g_mAdminCommands CVars.
• g_mPushItems - Allows Clients to push/pull all items, brought over from JA Mod.
• g_mProfCheckNames - Check names from a list of 'bad' names. From a file badnames.lst
• g_mSwitchTeamTime - Allows for the adjustment for how long before a client can switch to a different team.
• g_mNameChangeTime - Allows for the adjustment for how long before a client can change their name.
• g_mKickDelayTime - Time to delay before the player is kicked.
• g_mKickMessage - The default kick message if a reason is not given.
• g_mMaxDetandMine - The number of Dets or Mines that can be placed before they start to disappear.

• ---Misc Info---
• Added an Bit mask Calculator for enabling and disabling of admin commands, and emotes. Works with all versions of JAR.
• d_saberGhoul2Collision, d_saberAlwaysBoxTrace, d_saberBoxTraceSize, are once again cheat restricted, seemed to be a player in the damage issues.
• More new features and a restructuring of the admin system coming in next version.
• !version now displays the build date of the MOD.
• Modified how amsay is displayed to admins. ^3(name^7[rank]:^3) ^5message is the new display format.

1.3

• ---New Features---
• All debug... moves are now cheat restricted.
• Same name restriction.
• Full Damage control for Saber, Fighting, and Weapons.
• xMod Profanity Filter - courtesy of X Master Hex.
• Improved Empower vs. Terminator game play.
• Optimized code.
• Improved Documentation.

• ---New Cvars---
• g_mNerfBacta - cvar to control changing health regeneration for bacta and large bacta.
• g_mBigBactHP - the amount of health regeneration using the Large Bacta Canister.
• g_mBactaHP - the amount of health regeneration using the Default Bacta Canister.
• g_mAllowBotLimit - cvar to control allowing a certain amount of bots on server with human players.
• g_mMaxBots - the max bots allowed on a server at a given time, before g_mMinHumans is reached.
• g_mMinHumans - the minimum amount of humans allowed on the server at the same time as bots.
• g_mAllowTeamSuicide - this cvar controls the use of the \kill during team gameplay.
• g_mAllowDuelRegen - cvar that controls the use of separate force regen time for private duels only.
• g_forceRegenTimeDuel - the amount of force regen time in private duels only.
• g_mFlipKick - enables the use of JK2 Flip Kick.
• g_mMeleeDMGSwing - your damage level for melee combat.
• g_mLogDuelStats - cvar to control whether your server logs the stats or not.
• g_mNerfDamage - cvar that controls use of Saber/Fighting/Weapon Damage CVars.
• g_mProfanityCheck - Enforces the profanity filter.
• g_mProfReplace - String to replace the offensive text.
• g_mWarnings - Warnings before kicked from excessive profanity.

• ---Cvars no longer cheat enabled---
• d_saberGhoul2Collision
• d_saberAlwaysBoxTrace
• d_saberBoxTraceSize

1.2

• AdminGun enabled
• Major code tweaks
• Fixed memory leak which caused random crashes using the kick command.
• g_mSTFU - If enabled, will silence chat on Duel and Power Duel game modes.
• All game modes enabled from JK2.
• Empowered vs. Terminator enhanced gameplay.
• Server Admin's can now pick and choose what commands they wish to allow their “am” and “jk” level admin's to use.
• g_mAdminCommands - cVar bit value to determine which “am” commands are allowed for their admin's.
• g_mKnightCommands - cVar bit value to determine which “jk” commands are allowed for their knights.
• rcon admin can always execute the commands even if they are disabled to other admin's.
• aminfo - now prints commands that are accessible to admin, instead of just commands in the mod.
• amhelp - now prints commands help to the admin's pending if they are accessible to them.
• New IP Range Banning Admin Command ( mbanrange)
• g_mDebugEmpower - Will enforce the “No Force” rule and will not allow empowered clients to have force.
• Spectator Followers can now be kicked, banned, etc. without affecting others.
• mvstr - command that allows you to choose which map you want in the rotation, without disrupting the order.
• mnextmap - executes next map available in rotation.
• Most default settings that were in reloaded.cfg are now hard coded into mod for faster and easier configuration.
• mnpcaccess does not give client access to cheats.
• You can now use clients names for assigning mnpcaccess/mnpcnoaccess.
• g_mAdminGun - Enables/Disables AdminGun system. (includes script)
• g_mAllowTeleFlag - default is enabled, if set to 0, clients cannot teleport during CTF and CTY gameplay.
• New BanIP.dat file stores banned ip's. Full use of 2048 saved ip's activated!
• Tweaked the whois command a little again to make it more stable.
• g_mGiveAdmin - if set to 1, you can grant an admin access level to anyone on the server.
• madminaccess, mdenyadminaccess - commands for granting/denying admin access to clients.
• Enable/Disable use of black color names.
• New logout function - to logout as an admin or knight.
• Ignore - ignore certain clients from chatting so you don't have to listen to them.
• Sleeping clients can no longer use the \kill command.
  

Installation

Linux:
Where ever your installation of Jedi Knight: Jedi Academy is, for example:
'/home/orion/ja/gamedata'
In '/home/orion/ja/gamedata' create a directory 'reload', or extract the reload folder from the .tar.gz archive.
If you created the directory, extract the files from the reload directory in th archive, to '/home/orion/ja/gamedata/reload' .
You may also need to overwrite the file in your base folder. Now you can start the server with the '+set fs_game reload' argument

Example:
./linuxjampded +set fs_game reload +set dedicated 1 +exec server.cfg +exec reloaded.cfg
This will start your server, load the reload mod, make the server dedicated and be listed on the master servers. Then exec the two config files, to configure your server.

Windows:
Create a directory like this:
X:\Path\to\Star Wars Jedi Knight Jedi Academy\GameData\reload
where 'X:\Path\to\Star Wars Jedi Knight Jedi Academy\' is the path where you installed Jedi Academy. Now you can start the server with the '+set fs_game reload' argument.

Example:
jampDed +set fs_game reload +set dedicated 1 +exec server.cfg +exec reloaded.cfg
This will start your server, load the reload mod, made the server dedicated and be listed on the master servers. Then exect the two config files, to configure your server.

Modifications

• Logging of player IP when player connects to the server. Logging happens in the following format:
  mlog_ClientConnect: <player client id> '<player name>' -> '<player ip>'
• Logging of Admin and Knight commands. Every command will be logged in the following format:
  mlog_command <playername>
• Removed the 2 player at a time duel limit.
• Private Duel Stat Logging.
• Bacta/Big Bacta forbidden in Private Duels.
• Sabers do not automatically ignite at the start of a duel.
• When player wins a duel, their health and shields are returned to its pre-duel value.
• Typing !motd or !rules when chatting will display the motd to the player who typed it.
• Typing !version or !author when chatting will display the version number and author.
• Typing !home or !web when chatting will display JA Reloaded Home Page URL.
• g_banIPs cvar removed because it is no longer needed.
• bot_honorableduelacceptance no longer cheat protected. Default value is 1.
• g_mMOTDShowTime - converted to seconds.
• Max Vehicles now at 64 - courtesy of OJP.
• g_doWarmup now enabled for warm-up games. - courtesy of OJP.
• g_mPlayerDuelShield - now works for Duel and Powerduel gametypes.
  

Rcon, Admin, and Knight commands

• Included is a jar_admin.cfg script which allows the admin user to access the admin gun commands with ease. Place this file in your base folder and type \exec jar_admin.cfg in game console when in game.
  

Client Commands

Emotes

Saber/Fighting Damage CVars

Message CVars

Other CVars

Bit Mask Calculator

• What is this Bit Mask Calculator?
• To put it simply the Bit Mask Calculator is a way to quicky figure out what command a knight or a admin has acccess too. Or to quickly adjust what commands a knight or admin has access too.
• How Do I Use It?
• Also this is very easy to, first you choose from the two radio buttons, which level of admin you want to adjust/set command access for. Then you can either Enter a value, and choose admin commands, and it will check all the commands that, the Bit Mask Value you entered, is assocated with. Or you can just start checking what commands you want that level of admin to have. Once you have chosen all the commands you want, you can click the Copy To Clipboard button, and the text in the text field will be copied to the clipboard. So that you can open up your reloaded.cfg, and do Edit -> Paste, and the command will go straight to your config file.
• • Example Usage
  • For example, say I want to give Knight level admins access to only the Kick, Status, Game Type, and WhoIs commands. First I click on the radio button "Knight Commands," next I click the Kick, Status, Game Type and WhoIs check boxes. So in the edit box I now see "seta g_mAdminCommands "199168"". Now that I have choosen all the commands I want, I now click "Copy To Clipboard". Go to where I installed my server, open up my reloaded.cfg using WordPad or Note Pad. I go to the end of the file, click somewhere so i see the blinking '|', then go to Edit and click Paste, and now in my config file I see seta g_mAdminCommands "199168". At the end of the file.

Known Issues

• When changing some message CVars you can use '%s' to add the player name to the message. When changing the message in the console however, the '%' becomes a '.' so the name won't be displayed. Also when using spaces, it tends to only display the first word. A workaround for this is to only change the values in the config and re-exec it.
• The am/jk commands need a '/' or '\' (without quotes) in front of them when executing. Else the command will be shown as a talk command to all players. If the mod was client side this issue would not be around, because the commands could offically be added, so a '\' or '/' would not be needed.
• If you edit profanity.lst or badnames.lst and you do not leave a blank empty line at the end of the file. The server will hang or crash on start up. Make sure to add a trailing empty line after the last entry in those files.
• If you change game types and players reconnect, the ip logging becomes null and void, and only newly connecting clients will have their ips logged. Bug does not exists if the server just changes maps.
• If you try to use the maddprof or maddname, and you give it a name with spaces, ie "You suck" it will only read in "You". If you want to add names with spaces, you must add it manually to the profanity.lst or badnames.lst.

FAQ

• The installation instructions confuse me, is there a more detailed way to install?
•  
• - Yes, Make sure there is a reload folder in the gamedata directory. Inside the reload folder, you will find these files.
• 1. jampgamex86.dll or jampgamei386.so (.dll is for Windows, .so is for Linux)
  2. reloaded.cfg
  3. description.txt
  4. BanIP.dat
  5. profanity.lst
  6. badnames.lst
•  
• When all of these files are in, the mod should load with no problems. Open up the reloaded.cfg file in notepad and edit the cVars that control the passwords. After this, save the file and close it. Then this being linux you can just start the server with the command /.linuxjampded +set fs_game reload +exec reloaded.cfg +exec server.cfg This will launch the linux dedicated server, and for windows jampded.exe +set fs_game reload +exec reloaded.cfg +exec server.cfg. Starts the server with the reloaded mod and exec the reloaded and server config files. From there you can then connect to the server use the \amlogin command or \jklogin to get admin on the server.
•  
• Why is the config file so short?
•  
• Every default setting for JA Reloaded has been hard coded in the mod to
• 1) Shorten the size of the config file.
• 2) Be much easier to set up, even if you do not run config files.
• The JAR_Readme.htm lists all cVars that are in the mod. Just type those that you wish to change in the config file. An example for Admin Password, it would be:
• seta g_mAdminPassword "mypass"
• You will need to place a ( seta ) in front of all cVars you change. Once you have edited all that you want in the config (reloaded.cfg or server.cfg ) When you launch your server be sure to use the \exec command to
• execute your script.
• example: \exec reloaded.cfg
•  
• What is this Bit Value Thingy?
•  
• - You have to add the numbers together to get a value which you place in the g_mAdminCommands cvar or g_mKnightCommands cvar. example: If you just want amkickban, amsleep, and amstatus commands for "am" admin. You would first look up their bit value.
• kickban = 4096
• sleep = 1
• status = 131072
• Now add those together 4096+1+131072 = 135169
• You will now set g_mAdminCommands to 135169 in your reloaded.cfg file.(seta g_mAdminCommands "135169")
• This same pattern goes for both of the new bit value cvars (g_mAdminCommands,g_mKnightCommands)
• Or you can use the newly include Bit Mask Calculator to do all that math for you.
•  
• How do I get admin on my server and enable some commands?
•  
• This is quite simple. If you open up your reloaded.cfg you will notice that there are no entries for admin passwords or \anything. That is because there are default values for the password, just like every other cVar, as stated above in this read me. But that's not smart to use those since they are 'easy' passwords. So what you do is open up that reloaded.cfg, and some where in there add the lines:
• seta g_mAdminPassword "Password" That will allow for people to use the "/amlogin" command and have access to all the "am" commands you have enabled.
• seta g_mKnightPassword "OtherPassword" That will allow for people who know this password to use the "/jklogin" command and have access to all the "jk" command.
  
• Now you can use the new Bit wise Calculator to enable/disable commands. Its very easy, just check all the commands you want Knights have access too and click the radio button that says 'Knight Commands' and you can copy that line of text and place it in your reloaded.cfg. Something like this: seta g_mKnightCommands "SomeBigNumber" and you can do the same thing for Admins. As always its recommended to not have all commands enabled for both ranks. Since that defeats the purpose of having the ranks. The Knight should be the lower ranking admin, have less commands. While the Admin should have just about all the commands.

Special Thanks

• cHoSeN oNe for the development of JAMod up to version 1.5 and JAR Mod up to version 1.3, full credit for features in those Mod's, that are available and featured in future versions, belongs to him. Check out his next project Attack of The Clones: Total Conversion
• The JA Reloaded Quality Assurance Team (You know who you are...)
• Darth Mobility for his incredible web site.
• Moria, Marker0077, X Master Hex, and the OJP Team for their extra support.
• jk3files.com file administrators for their prompt service.
• The Jedi Academy

Disclaimer

Use this mod on your own risk. I take no responsibility what so ever for anything that might happen when using it. The mod has been primarily tested in all modes and gameplays on Linux servers. You do not have permission to decompile or modify this mod in any form or you will be immediately reported to Raven and brought to justice. The source code will NOT be released for download so please don't ask. This mod may not be re-distributed. Accept no cheap admin mod imitations. Please Read this Help document before coming to me with questions. Most questions can be answered by reading the documentation. If clarification is need on a subject that is not understood by reading this document, help will be provided. If I feel that you have not read this document no support will be given.