EQ2RaidAttendance

[Amadeus]

Please see the second posting in this thread for more information about this script.

Installation Instructions

1. Make sure that you have a valid subscription to ISXEQ2 and that it is properly installed.
2. Download Tortoise SVN from the internet at http://tortoisesvn.net/downloads. Then, install it and reboot your computer. Reboot, and all of that jazz.
3. Open Windows Explorer and browse to your /innerspace/Scripts folder. Right click anywhere in this folder and choose the option "SVN Checkout". In the window that pops up, enter https://github.com/isxGames/isxScripts/trunk/EverQuest2/Scripts/EQ2RaidAttendance as the "URL of Repository" and then be sure that the checkout path is "/innerspace/Scripts/EQ2RaidAttendance". (Leave the other settings alone.)
4. The new directory that was created (/innerspace/Scripts/EQ2RaidAttendance) should have an "SVN" icon in it. You can now update this directory at any time by right-clicking it in Windows Explorer and choosing the option "SVN Update". You should update this directory every so often to stay up-to-date with your files.
5. Check to see if you have a folder in your /innerspace/Scripts directory called EQ2Common. If you do, then you can skip steps 6 and 7.
6. Open Windows Explorer and browse to your /innerspace/Scripts folder. Right click anywhere in this folder and choose the option "SVN Checkout". In the window that pops up, enter https://github.com/isxGames/isxScripts/trunk/EverQuest2/Scripts/EQ2Common as the "URL of Repository" and then be sure that the checkout path is "/innerspace/Scripts/EQ2Common". (Leave the other settings alone.)
7. The new directory that was created (/innerspace/Scripts/EQ2Common) should have an "SVN" icon in it. You can now update this directory at any time by right-clicking it in Windows Explorer and choosing the option "SVN Update". You should update this directory every so often to stay up-to-date with your files.
8. Now, once you're in-game and ISXEQ2 is loaded, simply type run EQ2RaidAttendance in the console or /run EQ2RaidAttendance in the chat window to start the script (see later in this thread for more information on parameters as well as examples on running the script.)
9. Read the remainder of THIS thread for usage information.

 

[Amadeus]

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;;;;;;; Raid Attendance Tracker ;;;;;;;;;;;;;;;;;;;;;;
;;;
;;; This script takes "snapshots" of your raid and saves that information
;;; to an xml file called 'EQ2RaidAttendance.xml'.  At the same time, it 
;;; will produce detailed attendance statistics and spew them to the console
;;; as well as to a text file entitled 'EQ2RaidAttendance.txt'.
;;;
;;; Every time that you take a "snapshot" for a particular raid, it will
;;; retrieve the members saved for that raid and then add any new people 
;;; in your current raid to the list.  Again, it will save and spew statistics.
;;; Guilds that use DKP can use multiple snapshots to indicate new stages within
;;; the same raid, as each time a raid member is counted, their "seen" counter
;;; increments within the xml.  Therefore, if someone were there for the entire
;;; raid, and 5 snapshots were taken, they would have a "seen" counter of 5.  
;;; This counter is not utilized in the output statistics; however, it is saved
;;; in the xml (per raid) and should be exportable to Excel for easy viewing
;;; and calculation.
;;;
;;; The script is used by indicating a Raid NAME (otherwise it will simply use 
;;; the current date) followed by anyone that is 'sitting out'.  For example,
;;; if you wish to call your current raid "Korsha" and Amadeus, Pygar,
;;; and Valerian are sitting out, then you would use the following command in
;;; the console window:
;;;      > run EQ2RaidAttendance "Raid=Korsha [Overking Only]" Amadeus Pygar Valerian
;;; The script will run, call the raid "Korsha [Overking Only]" and count Amadeus 
;;; Pygar and Valerian as being IN the raid.   (NOTE:  In this example you're MANUALLY
;;; adding Amadeus, Pygar, and Valerian.  Anyone that is in your current raid will be 
;;; added automatically.)
;;;
;;; NOTES: To take further snapshots it is not necessary to indicate the 'sitters' again
;;; (unless there are new 'sitters'.)  Once someone is counted as in the raid, they
;;; are always in that raid, regardless of if they are still present during the next
;;; snapshot.  ALSO, this script saves raids by date as well as by name.  Therefore,
;;; if your raid crosses over midnight (your time), then issuing another snapshot,
;;; even with the same name, will save as a new raid.
;;;
;;; Finally, the script supports alts!  If a character name is entered as an alt of a
;;; main, then when that alt is found in a raid, it will count towards the attendance
;;; percentage of the main to which it is paired.   Alts can be added to the XML file
;;; with this command:
;;;      > run EQ2RaidAttendance ALT=MAIN
;;;   (ie: run EQ2RaidAttendance MiniAma=Amadeus)
;;;
;;; To delete an alt<->main pairing, simply edit the xml.
;;;
;;; There are a few other optional command line parameters that can be added to any
;;; of the ones above:
;;;      -StatsOnly         (Produce statistis only -- no raid snapshot is taken.)
;;;      -SnapshotOnly      (Take raid snapshot only -- no stats are spewed.)
;;;      Date=xx/xx/xxxx    (Forces the script to utilize the given date as the date of the raid.)
;;;      -AltsAsMains       (When used, the script will treat all characters as mains when creating statistics.)
;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

 

[Amadeus]

Examples:

1. To take a snapshot of your current raid named "VP"

run EQ2RaidAttendance "Raid=VP"

(NOTE: You can do this as often as you like. It will consider any snapshot taken on a particular day to be the SAME raid. So, it will just update the attendance if you run it more than once.)
---------

2. To take a snapshot of your current raid, named "VP", and MANUALLY add Amadeus, Pygar, and Valerian as being "in" the raid, but sitting out:

run EQ2RaidAttendance "Raid=VP" Amadeus Pygar Valerian

3. To tell the script to always consider "Ama" to be an alt of "Amadeus" (ie, save it to the configuration file):

run EQ2RaidAttendance Ama=Amadeus

(NOTE: You can only do one alt->main paring command at a time with the script. However, you can add as many alt->main parings as you like.)
---------

4. To take a snapshot of a raid, with the name "VP", but have it enter it as being dated as 09/09/2009:

run EQ2RaidAttendance "Raid=VP" "Date=09/09/2009"

(NOTE: This is useful for instances when your raid lasts past midnight. EQ2RaidAttendance considers any raid with the same name, on the same date, to be ONE raid. So, if you start a raid on 09/09/2009 at 9:00 p.m. and you want to take a snapshot after midnight, you'd want to use the "Date" parameter. Of course, you could always utilize the date parameter if you were ever afraid of forgetting to do it...)
---------

5. To take a snapshot, but consider all "alts" as "mains":

run EQ2RaidAttendance "Raid=Korsha" -AltsAsMains

6. To take a snapshot without spewing stats at the end (ie, to avoid spam):

run EQ2RaidAttendance -SnapshotOnly

7. To see raiding statistics without taking a 'snapshot':

run EQ2RaidAttendance -StatsOnly

Final Thoughts
Users are encoruaged to look through the script and simply "play" with it in-game for a while. Although small, it is a powerful script and may take a bit of 'getting used to'. The most important concept was that it allows for you to take multiple snapshots of the same raid, so that everyone gets 'counted', even if they come late. HOWEVER, it also tells you how many times someone is "counted", so those that come early, or stay late, will have a higher 'count'. I think you'll like it.

Also, please note that many of the parameters above can be combined. So, just about anything should be possible with this script when it comes to doing raid attendance tracking.