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

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


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? 
9 Can i teleport a player close to another player? 
10 How do the client scrip 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?


-------------------------------------------------- 
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? 
--------------------------------------------- 

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. 


--------------------------------------------- 
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?
--------------------------------------------------------------
by default the duel isloation is disable.
to enable it you have to set at server side jp_duelAlpha between 0 and 255.
for ex: jp_duelAlpha 50 is a good value.
