The Chiken Confederation is pleased to host a new Homeworld 2 Multi-player Stats Browser that can be found under the "Chiken Research" on the main portal page at:
http://chikens.net/forum/
or can be directly downloaded with:
http://chikens.net/forum/hw2/msb/HW2-MSB.zip
Below is the README.txt file found with the application:
Have fun with it...Code:HW2-MSB Version 1.0 README Copyright 2004 NemesisChiken's Homeworld 2 Multi-Player Stats File Browser ----------------------------------------------------------------------- TABLE OF CONTENTS ----------------------------------------------------------------------- 1. Introduction 2. System Requirements 3. Package Files 4. Installation 5. Setup and Customization 6. Usage 7. Frequently Asked Questions ----------------------------------------------------------------------- 1. INTRODUCTION ----------------------------------------------------------------------- This small application was designed to allow Homeworld 2 players to take advantage of the multi-player statistics files that are created at the end of each game. These files are store in a special \Stats directory under the Homeworld2\Bin\Profiles directory for each Player Profile defined in Homeworld 2. They contain the final results of each game that are displayed when a game concludes such as the player scores, ships built, mining and production operations. The Multi-Player Stats File Browser will read through the Stats files and generate a combination of HTML and JavaScript code that can then be browsed with a Web Browser. ----------------------------------------------------------------------- 2. SYSTEM REQUIREMENTS ----------------------------------------------------------------------- The general system requirements needed for running Homeworld 2 are more than adaquete for using this application with the addition of only a JavaScript capable Web Browser. ----------------------------------------------------------------------- 3. PACKAGE FILES ----------------------------------------------------------------------- README.txt HW2-MSB installation and usage document HW2-MSB.bat DOS Command File to generate and display stats HW2-MSB.awk AWK Program to parse stat files and builds HTML HW2-MSB Profile1.lnk Sample Windows Desktop link to launch HW2-MSB COPYING.txt GNU General Public License, Version 2 gawk.exe GNU utility program to run HW2-MSB.awk program The Homeworld 2 Multiplayer Stats Browser (HW2-MSB) is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version. HW2-MSB is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with HW2-MSB; if not, write to the: Free Software Foundation, Inc. 59 Temple Place, Suite 330 Boston, MA 02111-1307 USA ----------------------------------------------------------------------- 4. Installation ----------------------------------------------------------------------- Normally delivered in a .ZIP package, the files for the Multi-Player Stats File Browser should be extracted into a single directory such as "C:\Program Files\HW2-MSD". Once un-packed, copy the Shortcut file HW2-MSB Profile1.lnk to the desktop. This Shortcut is setup by default to look for the first profile (ie. Profile1) in the normal installation directory of Homeworld 2 "\Program Files\Sierra\Homeworld2", but can be changed if a non-standard installation of the game was performed or if another Player Profile set of Stats files should be processed. ----------------------------------------------------------------------- 5. Setup and Customization ----------------------------------------------------------------------- Because of the flexibility in installing software and the variety of setups individuals use, this application may require some modification if non-standard installation of Homeworld2, Windows, or this program was performed. The default Windows Desktop Icon and MW2-MSB.bat file will most likely have to be adjusted to work properly. Desktop Icon: Open the Properties Window of the link by right-clicking on the Icon and selecting Properties. In the "Shortcut" tab of the Properties, verify the "Target" and "Start In" directory names match where the application was installed (C:\Program Files\HW2-MSB by default). The "Run" option should be set to "Normal Window" and then click on the "OK" button to save any changes. Also, the "Target" specifies which Profile directory to process (ie. Profile1 by default). If another profile should be reported on, change this value to the Profile that should be used. Command File: The DOS Command File has been generically setup to work with the most common installations of Homeworld 2 and Windows, but may need to be altered depending upon the specific system setup. There are four (4) variables that can be changed as needed by opening the HW2-MSB.bat file in a text editor such as Notepad. The variables, descriptions, and default values that can be changed are: Variable Name Description -------- ------------------------------------------- HWDRIVE Disk Drive Homeworld2 software is installed Default: HWDRIVE=C: HWDIR Directory Homeworld2 software is installed Default: HWDIR=\Program Files\Sierra\Homeworld2 MSBDIR Directory Multi-Player Stat Browser installed Default: MSBDIR=\Program Files\HW2-MSB BROWSER Web Browser software to launch Default: BROWSER=explorer.exe ----------------------------------------------------------------------- 6. Usage ----------------------------------------------------------------------- Double-Clicking the Desktop HW2-MSB Shortcut Icon will start a normal DOS Command Prompt window, run the AWK HTML generator application, and finishes by launching the Browser to view the Web page results. Across the top of the page are three (3) checkboxes and pull-down menus that contain lists of all the Maps, Players, and Races that were found in the Stats files. The checkboxes turn "ON" and "OFF" the particular filtering and the menus can be used to indicate which particular Map, Player, and/or Race to limit the results to. In parentheses next to each menu list item is the number of records that were found for each item. Below the pull-down menus is the Statistics Summary Table that report the statistics from the games. There are a pair of radio buttons to the side of these statistics lines that govern whether cumulative totals or game averages should be reported. Following the Summary lines is a scrollable list of the individual game player records that were used to calculate the statistics summary. The list contains the Map Name, Date & Time of the game, Players that were involved, what Race they were, what starting position on the map they held, and the Time of Death if they were killed in the game. Selecting a specific line item, a new windows will be displayed with all of the player details for that game. The line items are highlighted in sets of alternating colors to group players of a particular game together. Players that were killed in the game are also shown with red text. At the bottom of the page is a Status area and another pull-down menu that changes the number of individual game player rows that are shown but does not effect the calculations in the Summary Table. Finally, there is a checkbox to filter out game records that did not last for more than five (5) minutes (ie. abandoned games) from both the Summary Table and the Detail List. ----------------------------------------------------------------------- 7. Frequently Asked Questions ----------------------------------------------------------------------- Q: How can I change which Player Profile is used? A: The Desktop Shortcut Icon has a parameter on the end of the "Target" that by default is "Profile1". Change that to "Profile2" or whatever Player Profile should be used. Q: I double-click on the Desktop Icon but nothing is browsed. A: More than likely there needs to be an adjustment made to the HW2-MSB DOS Command File. Refer to Section 5 of this README for details on what should be adjusted. The HW2-MSD.bat file has built in error detection and should show what kind of problem is being encountered. Q: How can I look at the results of all my Player Profiles together? A: The HW2-MSB is designed to only scan one profile directory at a time. The .stats files from other directories could be copied or moved to a common directory under \Homeworld2\Bin\Profiles to consolidate the results such as "Profile-All\stats" and changing the Desktop Shortcut to point to the common "Profile-All" profile. Note that new game .stats file would have to be copied there as well to be included.
May the BAWK be with YOU !!
