********************************************* 
JA+ Mod FAQ 
Author: Silder 

********************************************* 

- How to start a server which read all the cvars described in the doc?
0 How to become admin? i want to execute admin cmd and i am not allowed 
1 Can i use partial player name instead of player ID? 
2 All the admin cmd works in RCON ? even if the cmd is not allowed for council and knight? 
3 Is it possible to define myself all the allowed admin cmds for knight and council? 
4 I can't use an admin cmd like NPC as an admin..... 
5 WHERE are the banned player IPs ? i can't find them in the g_banips cvar 
6 How does i unban player? 
7 Model Scaling System does not work....? 
8 How does the clan Speak mod works? and CLan tag protection?
9 Can i teleport a player close to another player? 
10 How do the client script saber.cfg, admin.cfg, chat.cfg work? 
11 This mod changes a lot all the gameplay and sometimes i want to disallow all the new features.... 
I know it is possible but how? 
12 ANTI fake player name system : how it works? 
13 CONFIGURABLE SABER DAMAGES ===> Does it change the gameplay and DMGs with the default settings? 
	how to get the default basejka damages?

14 NEW VOTE MANAGEMENT jp_votesDisable ==> how i disable a vote Type? 
15 Can i force a player to go in a team, or spectator or join the ffa in every gametype? 
16 : CHAT GOD SYSTEM what is it? 
17:  How works /amvstr ?
18 : is ja+ reamain a server side mod?
19 : duel isolation (non interference duel) how it works?
20 : d_saberSPStyleDamage what is it? 
21 : 16 increased to 32 different vehicles max spawned in a map and 
	.veh & .vwp files max size increased to allow to load a lot of pk3 vehicle files (more than 50).
	.veh extension file too large? what is it?
22: when i start my game all my settings are initialized with the default?
23 : death method MOD_FALLING, CRUSH ....etc... what is it?



-------------------------------------------------- 
- How to start a server which read all the cvars described in the doc?
------------------------------------------------------- 
fist, install the mod as described in the doc
then there is several ways to do it:
	** the easiest way but NOT RECOMMENDED : start a server from the game in the menu : 
		load the mod from the menu
		configure the server in the game menu
		open the console and type /exec server.cfg
	** the best way  to do it : start a DEDICATED SERVER: server started in a little console
		install the file start_japlus_without_dedicated_raven_pack.bat in gamedata folder
		then double click on this .bat file
		it will start a console (this is your dedicated server)
		then open your game and type into console /connect IP:21000 where IP is your IP and 21000 is the port
			used by the dedicated server
		(you can change the port by editing the .bat file with notepad, you also can use the dedicated server pack
		released by raven and install it and then use instead the file called start_japlus_using_raven_dedicated_server_pack.bat
		to start the server)

-------------------------------------------------- 
0 How to become admin? i want to execute admin cmd and i'am not allowed 
------------------------------------------------------- 
your server owner must specidy the 2 passwords in the server.cfg 
seta jp_councilPass "council_pass" 
seta jp_knightPass "knight_pass" 

then during the game, type in the console /amlogin "council_pass" ti log as a council admin 
or /amlogin "knight_pass" to log as an knight admin. 

----------------------------------------------- 
1 Can i use partial player name instead of player ID? 
----------------------------------------------- 
yes 


----------------------------------------------- 
2 All the admin cmd works in RCON even if the cmd is not allowed for council and knight? 
----------------------------------------------- 
yes, for ex : /rcon ammap 0 mp/ffa5 

----------------------------------------------- 
3 Is it possible to define myself all the admin cmds 
which an admin council or knight will be able to use? 
----------------------------------------------- 
Yes, use the bit values of the readme and add all the bit value of the cmd you want to allow for the cvar 
jp_councilAllowedCMD and jp_knightAllowedCMD.... 


u can also use the rcon cmd admtoggle...that add those bit values for you. 
-admToggle < ID Cmd> <level> where <level> = council, knight 
allow/disallow and admin cmd for council or kight. It changes automatically the server cvar 
jp_councilAllowedCMD and jp_knightAllowedCMD 
type admToggle without argument to display help and see the ID of adm cmds. 

EXAMPLE: 
for example imagine the bit value for amsleep is 2 and the bit value for npc is 4.... (it is just an example). 

if you put seta jp_councilAllowedCMD "0" 
th council won't be able to use any admin cmd... 

if you put 2, he will be able to use amsleep 
if you put 4 , he will be able to use npc 
if you put 4+ 2=6 , he will be able to use npc and amsleep 


u can also use the /rcon admTogle cmd that give all Cmd ID... 
then type /rcon admToggle ID_CMD council to allow/disallow the cmd whose ID is ID_CMD... 



----------------------------------------------- 
4 I can't use an admin cmd like NPC as an admin..... 
----------------------------------------------- 
You have to allow this cmd for the admin class you want by adding all the bit values of the cmd you want to allow. 
Then you put this value in the good server cvar jp_councilAllowedCMD and jp_knightAllowedCMD. 




-------------------------------------------------- 

5 WHERE are the banned player IPs ? i can't find them in the g_banips cvar 
-------------------------------------------------- 
the ban ips list is stored in an external file banIPs.txt under the japlus folder ..... 

PS: for linux the file will be under japlus folder but the one of ~HOME\.ja\japlus\ 
THe banIPs.txt will be just close to the default games.log place. 


----------------------------------------------- 
6 How does i unban player? 
----------------------------------------------- 
/rcon removeip <ip-mask> 

/rcon removeip all ==> it remove all IPS 


---------------------------------------------- 
7 Model Scaling System does not work.... 
---------------------------------------------- 
You have to allow the model scale system with the cvar (jp_allowModelScale) and place the modelscale.cfg in 
you japlus server folder. 
this file contains all model size factor between 0.7 and 1.2. 
Open it to change the size factor. 


--------------------------------------------- 
8 How does the clan Speak mod works? and CLan tag protection?
--------------------------------------------- 

you have to select the good speak mod with the cmd /say_team_mod clan and type the good /clanpass clan_speak_pwd... 
THen you speak with Say_team key (default is T) 

/say_team_mod= normal : the use of the say_team cmd send messages to your team 
= clan : the use of the say_team cmd send messages to all players 
logged into the same clan as you . They have all typed the same clanpass. 
You will be able to read msgs of players that have the same clanpass as you. 
= admin : the use of the say_team cmd send messages to all admins 

You can use the client script chat.cfg that binds all the cmd for you. 
ALso you can be autologed in the clan chat channel using the Autologin plugin features cp_clanPwd 

This clanpass is also used by the Clan Tag protection configured at serverside.

--------------------------------------------- 
9 Can i teleport a player close to another player? 
-------------------------------------------- 
Yes /amtele player1 player2 ..... player1 and player2 can be ID or partial player name 
/amtele player2 :teleport yourselfs near player2 
/amtele : without any argument teleports yourselfs at the place where you last used the cmd /amtelemark 
ideal to quickly come back at a specific point. 


--------------------------------------------- 
10 How do the client scrip saber.cfg, admin.cfg, chat.cfg work? 
-------------------------------------------- 
those script are example scripts that i made in order to use easily all the JA+ cmds. 
Those script enable to bind keys on your keyboard that will execute ja+ cmds. 
You can use those scripts or bind yourself the various cmds. 
I advice to open those files with blocNote and read the begining of the file that show it works. 
IF you use those file, you will have to change the binded key and during the game, you type /exec saber.cfg 
or /exec admin.cfg ..... etc... 

--------------------------------------------- 
11 This mod changes a lot all the gameplay and sometimes 
i want to disallow all the new features.... 
is it possible? 
-------------------------------------------- 
YES OF COURSE...... 
There is a lot of server cvar that u can use to turn ON/OFF everything in the mod.... 
It is the main policy of the mod..... there are plenty of new things but all is configurable.... 


----------------------------------------------- 
12 ANTI fake player name system : how it works? 
---------------------------------------------- 
When a player first connect to the server, His IP with his name, is stored. 
IF he disconnect and come back later with the same IP and a different name, all players will see 
that his connected in the past under a different name. 
The 100 last different IP are stored and remember. 
WHen 100 Ip had been stored, the frist IP is override with the 101 IP, then the seconde IP is overwrite....etc... 
All IP with name are stored in a separate file ipname.txt and refreshed at each map change or level change. 
this file is loaded at server startup so that you keep the memory of each player IP. 




------------------------------------------------- 
13 CONFIGURABLE SABER DAMAGES ===> Does it change the gameplay and DMGs with the default settings? 
	how to get the default basejka damages?
------------------------------------------------- 
OF COURSE NO 
with d_saberSPStyleDamage 1 
 jp_alterDMG 0 
jp_reduceSaberBlock 0
jp_allowSaberTouchDMG 0
jp_improveYellowDFA 0


===> all damages become unchanged like in BASEJKA 



-------------------------------------------------- 
14 NEW VOTE MANAGEMENT jp_votesDisable ==> how i disable a vote? 
------------------------------------------------- 
if g_allowVote is 0, not vote are possible. 
If g_allowVote is 1, only the vote types allowed by the cvar jp_votesDisable are allowed. 

you have to add the bit values of votes you want to disallow in the cvar jp_votesDisable. 
By default jp_votesDisable = 0 ==> all vote are allowed. 


-------------------------------------------------- 
15 Can i force a player to go in a team, or spectator or join the ffa in every gametype? 
------------------------------------------------- 
YES, use amforceteam... 
you can also lock, blue, read, spectator, or lock the joining game.... with amlockteam. 

------------------------------------------------------------- 
16 : CHAT GOD SYSTEM what is it? 
------------------------------------------------------------- 
The chat god is an automatic admin system which protect people who are chatting (or with console open).... 
This can"t be use to lame because you can't be god while attacking and bubble chat at the same time, 
You can't do damage while attacking with chat buble on at the same time... 
you can't become god while being gripped and puting bubble chat after being gripped..


--------------------------------------------------------------
17:  How works /amvstr ?
--------------------------------------------------------------
amvstr can execute a variable already defined in the server.cfg

for example: put in your server.cfg ==> seta test_vstr " d_saberSPStyleDamage 1 ; jp_alterDMG 0 "
restart your server
then log in as an admin, then type into the console /amvstr test_vstr
=====> it will execute d_saberSPStyleDamage 1 then jp_alterDMG 0

this cmd is ideal to create macro variable that u can use to change quickely dynamically the cvar value
But the previous value keep the same in the server.cfg
so if you restart the server, it will load the previous value of the server.Cfg

--------------------------------------------------------------
18 : is ja+ reamain a server side mod?
--------------------------------------------------------------
yes the JA+ mod can always turn as a server side only mod.
BUt the ja+ has the capabilty to be pluginable.
But this client plugin is not needed to make ja+ work.
this plugin is made to enhance UI, animations, graphic rendering....
In server cvar sv_pure 0, the server is not obligated to install the client side plugin in the japlus folder.
Moreower, every player will be able to join the server even if they don't have the plugins.
The players who have this plugin will have a better enhancement in UI, animation, graphic rendering ...etc...

--------------------------------------------------------------
19 : duel isolation (non interference duel) how it works?
--------------------------------------------------------------
to enable it you have to set at server side jp_duelAlpha between 0 and 255.
-1 to desactivate it.
for ex: jp_duelAlpha 50 is a nice value.

--------------------------------------------------------------
20 : d_saberSPStyleDamage what is it?
--------------------------------------------------------------
**d_saberSPStyleDamage 1 : this is the default basejka value: it means that in the default basejka, the damage management
system is the same as the one you find in Single PLayer game.
don't forget that if you have put jp_alterDMG to 1: the value of d_saberSPStyleDamage is ignored 
and you will have MP sytele damage.


****d_saberSPStyleDamage 0: this is JA+ extension: it enable to activate MP damages. This is the old damage system
management that is close to what you had in JK2.
Moreover in this MP damage, you can modify all damage attacks thanks to the other cvar of the mod.
The modification will be take into account if jp_alterDMG is 1.

*****The code is sp style damage is totally unchanged. IF you want to have basejka damages you will have to read also this 
FAQ to know the value of several cvars that correspond to basejka.(question 13)

-------------------------------------------------------------
21 : 16 increased to 32 different vehicles max spawned in a map and 
	.veh & .vwp files max size increased to allow to load a lot of pk3 vehicle files (more than 50).
	.veh extension file too large? what is it?
-------------------------------------------------------------
The server is now capable of loading a lot of vehicle pk3 files without crashing. 
	instead of about 10 extra vehicle pk3 files in basejka, i could load about 50 vehicles (whose about 20 that come in the game + about 30 new pk3 files) Perhaps it is possible to load more but not tested.
	If you don't use the JA+ plugin, the server will be able to load all those vehicle pk3, but not the player. So the player wil have to put only the pk3 he needs to play the map like he was doing before.
	If you use the JA+ plugin, you can put in your base folder the same number vehicle pk3 files than the server (so a lot :) )....
	In a map, you can spawn MAX 32 different vehicles instead of 16 in the basejka.


----------------------------------------------------------------
22: when i start my game all my settings are initialized with the default?
----------------------------------------------------------------
this problem occure if your jampconfig.cfg file in Japlus folder is too large (about more than 14 Ko).
It means that you have to much cvars set in it...

You can solve easily this problem by making a japlus.cfg script that contains all your binds and your config
Before to start the game, just delete your japlus/jampconfig.cfg
Then start your game with japlus loaded. your jampconfig.Cfg will be reinitialized with the working one from base folder
Then exec your japlus.cfg config /exec japlus.cfg...

You can automate all those actions with a .bat script:

Create a Txt file play.txt in your gamedata folder
Open it with notepad.
Write in this file :
	del /q .\japlus\jampconfig.cfg
	call .\jamp.exe  +set fs_game japlus +exec japlus.cfg

Save it and rename it with playJaplus.bat
Then execute this bat file (Double click on it).

----------------------------------------------------------------
23 : death method MOD_FALLING, CRUSH ....etc... what is it?
----------------------------------------------------------------
In the plugin other death message are added, like water, cruch, falling messages.
If you don"t start the game directly with japlus loaded, the jamp.exe do not load correctly the new messages.
So you will have to use the bat file play_japlus.bat provided with the mod to start the game.

you can also create a shortcut of the jamp.exe and add to the target in the properties menu of this shortcut:
GameData\jamp.exe" +set fs_game japlus 
