===========================================================================
MatchMod v0.90 Beta - Version LIGHT

  http://djeyl.net/m4

---------------------------------------------------------------------------
CONTENTDS

- LIGHT ?
- REQUIREMENTS
- INSTALLATION
- USING M4

---------------------------------------------------------------------------
LIGHT ?

M4 was basically designed to be used on several servers for LAN events.

Then it's become obviously necessary to make a version that would be less
hard to install -- in particular for clans renting individual servers and
not having what required to run m4 in 'full' mode.

So LIGHT version is only a MetaMod plugin (the same one, that detects it
must run in light mode).

No more MySQL database, no more web interface, no more centralized
management.

So now you've got a server addon that should allow you to play matches on
your server easily.

Functions that are available are the same as in full mode for in-game
features : m4 detects which team players belong to, assigns them to the
right side (Terrorist or CT), warm-ups, waits for players to be ready,
first half, second half, optionally overtime...

The difference is that players are identified with their clantags (in their
names or in a setinfo line ; cf. "Using m4" below).

---------------------------------------------------------------------------
REQUIREMENTS

* Game server :
 Half-Life 1.1.1.0 (HLDS 4.1.1.0 for Windows and 3.1.1.0 for Linux)
 Counter-Strike 1.5
 MetaMod v1.13

---------------------------------------------------------------------------
INSTALLATION

In the archive, only folder 'cstrike' requires to be uncompressed for M4
to run in light mode. It contains files to copy to your cstrike folder
(cstrike/addons/m4 subfolder).

Don't forget to declare m4 .dll / .so file in MetaMod's plugins.ini (where
other plugins like AdminMod, StatsMe or HLGuard might already be) that's
in cstrike/addons/metamod directory.

You can remove file 'cstrike/addons/m4/mysql.cfg' (full mode MySQL config).

Take a look at the other files in cstrike/addons/m4 ; read their comments
to see what they're used for.

Now add one of those syntaxes to your hlds command line :

+serverinfo m4_server light
or
+serverinfo m4_light 1

That's all !...

---------------------------------------------------------------------------
USING M4

Well, if you've successfully installed it, you probably won't have problems
using it... Here are some CVARs and console commands.

(Please remember it's only a beta version)

(please read ReadMe.txt file for further information about in-game features
 during a match)

Warning :
the following commands are CONSOLE commands ; they need you to have an
access to server console (rcon or admin_rcon for example).


#1# Launching a match
------

Syntax  : m4_match Clan1 Clan2 map [side]

Examples :
m4_match *haHAha* [JJ.Google] de_aztec
m4_match *haHAha* [JJ.Google] de_inferno 1

First two parameters are team names (that will be used to recognize
players, cf. 3).

Third parameter is the map to play the match on.

Fourth and last optional parameter is a number :
- 1 : haHAha team will begin Terrorists, and JJ.Google CT
- 2 : well, guess :-)
- (unspecified) : M4 randomly decides


#2# Other commands
------

m4_force :
  tells m4 not to wait for the end of warming-ups, or latency periods
  between phases

m4_restart :
  restarts the current phase (warmup, first & second halves, first &
  second overtimes)

m4_cancelmatch :
  cancels current match

m4_endmatch :
  makes the server become "normal" again after a match (also gets
  back to "normal" status if you 'changelevel' to another map)
  * note * this is done automatically after 90 seconds

#3# Clantags, recognizing players
------

Example : so, you run this match : *haHAha* vs [JJ.Google]

Players are recognized to belong to a team thanks to their names, that
must contain _exactly_ one of those values :

"HAHAHA*Alfred" won't be recognized
"*haHAha*Alfred" will

"JJ-Florian" won't be recognized
"[JJ.Google] Florian" will

If players don't want to have exactly this in their names, they can
specify their team with a setinfo line :

setinfo clan "*haHAha*"
or
setinfo clan "[JJ.Google]"

Values also require to be exactly the same as those you specified as
parameters to m4_match command.

(Note : setinfo prevails on name)


#4# Here you go !
------

Don't hesitate to say what you think of m4, report bugs and tell what
features would be great to be added. Just send an e-mail or visit
m4 forums !

===========================================================================
