Day of Defeat Clan Match Player Score Calculator v2.1 ===================================================== ©Copyright 2011, Rich „Weeds„ Nagel - All Rights Reserved Overview -------- The Day of Defeat Clan Match Player Score Calculator v2.1 is a program that will calculate player scores for "clan match" mode games played using the "Day of Defeat" addon for Half-Life. Find out more about this excellent World War II styled game from http://store.steampowered.com/app/30 on the Internet! The program will display and automatically calculate player and team scores based upon you and your opponents' kills, deaths, player objectives scores, and final team objectives scores that are shown after a clan match mode game. The program will also calculate and display the actual "size" of each team's army (based upon the amount of players and total deaths for each team), as well as the relative "strength" of each team's army. Also included is a score averaging calculator that will average a set of final scores from previous games. The Day of Defeat Clan Match Player Score Calculator also includes the ability to save and append the calculated results to a text file, as well as viewing and printing the previously saved results file from within the program. The program features special support for the popular "SturmBot" plugin for Day of Defeat, with the ability to select and display the SturmBots' specific ranks and skill levels for any SturmBot players that may have been playing in your clan match game (along with the human players). The program has the ability to save and load all calculator entries from a special ".DoDCalc" plain-text format file. This allows you to save all of the calculator data that you have currently entered, and then load the complete set of entries again at a later time. Lastly, the Day of Defeat Clan Match Player Score Calculator supports loading a previously saved ".DoDCalc" entries file from the command-line, which allows you to associate these saved calculator entries files with the Day of Defeat Clan Match Player Score Calculator program itself for complete Windows Explorer integration. System Requirements ------------------- The Day of Defeat Clan Match Player Score Calculator requires Windows 95 or newer, and will run on any computer capable of running Day of Defeat or Half-Life. Installation ------------ Simply unzip "Day_of_Defeat_Clan_Match_Player_Score_Calculator.zip" to any directory on your hard drive in verbatim (maintaining the directory structure within the archive). You may also wish to manually add a shortcut to your Windows Start Menu (or Windows Desktop) for the program, as well as this help and readme file. Windows Explorer File Associations ---------------------------------- Optionally, you can associate the ".DoDCalc" calculator entries files that the calculator has the ability to save with the program itself. Simply double-click on the included "Day of Defeat Sample Clan Match Calculator Entries File.DoDCalc" file (located in the "Sample Files" directory) from within the Windows Explorer, check the "Select the program from a list" radio button, and then click the "OK" button. Then enter a description for the ".DoDCalc" calculator entries files in the provided text-entry box (such as "Day of Defeat Clan Match Calculator Entries File", minus the quotes), and ensure that the "Always use the selected program to open this kind of file" checkbox is checked. Lastly, click the "Browse" button, and browse around your hard drive to the directory where you installed the program, and then select the "Day of Defeat Clan Match Player Score Calculator.exe" program executable file. After configuring the Windows file associations for the ".DoDCalc" calculator entries files, you can then simply double-click one of your previously saved files to automatically start the Day of Defeat Clan Match Player Score Calculator, which will then automatically load the file that you selected into the calculator. Brief Usage ----------- To start the Day of Defeat Clan Match Player Score Calculator, simply run "Day of Defeat Clan Match Player Score Calculator.exe". The various text-entry boxes and buttons within the program are all self-explanatory, and will display a small descriptive popup "tooltip" window when your mouse cursor is hovered over them. All of the buttons within the program have shortcut "hotkeys" as described below (e.g. ALT+B or CTRL+S, which is the underlined letter displayed on the button). Note that the complete shortcut hotkeys will also be displayed within the popup tooltips mentioned above. Note that all of the calculations are performed automatically in real-time as you enter the statistics for your clan match into the Day of Defeat Clan Match Player Score Calculator. There is no "Calculate Scores" button that is required to be pressed to perform the actual calculations. Click the "Average Scores »" button to display the "Day of Defeat Clan Match Player Average Scores Calculator" menu of the program, or within that menu click the "« Player Score" button to return to the main "Day of Defeat Clan Match Player Score Calculator" menu. Detailed Day of Defeat Clan Match Player Score Calculator Usage --------------------------------------------------------------- In the "Allies Objectives Score" text-entry box, enter the final Allies team objectives score. In the "Axis Objectives Score" text-entry box, enter the final Axis team objectives score. In the "Map Name" text-entry box, enter the name of the map used for the clan match (e.g. "DoD_Avalanche", "DoD_Avalanche_Deathmatch", etc...). Enter all of the player data and statistics for the players that were in the clan match game within the text-entry boxes for the "Player Name", player "Obj." (Objectives) score, player "Kills", and player "Deaths". Select all of the players' teams and classes using the "Team" and "Class" dropdown boxes. Then select either "Human" for a human player, or a skill level for a non-human SturmBot player using the "SturmBot Skill / Human" dropdown boxes. Enter the duration of the clan match in minutes (MMM) within the "Clan Match Duration" text-entry box, as well as the date (MM/DD/YYYY) and time (HH:MM:SS) of the clan match within the "Clan Match Date" and "Clan Match Time" text-entry boxes. After all of the clan match and player data and statistics are entered, click on a player's name in the "Player Name" column (located to the left of the "Player Score" and "Team Score" calculated results columns), or the "Best Player" column to display detailed statistics for the specific player in a popup tooltip window. Click your mouse (or press any key on your keyboard) to close the popup statistics window. Click on "Allied Army Size/Strength" or "Axis Army Size/Strength" (located at the top-right of the calculator) to display detailed statistics for the specific team's army in a popup tooltip window. Click your mouse (or press any key on your keyboard) to close the popup statistics window. Refer to the "Mathematical Formulas" section below" section below for a detailed explaination of the total army size and strength calculations and statistics. Click the "Load All Entries" button (or press CTRL+L) to load all "Day of Defeat Clan Match Player Score Calculator" and "Day of Defeat Clan Match Player Average Scores Calculator" entries from a previously saved ".DoDCalc" calculator entries file. Note that this function of the calculator will effectively clear both menus of the entire calculator, and then automatically load and enter a complete set of calculator entries from a ".DoDCalc" calculator entries file that you previously saved using the "Save All Entries" function of the calculator (see below). Refer to the "Windows Explorer File Associations" section above for another handy method for loading previously saved ".DoDCalc" calculator entries files. Included with the Day of Defeat Clan Match Player Score Calculator are two sample saved ".DoDCalc" calculator entries files ("Day of Defeat Sample Clan Match Calculator Entries File.DoDCalc" and "Day of Defeat Sample Clan Match DeathMatch Calculator Entries File.DoDCalc", located in the "Sample Files" directory) which were generated and saved using the "Save All Entries" function of the calculator (see below). Click the "Save All Entries" button (or press CTRL+S) to save all "Day of Defeat Clan Match Player Score Calculator" and "Day of Defeat Clan Match Player Average Scores Calculator" entries to a ".DoDCalc" calculator entries file. You will then be prompted to enter a filename to save the calculator entires, and the filename can be entered with or without the ".DoDCalc" file extension (the Day of Defeat Clan Match Player Score Calculator will automatically add the correct ".DoDCalc" file extension if it is incorrect or not provided). This function of the calculator allows you to save all of the calculator data that you have currently entered, and then load the complete set of entries again at a later time. Included with the Day of Defeat Clan Match Player Score Calculator are two sample saved ".DoDCalc" calculator entries files ("Day of Defeat Sample Clan Match Calculator Entries File.DoDCalc" and "Day of Defeat Sample Clan Match DeathMatch Calculator Entries File.DoDCalc", located in the "Sample Files" directory) which were generated and saved using this function of the calculator. Click the "Clear All Entries" button (or press ALT+C) to clear all of the current entries within the text-entry and dropdown boxes of the "Day of Defeat Clan Match Player Score Calculator", and to reset the calculator. Note that this function of the calculator does not clear and reset the "Day of Defeat Clan Match Player Average Scores Calculator" menu, only the main "Day of Defeat Clan Match Player Score Calculator" menu of the program. Click the "Save Results" button (or press ALT+S) to save and append the currently calculated "Day of Defeat Clan Match Player Score Calculator" results to a plain-text format file. This text file will be saved within the same directory that program is installed, and to the filename "Day of Defeat Clan Match Player Scores.txt". Note that you can open and view the previously saved results file at a later time using Windows Notepad, or simply from within the program itself (see below). Included with the Day of Defeat Clan Match Player Score Calculator is a sample saved results file "Day of Defeat Sample Clan Match Player Scores.txt" (located in the "Sample Files" directory) which was generated and saved using this function of the calculator. Click the "View Saved Results" button (or press ALT+V) to view the previously saved results file. Click the "Print Saved Results" button (or press ALT+P) to print the previously saved results file using your printer. Click the "Delete Saved Results" button (or press ALT+D) to delete the previously saved results file. Click the "Average Scores »" button (or press ALT+A) to display the "Day of Defeat Clan Match Player Average Scores Calculator" menu of the program. Click the "Help" button (or press ALT+H) to view the Day of Defeat Clan Match Player Score Calculator's help and readme file (this file). Click the "About" button (or press ALT+B) to view the copyright and version information for the Day of Defeat Clan Match Player Score Calculator. Click the "Quit" button (or press ALT+Q) to exit the Day of Defeat Clan Match Player Score Calculator. Deathmatch Game Mode Player Score Calculations ---------------------------------------------- Note that the Day of Defeat Clan Match Player Score Calculator can *ALSO* calculate standard "deathmatch" game mode scores, based upon a modified version of the "Descent" online scoring system (refer to the "Mathematical Formulas" section below). Simply select "none" for all of the players' teams using the "Team" dropdown boxes, and "0.1" for all of the player objectives scores in the "Obj." score text-entry boxes. The time-based clan match player and team objectives scoring system for Day of Defeat is then effectively bypassed, resulting in a slight variation of standard deathmatch game mode scores. Detailed Day of Defeat Clan Match Player Average Scores Calculator Usage ------------------------------------------------------------------------ In the "Player Name" text-entry box, enter the name of the player that you wish to average a set of scores (press ALT+N to quickly jump to this text-entry box). Click the "Input Scores" button (or press ALT+I) to enter the set of scores that will be averaged together (as displayed in the score results under the "Player Score" or "Team Score" sections located within the main "Day of Defeat Clan Match Player Score Calculator" menu of the program). Note that the score entries that will be averaged together are entered one at a time. Simply click the "Input Scores" button, enter the first score, and then click the button again (repeating for each additional score that you wish to be averaged together). Each score that is entered will be displayed within the "Score Entries to Average" list box. Click the "Load All Entries" button (or press CTRL+L) to load all "Day of Defeat Clan Match Player Score Calculator" and "Day of Defeat Clan Match Player Average Scores Calculator" entries from a previously saved ".DoDCalc" calculator entries file. Note that this function of the calculator will effectively clear both menus of the entire calculator, and then automatically load and enter a complete set of calculator entries from a ".DoDCalc" calculator entries file that you previously saved using the "Save All Entries" function of the calculator (see below). Refer to the "Windows Explorer File Associations" section above for another handy method for loading previously saved ".DoDCalc" calculator entries files. Included with the Day of Defeat Clan Match Player Score Calculator are two sample saved ".DoDCalc" calculator entries files ("Day of Defeat Sample Clan Match Calculator Entries File.DoDCalc" and "Day of Defeat Sample Clan Match DeathMatch Calculator Entries File.DoDCalc", located in the "Sample Files" directory) which were generated and saved using the "Save All Entries" function of the calculator (see below). Click the "Save All Entries" button (or press CTRL+S) to save all "Day of Defeat Clan Match Player Score Calculator" and "Day of Defeat Clan Match Player Average Scores Calculator" entries to a ".DoDCalc" calculator entries file. You will then be prompted to enter a filename to save the calculator entires, and the filename can be entered with or without the ".DoDCalc" file extension (the Day of Defeat Clan Match Player Score Calculator will automatically add the correct ".DoDCalc" file extension if it is incorrect or not provided). This function of the calculator allows you to save all of the calculator data that you have currently entered, and then load the complete set of entries again at a later time. Included with the Day of Defeat Clan Match Player Score Calculator are two sample saved ".DoDCalc" calculator entries files ("Day of Defeat Sample Clan Match Calculator Entries File.DoDCalc" and "Day of Defeat Sample Clan Match DeathMatch Calculator Entries File.DoDCalc", located in the "Sample Files" directory) which were generated and saved using this function of the calculator. Click the "Clear All Entries" button (or press ALT+C) to clear all of the previously entered scores, as well as the current entries within the text-entry and list boxes of the "Day of Defeat Clan Match Player Average Scores Calculator", and to reset the averaging calculator. Note that this function of the calculator does not clear and reset the the main "Day of Defeat Clan Match Player Score Calculator" menu, only the "Day of Defeat Clan Match Player Average Scores Calculator" menu of the program. Click the "Save Results" button (or press ALT+S) to save and append the currently calculated "Day of Defeat Clan Match Player Average Scores Calculator" results to a plain-text format file. This text file will be saved within the same directory that program is installed, and to the filename "Day of Defeat Clan Match Player Scores.txt". Note that you can open and view the previously saved results file at a later time using Windows Notepad, or simply from within the program itself (see below). Included with the Day of Defeat Clan Match Player Score Calculator is a sample saved results file "Day of Defeat Sample Clan Match Player Scores.txt" (located in the "Sample Files" directory) which was generated and saved using this function of the calculator. Click the "View Saved Results" button (or press ALT+V) to view the previously saved results file. Click the "Print Saved Results" button (or press ALT+P) to print the previously saved results file using your printer. Click the "Delete Saved Results" button (or press ALT+D) to delete the previously saved results file. Click the "« Player Score" button (or press ALT+A) to return to the main "Day of Defeat Clan Match Player Score Calculator" menu of the program. Click the "Help" button (or press ALT+H) to view the Day of Defeat Clan Match Player Score Calculator's help and readme file (this file). Click the "About" button (or press ALT+B) to view the copyright and version information for the Day of Defeat Clan Match Player Score Calculator. Click the "Quit" button (or press ALT+Q) to exit the Day of Defeat Clan Match Player Score Calculator. Quirks of the Calculator ------------------------ There are a few minor guidelines that must be followed when entering clan match player data and scores: Any given player must have at least 1 point for their player objectives score, and have accomplished at least 1 kill. If either of these values are left at "000", then their final calculated scores will be "0.0000". Also, the actual player name of any player must not include the left or right square bracket characters, as the Day of Defeat Clan Match Player Score Calculator reserves these square brackets to enclose and identify it's internal program variables. A workaround is to simply substitute parenthesis in place of the square brackets if any member of your clan uses them within their player name. Lastly, you will notice that the Day of Defeat Clan Match Player Score Calculator only has enough text-entry and dropdown boxes to enter clan match data and results for a total of ten players. There was simply not enough "real estate" for additional player entries and functions within the program's GUI (graphical user interface)! A workaround is to simply run multiple instances of the Day of Defeat Clan Match Player Score Calculator if your clan match includes more than ten players. As an example, enter all of the clan match results for the Allied team in one running instance of the calculator, and all of the clan match results for the Axis team in a second running instance of the calculator. Note that this workaround is far from perfect (as one team will not be statistically compared to the opposing team in real-time), but is a partial solution to the ten-player restriction within the program's GUI. Day of Defeat Clan Match Tips ----------------------------- There are several console commands and configuration file settings for Day of Defeat that are handy for viewing the player and team scores at the end of a clan match game. This will be helpful when you are entering the clan match game's data and statistics into the Day of Defeat Clan Match Player Score Calculator. Issue the console command "hud_takesshots 1" (or add the line to your Day of Defeat "Config.cfg" or "UserConfig.cfg" file) to enable taking an automatic screenshot when the final scores are displayed when the current clan match round ends (after the duration of the "mp_timelimit" setting). The screenshots will be in "BMP format, and will be located in the directory "C:\Program Files\Steam\SteamApps\\Day of Defeat\DoD", with the filenames "DoD_MapName####.bmp". Included with the Day of Defeat Clan Match Player Score Calculator is an example screenshot file "Day of Defeat Sample DoD_Avalanche0000.png" (located in the "Sample Files" directory) which was created using this command (and then converted to "PNG" format). Issue the console command "condebug" (or add the line to your Day of Defeat "Config.cfg" or "UserConfig.cfg" file) to toggle the saving of console logs to the filename "QConsole.log" in the directory "C:\Program Files\Steam\SteamApps\\Day of Defeat". Alternatively, you can start Day of Defeat with the command-line parameter "-condebug" (e.g. "C:\Program Files\Steam\SteamApps\\Day of Defeat\HL.exe -condebug"). Issue the console command "log on" (or add the line to your Day of Defeat "Config.cfg" or "UserConfig.cfg" file) to enable the saving of detailed server logs. The detailed server logs will be located in the directory "C:\Program Files\Steam\SteamApps\\Day of Defeat\DoD\Logs", with the filenames "lMMDD###.log". Lastly, note that you can browse and download a complete list of *ALL* of the Day of Defeat console commands and configuration file settings that are useful for clan match games from http://tinyurl.com/DoDClanModeCommandsList on the Internet. Mathematical Formulas --------------------- The following mathematical formulas are used by the Day of Defeat Clan Match Player Score Calculator to calculate the final player and team scores, as well as the various other clan match statistics: PlayerScore = (PlayerObjectivesScore * PlayerKills * 10) / (PlayerObjectivesScore + PlayerKills + PlayerDeaths + 1) PlayerTeamScore = PlayerScore + TeamObjectivesScore Note that this formula is loosely based upon the online scoring system used for "deathmatch" game mode "ladder" matches for the older game "Descent" (with additional calculations for Day of Defeat's time-based clan match player and team objectives scoring system), and is considered standard for most FPS (first-person shooter) styled games (such as DOOM, Duke Nukem 3D, Quake, Unreal, etc...): (Kills * 100) / (Kills + Deaths + 1) The "Army Size" and "Army Strength" statistics are calculated using the following formulas: ArmySize = ArmyTotalDeaths + TeamPlayers "ArmyTotalDeaths" is the total number of player deaths for a specific team, and "TeamPlayers" is the total number of actual players on that team. Hence, the "ArmySize" calculated result is (for all practical purposes) the actual "size" of the team's army for the clan match round. ArmyStrength = (ArmyTotalObjectivesScores / ArmySize) * 100 Note that the "ArmyTotalObjectivesScores" variable in the formula above is the sum of all of a specific team's individual player scores, and *NOT* the final team's objectives score, as displayed at the top of the "ObjScore" column of Day of Defeat's score screen (refer to the "TeamObjectivesScore" variable mentioned further above). The "ArmyStrength" calculated result reflects the overall "strength" (or power) of a specific team's army, regardless of the team's final game or round objective scores (again, as displayed at the top of the "ObjScore" column of Day of Defeat's score screen). Lastly, note that the formula used for the "Day of Defeat Clan Match Player Average Scores Calculator" menu of the program is a standard mathematical averaging formula (the sum of all the given elements, divided by the total number of elements): AverageScore = SumOfScores / NumberOfScores In other words: AverageScore = (Score1 + Score2 + Score3 + etc...) / NumberOfScores Unused Mathematical Formulas ---------------------------- The overall "strength" (or power) for each specific player is yet another statistic that you can manually calculate from the results of the formulas above (using a variation of the formulas, entered into the bog-standard Windows Calculator): PlayerArmySize = PlayerDeaths + 1 PlayerStrength = (PlayerObjectivesScore / PlayerArmySize) * 100 Note that this statistic is *NOT* calculated nor displayed within the Day of Defeat Clan Match Player Score Calculator. But if you like crunching numbers, you can manually calculate those statistics yourself as well. Source Code ----------- Included in the archive is the original source code for the Day of Defeat Clan Match Player Score Calculator v2.1 (located in the "Source Code Files" directory). The file "Day of Defeat Clan Match Player Score Calculator.pub" is a "NeoBook for Windows" publication, which can be viewed or edited using NeoBook for Windows version 4.1.3a or newer. Note that you can also browse the source code file using Windows Notepad, but the routines will look rather jumbled and disorganized. Also included in the archive are the additional graphic and sound resource files required for compiling the program using NeoBook for Windows. Programs and Utilities ---------------------- The Day of Defeat Clan Match Player Score Calculator v2.1 was programmed and created exclusively using NeoSoft's NeoBook for Windows v4.1.3a. Copyrights and Legalities ------------------------- Day of Defeat Clan Match Player Score Calculator v2.1 - ©Copyright 2011, Rich „Weeds„ Nagel - All Rights Reserved The Day of Defeat Clan Match Player Score Calculator v2.1 (Day_of_Defeat_Clan_Match_Player_Score_Calculator.zip) may be freely distributed in it's whole and unmodified form for any non-commercial usage, contained in it's original unmodified and unedited ZIP format archive, including all documents, text, and support files. The Day of Defeat Clan Match Player Score Calculator v2.1 (Day_of_Defeat_Clan_Match_Player_Score_Calculator.zip) and included content may NOT be distributed on any commercial CD-ROM or any other commercial magnetic or electronic media (commercial or freeware implied), on any "pay-per-download" online service, for ANY purpose of financial gain whatsoever, or for any purpose other than 100% FREEWARE (with exclusions as stated above). Use the Day of Defeat Clan Match Player Score Calculator v2.1 at your own risk... I will not be held responsible for absolutely anything , and the like. Void where prohibited; not available in all states; removing factory seal will void your warranty; removing information tag from pillow is a violation of federal law; does not include tax, tag, or title; ask about FREE shipping (just pay additional processing and handling); your results may vary; results not typical; supplies are limited; I'm not a real doctor, but I portray one on TV; don't blame me, I didn't vote for him; etc... etc... . Version History --------------- v1.0 - First Release. (August 25, 2011) v2.0 - Added calculations and formulas to display the "Allied (December 1, 2011) Army Size", and the "Allied Army Strength". - Added calculations and formulas to display the "Axis Army Size", and the "Axis Army Strength". - Added "Load All Entries" and "Save All Entries" features, that use special ".DoDCalc" plain-text format calculator entries files (which are quite handy!). - Added a feature to load ".DoDCalc" calculator entries files from the command-line, that allows for standard Windows Explorer file associations for these new files that the calculator can load and save (which is quite handy!). - Included sample ".DoDCalc" calculator entries files with the program. - Added user-prompting for the "Clear All Entries" feature. - Numerous changes, edits, and bug fixes to the program. - Several changes to the layout of the GUI (Man... I'm running out of room here!). - Numerous changes and edits to this help and readme file. - Anything else that I may have forgotten about! v2.1 - Fixed a small bug with the "Save All Entries" routine. (December 9, 2011) When saving a calculator entries file, the absolute path and filename were written to the ".DoDCalc" file (causing the "Load All Entries" feature to display the incorrect path and filename when loading the ".DoDCalc" file). Quote of the Day ---------------- "You can't fix stupid!" - Ron White ENJOY! ------ Rich „Weeds„ Nagel - (S.B.C.) Rich Nagel / (S.B.C.) Herr Franz Nagel December 1, 2011 AIM: RichFNagel ICQ: 565228098 / RichFNagel richnagel@centurylink.net richnagel@simpilot.net rfnagel@juno.com http://www.richnagel.net http://www.simpilot.net/~richnagel http://www.cmoo.com/snor/ http://www.cmoo.com/snor/weeds/ http://www.cmoo.com/snor/weeds/Day_of_Defeat/ http://www.cmoo.com/snor/weeds/Swamp_Buzzards_Clan/ http://tinyurl.com/TumbleWeedsServerStatus http://www.facebook.com/RFNagel http://www.facebook.com/profile.php?id=1164518241 http://steamcommunity.com/id/RichNagel http://steamcommunity.com/groups/SwampBuzzardsClan http://www.youtube.com/RFNagel