===============================================
Open Jedi Project Master Cvar & Command Listing
===============================================

$revision$

=================
Table of Contents
=================

	0000............Table of Contents
	0001............Introduction
	0002............Legend
	     0002.1.....Tags
	0003............Cvar & Command Listing
	0004............Misc Listings
	     0004.1.....Maps
	     0004.2.....NPCs
	0005............Cvar Attributes
	0006............Legal Stuff
	0007............Credits


===================
0001 - Introduction
===================

As part of the OJP (Open Jedi Project) we are compiling a masterlist of commands, cvars, mapnames, and npcs for Jedi Knight: Jedi Academy (JKA).  We include cvar/commands that come with the game and those that have been added as part of the OJP.

The default valve is listed with each cvar/command is if is known.



=============
0002 - Legend
=============

-------------
0002.1 - Tags
-------------

(Cheat) Cheat Code - This can't be used unless you activate cheat mode.  See HelpUsObi and devmap to learn how to toggle cheat mode. 

(Client) Client Side - relivent to the client side of the game engine.  You always have control of these cvars/commands.

(Command) Commands - Commands do something when you type them in but do not store values.

(cvar) cvar - Controls various things by storing a value.  These are entered into the console by simply typing the name of the cvar (HelpUsObi) and a value (1).  Example:  HelpUsObi 1.  cvars are not case sensitive.

(Force Powers) Force Powers - This cvar/command is related to the Force Powers.

(Holster) - This cvar is related to the holstered weapons (VisualWeapons) feature of OJP.

(Latched) Latched Cvar - This cvar doesn't actually change/take effect until the map is restarted by changings maps or by using /map_restart.

(MP) MultiPlayer - For use in the multiplayer aspect of JKA.

(OJP) Open Jedi Project  - Added for use in the Open Jedi Project Basic and Enhanced Distributions.

(OJP+) Open Jedi Project Enhanced - Added for use in the Enhanced version of OJP.

(Protected) Protected Cvar/Command - This cvar/command can't be changed from inside the console.  The only way to change it is either using the command line or the UI menus.
 
(Razor Ace) Razor Ace - JKA Modder dude, likes to add his name to everything.  That attention whore. :D  - Razor Ace

(SP) Single Player - For use in the singleplayer aspect of JKA.

(Server) Server Side - Relavent to the server side of the game engine.  You can only use these cvars/commands if you are hosting/administrating a MP game OR playing SP.  All cvars with a "g_" prefix are server side cvars.

(Scaler) Scaler - Uses a decimal scaler to control a varible.  1 is typically the default.  .5 would be 50% of normal and etc.

(Startup) Startup Cvar/Command - this cvar/command effects the game on startup.  This will not take effect until you restart/change maps.

(Toggle) Toggle Command/Cvar - This is a simple off/on control for this feature.  A cvar value of 1 means on.  0 means off.

(True View)  True View Cvars - These cvars control True View, a realistic first person view for OJP.


--------------
0002.2 - Terms
--------------

(fps) Frames Per Second - A measurement of how many times something is processed per second.  This can also be referred to as the "frame rate".



=============================
0003 - Cvar & Command Listing
=============================

	/addip
	OJP, Multiplayer, Admin, Command
	Description:
		Adds a IP to the IP ban list.  You can use incomplete IPs (IE 192.246.40) to ban entire subnets.


	bot_attachments 1
	Multiplayer, Server, Bots, Toggle, cvar
	Descriptions:
		Toggles bot attachments.  Bot attachments are positive emotion attachments that they associate with other bots (based on model name).  These are set in the bot files.


	bot_forgimmick 0
	Multiplayer, Server, Bots, cvar, Integer, Cheat
	Description:
		Debug bot functions:
		1 = Stand still.
		2 = Stand and attack
		3 = Move towards map origin while attacking
		4 = Move towards client 0

	All modes also follow orders from the bot movement debug commands.


	bot_fps 20
	OJP, Multiplayer, Bots, cvar, Integer
	Description:
		Controls the number of frames per second that the bot AI is processed.  This is mainly designed to cut back on unnessicary resource drainage when you have the server fps set up.  Note:  the bot AI fps is clamped by the server fps.  The bot AI fps can't go faster than the server fps no matter what setting you set it to.


	bot_getinthecarrr 0
	Multiplayer, Bots, Debug, cvar
	
	Description:
		Bot debugger for vehicle passengers.
		1 = Get in a vehicle with a pilot, then try to move forward
		2 = Get in a vehicle
		3 = Get in a vehicle with a pilot, then try to move forward and press alt fire.


	bot_honorableduelacceptance 0
	Multiplayer, Bots, Cheat, OJP
	
	Description:
		Bots will accept saber challenges when a player has his saber holstered (or in single blade stance for the dual/staffs).

		OJP:  You now have to have your saber fully holstered for the bot to accept your duel challenge.


	bot_nogoals 0
	Multiplayer, Bots, Debug, Toggle, cvar
	Description:
		Disables the goal system for the bots.


	bot_pvstype 1
	Multiplayer, Bots, Cheat
	Description:
		Shares control with g_RMG weither or not visual check scans are done for far visual point checks (> 5000 game units).  Both must be enabled for the checks NOT to be done.  When they are not done, the system automatically assumes that the visual check fails.


	bot_wp_editornumber 0
	OJP, Multiplayer, Bots, BotTweaks
	Description:
		This cvar sets which client (by client number) recieves the bot waypoint editing information while in the waypoint editor.


	cg_chatbox 10000
	Multiplayer, Client, cvar

	Description:
		This CVar sets the amount of time (in milliseconds) that chat text may be displayed before disappearing.


	cg_chatboxheight 350
	Multiplayer, Client, cvar

	Description:
		This sets the position of where the chat text is displayed on-screen. Set this to 60 for it to be closer to how chat was in JK2.


	cg_fov 80
	Single Player, Multiplayer, Client, cvar, Float

	Description:
		Controls how large your field of view is (in degrees).  Larger values result in fisheye (or alien) like views while smaller values make your view appear to zoom in.
	

	cg_RenderToTextureFX
	Single Player, Multiplayer, cvar

	Description:
		Toggles the texture wrapping effects (force push/pull and respawning).  Some video cards don't support this effect and have extreme frame drops whenever they occur.  JKA attempts to automatically set this but this often doesn't do it correctly.  Experiment on your system to determine what works for you.


	cg_thirdPersonCameraDamp 0.3
	Multiplayer, Single Player?, Client, cvar, Float
	
	Description:
		Controls the amount how much your camera view "lags" behind movement changes of your crosshairs.  Set this to 1 to eliminate the lag.


	cg_trueeyeposition 0
	OJP, True View, Multiplayer, Float
	
	Description:
		Controls the forward/backward offset for True View camera.  This is automatically set by trueview.cfg on model load unless it's unlisted. 


	cg_trueflip 0
	OJP, True View, Multiplayer, Client, Integer

	Description:
		Controls the realism level of camera flip while in True View. 

		0 = none
		1 = Simplifed - Whenever a flip is performed, the camera does a simple flip.  This is for people who want flipping but find the real setting to be too pukey.  Note:  Yes, you can see thru parts of the model in this mode.
		2 = Real - When your character flips in the game, the camera is locked to his POV.


	cg_truefov 100
	OJP, True View, Multiplayer, Float

	Description:
		Sets the fov (field of view), in degrees, while using True View.  Setting this to 0 will make the game use the standard fov setting (cg_fov) for True View.


	cg_trueinvertsaber 1
	OJP, True View, Multiplayer, Client, Toggle

	Description:
		Controls weither or not the thirdperson setting is inverted for saber/melee modes or not.  IE, when the settings are inverted (enabled by default), the saber/melee modes will be in third person view while the other weapons are in first person view. 


	cg_trueguns 0
	OJP, True View, Multiplayer, Toggle, Integer

	Description:
		Controls if True View is used for the guns.


	cg_trueroll 0
	OJP, True View, Multiplayer, Client, Integer
		Default: 2

	Description:
		Controls the realism level of camera rolling while in True View.
 
		0 = none
		1 = Simplifed - Whenever a roll is performed, the camera does a simple roll.  This is for people who want rolling but find the real setting to be too pukey.  Note:  Yes, you can see thru parts of the model in this mode.
		2 = Real - When your character spins in the game, the camera is locked to his POV.


	cg_truemoveroll 0
	OJP, True View, Multiplayer, Client, Integer
	
	Description:
		Controls how much the roll (leaning) of walking or running effects the True View camera.
		0 = no walking/running lean
		1 = %50 damper on walk/run leaning
		2 = %100 realistic leaning 
  

	cg_truesaberonly 0
	OJP, True View, Multiplayer, Toggle, Integer

	Description:
		Determines if the your body is shown while using True View with the saber.  If this is set to on, only the saber blade will be seen.

	
	cg_truespin 0
	OJP, True View, Multiplayer, Client, Integer

	Description:
		Controls the realism level of camera spinning while in True View. 
	
		0 = none
		1 = Simplifed - Whenever a spin is performed, the camera does a simple spin.  This is for people who want spining but find the real setting to be too pukey.  Note:  Yes, you can see thru parts of the model in this mode.
		2 = Real - When your character spins in the game, the camera is locked to his POV.


	cg_turnAnims 0
	Single Player, Toggle, cvar	

	Description:
		Determines if the turn animation is on.  The turn animation plays whenever you look around.  It doesn't work very well since it skips in and out of the animation without smoothing.  


	/cvarlist
	Command
	
	Description:
		Prints out cvars and their cvar flags.  See Cvar Attributes for an explaination of the different cvar flags.  You can also limit the range of this function by giving a complete or partial cvar name as the cvar arguement.


	dmflags 0
	Multiplayer, Server, cvar

	Description:
		Enables various features for competative environment.
		Add values together to achieve multiple results:
  			8  = Disables Falling Damage
     			16 = lock Field of View to default of 80
     			32 = silent footsteps
			(Example: dmflags 56 would be all three options enabled)


	/forceteam <player> <team>
	Command, Admin

	Description:
		Forces the given player (by name) onto the given team (by name).


	fs_game " Default:"
	Multiplayer, Startup, Cheat, cvar, Protected

	Description:
		Sets the mod to be used by the game.  When you set this to something other than the default, the game will load the files in the gamedata/namedvalue directory.  In the state of a conflict with another file in the /base directory, the /namedvalue directory file should get presidence.  Use this cvar to load up your mod or test files into the game.


	fx_freeze 0
	Singleplayer, Multiplayer, cvar
	Description:
		Freezes all the fx images.  This makes bolts invisible and freezes the saber trails in their place.  There seems to be a maximum fx limit so even the saber trails quit drawing after a while.


	g_allowGametypeVote 1
	OJP, Multiplayer, Admin, Cvar
	Description:
		Allow Gametype voting


	g_AllowMapVote 1
	OJP, Multiplayer, Admin, Cvar
	Description:
		Controls map change voting
			2 = full map voting
			1 = map restart and next map votes only
			0 = no map votes
	

	g_AllowKickVote 1	
	OJP, Asteroids, Multiplayer, Admin, cvar
	Description:
		Allow kick votes.  Note: This does not apply to the Team Kicking mentioned above.


	g_allowTeamVote 1
	OJP, Asteroids, Multiplayer, Admin, cvar
	Description:
		Toggles the abilitiy to vote to of kick your own teammates.


	g_autoBanKillSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto ban a player after this many suicides (/kill). 0 = no limit.  This cvar overrides g_autoKickKillSpammers if set.


	g_autoBanTKSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto kick a player after this many team kills. 0 = no limit.
		

	g_autoKickKillSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto kick a player after this many suicides (/kill). 0 = no limit.  This cvar is overriden by g_autoBanKillSpammers (if set).


	g_autoKickTKSpammers 0
	OJP, Asteroids, Multiplayer, Admin, cvar

	Description:
		Auto IP bans TKs after this many team kills. 0 = no limit.
		

	g_corpseRemovalTime
	Single Player

	Description:
		Controls the time before dead bodies disappear in SP.  Setting this to 0 will result in dead bodies remaining on the map until you load a game, die, or finish the map.


	g_duelWeaponDisable 0
	Multiplayer, Weapons

	Description:
		Controls which weapons are useable in duel gametypes.  (See g_WeaponDisable).  To set this you must use the numberical sum of the weapons you want disabled (0 = All weapons enabled).

	Numberical Value for Weapons
	----------------------------------
	Stun Baton		2
	Melee Mode		4
	Saber			8
	Pistol			16
	Blaster 		32
	Disruptor		64
	Bowcaster		128
	Repeater		256
	Demp 2			512
	Flechette		1024
	Rocket Launcher		2048
	Thermal			4096
	Trip Mine		8192
	Det Pack		16384
	Concussion Rifle	32768
	Bryar Pistol		65536
	Emplaced Guns		131072
	Turrets			262144


	g_doWarmup 0
	Multiplayer, Server, OJP

	Description:
		Toggles the warm up period before a non-duel gametype match. Use g_warmup to set the warm up time period. 


	g_forcePowerDisable
	Multiplayer, Force Powers, Server, Latched

	Description:
		Controls which Force Powers are useable in the match.  To set this you must use the numberical sum of the Force Powers you want disabled (0 = All powers enabled; 262143 = All powers disabled).

	Numberical Value for Force Powers
	----------------------------------
	Heal		1
	Jump		2
	Speed		4
	Push		8
	Pull		16
	Mind Trick	32
	Grip		64
	Lightning	128
	Rage		256
	Protect		512
	Absorb		1024
	Team Heal	2048
	Team Energize	4096
	Drain		8192
	Seeing		16384
	Saber Offense	32768
	Saber Defense	65536
	Saberthrow	131072
	


	g_saberanimspeed 1
	Single Player, Scaler, Razor Ace

	Description:
		Controls the saber animation speeds in single player.  This effects all saber moves.  If you're interested in more "movielike"/controllable saber battles, set this to a lower value.  I recommend .5 (50% normal speed).

		Slows down the saber attack animations by 50%. Trust me, this makes the saber duels MUCH, MUCH better. I'm surprised Raven didn't do this in the first place. There are some downsides however: 

		1. The yellow single saber special doesn't really work correctly. The animation goes too slow and the camera flips out when you try it.

		2. The saberlock kills often doesn't work. The loser regains control before you can complete the animation and kill him. On the plus side, it's not a big deal and it looks cool when your opponent dives out of the way of a fatal strike.

		3. The saber staff wielders in the last few levels are tuff to beat. Unfortunately, it looks like Raven made the last level dual/staff dark jedi have faster saber swings than the earlier levels. That coupled with the way the later level AI spams the saber twirls makes them very tricky to beat. 

		Anyway, if you decide to go thru the game with the saber animation speed turned down, I suggest you use the single saber thru the whole game for the full experience. It's totally worth it. 

		FYI, I've found that the Blue Stance works best on Red single saberers and dual saberers. The Red Stance works best on double saberers and Yellow Stance works on everything else.  


	g_saberAutoAim 1
	Single Player, Toggle

	Description:
		This disables SP's saber "auto aim". Basically, it tries to pick the right attack swing to hit nearby opponents. I don't like it because it ends up giving you weird swings instead of the swing you were trying for.


	g_saberBladeFaces 1
	Multplayer, Sabers

	Description:
		Determines if you want to do more advanced saber on saber hit detections.  This only applies to the kind of blade on blade detection used with d_saberSPStyleDamage turned off.


	g_spSkill 2
	Multiplayer, Bots, cvar, integer
	
	Description:
		Determines the skill level of bots that are automatically added to the game with minimum players system.  1 = lowest level 5 = max level.


	g_teamForceBalance 0
	OJP, Multiplayer, Admin, cvar

	Description:
		Enabling this will make it so players can only join the team with the least number of players.

	OJP Changes (see Auto Team Balancer):
		0 = disabled
		1 = basejka g_teamForceBalance	
		2 = standard Auto Team Balancer scans.  
		3 = Auto Team Balancer scans with additional team balancing for score.


	g_useWhileThrowing 1
	Multiplayer, Toggle, Force Powers

	Description:
		Controls weither or not you can use Force Push/Pull while using Saber Throw.	


	g_vehAutoAimLead 0
	OJP, Asteroids, Multiplayer, Vehicles, Archived

	Description:
		Toggles auto weapon lead when you're pointing directly at another vehicle.
	

	g_warmup 20
	Multiplayer, Server, OJP
	Minimum:  5
	Maximum:  120
	
	Description:
		Sets the warm up time (in seconds).  See g_Dowarmup to toggle the warmup period.


	g_weaponDisable 0
	Multiplayer, Weapons

	Description:
		Controls which weapons are useable in non-duel gametypes.  (See g_duelWeaponDisable).  To set this you must use the numberical sum of the weapons you want disabled (0 = All weapons enabled).

	Numberical Value for Weapons
	----------------------------------
	Stun Baton		2
	Melee Mode		4
	Saber			8
	Pistol			16
	Blaster 		32
	Disruptor		64
	Bowcaster		128
	Repeater		256
	Demp 2			512
	Flechette		1024
	Rocket Launcher		2048
	Thermal			4096
	Trip Mine		8192
	Det Pack		16384
	Concussion Rifle	32768
	Bryar Pistol		65536
	Emplaced Guns		131072
	Turrets			262144


	/listip
	OJP, Multiplayer, Admin, Command
	Description:
		Adds a IP to the IP ban list.  You can use incomplete IPs (IE 192.246.40) to ban entire subnets.  The IP ban list is stored in a text file called banip.txt in your mod dir.


	ojp_chatProtectTime 1000
	OJP, Multiplayer, Admin, cvar

	Description:
		Sets how often a player can send text messages.  Time is in milliseconds. 0 = no limit.


	ojp_holsterdebug 0
	OJP, Multiplayer, Client, cvar, Holster

	Description:
		Controls the debugging of the holster system.  Value sets which type of holstered weapon is being debugged.
		0 = debug off
		1 = HLR_SINGLESABER_1,	//first single saber
		2 = HLR_SINGLESABER_2,	//second single saber
		3 = HLR_STAFFSABER,		//staff saber
		4 = HLR_PISTOL_L,		//left hip blaster pistol
		5 = HLR_PISTOL_R,		//right hip blaster pistol
		6 = HLR_BLASTER_L,		//left hip blaster rifle
		7 = HLR_BLASTER_R,		//right hip blaster rifle
		8 = HLR_BRYERPISTOL_L,	//left hip bryer pistol
		9 = HLR_BRYERPISTOL_R,	//right hip bryer pistol
		10 = HLR_BOWCASTER,		//bowcaster
		11 = HLR_ROCKET_LAUNCHER,//rocket launcher
		12 = HLR_DEMP2,			//demp2
		13 = HLR_CONCUSSION,		//concussion
		14 = HLR_REPEATER,		//repeater
		15 = HLR_FLECHETTE,		//flechette
		16 = HLR_DISRUPTOR,		//disruptor


	ojp_holsterdebug_angoffset "0.0 0.0 0.0"
	OJP, Multiplayer, Client, cvar, Holster

	Description:
		Controls the angular offset for the current debug holsterType.


	ojp_holsterdebug_boneindex 0 
	OJP, Multiplayer, Client, cvar, Holster

	Description:
		Controls which bone that the current debug holsterType is based off of.


	ojp_holsterdebug_posoffset "0.0 0.0 0.0"
	OJP, Multiplayer, Client, cvar, Holster

	Description:
		Controls the positional offset for the current debug holsterType.  e the directions are dictated in terms of the current orientation of the body part that the holsterType is currently based off of.


	ojp_holsteredweapons 2
	OJP, Multiplayer, Client, cvar, Holster

	Description:
		Controls how holstered weapons are rendered.
			0 = Off
			1 = Only show on your player
			2 = Show on all players
	

	ojp_teamrgbsabers 0
	OJP, Multiplayer, Client, cvar

	Description:
		Controls the saber blade colors during team games.
			0 = All sabers are based on team color
			1 = Player's saber is custom color, everyone else has team colors
			2 = Everyone has custom colors.


	ojp_sabermelee 0
	Multiplayer, OJP, Enhanced

	Description:
		Controls the behavior of pressing the saber weapon button when the saber is already selected and turned on.  A setting of 1 makes it toggle between melee mode and an ignited saber.  A setting of 0 makes it toggle the saber on/off (default baseJKA behavior).
		Please note that you can also use /togglesaber to toggle the saber on/off reguardless of your ojp_sabermelee setting.


	ojp_skipcutscenes 0
	Multiplayer, OJP, CoOp

	Description:
		Controls how cutscenes in CoOp mode are skipped.

		0 = not at all
		1 = automatically use skip scripts if possible.  Skip scripts exist for most of the major cutscenes.
		2 = automatically use skip scripts and time acceleration
		3 = toggleable use (player's use key) of skip scripts
		4 = toggleable use of skip scripts and time acceleration


	r_fastsky 0
	Multiplayer, Singleplayer, Client, cvar

	Description:
		Enabling this option disables certain textures that can speed up the frames per second (FPS). This disables mainly skies but does disable other textures as well.


	/removeip
	OJP, Multiplayer, Admin, Command
	Description:
		Removes a IP to the IP ban list.  You can use incomplete IPs (IE 192.246.40) to ban entire subnets.


	sabercolor
	Single Player, Command

	Description:
	Sets the color of the blade on lightsaber(s).
	Use: /sabercolor 1 purple , where '1' is the saber blade number, and 'purple' is the saber color.


	sv_fps 20
	Single Player, Multiplayer, server

	Description:
		Controls the frame rate of the server's world updates.  This basically controls everything in the game world except player movement and client side effects.  Turning this up will result in better hit detection but might result in some communication difficults and minor gameplay issues (jiggling gibs and unstoppable AI in saberlocks).  In theory, the ideal setting for this as the fps of the client(s).  However, this does result in more system useage (and possibly lower frame rates).  use with caution.


	/togglesaber
	OJP, Multiplayer

	Descriptions:
		Toggles your saber blade.  You must have your saber selected for this to work.


	/voice_cmd
	Multiplayer, Command

	Description:
		Plays a given voice command in all team gametypes.

	Voice Commands Availible:
		att_attack
		att_primary
		att_second
		def_guns
		def_position
		def_primary
		def_second
		reply_coming
		reply_go
		reply_no
		reply_stay
		reply_yes
		req_assist
		req_demo
		req_hvy
		req_medic
		req_sup
		req_tech
		spot_air
		spot_defenses
		spot_emplaced
		spot_sniper
		spot_troops
		tac_cover
		tac_fallback
		tac_follow
		tac_hold
		tac_split
		tac_together


====================
0004 - Misc Listings
====================


-------------
0004.1 - Maps
-------------

	Single Player:

	t2_trip - Meet Contact (Swoop Riding Level)
	t3_rift - (Jedi Tomb Level)

	Multiplayer:

	mp/duel3 - Imperial Shaft
	mp/duel8 - Abandoned City

	mp/ffa1 - Vjun Sentinel 
	mp/ffa5 - Taspir

	mp/siege_hoth - Hoth


-------------
0004.2 - NPCS
-------------




======================
0005 - Cvar Attributes
======================

	There's a listing of cvar attributes/flags that cvars can use.  The letter in the ()'s is the ingame character used to represent that flag in cvarlist.

	Archive (A) - These cvars have their current setting saved to your cfg file.  This is used for every cvar that saves between game seasons.

	Cheat (C) - These cvars are cheat codes and can't be changed without being in cheat mode.

	Latch (L) - These cvars don't change values until the map is restarted.  Sometimes you even have to change maps for this to work.

	Serverinfo (S) - These cvars are made availible for access by game browsers.  Useful for important game changing cvars.

	Systeminfo - These cvars are transmitted to and overright the clients' version of the cvar.  Used for game information that needs to be set the same as the server.  
	
	




===================
0006 - Legal Stuff
==================

 - You may freely use the information provided here for whatever purpose.

 - You may distribute this file as long as you do not alter the contents of this file in any way.  Instead, if you wish to contribute to the listing.  Visit the OJP Website and contact one of the OJP moderators.

 - You may not plagerize sections from this file.



==============
0007 - Credits
==============

Contributors:

	Razor Ace 	(razorace@hotmail.com)
	Samuel Dravis
	Marker0077
