-------------------------------------------------------------------------
------------------------- JJ2 Add-on for mIRC ---------------------------
-------------------------------------------------------------------------
-> Version 3.5 [10-10-03]
NOTE: Please visit http://www.aleger.tk/ for more information,
including help.
--=> Introduction
'JJ2 Add-on for mIRC' is a multiplayer launcher which allows you to
easily and quickly serve and join internet JJ2 servers.
--=> Regarding the Rumors
It seems there are some rumors about this script having a trojan horse,
so let's clear up the things.
This scripts DOES use mIRC's socket functions. Therefore, some scanners
may classify this script as potentially dangerous.
This script DOES NOT listen to any port whatsoever, so it CANNOT accept
incoming connections.
This script ONLY uses the socket functions to:
1) Retrieve the server list.
2) List a server.
3) Check for updates.
4) Download the updates.
5) Get the list server statistics.
6) Download a page for statistical purposes.
You can check the script yourself. There is no malicious code.
However, spiteful actions may actually be performed with the use of 4),
since the updates may have damaging code. Therefore, I'm going to clarify
how the updates feature works.
A) An .ini file is downloaded from (and only from)
http://pwp.netcabo.pt:80/0149486101/jj2/jj2u.ini. This file
contains the number of the latest version as well as the
addresses of the update files.
B) The .ini file is read and, if the version number specified in
it is greater than the script's version number, the script
_ASKS_ the user whether he wants to download and install the
update.
C) If the user answers yes, each file specified in the .ini is
downloaded and copied to the script folder afterwards.
Consequently (since I'm the only one who is able to touch the .ini
file), the possibility of performing malicious actions depends only upon
me. So, if you do not trust me, just say no to the update warnings or
TURN OFF THE AUTO-CHECK FOR UPDATES OPTION.
Alternatively, set the update method to manual so you can see the
update content before it is loaded.
This can be achieved via the popup menu.
If you still have any doubt, please contact me.
--=> False Alarms
Some antivirus report a virus/trojan on one or more of the following
files:
- registry.dll
- MDX.DLL
- views.mdx
THESE ARE FALSE ALARMS. Some DLLs for mIRC are actually virus and
they probably share some code with these files and therefore the
scanner stupidly makes a generalisation.
Those files were written by the best mIRC DLL coder, and he includes
the source code of his DLLs, so I would reject the possibility of a
virus.
--=> Compatibility
This add-on works under the following mIRC versions:
- mIRC 5.91 32bits
- mIRC 6.0
- mIRC 6.01
- mIRC 6.02
- mIRC 6.03
- mIRC 6.1
NOTE: This add-on probably works with higher versions. However,
by the time this add-on was released, mIRC 6.1 was the most
up-to-date mIRC version.
This add-on works for the following JJ2 versions:
- 1.23
- 1.24 (TSF)
- 1.24 x (CC) (read note 3)
NOTE: You will be able to join 1.23 s and 1.24 s (shareware)
servers.
NOTE(2): This add-on is not compatible with private servers.
NOTE(3): Read the following section for details regarding the
1.24 x support.
--=> 1.24 x (Christmas Chronicles)
This add-on only allows you to join 1.24 x servers.
It does not allow you to:
- serve CC games.
- change Player 1 for CC.
By the way, if you have TSF you can manage to join the rare CC
servers. Open your tsf jazz2.exe with a hex editor like XVI32. Search
for the string '1.24 (space) (space)' - equivalent to HEX
31 2E 32 34 20 20 and replace it with '1.24 x'
(HEX - 31 2E 32 34 20 78). Now save the file with the name sth.exe and
put it on the TSF dir.
If you did it correctly you'll just have to launch that file in order
to join (and serve) CC games. It will use the TSF definitions. You can
also provide its path for JJ2 add-on and join CC servers from there.
NOTE: You will _NOT_ see incorrect animations and cause lag as
a consequence resulting from this procedure. This is _NOT_ the same as
joining 1.23 servers with TSF or vice versa for 1.24 and 1.24 x are
very similar versions.
--=> Installation
Unzip all the files contained in the downloaded zip file to the same
folder and then open mIRC and type:
/load -rs path to\jj2.mrc
NOTE: If the path contains at least one space, you'll have to
quote the path.
ex.: /load -rs "c:\program files\mIRC\jj2 add-on\jj2.mrc"
Alternatively, type:
//load -rs " $+ $findfile(letter:,jj2.mrc,1) $+ "
Just replace letter: with the letter of the drive wherein the
add-on is located.
--=> How To Use This Add-on
Simply right click on a status/query/channel window area and explore
the submenu 'JJ2 SL' on the context menu which pops up.
--=> Version History
Changes v1.03-v1.1
- J2sl uses a list in the main table, instead of the multiple
edits.
- No server limit.
- J2sl v1.03 didn't load any 1.24 saves if you don't specify the
path for 1.23. Fixed.
- Changed "Retrieving Server" into "Receiving server list"
- on load event changed
Changes v1.1-v1.12
- Now you can hide the servers you cannot join or disable the
Join button when you select an unjoinable server.
- Some other minor changes..
Changes v1.12-v2
- Many
Changes v2-v2.1
- Several bugs fixed
- On load event changed
- Added an on start event which checks for updates each time you
open mirc
- Added the 'Check For Updates' feature
- Hexadecimal thing (fur)
Changes v2 - v2.3
- Servers are now pinged
- Some Bugs fixed
- You may double-click a server to join it
- Altough it is discouraged, since the ping results may be shown
in the incorrect line, you may Shift+click to remove a server
from the list
- Level name (not its filename) is also shown in the browse files
dialog
- Fixed the Browse files dialog, which had been messed up in
version 2.2
- Added a function in the browse dialog to copy a level in your
1.23 dir to your TSF dir and vice-versa
- You may delete levels in the browse dialog with shift+click
- You may move the levels in your cache to your main jazz2 dir
(popups).
- Unless you have chosen to hide 'unjoinable servers', the number
of servers in the list server is shown.
Changes v2.3 - v2.4
- The first time you set up a server you could click 'Browse'
w/out picking a version. Fixed
- The on start event had disappeared... Fixed
- If you were on tab 'Serve' and the contents of ID 1 were changed
you had to click over the 'join' tab and then the 'Serve' tab
again in order to display its contents correctly. I made it so
when you click over 'Serve' J2SL stops pinging the servers.
However, the problem remains if you click 'Serve' before the
servers are listed.
- When the connection with the check-4-updates server fails,
J2SL writes to the 'upta' dialog 'Connection failed' instead
of 'Connected!'
- Changed the name of the script to 'jj2.mrc' shrink the file
size.
- Changed the default list server from 'monolith.idlegames.com'
to 'jazz.logicware.com' ('monolith.idlegames.com' doesn't work
anymore)
- Removed 'monolith.idlegmes.com' from the popups.
Changes v2.4 - v2.5
- MDX 0.92, which means compatibility with mIRC 6.0x and no
problems with the tabs.
- Check-4-updates and update features completely remade. Now
it is more autonomous.
- The Hexadecimal to Decimal and vice-versa alias uses $base()
instead of the nonsense used before.
- R doesn't close the dialog anymore. Now it just cleans the list
and downloads the server list again.
- Minor bug fixes.
- Some internal changes which made the code tidier and smaller.
- The add-on does not require being put in the mIRC dir anymore.
- Now the path to the add-on may contain spaces.
- Monolith.idlegames.com re-added, however it is not the default
one.
Changes v2.5 - v2.52
- Fixed bug which was preventing joining servers which didn't
send its version to the list server.
- This readme is displayed when the script is loaded.
- Added option 'Run Readme.txt' to the menu.
- Fixed bug which used to occur when clicking 'R' before the
server list was received.
Changes v2.52 - v2.6
- The script now warns the user when the connection to the list
server fails.
- Added an uptime field. The IP tab is now hidden.
- Serverlist on sockread event remade, it is now much cleaner.
- Added the 'Regarding the Rumors' section in this readme.
- Added the 'List Server Statistics' option.
Changes v2.6 - 2.62
- Added the manual option for downloading updates.
- Auto update bug (hopefully) fixed. It was preventing the
download of the last file (not always though).
- Playerum dialog: radio buttons used to the detriment of
the menu.
- Playerum dialog: Added an image showing the successive
colors obtained with the |'s.
- Other minor changes concerning the playerum dialog.
Changes v2.62 - v2.7
- Minor playerum dialog menu change.
- Games w/ unknown game type show ?? instead of 'unknown'.
- Several minor bugfixes.
- Added the random fur buttons.
- Now .ini's can contain data referring to more than one
version.
- Fixed acute bug which was showing private servers twice,
one of the times offering to the possibiity to join them.
Changes v2.7 - v2.8
- Fixed little mistake regarding the 'unk' dialog.
- Added a slight support for 1.24 x.
- Added the auto-refresh option.
- Fixed a small mistake on the 'playerum dialog'.
- Fixed little playerum dialog imperfection.
Changes v2.8 - v2.81
- The option to disable the join button works again.
- The option to hide the servers which cannot be joined works now
for 1.24 x servers.
- New enter_ip dialog. You can now join 1.24 x games via IP using
that dialog.
- The 's and the eventual number after it is now removed from
the server names and the level names.
Changes v2.81 - v3
- Minor bug fixes.
- Added the 'server info' feature.
- Added the Shortcuts thing.
- Added a warning box which is displayed before accessing the
'Change PLayer 1' feature.
- The main jj2 add-on window is made active after, for example,
closing The Change Player 1 one.
- Little adjustment on the 'Chng. Player 1' dialog.
Changes v3 - v3.1
- Everytime the script is started a website is visited for
statistical purposes.
- Added a 'news' feature.
- Removed to echoes I used for my debugs (S.I. feature).
Changes v3.1 - v3.11
- Added a ninth shortcut.
- The main dialog is now more equilibrated and rational.
- Added the add-on menu to the menu bar.
- Fixed which was preventing the Shortcut reset function to work
unless there was no crosscuts.ini file.
Changes v3.11 - v3.12
- Fixed some minor bugs.
- Fixed a bug which was making the events which were supposed to
be run only when some two buttons of the dialog 'browse'
trigger just by putting the mouse cursor over the buttons
(mIRC v6.03).
- Fixed a serious bug which was making the S.I. feature
malfunction under certain circumstances.
Changes v3.12 - v3.13 [not public]
- 'treas' is displayed instead of 'treasure'.
- The exact version appears in the name of the user which joins
a server in order to retrieve the level and player list.
- Added a /jj2.add.server <ip> [version] alias.
Changes v3.13 - v3.2
- Fixed a serious bug in the S.I. feature, which existed since
version 3.12.
- The add-on reads the last byte of the pseudo-ping and re-adds
the server with its correct version, game type (including co-op
and Race) and whether it is private or public.
Note: Servers listed as private are not pinged, so a server
erroneously listed as private cannot be displayed as public at
a later time.
Changes v3.2 - v3.21
- Changed 'Terminate' into 'Close' in the main dialog.
- Fixed a minor bug.
- Fixed a bug which was preventing some 1.23 related functions
from working.
Changes v3.21 - v3.3
- Added the filter feature.
- Added a 'delete' button to the browse dialog (it has the same
function 'shift+mouse button' has).
- Shortened the code that checked whether a certain version was
installed throughout the script (it is possible that I have
made some mistake because I had to substitute a lot of
occurrences).
- The add-on creates hash tables for the list of levels (so that
it becomes faster to apply the filters).
- Added an option that allows those tables to be created 'on
start' in lieu of each time the browse dialog is launched
(which speeds up the launching). Useful if you a lot of files.
- A few other minor changes.
Changes v3.3 - v3.31
- Restored mIRC 5.91 compatibility (two changes).
- Levels were being load too many times (I didn't remove a
portion of the old code). My tests have shown that, after this
modification, the time spent until the LVL list is displayed
when using the Auto LVL list build is approximately 50% of the
time spent if the option is not enabled (for an average LVL
collection and if the JJ2 folder was read little time before).
- JJ2 add-on was looking for lvls in subfolders of the JJ2
directory. Fixed.
- Fixed a minor bug which made the browse dialog not show any
window if LVL list build on startup were activated and the
location of the concerned .exe had been set before mIRC had
been restarted.
- 'deactivated' in the 'loading...' dialog, not 'deactive'.
- When the server is unable to determine the version of the
server via the pseudo-ping (it happens only under abnormal
circumstances) it displays "??" in place of showing nothing.
- Done a few position adjustments to the 'Join' tab (main
dialog).
- Removed the square brackets around the players/capacity
information.
- Other minor changes.
- The pseudo-ping is now being correctly interpretated for
the shareware versions (I hope).
Changes v3.31 - v3.4
- All on dialog events about the dialog server_list assembled in
one big *:dialog:server_list:*:*:
- 'Change player 1' completely reformulated.
- Added the Statistics feature.
- The levels are now shown with some order.
- Added a feature which allows you to remove your colors right
before you serve or join a CTF server (colors are restored a
few seconds after).
- The content of the pseudo-ping is not analysed for 1.24 x
servers because I was unable to comprehend how to distinguish
a 1.24 x server from a 1.23 server through the pseudo-ping.
- Added the option 'S.I. permissive mode' which makes the S.I.
sockread trigger not close the connection with the JJ2 server
even if the inicial message doesn't include the string ".j2l".
- Improved the saving of profiles through the S.I. dialog.
- Fixed a bug which was making the trigger of the 'unk' dialog
launch JJ2 just by putting the mouse cursor over the buttons
(only mIRC v6.03, I think).
- Added the possibility of not participating in the anonymous
statistics.
- Added a popup option which allows activating the Spy Window.
- A lot of small changes.
Changes v3.4 - v3.41
- Once spy was activated it could not be deactivated. Fixed.
- Alias remcolsp improved.
- Added a 'record' option, includes the switch to create macros.
- Made several improvements to the 'Change Player 1' tab.
- Changed the way the extension factor is edited, now it has a
more elaborated dialog.
Changes v3.41 - v3.42
- Fixed a few minor bugs (actually only one, I think).
- Changed 'On' and 'OFF' into [] and [ ]. Now, identify what is
activated and deactivated is much easier.
- Added the possibility of changing the name of the bot that
retrieves the server information.
- Changed 'JJ2 SL' into 'JJ2 add-on vx.xx' (popup menu).
Changes v3.42 - v3.5
- Fixed a nasty bug which was making mIRC exit in case the HTTP
server sent an unexpected response (bug existed since v3.4).
- Added Server Scores (works with two AOSA entries) and Join Best
Server features.
- Added support for an entry in jj2u.ini which makes mIRC not
download a certain file if it already exists.
- Added tooltips to several dialogs. They may be deactivated to
speed the loading up.
- The way the dialog is enlarged/shrunk to show/hide the
shortcuts has been changed. Fixed the problems inherent to the
last method.
- S.I. now recognises a bird (1.24).
- Added AOSA (Automatic On Server Actions).
- Changed the default list server to 'jazz.contrabandent.com'.
- Removed 'jazz.logicware.com' and 'monolith.idlegames.com';
added 'jazz.contrabandent.com'.
- The values of %listserver, %jj2.cfu and %unse were being
changed into the defualt ones on each load. Fixed.
- Unless one has chosen to hide the "unjoinable servers", the
total number of players and the record are shown.
- The alias check4updates used to be always called upon each
mIRC start, no matter the value of %jj2.cfu (unless %jj2.cfu
was undefined).
- Fixed bug which was making impossible to list a server in
case its name was a number.
- Other minor adjustments.
--=> Credits
- Dragonzap, MDX, http://www.dim-bulb.net/~dragonzap/dlls/
- Dragonzap, registry.dll, idem
- ClickHeRe, tooltip.dll, SDB.org Team http://scriptsdb.org/
- Dohcan, Dialog Studio, http://www.mircscripts.org/dstudio/
- Link, Color Guide
-----------------
Lisboa, 10 de Outubro de 2003
Cataphract
Email: Cataphract@netabo.pt
UIN: 68196272
Messenger: Cataphract@netcabo.pt
