=    _________________         =
						=    ZZZZZZZZZZZZZZZZZZZ       =	
						=    ZZZZZZZZZZZZZZZZZZZ       =
       						=	        ZZZZZZZ        =
     						=	       ZZZZZZZ         =
    						=	      ZZZZZZZ          =
     						=	     ZZZZZZZ           =
    						=	    ZZZZZZZ            =
   						=	   ZZZZZZZ             =
  						=	  ZZZZZZZ              =
 						=	 ZZZZZZ___________     =
						=	ZZZZZZZZZZZZZZZZZZZZ   =
						=       ZZZZZZZZZZZZZZZZZZZZ   =
						=        
	
						      zBlock v3.2.2 Release
							  19 / 06 / 07
				       	           ===========================
				       	       Counter-Strike Source: Server Plugin
					 	  

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
"/cstrike/addons/" directory

If the directory "addons" does not exist in "/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)

Note: 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 important server settings, aswell as available zBlock commands

--

"zb_lo3"
- 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_readyup"
- 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_readyup_max" (Default: 10)
- 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_matchconfig" (Default: None)
- 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

"zb_startmoney" (Default: 800)
- 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.

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

zBlock will allow sv_pure to take any value so that it is also compliant with other mods, however warning messages will be provided whilst "sv_pure 2" is not enabled, all league servers should have the setting "sv_pure 2" in their server.cfg's.
"sv_consistency 1" is also required for league play and again a warning message will be given when this is not 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.

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 adminstrator/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

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