Main Stream Gamers' PunkBuster™ Screenshot Viewer

MSG Punkbuster&trade screenshot viewer Main Stream Gamers download

User Guide

GUI overview

User Interface

The Viewer uses six panes as follows:

A. options for Viewer behavior

B. the menu; a list of choices for what is to be shown in pane C

C. summary view of the screenshot index, as chosen from pane B

D. details of a clicked item, such as a player

E. list of screenshots associated with a clicked count

F. links to MSG's website, this web site, the Viewer forum, and the URL of the viewed PunkBuster™ index file


Getting Started

The Viewer uses a web browser as its host.

For screenshots on a local machine (or to which you are remotely connected with such as Windows Remote Desktop) open msgpbssv.html as a file. With Firefox, that can be accomplished with menu item File | Open File....

For screenshots on a remote machine access msgpbssv.html using an FTP URL like ftp://[username]:[password]@[IP address]/[game instance root]/pb/svss/msgpbssv.html. With Firefox, that can be accomplished with menu item File | Open Location....

The expected sequence of events is:

  1. user opens the Viewer
  2. Viewer shows "loading PunkBuster's screenshot index..."
  3. Viewer finishes loading the index
    (Load time is based on download speed, index size, and your web browser and processor speeds.)
  4. Viewer presents the Index Summary
  5. user clicks an item from List Selection
  6. user clicks a screenshot count (from such as Screenshot Census)
  7. Viewer presents screenshots
  8. user clicks here, there, and anywhere

Settings

Settings

Always present.

Parameters that affect your viewing pleasure.

hide: Click to abbreviate the pane to only the heading. When abbreviated, hide becomes show. Guess what that does.

Display screenshots with PBSS plugin: If unchecked, screenshot images are presented as PunkBuster™ saved them. If checked, screenshot images are presented within Orangepeel's plugin. The desired plugin display dimensions can be set with the dropdown lists. Plugin information is available from the link embedded in the checkbox's label. Due to plugin mechanics, it does not work with IE v7.

Time format: The preferred way to display time values.


List Selection

List Selection

Always present.

A menu of things to view.

Click one.


Index Summary

Index Summary

Presented when index loading is complete and when selected from List Selection.

The displayed items are as follows:

items encountered: count of entries found in PunkBuster™ index

items loaded: entries successfully included for viewing

items excluded: number of PunkBuster™ entries that could not be included for viewing; the count is a link to a display of them

from: earliest date and time listed for any indexed item

through: latest date and time listed for any indexed item

players: number of unique player names encountered

screenshots: number of useable indexed screenshots; this number can be less than the line items because of screenshot file recycling

players with screenshots: number of unique player names with useable indexed screenshots

screenshots/player: mean number of useable screenshots per player, for players with at least one useable screenshot


Players With Aliases

Players With Aliases

Presented when selected from List Selection.

The PunkBuster™ index provides player names and their GUIDs. Players who have used more than one name — in the time span covered by the index — are listed here.

Clicking a player name will present Player Details in pane D.

The footer includes a count of the aliased player names. (It's a count of names, not GUIDs.)


Screenshots By Player

Screenshot Census By Player

Presented when selected from List Selection.

There are two versions of this list: all players, or only those players with at least one screenshot.

Players are listed alphabetically, ignoring special characters. The count of screenshots is provided with a bar chart showing each player's count relative to the player with the most screenshots.

Clicking a player name will present Player Details in pane D.

Clicking a count will present the player's screenshots in pane E.

The footer includes a count of the listed players.


Screenshots By Time

Screenshot Census By [Time]

Presented when selected from List Selection and when heading's time period is changed.

Time periods are listed from first to last in which screenshots exist. Periods with no screenshots are represented by blank lines. The count of screenshots is provided with a bar chart showing each period's count relative to the period with the most screenshots.

Each period begins at the listed time and ends one moment prior to the beginning of the next period.

Clicking a time period will present Time Period Details in pane D.

Clicking a count will present the period's screenshots in pane E.

The footer includes a count of the listed periods.


Player Details

Player Details

Presented when a player name is clicked.

The controls and displayed items are as follows:

Buttons in the title bar navigate to the (alphabetically) prior and next players.

name: the player name, as shown throughout the application; color codes are stripped for legibility

real name: name as recorded in the game's settings

aliases: other names used by the player based on having the same GUID; clicking one will present that player's details

GUID: the player's game-assigned unique identifier

earliest: the time of first mention of this player in the index; may not be associated with an existing screenshot (due to screenshot file name recycling)

latest: the time of last mention of this player in the index; should be associated with an existing screenshot

screenshots: count of screenshots in the index for this player name; clicking it will present the player's screenshots in pane E

Screenshots by Day: a list of days for which the player has screenshots, their counts and a graphical representation of the counts; clicking a day will present its Time Period Details in this pane; clicking a count will present the player's screenshots for that day in pane E


Time Period Details

Time Period Details

Presented when a time is clicked.

The controls and displayed items are as follows:

Buttons in the title bar navigate to the prior and next time periods of the same duration as the current one.

period start: opening moment of the time period, inclusive

period end: closing moment of the time period, exclusive

screenshots: total number of screenshots in the time period; clicking it will present the time period's screenshots in pane E

Screenshots by Player: a list of players for which the time period has screenshots, their counts and a graphical representation of the counts; clicking a player name will present their Player Details in this pane; clicking a count will present the player's screenshots for that time period in pane E


Screenshots

Screenshots

Presented when a screenshot count is clicked.

This is a list of screenshots for a player or for a period of time, depending on how it was requested. The title will reflect that.

Each screenshot is accompanied by a block of information as follows:

  1. Viewer-assigned sequence number
  2. player name; a link for presenting Player Details in pane D
  3. screenshot date
  4. screenshot time
  5. PunkBuster™ indexed screenshot file name

Excluded Index Entries

Excluded Index Entries

Presented when selected from the Index Summary.

This is a list of items from the PunkBuster™ index that failed Viewer validation. Such entries are not included elsewhere in the Viewer.

For details about such entries, see the FAQ.

Each line provides:

  1. Viewer-assigned sequence number
  2. summary of the excluded line, starting with the Punkbuster™ screenshot file name; a link to display the index entry

last updated 9:00 pm 2Dec13