					
						=    _________________         =
						=    ZZZZZZZZZZZZZZZZZZZ       =	
						=    ZZZZZZZZZZZZZZZZZZZ       =
       						=	        ZZZZZZZ        =
     						=	       ZZZZZZZ         =
    						=	      ZZZZZZZ          =
     						=	     ZZZZZZZ           =
    						=	    ZZZZZZZ            =
   						=	   ZZZZZZZ             =
  						=	  ZZZZZZZ              =
 						=	 ZZZZZZ___________     =
						=	ZZZZZZZZZZZZZZZZZZZZ   =
						=       ZZZZZZZZZZZZZZZZZZZZ   =
						=        
	
						       zBlock v4 Beta 2 Release
							  10 / 11 / 07
				       	           ===========================
				      		   Source Engine Server Plugin
					 	   http://zblock.cs-resourced.net


Beta Notes:
-----------------------------

This software is released as BETA, it may not reflect the actual release version of the plugin.
-> In short certain functions in this version may be modified or removed entirely in a later version.

We look forward to your feedback, preferably on our forums!

Notes to competitions/gaming leagues on this release:
This release is not just a test of the new player authentication feature, but also of some new methods behind the core release of the upcoming zBlock 4.

We are happy for you to make your own decision whether this Beta release is acceptable for use in your leagues or competitions.


About:
-----------------------------

zBlock was first developed as an addition to the "CSP" server plugin, at this time VALVe had accidentally let a convariable slip that would allow players to "wallhack".

"CSP" (CAL Server Plugin) was a server plugin that enforced certain convariables that could either be exploited or created an unbalanced/unfair playing field.

Another feature of zBlock was to make CSP more difficult to bypass, however not too long after release, we determined that instead of making CSP more difficult to bypass, we should instead take on board the functions CSP had due to the significant ease at which is was bypassed.

zBlock is now one of the most used CS Source server plugins all around the world, enforced in leagues like EnemyDown, CALeague and CEVO it's become a plugin you can't imagine CS Source without any more.



Installation instructions:
-----------------------------

Copy the files zblock.dll, zblock_i486.so and zblock.vdf to your servers
"/GAME/addons" directory, i.e. "/cstrike/addons/".

If the directory "addons" does not exist in you game-folder (i.e."/cstrike") you will need to create it first,


Notes: 
-'zblock.dll' is the Windows module and 'zblock_i486.so' is for Linux, if you are unsure which operating system your server uses: copy them both and the game will run the correct module for your platform (Recommended)
-zblock_css.vdf is required if you are installing on a Counter-Strike server, zblock_dod.vdf is only required if installing on a Day of Defeat Source server.
-Please make sure your server is up-to-date using the 'hldsupdatetool' otherwise the plugin will not load for reasons of server security.



Enabling/Disabling zBlock:
-----------------------------

Firstly it is recommended that any server config changes affecting zBlock are made in the "server.cfg" file on your server, and not the "autoexec.cfg".

To Enable/Disable zBlock the CVar "zb_active" is provided (accessible via rcon or by addition to a server config), set this to '0' to disable the plugin, and use '1' to re-active.
i.e. From your clients console type
"
 rcon_password YOUR_RCON_PASSWORD
 rcon zb_active 0
 rcon zb_active 1
"

It is highly recommended that zBlock be kept running at all times (for most competitive and league games this will be a must).



zBlock commands and settings:
--------------------------------

"zb_status"
- Client console command, can be entered in console at any time.
- Displays important server settings

"zb_netinfo"
- Client console command, can be entered in console at any time.
- Displays clientside netsettings (rates, interpolation, prediction, lag compensation)

"zb_version"
- Client console command, can be entered in console at any time.
- Displays version of zBlock currently installed on the server

"zb_help"
- Client console command, can be entered in console at any time.
- Displays information about available zBlock commands

"zb_readylist"
- Counter-Strike: Source Only
- Client console command, can be entered in console at any time.
- Displays ready and not-ready players when using the ready-up system.

"zb_players" 
- Client console command, can be entered in console at any time.
- Displays a list of players authenticated by a configured auth-host (zb_authhost)


--

"zb_lo3"
- Not available in DOD:Source
- Server console command, needs to be used through RCON (IE: rcon zb_lo3)
- Executes config defined in "zb_matchconfig"
- Restarts the round 3 times
- Returning startmoney to value set in "zb_startmoney" (Default 800)

"zb_ko3"
- Not available in DOD:Source
- Server console command, needs to be used through RCON (IE: rcon zb_ko3)
- Restarts the round 3 times, declaring a knife-round

"zb_readyup"
- Counter-Strike Source Only
- Server console command, needs to be used through RCON (IE: rcon zb_readyup)
- Use zb_readyup to start, or stop the readyup sequence
- Accepts "1" or "0" as parameter, "1" enabling readyup, "0" disabling readyup.
- Allows all players to set themselves as ready
- When all players are ready, zb_lo3 is triggered

"zb_players"
- Server console command, needs to be used through RCON (IE: rcon zb_players)
- A mirrored server-side command of the "zb_players" client console command.

--

"zb_matchconfig" (Default: None)
- Not available in DOD:Source
- Server console settings, needs to be set through RCON (IE: rcon zb_matchconfig calcss.cfg)
- Match config to be executed before initiating the live on 3 sequence
- Note: To reset this value using rcon use: rcon zb_matchconfig " "

"zb_readyup_max" (Default: 10)
- Counter-Strike Source Only
- Server console settings, needs to be set through RCON (IE: rcon zb_readyup_max 6)
- Minimum number of players required to be ready to initiate lo3

"zb_startmoney" (Default: 800)
- Counter-Strike Source Only
- Server console settings, needs to be set through RCON (IE: rcon zb_startmoney 5000)
- The amount that startmoney should be returned to after the live on 3 sequence is completed.
- This is to prevent players from regaining full money by using "retry" in the second round of overtime.

"zb_authhost" (Default: NONE)
- Server console settings, needs to be set through RCON (IE: rcon zb_authhost zblock)
- Configures the auth-host to use with zBlock, to authenticate new players (please see our article on "Player Authentication" at our website).
- Note: To reset this value using rcon use: rcon zb_authhost " "



A note about sv_pure:
------------------------

zBlock 4 will allow sv_pure values 1 or 2 whilst the plugin is active and will automatically change the map (issuing a kick message to all connected clients) whenever its value is changed - this is to allow the new value to take effect correctly.

Warning messages will be issued on connecting if sv_pure is not set to "2".
Note: All league servers should have the setting "sv_pure 2" in their server.cfg's.

A further change from zBlock3 is that sv_consistency is forced to 1 whilst using zBlock is active.



 
LAN Mode
------------

LAN mode will become active with the following changes made:
sv_lan 1
sv_unlag 0

This will cause zBlock to run with optimal settings for LAN gaming.


Plugin not loading?
---------------------

If the plugin does not seem to be loading, here are some tips for troubleshooting the issue.

1.Restart the server and join and type "rcon plugin_print", is zBlock listed in the list of plugins?
-If it is, then maybe "zb_active" is set to '0'.

2.Load the plugin manually using:
rcon plugin_load "../cstrike/addons/zblock"

View the message which appears, this should help you locate the issue.
-Note: This action will not actually allow you to load the plugin, but should indicate the problem.

3.Stop your server.
Remove all zBlock files from your "addons/" directory.
Make sure the server is up-to-date using the hldsupdatetool (use the "-verify_all" command line option when updating to check for corrupt files).
Re-install zBlock as per the instructions in this text file. (Make sure your version of zBlock is also the latest).
Restart the server.

4.Contact your server administrator/GSP staff.


Map restarts triggered by the zBlock plugin
---------------------------------------------

On changing the value of certain server cvars when running the zBlock plugin your server will automatically restart the current map (kicking all players to give the reason for the map change), this is done to ensure a level playing field on your server and also for ease of use to server administrators.
A change in the following cvars will trigger a map restart:
zb_active (on only)
sv_cheats (off from on)
sv_pure
sv_consistency
mp_dynamicpricing (CSS)

CAUTION: Be careful that you do not make contradicting references to these cvar values in your "server.cfg" (ran automatically on map loads) as this will cause your server to repeatedly reload the map.
i.e. 
sv_pure 0
...
sv_pure 2


Authors and Credited Others
-----------------------------
"TheUnknownFactor"
"J3Di"
"Trepje"

Contact details are available from our website