Quick Source Loading Page

From PCGen Wiki
Revision as of 07:45, 21 September 2008 by James (talk | contribs) (Source Definition)
Jump to: navigation, search

The current source loading page is difficult for new users to understand ands is lacking in general guidance on what to do next. As this is the first thing a user sees it is a significant barrier to usage.

This specification describes a simplified source selection user interface that allows use by both new and advanced users.

User Interface

The Quick Source Loading page should pop up when PCGen is first started. It should have large (200x200 pixel-ish) buttons showing the common sets of sources to be loaded. Out of the box it should cater for both PC only and game master versions of "SRD", "RSRD", and "MSRD". Obviously other major game modes should be available here too, however we need to be careful not to overload the screen and make it too complex again. When clicked each sets the game mode and loads those entire sets (e.g. RSRD Complete). This would be single shot, no additional questions for the user.

Other buttons on the screen:

  • Define a quick launch set of sources. This brings up the old sources selection screen that would set the sources for just that button, returning the user to the "quick sources" after "OK" is clicked.
  • Load Custom Sources This is a small button (vertical size similar to traditional buttons like "OK", and "Cancel"), which allows creation, hiding, and deletion of the shortcut buttons. The screen can probably reasonably handle 8 large shortcut buttons before it's overloaded visually.

Once the data is loaded the next action should be obvious. The primary actions are:

  • New - create a new character
  • Load - load an existing character
  • Generate - generate a new random NPC

These could be provided by a series of buttons on the screen or the quick sources dialog is hidden and buttons are shown on the main part of the screen.

Tom's mockup: Tom;s mockup

Connor's mockup: Connor's mockup of the quick source loading page

Source Definition

The following use cases need to be supported by the Quick Source Loading dialog:

  1. Standard shipped sources - we would like RSRD for Players (PC races & classes), RSRD for Game Masters (SRD including Monsters) etc to appear as selections when the program is first started.
  2. User custom combination - it should be easy for users to define their own combination of sources to load, like the existing screen allows, and give that combination a title and then for it to be displayed in the Quick Source Loading dialog.
  3. GM Supplied Sources - it should be easy for a GM to ship their custom combination to their players and for the players to install that set. Once installed the source should appear in the Quick Source Loading dialog.
  4. Last loaded sources - the sources that the user loaded in their last session.

For each source to appear in the dialog we will need to know the title to be displayed, the game mode to switch to and the PCC files to be loaded.

In supporting use case #1 there are two existing structures that could be harnessed: the DEFAULTDATASET tag usable in the game mode and the SHOWINMENU tag usable in PCC files. The DEFAULTDATASET tag would need to be enhanced to include a title, but this would allow a collection of PCC files to be loaded. The SHOWINMENU only loads a single PCC (which may include references to other PCC files of course) but the title would be from the CAMPAIGN tag and the game mode form the GAMEMODE tag (first mode used if multiple are listed). Data sets would be shipped with the SHOWINMENU flag set. NB: The use of the DEFAULTDATASET tag for this purpose may mean we end up with too many entries if there are game modes which would otherwise be excluded.

Supporting use case #2 would require a PCC file to be written out with the title and the SHOWINMENU flag set to true. It would work much the same as the current PCC customiser however the user interface from the current Source Material tab might be more appropriate for use here as it will be the primary way that non-core sources get viewed and selected by the user. Note that a game mode would have to be selected before the source selection could be displayed. This could be added to the 'advanced' dialog.

Use case #3 is an extension of use case #2. We should have an export function which will package up the custom PCC file in a zip file suitable for use by the Data Installer. This can then be sent by a GM to their players. Question: Should we include other sources in the install pack? If so how should they be selected? Possibilities are to include sources from the vendordata folder, or to allow the GM to select the sources to be included.

Use case #4 is simply a matter of highlighting the last data set loaded in the last game mode, if the Quick Source Loading dialog is the only way to load sources. If the existing page continues as an 'Advanced' page then the last data set loaded will have to be added as an entry to the dialog in much the same manner as a DEFAULTDATASET would be.


User Preferences

Adding New Sources to the Page

You'd need to poll for the game mode first, but otherwise, yes this would work.nicely.