Jedi Academy Mod

Index

Overview

1.5 - Updates

• Over 60 cVars removed.
• Server Admins can now pick and choose what commands they wish to allow their "am" and "jk" level admins to use.
• g_mAdminCommands - cVar bit value to determine which "am" commands are allowed for their admins.
• 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 admins.
• aminfo - now prints commands that are accessable to admin, instead of just commands in the mod.
• amhelp - now prints commands help to the admins pending if they are accessable to them.
• g_mNerfBacta - Allows you to change the Health regeneration of the Bacta.
• g_mBactaHP - The value of which the bacta regenerates your Health.
• Windows Installer Version includes jk2 1.04 Dedicated server.

1.4 - Features

• New IP Range Banning Admin Command ( mbanrange)
• g_mAllowPowerups - Enforces the use of powerups when 1 or more (Except for ALL) force powers are disabled.
• g_mDebugTerminator - Will enforce the "Saber Only" server rule and will allow no weapons other than saber upon it.
• g_mDebugEmpower - Will enforce the "No Force" rule and will not allow empowered clients to have force.
• g_mAllActivity - detects all activity by client when using the g_timeouttospec cvar, thanks Lee
• bot_honorableduelacceptance - now available without cheats, default is enabled.
• 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.
• g_mAllowTeamSuicide - allows clients to use the \kill command when in team games.
• Added Thunder sound effect to admin & knight login.
• Added Explode sound effect to the mexplode admin command.
• Most default settings that were in academy.cfg are now hardcoded into mod for faster and easier configuration.
• jk2logbackup.pl - this is a perl script for BSD and Linux servers only, designed to archive your games.log file weekly. (written by neoE)
• Minor Code Tweaks

1.3 - Special Edition

• mnpcaccess does not give client access to cheats.
• You can now use clients names for assigning mnpcaccess/mnpcnoaccess.
• Fixed an emote exploit due to g_mDebugCheats set to 1 and cheats enabled. (debugKnockMeDown)
• Fixed emote exploit when in spectator.
• Disabled the use of pushing/pulling dropped items. (this fixes the weird spawnpoint bug)
• Empower only gives team force and team heal power as an extra when playing team games only
• Empowered clients now has stronger team force and heal when playing in team games.
• g_mAdminGun - Enables/Disables AdminGun system. (includes script)
• Fixed using emotes when dead.
• Fixed using terminator and unterminator to become alive after death.
• Fixed Teleporting the dead.
• 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 ips activated! ( written by Lee Oattes )
• Clients cannot use emotes during movements, specials, backattacks, and other saber attacks.
• Tweaked the whois command a little again to make it more stable.
• Server messages print better for clarity.
• New Voting checks, 1) Failed Vote Delay, 2) Need 2 clients to call a vote 3) No voting within 1 min of map change.
• g_mAllowVoteMap, g_mAllowVoteGameType, g_mAllowVoteKick - new cVars to control certain voting rights.
• Clients can no longer change their name during a vote to escape its purpose.
• 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.
• New admin command mprotect/munprotect - protects client on server from attacks untill client attacks others.
• Silence/Unsilence has new mode parameter.
• Sleeping and Punished clients now are invulnerable to attacks.
• Explode now gives you a selection of which appendage you wish to detach.
• Enable/Disable use of black color names.
• Client's nick can now be 50 characters rather than 32.
• mreward command removed.
• New logout function - to logout as an admin or knight.
• Timeout to spectator finally working correctly with g_inactivity timer. ( written by Lee Oattes )
• Ignore - ignore certain clients from chatting so you dont have to listen to them.
• Punished and Sleeping clients can no longer use the \kill command.
• New cVar g_mNameChange - Name changing time allowance, default is 1 minute.
• Same name checking, auto renames when a client with same name is found.
• New g_mAllowBotLimit, g_mMaxBots, and g_mMinHumans to control amount of bots and players on the server at any given time.
• Saga Mode compatible, including all bug fixes made by authors in Lucasforums.
• Included Filter for all QTracker™ servers using JA Mod. ( Double click JAMod.qtf file to install )
• Optimized Source code to increase speed and stability.
• All Features included from previous releases.

Installation

Linux:
Create a directory like this:
/home/.../jk2/academy
where '/home/.../jk2/' is the path where you installed Jedi Knight II. Now you can start the server with the '+set fs_game academy' argument.

Example:
./jk2ded +set fs_game academy +exec server.cfg +exec academy.cfg

Script:
Place in location of your server's jk2 root directory.
View the cron script by using the crontab -1 command to see the script.
Next edit the script using the crontab -e command and map the path to the perl script.
If you wish to Back-up at 5 am every week, every month, type the following.
0 5 * * 0 /path/jk2root/jk2logbackup.pl
If you wish to have an email sent to you in case the script fails, type MAILTO="your email"


Windows:
Create a directory like this:
X:\...\Star Wars JK II Jedi Outcast\GameData\academy
where 'X:\...\Star Wars JK II Jedi Outcast\' is the path where you installed Jedi Knight II. Now you can start the server with the '+set fs_game academy' argument.

Example:
jk2mp.exe +set fs_game academy +exec server.cfg +exec academy.cfg

IMPORTANT:
For the Ban code, you will need to authorize FULL Admin access to the academy folder.
Windows: Make sure you have an administrator account.
Linux: command = man chmod, then follow on screen instructions.

Server Side Only Installation

Modifications

• Various Trainer and Knight commands
• 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 Trainer and Knight commands. Every command will be logged in the following format:
  mlog_command <playername>
• Removed the 2 player at a time duel limit.
• Sabers don't automatically ignite at the start of a duel.
• "No bacta rule" is now working for duels.
• Voting system is now limited for Trainer use only.
• When player wins a duel he now gets up to 25 shield points as well as the full 100% health.
• Typing !motd or !rules when saying something shows the motd to the player who said it.
• Typing !version or !author when saying something shows the version number and author.
• Typing !home or !web when saying something shows the JA home page link.
• Setting the g_allowDuelSuicide to 1, will enable the clients to use \kill during private duels.
• Setting damage for all the moves.
• Various emotes.
• Fixed Red Stance kick bug, are now able to kick those that use Red.
• Invisible Saber Bug fix.
• Spectator following/saber throw bug fixed.
• g_banIPs cvar removed because it is no longer needed.
• g_mMOTDShowTime, g_mSlapKnockDownTime - converted to seconds

Rcon, Admin, and Knight commands

Emotes, Client, & Admin Commands

Damage CVars

Message CVars

Other CVars

Help for NPC commands

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. A workaround for this is to only change the values in the config and rerun 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.
• When sitting, crossing arms, kneeling, begging, surrender, or waiting on someone's head; Or on moving platforms a player will remain in the air and not fall down. You can use g_mOnlySitOnGround to only allow players to sit on the ground thus alleviating the problem.
• When sitting, crossing arms, kneeling, begging, surrender, or waiting - the player will become invulnerable to attack, this is due to the nature of how these animations have been implemented and can not be changed unless client side code is changed.
• When running a Non-Dedicated Server (Listen Server), and using the \map_restart command the server crashes - Workaround: Place the VM folder inside dummy.pk3 and reload the mod. Clients will then need to download the mod.
• If you tend to have trouble with the Mod, be sure to clean out all previous files the mod creates. -jk2mpconfig.cfg and games.log: These files are not compatible with previous version of this mod.

FAQ

• Installation instructions confuse me, is there a more detailed way to install?


-Yes, An academy folder in the gamedata directory. Also, make sure inside the academy folder are these files.
1) A vm folder with a jk2mpgame.qvm file in it
2) academy.cfg
3) dummy.pk3
4) description.txt
5) BanIP.dat
6) Readme.htm
When all of these files are in, the mod should load with no problems. Open up the academy.cfg file in notepad and edit the cvars that control the passwords. After this, save the file and close it. When you get in game, Click the setup menu and click the mods menu. Highlight the JA Mod 1.5 and click Load. The screen should flash a couple times, then create your server and enter the game. Open up the console and type \exec academy.cfg That will load all of your cVars and passwords you declared in the academy.cfg file. Then, to login use \amlogin pass (where pass is the password) If you wish to load the mod via shortcut, you can right click on the EXE file in windows and create shortcut. Then, add the arguments
+set fs_game academy +exec academy.cfg +exec server.cfg
Save the shortcut, and double click it to launch. This will launch jk2mp or jk2Ded and load the mod and cfg at same time...skips extra steps thats all...


• How do I spawn an NPC?


-You make sure g_mDebugCheats is set to 1 and use the amnpcaccess command to give yourself access. Next, use the g2 animent or g2platoon commands. Example
\g2platoon 0 2 4 /models/players/stormtroopers/model.glm /sounds/chars/st1/misc
\g2animent 1 1 4 /models/players/rodian/model.glm /sounds/chars/rodian/misc 100 0


• Why is the new config so short?


-Every default setting for JA Mod 1.5 has been hardcoded 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 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 (academy.cfg or server.cfg ) When you launch your server be sure to use the \exec command to execute your script.
example: \exec academy.cfg


• Everytime I idle, I get kicked into spectator!!!


-When Raven created the cVar g_timeouttospec, it never seemed to work as intended. Now it does :) You need to change the g_timeouttospec cVar. Right now it is defaulted at 50 minutes or or g_timeouttospec 3000. If that is too short of time, you can change it to anything you desire.


• 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, amslap, and amstatus commands for "am" admin. You would first look up their bit value.
kickban = 524288
slap = 1
status = 33554432
Now add those together 524288+1+33554432 = 34078721
You will now set g_mAdminCommands to 34078721 in your academy.cfg file. (seta g_mAdminCommands "34078721")
This same pattern goes for all 3 of the new bit value cvars (g_mAdminCommands, g_mKnightCommands, and g_mEmotes)

Other Cool Mods

• Duelers Mod
• Masters Of The Force
• Attack Of The Clones Total Conversion
• ForceMod
• ProMod

Disclaimer