-------------------------------------------------------------------------
------------------------- JJ2 Add-on for mIRC ---------------------------
-------------------------------------------------------------------------
-> Version 4.0 [2007-07-28]
NOTE: Please visit http://www.geleia.net/lixo/addon/ for more
information, including help.
--=> Introduction
'JJ2 Add-on for mIRC' is a multiplayer launcher which allows you to
easily and quickly host and join internet JJ2 servers.
--=> 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 add-on v4.0' on the context menu which pops up.
--=> 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.
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.
--=> Compatibility
This add-on works with the following mIRC versions:
- mIRC 6.2
- mIRC 6.21
NOTE: mIRC 5.91-6.17 support was dropped in version 4.0. If you must
one of those mIRC versions, download version 3.5 of the
add-on from http://www.geleia.net/lixo/addon/
NOTE: This add-on probably works with more recent versions.
However, by the time this add-on was released, mIRC 6.21
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.
--=> 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.
--=> 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.
Changes v3.5 - v4
- mIRC 5.91-6.17 support discontinued.
- "Select Level" dialog significantly improved and renamed "Level
Browser".
- Version, tileset, missing dependencies, belonging in level
sequences and time of last modification were added to the
level list.
- Added level thumbnail.
- Added other extended information, such as next level, secret
and music files.
- Added button for launching JCS.
- Added button to transitively list all the dependencies of a
certain level.
- Double clicking a level now launches a full-size picture of the
level.
- "Level Browser" can be launched outside of the context of
selecting a level to host. In those circumstances, you will be
able to launch the level in single player mode. Accordingly,
added a popup entry to launch this dialog directly.
- Added tileset functionality - thumbnail, picture/mask and
palette extraction.
- Added support for private servers. Clicking a confirmation or
entering a password is required (the user can choose between
the two methods).
- Added pinging for all servers, even the private ones. Servers
using 1.20 don't respond to the pings, but that, from what I
have seen, seems to be an 1.20 bug, rather than the ping
structure being different.
- Added 'Drop system privileges' feature. This is a security
feature that you are encouraged to use, but it is not enabled
by default for compatibility reasons. It should only work in
Windows Server 2003/2008 or Windows XP/Vista.
- Added message of the day to the list server popup submenu.
- Added dragging of lists headings.
- Added retrying after failing to connect to the list server.
- Added re-ping servers by right clicking a server from which we
already have the ping.
- Added sorting of columns in lists by clicking their header.
- Added persistent removal of servers (by alt+mouse click), but
not across mIRC sessions. The list of removals can be purged.
This option needs to be explicitly activated, so as not to
break previous behaviour.
- Added simultaneous copy/deletion of files in the browse dialog.
- Header width and order is now saved for the server list listbox
and for the profiles listbox.
- Implemented paliative solution for servers whose name includes
a CR/LF.
- Extended factor dialog converted to MDX.
- Fixed listing own 1.23 server as 1.23 instead of 1.21.
- Error messages are now cleared after 10 seconds.
- Time units for the uptime are abbreviated.
- Browse dialog filtering performance significantly improved.
- Ping responses one value below co-op are now considered to also
be co-op, though they technically probably are something
different like single player (speculation).
- Renamed %unse into %jj2.unse. If you had a non-default setting
for servers that cannot be joined, you'll have to redefine it.
- No longer AOSA entries are used for server points. As a side
effect, in order to ensure compatibility with previous
installations, AOSA names 'markpts' and 'showpts' cannot be
used.
- The .srv and udpping.dat files are not used anymore.
- Seconds are only shown in uptime if the server has been up for
less than one minute.
- No longer ".timer 1 0" is used for executing AOSA entries.
/scid is used instead.
- Fixed 1.23 servers being listed as 1.00 servers.
- S.I. now recognises a 242 Lori.
- Timer jj2ar and p1 are now stopped when the dialog is closed.
- Changed the list of list servers as well as the default list
server.
- Improved error handling in case there are missing files upon
script loading.
- Fixed capture the flag games being shown as "ctf" instead of
"capture" after the pseudo-ping.
- Changed the on/off markers on the popup menu.
- Number of users and ping now each contribute with an additive
constant to the pontuation, making "High ping inluence" really
depend only upon the ping.
- Fixed Lori not being activated/deactivated when loading .ini's
or copying between versions.
- Almost all global variables now use the %jj2. or %jj2u. prefix.
- Date removed from main dialog title bar.
- Removed the optional confirmation before the use of the server
information feature.
- Removed the download of a webpage upon startup for statistical
purposes.
- Removed the non-permissive mode of S.I.
- Removed auto LVL list builds.
- Other minor bug fixes and code cleanups.
--=> 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, 28 de Junho de 2007
Cataphract
Email: mail@geleia.net
Messenger: Cataphract@netcabo.pt
