Q3Plug 1.3
==========

04/14/2003

Homepage: http://members.liwest.at/mb/q3plug
Author: Markus Baumgartner (markus.baumgartner@liwest.at)

Information for users of MS Internet Explorer 6.0 or MS Internet Explorer 5.0/5.5 SP 2:
---------------------------------------------------------------------------------------

You must apply this registry fix (http://members.liwest.at/mb/q3plug/q3plug_fix_ie55sp2_ie6.reg) in order to make Q3Plug work with these browsers. This is due to Microsoft having dropped support for Netscape-style plug-ins. This can be circumvented by this fix, however.


General information: 
--------------------

This web browser plugin is a rewrite of the popular QPlug/Q2Plug-Plugin by John Carmack, Jack Mathews and Dave Kirsch. Its purpose is to provide information about Quake 3 Arena servers such as game settings and connected players. Like the original version, Q3Plug features a connect button that can be used to connect to the game directy from the browser. Q3Plug has been tested with Internet Explorer versions 4.0, 5.0, 5.5, 6.0, Netscape Navigator version 4.x and 6.x, Mozilla 0.9.9, and Opera version 4.0 and 5.01 on Microsoft Windows 98, Windows NT 4.0,Windows 2000 Professional, and Windows XP. Other versions probably work, too. Please note, however, that Q3Plug won't work with Windows 95 unless it has been upgraded to Win95B or higher. 

Installation:
-------------

Note: Some browsers must be restarted after installation. If plugins directory does not exist, create it.

Netscape Navigator:
- copy "NPQ3PLUG.DLL" into Netscape\Communicator\Program\Plugins directory

Mozilla:
- copy "NPQ3PLUG.DLL" into Mozilla.org\Mozilla\Plugins directory

Microsoft Internet Explorer < IE 5.0/5.5 SP2:
-copy "NPQ3PLUG.DLL" into Internet Explorer\Plugins

Microsoft Internet Explorer >= IE 5.0/5.5 SP2:
-copy "NPQ3PLUG.DLL" into Internet Explorer\Plugins
-open the file "q3plug_fix_IE55SP2_IE6.reg" (located inside the zip file) and click yes at the prompt asking for permission to 
 modify the registry

if you do not have this file, get it at http://members.liwest.at/mb/q3plug/q3plug_fix_IE55SP2_IE6.reg

Opera Software Opera:
- copy "NPQ3PLUG.DLL" into Opera\Plugins

Embedding Q3Plug on a web page:
-------------------------------

(only read this section if you are creating a web page and want to use q3plug on it)

Use the following HTML code on your page:

<p><embed 
width="width" 
height="height" 
type="application/x-q3plug-plugin"
name="IP address[:port]" 
game="game" 
pluginspage="http://members.liwest.at/mb/q3plug"
></p>

Where:
- width is a number specifying the width of the plugin window in pixels
  (please use a minimum width of about 400 pixels) 
- height is a number specifying the width of the plugin window in pixels
  (please use a minimum height of 90 pixels, minimum height of 134 pixels required for game bitmaps to be     displayed)
- name is a valid DNS name or IP address and port is an optional port number 
  (default port number for the specified game will be selected if no port number is given)
- game is one of the following (if you use these options, always use "application/x-q3plug-plugin" as MIME type): 
  - QW
  - Q2
  - Q3 (default)
  - UT
  - HL
  - TR
  - T2
  - CW
  - JK
  - MH (for instructions on how to specify the query port please see below)
  - NN (thanks to "SteelDen" xdeniz_at_mail.ru for sending the NN query code)

Note: Do not use multiple MIME types on a single HTML page. Some browsers do not like this. If you want to show different games on one page, use above parameters instead.  

Example:

<p><embed 
width="600" 
height="150" 
type="application/x-q3plug-plugin"
name="212.33.55.69:27960" 
game="Q3" 
pluginspage="http://members.liwest.at/mb/q3plug"
></p>

Optional parameters:
color="<HTML color code>"
color2="<HTML color code>"
bgcolor="<HTML color code>"
queryport="<port number>"

- color: Q3plug text color (defaults to white).
- color2: Q3plug alternative text color (defaults to red).
- bgcolor: Q3plug background color (defaults to black). If you use any other color than black, no game icon will be shown.
- queryport: this parameter specifies the port used for querying Medal of Honor and Unreal Tournament servers (defaults to 12300 for MOH and 7778/port+1 for UT)


Or just have a look at http://game.liwest.at/content_status_q3plug.asp

Version history:
----------------

q3plug 1.3b1 (2):
- added: "SteelDen" xdeniz_at_mail.ru sent in some query code for Neverwinter Nights (NN), which has been included
  in this version

q3plug 1.3b1:
- added: support for Medal of Honor Allied Assault, Jedi Knight 2
- fixed: problem with Half Life Day of Defeat servers (and possibly others)
- fixed: bug in query code for Tribes servers

q3plug 1.2b1:
- added: support for Tribes, Tribes 2, Quakeworld
- improved: Return To Castle Wolfenstein now has dedicated support
- added: custom colors for text and background
- changed: default list box background color is now black 
- added: registry fix to support Microsoft Internet Explorer 5.5 Service Pack 2 and Microsoft Internet Explorer 6.0

q3plug 1.1b5:
- added: game-specific bitmaps
- fixed: correct number of players now shown in OSP display mode
- new: optional disabling of OSP display mode  

q3plug 1.1b4 (test version):
- new: direct launching of HL and UT 
- new: Auto Refresh
- fixed: network errors reported by Netscape after visiting pages containing q3plug
- fixed: GDI leak

q3plug 1.1b2 (test version):
- new: extended support for OSP Quake 3 servers (team display)
- fixed: multiple MIME types for game recognition replaced by a parameter (see above)
  (multiple plugin MIME types on a single page seem to cause some versions of Internet Explorer to crash)
- fixed: some minor bugs

q3plug 1.1b1 (test version):
- new: support for Half Life, Quake 2 (+Quake 2 engine games like SoF), Unreal Tournament server querying
- improved: better layout including image buttons and List View controls
- improved: sortable columns
- improved: higher timing precision
- improved: Quake 3 colored names displayed 

q3plug 1.0b2:
- fixed: sockets not being closed properly
- fixed: GDI memory leak

q3plug 1.0b:
- first public release

Credits:
--------

Special thanks go to:

gf\ff0      - for hosting q3plug on his web site (www.nem3d.net)
FuSioN|KoaX - for providing me with some useful hints on Win32 programming
OBC|gynta   - for beta testing q3plug and some hints on improving the UI

As well as a lot of others for helping me with q3plug.
