HTGH AA IRC ScoreBot www.htgh.net (c) 2007 Eric Goldner htgh.net@gmail.com This scorebot was created by Eric Goldner aka Rdpfire aka .neXus[rpd]. It contains resources made by Kjell Arne Brudvik (BIRCBot). This product REQUIRES the previous installation of .NET FRAMEWORK 2.0 *If it doesn't start, this is probably why. ------------ INSTALLATION ------------ 1) Get the .NET FRAMEWORK 2.0 from Microsoft if you need it @ 32-bit: http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displaylang=en 64-bit: http://www.microsoft.com/downloads/details.aspx?FamilyID=b44a0000-acf8-4fa1-affb-40e78d788b00&displaylang=en 2) Install it then restart 3) Double click the ScoreBot.exe icon. No install is required for this program. ------------ INSTRUCTIONS ------------ A] Settings B] Colors C] Connecting D] Reporting E] Controlling the bot from an IRC client A] Enter your SETTINGS in the "IRC Settings" tab Nickname: the bot's name to display in the IRC channel Ident: the IRC identity of the person authorized to send the bot commands NOTE: To find yours, type .IDENT while the bot is running in your channel Server Hostname: the host of your IRC network, e.g. Gameservers.NJ.US.GameSurge.net Server Port: the port of your IRC network, e.g. 6665 Channel: the IRC channel the bot should join and send results to NOTE: This channel should have +c and moderator options turned off. Otherwise, bot output won't show. Maximum connection: Functionality disabled for now. Maximum individual message length is statically set at 256 bytes. Perform: IRC messages to send after joining channel !!!IMPORTANT: Click "Update Settings" for these changes to save and take effect.*** B] SETTING COLORS: a) Click a colored number from the upper-right box. NOTE: Colors displayed there are defaults. Clients with themes may see different results. b) Click the button of the attribute you want to apply that color to. c) Repeat from (1) as necessary. C] CONNECTING TO AN IRC SERVER a) Click "Connect" at the top-left of the "Main" tab. b) Wait a couple seconds and it should automatically join your selected channel. c) If your bot does not autoconnect to your channel, wait a few seconds after connecting to the IRC network, then click "Join Channel." D] SELECTING AN AA SERVER TO REPORT a) Enter its ip and hostname in the "Game Server" box in the "Main" tab. NOTE: You can enter form ([ip or hostname]:port) and it will still work b) If you don't know the IP, clicking "Server Lookup" will open an external web browser. NOTE: From there, you can look up the server IP with a partial server name or IP. c) For each round you don't want scores counted, uncheck the "Live Round" checkbox. E] BOT COMMANDS FROM AN IRC CLIENT #[G] Means anyone can execute it. Otherwise only the member w/ "Ident" from the "IRC Settings" tab can. #DO NOT type the [G] in IRC!!! it's just for reference! .IDENT [G] = Displays your identity, used to set the authorized user .START ip:port = Start reporting on a new IP .STOP = Stop the current reporting session .WEB = Show link to htgh.net reporting for current server .STATS = Show link to complete server stats (AAOT style) .EXIT = Disconnects the IRC bot from the IRC channel and network #You should not need these (except .SWAP or .SCORES)! Wins should automatically get recorded. Just in case... #Commands added in v1.0.0.9 .SCORES [G] = Displays current match score and who's on each team .SWAP = Switches team sides AND scores in the "Teams" tab (assault to defense, etc) .AWON = Add a win to teamA (whoever's left side in the "Teams" tab) .SETA 5 = Manually sets the number (5 here) of wins recorded for TeamA .BWON = Add a win to teamB (right side team) .SETB 4 = Manually sets the number of wins recorded for TeamB .TIE = Add a tie to the count .SETTIE 2 = Manually sets the number of ties #Commands added v1.0.0.14 .DEAD = Sets dead/setup round (score doesn't count) .LIVE = Sets round to live (only needed if you killed current round and changed your mind) #Commands added v1.5.0.0 .LEFT = Shows which players are still alive (.SCORES now shows who's alive in bold) #Commands added v1.6.0.0 .TIME = Shows amount of time left in round --------------- VERSION CHANGES --------------- v1.0.0.1, added self-kills output v1.0.0.2, fixed how to gain honours link to point to htgh.net v1.0.0.3, added auto-update component (requires ScoreBotUpdate.exe) v1.0.0.5, format now "[k/d]"; perform now does commands instead of messages (don't / before them); separate join/part channel buttons v1.0.0.6, added messages color sample in the settings tab v1.0.0.7, fixed team label colors v1.0.0.9, random bug fixes, mostly in scoring. New manual scoring system, see new section in "Teams Tab" and new IRC commands. v1.0.0.10, fixed major scoring bug added from .9, added clan labelling to make results clearer v1.0.0.11, displays final score when bot stops reporting v1.0.0.12, colourizes winning team v1.0.0.13, (hopefully) fixes double kill bug v1.0.0.14, fixed tab order for buttons, added support for dead rounds v1.0.0.15, fixed update settings button v1.0.0.16, random and minor changes v1.0.0.17, minor output changes v1.5.0.0, new autopilot mode, doesn't require someone to operate the bot v1.5.1.0, UNBELIEVABLE number of bugs fixed. I have know idea no one noticed these. v1.5.2.0, Tied rounds are displayed again v1.5.2.1, Changed formatting of scores at end of round v1.5.2.2, Internal changes to update engine v1.5.3.3, Compatible with AA v2.8.2.0 v1.6.0.0, Better support for larger servers; Time warning system added, use presets or type .TIME in irc v1.6.0.1, Changed gamesurge servers since the NJ one stopped working v1.6.0.2, Updated my name to [rpdfire.drp] to shut big up ---------- KNOWN BUGS ---------- 1) All links from the "About" page open in IE. 2) Sometimes, bot doesn't automatically join channel after connecting to the network. If this happens, use the manual "Join Channel" button. ------- LICENSE ------- By using this software (HTGH AA IRC ScoreBot), you agree to the Software License Agreement: 1. This is an agreement between Licensor (Eric Goldner) and Licensee (program user), who is being licensed to use this program. 2. This License Agreement is valid without Licensor's signature. It becomes effective upon the earlier of Licensee's signature or Licensee's use of the Software. 3. Licensee acknowledges that this is only a limited nonexclusive license. Licensor is and remains the owner of all titles, rights, and interests in the Software. 4. This software is provided AS-IS. Licensee agrees to defend and indemnify Licensor and hold Licensor harmless from all claims, losses, damages, complaints, or expenses connected with or resulting from use of this program. 5. This Software is subject to a limited warranty. Licensor warrants to Licensee that program contains no viruses, spyware, or adware, and that the Software will perform according to its documentation, if any. This limited warranty lasts for a period of 15 days after installation. To the extent permitted by law, THE ABOVE-STATED LIMITED WARRANTY REPLACES ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, AND LICENSOR DISCLAIMS ALL IMPLIED WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF TITLE, MERCHANTABILITY, NONINFRINGEMENT, OR OF FITNESS FOR A PARTICULAR PURPOSE. No agent of Licensor is authorized to make any other warranties or to modify this limited warranty. If the law does not allow disclaimer of implied warranties, then any implied warranty is limited to 5 days after download of the Software by Licensee. 6. In case of a breach of the Limited Warranty, Licensee's exclusive remedy is as follows: a full refund :). 7. Notwithstanding the foregoing, LICENSOR IS NOT LIABLE TO LICENSEE FOR ANY DAMAGES, INCLUDING COMPENSATORY, SPECIAL, INCIDENTAL, EXEMPLARY, PUNITIVE, OR CONSEQUENTIAL DAMAGES, CONNECTED WITH OR RESULTING FROM THIS LICENSE AGREEMENT OR LICENSEE'S USE OF THIS SOFTWARE. 8. This License Agreement is the entire and exclusive agreement between Licensor and Licensee regarding this Software. This License Agreement replaces and supersedes all prior negotiations, dealings, and agreements between Licensor and Licensee regarding this Software. If you do not agree to any of the above, delete and do not use this program.