=====================================
= Multi Theft Auto mIRC Admin v3.24 =
=====================================

- Contents -

 1. Description
 2. License Agreement
 3. Installation
 4. Uninstallation
 5. MTA:mA command list
 6. Map function
 7. Credits
 8. Support
 9. Special thanks
 10. Disclaimers
 11. User requested functions
 12. Change log

- 1. Description - 

 A mIRC script to enable monitoring and administration of several MTA:0.5 servers at once via normal admin and admin+ server port and login, featuring script handling via standard mirc scripting.

- 2. License Agreement -

 MTA:mA v3.24 LICENSE AGREEMENT
 Copyright  2005 Aeron
 
 PLEASE READ THIS DOCUMENT CAREFULLY BEFORE INSTALLING THE SOFTWARE. BY INSTALLING AND USING THE SOFTWARE, YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THE AGREEMENT, DO NOT INSTALL OR USE THE SOFTWARE.
 Aeron (which is the author of this product) provides you this license to use this software. This free software is licensed and for use only under the terms of this Agreement.
 This software is provided 'as-is', without any express or implied warranty. In no event will the author be held liable for any damages arising from the use of this software.
 This software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties.
 You may distribute this software on on-line services, bulletin boards, or other electronic media provided that it is not modified and the original package remains intact with all accompanying files included, and provided that no fee is charged. This software may not be distributed on cd-rom, dvd-rom, disk, or other
 physical media for a fee without the permission of the author, which is Aeron.
 Altering and/or changing the files and/or other binaries included within this installation package in ANY possible way is forbidden (Except for mIRC scripts).
 Decompiling, disassembling or otherwise reverse engineering of ANY of the included dlls and/or binaries is forbidden. You may not modify, rent, or resell for profit this software, or create derivative works based upon this software.
 The origin of this software must not be misrepresented; you must not claim that you wrote the original software.
 If you use this software in a product, an acknowledgement in the product documentation and on the website is recommended before using this software.
 This license will terminate automatically and the software may not be used if you fail to comply with any of the above terms and conditions. The license may be terminated by either party at any time and without notice.
 The owner of the software has reserved the right to change the LA at any time. The latest version of the LA can be found within the latests release.
 This license may not be removed or altered from any distribution. 

- 3. Installation -

 1. Download the latest version of mIRC at http://www.mirc.com
 2. Unload older 'mta.mrc' by '/unload -rs mta.mrc' (Without qoutes)
 3. Remove older MTA:mA files
 4. Place all the files from the archive into a directory, Example 'C:\Program files\mirc\mtama'.
 5. In mirc's status window type '//load -rs $+(",$$sfile(*.mrc,Select your mta.mrc,Load),")' (Without qoutes)
 6. Select your 'mta.mrc'
 7. Click on 'Load' (It may ask for confirmation that you wish to run the script, hit Yes.)
 8. Done

- 4. Uninstallation - 

 1. Close MTA:mA dialog
 2. In mirc's status window type '/unload -rs mta.mrc' (Without qoutes)
 3. Repeat step 1-2 if you have multiple mIRC windows open
 4. Delete the files

- 5. MTA:mA commands list - 

 Commands that can be typed in the MTA:mA window:

 /close		- Closes MTA:mA
 /clear		- clears the log
 /update	- check for updates
 /con		- Connects to the server
 /dis		- Disconnects from the server

- 5. Map function - 

 Colors-Nick:
  Orange	- Dead
  Blue		- Pedestrian
  Purple	- Driver
  Teal		- Pilot
  Lime		- Selected

 Colors-Dot:
  Red		- Unknown/Player
  Pale blue	- Cop
  Brown		- Robber
  Bright pink	- Mexican
  Green		- Sailor
  Yellow	- Vice City Crusador
  Turquoise	- Secret Service
  Pale blue	- Custom Racer
  Brown		- Hollywood Stuntman
  Bright pink	- Commercial Stunter
  Green		- Trick Turners
  Yellow	- Street Racers
  Turquoise	- Suburban Stunters

 Zoom:
  Single left-click	- In zoom
  Single right-click	- Out zoom
  Double left-click	- Reset zoom
  Arrow-keys		- Move

- 7. Credits -

 Title				- Multi Theft Auto mIRC Admin (MTA:mA) v3.18
 Original idea and coding	- Aeron
 Advisor			- MrBump
 Officially approved by		- The MTA Team

- 8. Support - 

 mtama_help@hotmail.com	- Mail/MSN *
 http://forum.mtavc.com	- Forum
 http://www.aeron.tk 	- MTA:mA's website

 (* = Only support if you follow the rules:
  1 No MTA help 
  2 No non-MTA:mA knowers 
  3 No non-MTA:mA commands/identifers/events knowers 
  4 No script request 
  5 No notepad scripters 
  6 No chat flood 
  7 No website offer 
  8 No private email 
  9 No totally idiots 
  10 No kids under 18 [Below 18 = rule 9])

- 9. Special thanks -

 MrBump 		- For testing, advise & manual.
 [FMJ]Oli		- For advise
 RISO & IJsVogel	- For the netcode.
 Jey Bee 		- For the GTA:3 map.
 Pyromanic		- For the GTA:VC map.
 #mta 			- For the useless support.
 [WWS]Gunner		- For some PunkCatcher contribution.
 Khaled			- For mIRC!
 MTA Team 		- For MTA!
 Rockstar 		- For GTA!

- 10. Disclaimers -

 The maps for MTA:mA are not made by Aeron, only resized.
 They are taking out of other mods and if you want to use MTA:mA's maps for own products you have to read the disclaimers of the original authors:

 Jey Bee's "JB - GPS-Radar" mod:
 ---------

  This archiv can free offer to be download on other internetsites, if the archiv NOT changed.
  A use in other MODs are allowed, when my name as author mentioned!
  The maps are only to be change to private usings.

 ---------
 Email: JeyBeeHH@gmx.de
 MTA:mA has the author's name mentioned.

 Pyromanic's "GPS-Color-Radar" mod:
 ---------

  This addon is freeware and can freely be spread, as long as this readme
  is included and no changes to both the addon and the readme were made!
  I take no responsibility of any damage caused by usage of this product!
  It is strongly recommended to backup your files first!
 
  - You MAY NOT use this addon for your own projects without the WRITTEN
    permission of the author!
  - You MAY NOT sell this addon by eBay or similar auctions!

 ---------
 Email: McLarenFahrer@aol.com
 MTA:mA has written permission.

- 11. User requested functions -

 MrBump		- Server notes, slap button, remember window positions, delay of 5 seconds on Auto reconnect on timeout
 [FMj]Oli	- Enable scripts function, reload button
 {ULK}Dross	- Include nickname in messages option
 [Drugs]Toker	- Always on top function
 SwIF		- Vehicle health seperated from Player health
 meliantoni	- 'localhost' as host defining as the local host

- 12. Change log -

25/10/05 Version 3.24
 Fixed Update-button in Bans list-dialog
 Update-button in Bans list-dialog gets diabaled/enabled on disconnect/connect
 Menu with Alt combo's
 Seperated Server-options from MTA:mA options
 Moved all left-over buttons to the Help menu
 Added "Notify random weather change" option in options
 Added Player-menu in the menu bar
 Added /mta.setmotd (Read scripting.html first)
 Fixed mta.kill documentation

30/05/05 Version 3.23
 Added $mta.bans()
 Added /mta.tsay
 Added /mta.tmsg
 Added /mta.getbans
 Added Update-button to the banslist dialog
 Added Log file-button to the server-setup dialog
 Little changes

03/03/05 Version 3.22
 Fixed server-setup
 Fixed "/writeini" bug
 Added indication if the MOTD is changed
 Fixed mta.refresh bug (Hopefully)
 Changed menu
 Added MTA-MOTD viewer

28/02/05 Version 3.21
 Skin detection at spawn for GTA3:SSV
 Fixed previous-packet garbage bug (Text overlapping)
 Readded $mta.motd()
 Fixed offline join game
 MOTD viewer
 Improved mta.refresh
 Submode-type detection

09/02/05 Version 3.20
 Added:
  mta.money event
  mta.score event
  mta.submode event
  $mta.score()
 Changed:
  $mta.kills()
 Detection of all spawns.
 Map colors up-to-date
 Fixed negative score in GTA:VC Stunt
 Fixed mta.refresh
 Improved mta.refresh
 Timestamps for normal log
 'Recoverd' parameter on event on:SIGNAL:mta.join: when a player is recoverd
 URLs opened with standard browser

01/02/05 Version 3.19
 Measures against cracked dll
 MTA v0.5 compatible
 Added:
  $mta.submode
  $mta.sname
 Removed:
  Stunt mode area's
 Fixed $mta.vehicle()
 Improved spawn detection/PuckCatcher

11/01/05 Version 3.18
 Fixed PunkCatcher on mta.refresh
 Puckcatcher v0.7
  Some protection against 'Cracked client'

20/11/04 Version 3.17
 Multiple scripts possible
 (Help for converting at http://www.aeron.tk)
 Added $mta.event
 Double event checker
 All scripts shown in 'Scripts'-dialog
 Fixed robber's 3rd spawn location
 Fixed empty banlist on non-ip host
 (Might change your mta.banlist.ini)
 Puckcatcher v0.6
  Protection against 'Superbike'

28/10/04 Version 3.16
 Added: 
  Commands
   mta.black
   mta.update
 Added blacklist update status (Updated./No updates.)
 Added blacklist on/off
 Added include admin type on/off
 PunkCatcher v0.5:
  New protection against MTA Exploit Panel's
  Blacklist names removed

14/10/04 Version 3.15
 Added "(Normal/Admin+)" on !info
 Fixed some area typo's
 Fixed nicklist refresh on unknown
 Fixed some scripting.html bugs
 Fixed 'mta.event' bug on automatic weather change
 PunkCatcher v0.4:
  Added the blacklist

27/09/04 Version 3.14
 Fixed offline banlist-bug
 Nicklist refresh on unknown
 PunkCatcher v0.3:
  Fixed 'MTA Chat Bot'-bug
  Protection against 'BLooDs Weapon'

22/09/04 Version 3.13
 Disabled all weather functions for GTA:3
 Fixed area typo's (thx to [DK]Mike)
 Fixed GTA:3 money reset
 Nick-list refresh function
 Added 'Server setup'
 Fixed 'localinfo' bug
 'mta.mrc' now always 1st loaded script: better preformance
 Added $mta.server(Server).ip, .port, .cport, .send, .recieved, .time
 Added 'Join game' option
 Added client port
 Replaced 'Scripts archive' link with 'MTA:mA site'
 Fixed 'mta.punk' bug
 Added 'Auto open PM-dialogs on PM'
 Fixed some typo's in scripting.html

06/09/04 Version 3.12
 Added option to show MTA:mA on desktop
 Added option for silent DNS
 Changed 'Admin: text' to '<text>' in PM dialog
 Added 'Include admin nick in messages' support for PM
 Fixed PM-dialog name bug
 Host now doesn't get replaced with DNS-ed IP's
 'localhost' as host defined as local host
 PunkCatcher v0.2:
  Timer for "MTA chat bot" changed to 20 seconds
  Protection against "MTA Exploit Panel"
  Banning instead of kicking

04/09/04 Version 3.11
 Defined Dirtring, Hotring, Bloodring as area's
 Confirmation for unloading 'mta.mrc'
 Map function discribed in manual.txt
 Bigger dots on Map function
 Mouse click on Map is now middle of zoomed part
 Added !info for admins
 Added skin colors on the map
 Fixed empty socket info
 Fixed /mta.close bugs (Updater-bug)
 Fixed nicklist refresh after score/money-reset
 Fixed unknowns left on the map
 Fixed ingame / outgame bug in alias mta.spawn
 Fixed colors on the Map

31/08/04 Version 3.10
 Zoom function for the Map
 Warning if script is already loaded.
 Double alias check on Scripts-dialog close
 Multiple Private-chat's
 Location in Statistics replaced with Area
 Defined all districs as area's
 Fixed:
  Alias check bug - Defining local aliases '-l' as a alias
  Map bug - Not displaying PlayerID 0
  $mta.area(Server,PlayerID) bug - Defining a area when there is no data
  Window positions bug - Saving positions when not minimezed
 Added:
  $mta.dir - Returns the directory of the script "mta.mrc".
  $mta.scripts(<Server>) - Returns $true or $false if the server has scripts enabled.

22/08/04 Version 3.09
 $mta.location(Server,PlayerID) for passengers with driver
 $mta.health(Server,PlayerID).vehicle for passengers with driver
 $mta.location, $mta.vehicle, $mta.health, $mta.passenger fixed for 25+ player servers
 Fix for 'alias mta.enter' for passengers (Read scripting.html first)
 Faster MTA:mA reboot after update
 Auto MTA:mA start up when loading "mta.mrc"
 MTA link moved to options dialog
 Fixed scripting.html bugs
 Fixed updater bug
 Added 'alias mta.admin.action'
 Added 'alias mta.admin.pm'
 PunkCatcher:
  Now not pre-selected
  Renamed to 'PunkCatcher'
  Kicking instead of banning
  Delay changed to 15 sec

16/08/04 Version 3.08
 Fixed Health rounding
 3rd parameter of 'alias mta.exit' is the VehicleID
 $mta.health(Server,PlayerID).vehicle added
 Fixed "Unknown"-banning
 Punkbuster added (v0.1)
 "Enable scripts"-auto checked
 Server displayed in titelbar of Map
 Double alias checker over all loaded scripts.
 $mta.getid(Server,Wildcard) now returns -1 if no names matches
 $mta.passenger(Server,PlayerID) bug fixed
 Delay of 5 seconds on Auto reconnect on timeout
 $mta.vehicle(Server,VehicleID)[.name] bug fixed
 $mta.vehicle(Server,VehicleID).list driver bug fixed
 alias 'mta.spawn' added (GTA:VC only)
 $mta.skin(Server,PlayerID)[.name] added
 "Remember window positions" function added
 GTA:VC-DM kills bug fixed
 Improved scripting.html
 MTA:mA map disclamers discribed in manual.txt
 Vehicle health rescaled to 0-100
 $mta.area(Server,PlayerID) added
 Updater improved
 $mta.location(Server,PlayerID,[x/y/z]) added
 Faster map update
 Players in a vehicle blue
 Players on foot purple
 Selected player green
 Statistics dialog on double click on nick back

27/07/04 Version 3.07
 Fixed $mta.vehicle().id bug
 Fixed /mta.dis halting
 Fixed statistics refresh bug
 Selected nick on map now green
 $mta.vehicle().list added
 Focus on last active server on startup
 Time pre-set in options dialog
 Weather pre-selected in options dialog
 Script status reported
 Reload button added in scripts dialog
 /options removed from quick command list
 Dialogs are now children of the main dialog (Except the map)
 MTA:mA quick commands:
  Fixed /slap bug
  Fixed /msg bug
  Added /slap <ID/text> <text>
  Added /msg <ID/text> <text>
  Removed /options

26/07/04 Version 3.06
 Help button moved to options dialog
 Contact button added in options dialog
 Script archive button added in options dialog
 Statistics button added
 Statistics updated every second in dialog
 Nicklist agenda added
 Money displayed in nicklist when in GTA:VC stunt
 GTA:VC Stunt money fixed.
 $2000 money when a player joins in GTA:3
 Some text changes made

25/07/04 Version 3.05
 Nicklist bug fixed
 Loaded script now displayed better
 /mta.addban Reason fixed
 Slap button added
 Bans not added to banslist bug fixed
 Some dialog changes made

23/07/04 Version 3.04
 Added:
  alias mta.enter <Commands>
  alias mta.exit <Commands>
  $mta.passenger
 Renamed:
  $mta.job to $mta.function
  $mta.place to $mta.location
  $mta.getcar to $mta.vehicle
  $mta.getcar().carid to $mta.vehicle().id
  $mta.getcar().name to $mta.vehicle().name
 Removed:
  $mta.job
  alias mta.car <Commands>

23/07/04 Version 3.03
 /mta.c -bug fixed

23/07/04 Version 3.02
 /mta.dll -bug fixed

23/07/04 Version 3.01
 Scripts dialog-bug fixed

22/07/04 Version 3.00
 Adding ban to local banlist if player gets banned by other admins
 !info Changed
 Bigger dialog
 Action button added
 Showing game info when connected
 Showing updater status
 Focus on false input on connect
 PM dialog
 MAP function
 GTA:3 servers compitble
 Ping renamed to Ping flux
 Showing Weather
 Showing Game time
 Admin+ connection option
 Scripts on/off option
 Reset scores
 Reset money
 Change weather
 Set game time
 Longer discriptions in options menu
 Include nickname in messages option
 Always on top option
 Help button on main dialog
 Go to the forums-button
 Check for updates-button
 View manual-button
 New game mode: Capture the Whoopee!
 Change ban reason offline option
 Double alias checker for scripts
 Improved scripts dialog
 Improved CRC-check
 Added getnick command for lost nicks
 Litte Faster script progress
 Fixed 1st packet lost
 Added:
  $mta.admin+
  $mta.game(N)
  $mta.time(N)
  $mta.health(N,ID) 
  $mta.getcar(N,ID)
  $mta.getid(N,Wildcard)
  $mta.job(N,ID)
  $mta.idle(N,ID).time
  $mta.money(N,ID)
  $mta.online(N,ID).time
  $mta.place(N,ID)
  $mta.status(N,ID).text
  $mta.weapon(N,Weapon ID) 
  $mta.weather(N)
  /mta.me <N> <Text>
  /mta.msg <N> <ID> <Text>
  /mta.slap <N> <Name/ID>
  /mta.resetmoney <N>
  /mta.resetscores <N>
  /mta.settime <N> <Time>
  /mta.setweather <N> <T>
  alias mta.car <Commands>
  alias mta.command <Commands>
  alias mta.event <Commands>
 Renamed:
  $mta.game to $mta.status
  $mta.type to $mta.mode
 Removed:
  $mta.motd(N)

??/??/04 Versions 2.005-v2.013
 alias mta.quit added
 Fixed !info halting
 Fixed 1 character nick-bug
 Fixed longer admin-password
 Fixed list refreshing
 Showing "Connection retry" for connection retry's
 Showing admin name in !info
 Removed password function added
 Removed getnick command for lost nicks
 Show ip's
 Improved mta.con
 Improved mta.dis
 Timestamp logs
 IP checking
 Added:
  /mta.setpassword <N> <Password>
  alias mta.start <Commands>
  alias mta.quit <Commands>
 And other fixes I forgot

24/02/04 Version 2.004
 Local ban list
 Ip's of players
 New identifer:
  $mta.ip(Server,ID)
 New command:
  /mta.addban Server IP
 New options:
  Reconnect on time out.
  Clear log on connect.
 Updater
 Server password changing
 New game mode script gang
 Fixed game mode script team

24/01/04 Version 1.21
 Last entry list
 Statitcis dialog for each player
 New events:
  alias mta.connect
  alias mta.disconnenct
 New Identifers:
  $mta.deaths(Server,ID)
  $mta.idle(Server,ID)
  $mta.online(Server,ID)
  $mta.game(Server,ID)
  $mta.type(Server)
  $mta.server(Server)
 Script manual
 New game mode script Kotc

12/01/04 Version 1.20
 Manhunt: Nicklist-loop fix
 Manhunt: cancels if there is not enough players
 Manhunt: Typo fixed
 Unban moved to main dialog
 Scripts dialog
 Nicklist count bug
 Ping added
 $mta.players(Server) added
 $mta.maxplayers(Server) added
 Faster script progress
 Added support for 'Refresh MOTD'
 New game mode script VIP

06/01/04 Version 1.19 
 Warning if mIRC version is lower then 6.12 
 Empty nicklist error fixed
 Unban ip support added 
 Auto-close Options dialog when MTA:mA dialog is closed 
 Renamed to MTA mIRC Admin

05/01/04 Version 1.18 released
