About

The Dungeon Runners Character Sheet Library (DRCSL) is a small library written by Three Planets Software designed to allow web site owners to easily set up a character sheet viewer. It uses PHP 5 classes, with minimal requirements.

Along with the DRCSL is a MediaWiki Extension (MWE) that uses this library to integrate character viewing capabilities into TheTownstons.

Requirements

All that is required for the DRCSL is PHP 5 on a host that allows exec() callouts. Currently the paths are Unixy, but in the future they'll be cleaned up to allow for Windows paths as well. The advantage to this system is that PHP needs no additional libraries, such as cURL or XSL.

Download

The latest version of DRCSL can be found here.
The latest version of the MediaWiki extension can't be found online yet. A test version is installed on TheTownstons for experimentation and testing.

Latest 5 Changes

• 5/16/2008 - Version .22:

  • Added max_level, description, genre, and type to Item class. Each variable can be returned (initialized to false) by calling $item->get_(variable_name).
  • Added variable in drcsl.php to change where the data comes from. Allows for seperate PTS and Live feeds to be tracked.
  • Added PVPRating and PowerLevel to Character class. Can be found with: $billy->get_char_info('PVPRating'); and $billy->get_char_info('PowerLevel');.

• 3/26/08 - Version .2 - Major changes:

  • Added item class. This is created for every Item a Character has, and stored in an Items array (indexed by SlotID) in the Character. Calling $billy->get_char_items() now returns the array of Items. Calling $billy->get_char_item($slot) now returns the Item in that index, or false if its empty.
  • Added Skill class. This is created for every Skill the Character has, and is stored in a Skills array (indexed by SlotID) in the Character. Calling $billy->get_char_skills() now returns the array of Skills. Calling $billy->get_char_skill($slot) now returns the Skill in that index, or false if its empty.
  • Added the $billy->get_char_mods() function. This returns an array of all the modifications involved in a Character's stats. The structure is:
    $mods[mod_type][item_name] = amount
    For example:
    $mods["Movement Speed"]["Multi-Faceted Scrap Metal Splint Spaulders of the Greyhound"] = "-1%"
  • Added DPS calculations... finally. This is a very basic version of DPS calculation, and should be taken as a base value for melee damage. Spell damage is not taken into account, nor is critical hit chance. However that means you know you'll be dealing at least this amount.
    DPS for a weapon is included in the data you get when you call $billy->get_char_weapon('primary'); and you can get overall DPS through $billy->get_char_dps().
  • Changed how Characters are fetched. This is significant, as my library now requires cURL. Howver cURL is fairly often installed with a default php, or rather can be found on most php installs, even though its added seperately. If libcURL is not available, it'll try a raw socket transfer, and if that doesn't work you're (currently) out of luck. I will be adding a wget feature back in, but this system is fairly redundant enough to not require it.