

        Playername Metamod Plugin v2.81!
                
        by Jussi Kivilinna <hullu@hullu.cjb.net>
                 
        http://hullu.xtragaming.com/
        
        [13.9.2003]


PLUGIN:
^^^^^^
  * Shows name of targeted player. 
  * In teamplay shows text with different color for enemies and teammates.


INSTALLATION:
^^^^^^^^^^^^
 
1. You need newest Metamod or Adminmod. (www.metamod.org / www.adminmod.org)

2. Extract playername_mm.dll and playername_mm_i686.so to "c:\life\moddir\addons\playername"-folder 

3. Add following two lines to "c:\life\moddir\metamod.ini":

win32 addons/playername/playername_mm.dll
linux addons/playername/playername_mm_i686.so

If you reinstall Adminmod you have to add these lines again!


HISTORY:
^^^^^^^
        [2.81]
         * i686 optimized binaries included (playername_mm.dll and playername_mm_i686.so)
            - i586 binaries for older CPUs included too
         * Fixed "[META] ERROR: Plugin didn't set meta_result: playername_mm.dll:PlayerPostThink_Post()" on TFC

        [2.80]
         * Fixed model name compare being case sensitive
         * Fixed HLDM/OP4DM teamplay detection not working sometimes
        
        [2.71]
         * Fixed to work with hlds 3.1.1.1/4.1.1.1
        
        [2.70]
         * New extra info formats
            - %name%    is replaced with name of player
            - %health%  is replaced with health of player
            - %armor%   is replaced with armor of player
         * New color cvars
            - playername_dm_color, playername_friendly_color, playername_enemy_color
            - playername_team1_color, playername_team2_color, playername_team3_color, playername_team4_color
            - color format is read as: "%red%:%green%:%blue%"
         * Sourcecode cleanup
         * Compiled with metamod-1.08 headers (so you don't have to update your metamod to get playername running)

        [2.25b]
         * New installation directory (http://www.unitedadmins.com/info_addon_dev_standards.aspx)

        [2.25]
         * TFC spy fix

        [2.24]
         * Team detection wasn't working right way after XP bughunt

        [2.23]
         * Recompiled win32 binary with other compiler (it seems to have fixed XP problems :D )
         * Recompiled linux binary because of version number change :P

        [2.22]
         * Recompiled win32 binary. Might help XP problem.. most like doesn't.. I don't care :P

        [2.21]
         * Fixed cvar-reg problem with linux
         
        [2.2]
         * Faster teamdetection for CS (Less server CPU usage)
         * Customable HUD-text effects and timings
         * Easy copy-paste-to-config cvar-help in this file
         
        [2.1]
         * Playername is now paused for some time on new round start in CS. (playername_newround_pausetime cvar)
         * Added 'playername_version'-serverinfo-cvar.

        [2.0]
         * Team specific colors
         * Shows if targeted player is your enemy or friendly
         * Shows health/armor of teammates
         * Customable extra-info text
         * Shows names of enemies in CS/TFC as default
         * [bugfix] Fixed team detection for 'Arctic Avenger'-model in CS

        [1.5a]
         * [bugfix] Fixed bug that caused error message every frame

        [1.5]
         * Shows only names of teammates in CS/TFC/DOD and "playername_teammates_only"-cvar to change this

        [1.4]
         * Customable colors (Friendly/Enemy/Deathmatch -colors)
         * "playername_dmcolor"-cvar removed
         * MOD-Detection for DOD

        [1.3]
         * playername_vertical and playername_horizontal cvars for changing playername placement

        [1.2a]
         * Opfor CTF detection works now right way with all maps.

        [1.2]
         * [bugfix] Fixed bug that caused any server to crash after some time.
         * MOD-Detection for Phineas-Bot

        [1.1]
         * MOD-Detection for normal Half-Life, DMC, CS, TFC, OpFor
         * Team detection for CS and OpFor-CTF

CVARS (place these in your server.cfg):
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
// Enable/Disable plugin [1/0]
//
playername_on 1

// Plugin Disabled/Enabled with op4ctf [0/1]
//
playername_enabled_in_op4ctf 0

// How long time plugin is paused on new round in CS
//
playername_newround_pausetime 5.0

// Enable/Disable fast CS teamdetection [1/0]
//
playername_fast_cs_teamdetection 1

// Sets team detection style
//      100     Auto-detect mod  [default]
//      1       HLDM-style teamdetection (single model)
//      2       TFC-style teamdetection (TFC and DOD)
//      3       CS-style teamdetection (compare model names)
//
playername_teamdetection 100

// Enable/Disable spy fix in tfc (don't show playername on undercover spies)
playername_tfc_spyfix 1

// Disable/Enable forced teamplay mode [0/1]
playername_forceteammode 0

// Sets if enemy names are shown or not
//      1:      default with DOD
//      0:      default with others
//
playername_teammates_only 0

// Sets extra info mode
//      0:      Old style. Shows player name only
//
//      1:      In DM old style.
//              Shows Friendly name with "playername_friendly_extra_style" format
//              Shows Enemy name with "playername_enemy_extra_style1" format
//
//      2:      Shows DM name with "playername_dm_extra_style" format
//              Shows Friendly name with "playername_friendly_extra_style" format
//              Shows Enemy name with "playername_enemy_extra_style1" format
//
//      3:      Shows DM name with "playername_dm_extra_style" format
//              Shows Friendly name with "playername_friendly_extra_style" format
//              Shows Enemy name with "playername_enemy_extra_style2" format
//      
playername_extra_info 1

// These cvars set extra info formats.
//
//      %name%          is replaced with name of player
//      %health%        is replaced with health of player
//      %armor%         is replaced with armor of player
//      \n              is replaced with newline
//
playername_enemy_extra_style2   "(Enemy) %name% (%health%/%armor%)"
playername_friendly_extra_style "(Friendly) %name% (%health%/%armor%)"
playername_dm_extra_style       "%name% (%health%/%armor%)"

// Extra enemy info format without health and armor
//
//      This is used when "playername_extra_info" is 1
//
playername_enemy_extra_style1 "(Enemy) %name%"

// Sets vertical position of HUD text
//      0:      Up corner
//      1:      Down corner
//      -1:     Center
//
playername_vertical 0.6

// Sets horizontal position of HUD text
//      0:      Up corner
//      1:      Down corner
//      -1:     Center
//
playername_horizontal -1

// Sets HUD text effect
//
//      0: Fade In/Out
//      1: Credits (Flashing)
//      2: Scan Out
//
playername_hudtext_fx 1

// Sets HUD text fade in/out times
//
playername_hudtext_fadein_time 0.2
playername_hudtext_fadeout_time 0.1

// Sets how long HUD text is hold on screen
//
playername_hudtext_hold_time 0.75

// Sets scan time (scan effect only)
//
playername_hudtext_fx_time 0.1

// Use one color for each team in TFC,DOD,CS [1/0]
//
playername_use_team_colors 1

// Color for TEAM1
//      TFC: blue team
//      CS:  CT team
//      DoD: allies?
//
// RGB: 27,102,228
//
playername_team1_color "27:102:228"

// Color for TEAM2
//      TFC: red team
//      CS:  Terrorist team
//      DoD: axis?
//
// RGB: 230,53,0
//
playername_team2_color "230:53:0"

// Color for TEAM3
//      TFC: yellow team?
//
// RGB: 200,150,0
//
playername_team3_color "200:150:0"

// Color for TEAM4
//      TFC: green team?
//
// RGB: 72,193,29
//
playername_team4_color "72:193:29"

// Color for Friendly/Teammate
//
// RGB: 72,193,29
//
playername_friendly_color "72:193:29"

// Color for Enemy
//
// RGB: 230,53,0
//
playername_enemy_color "230:53:0"

// Color in DeathMatch
//
// RGB: 27,102,228
//
playername_dm_color "27:102:228"

