DGSH - the DunGeon Shell $Id: index.shtml,v 1.6 2002/09/08 08:18:14 jmettraux Exp $ |
|
* home * features * installing * running * tracking your party * adding a PC or a NPC * parsing stat blocks * some fight * commands * scripted commands * scripted triggers * javadoc * data files * missing features * mailing lists * some links * credits * download * dgsh on sf.net * sources * contact |
Dgsh is for Dungeon Masters The DunGeon SHell is a shell-like interface for tracking a party of d20 characters and their opponents. I wrote dgsh because I was tired as a DM of rolling initiative for 5, 6 more goblins and tracking who's the next to play. The rest of the features came naturally. Dgsh hasn't any fancy graphical user interface because I wanted to concentrate on fonctionality. If your machine can run Java 1.4.0, even if it's an old machine, you can run dgsh... A good choice would be an old Pentium laptop, with linux and no X server running,... Dgsh is not a character generator. But it will soon be able to parse standard stat blocks to turn them into its own (XML) format. If you're looking for a character generator, PCGEN might be the best choice. Warningdgsh is a shell, it has no user-friendly interface, you must type commands, there is nothing to click. !! FEEDBACK !!Don't be shy or too polite, tell me what you think of dgsh and what you await from such a soft. My mail address is jmettraux @ burningbox.org, but the best thing would be to send your mail to the users mailing list. Thanks in advance ! New :Game time is now tracked ! At the end of each combat, time elapsed is added to the game clock. With commands like 'clock add 3h' you can add durations to the game clock. There is now a sample session you can browse. Added 'charge', 'fidef' and 'todef' commands. Added a 'treasure' command for generating random treasure. For the moment, only the 1st level SRD treasure table is implemented. FeaturesDgsh doesn't abolish scenario study and session preparation. It is designed to help you during the game session.
Installing dgshRequirements : Download the zip file of the latest binary release and then unpack it in any of your directory. Running dgshInto the unpacked dgsh/ dir type ./dgsh.sh and start using dgsh. Make sure your JAVA_HOME is set, either in the env, either directly in dgsh.sh On windows, get into the dgsh directory and type dgsh Tracking your partyAt first, you've got to load your party into the game session. Type load p.xml party to load a sample party. Then use display shana to show who and what Shana is. Dgsh knows 2 states : normal or fight. You enter normal mode when you start the shell. You enter the fight mode with the fight command and then leave it with relax. After you've typed relax, dgsh will tell you how many XP your party should earn for this encounter, but after, it's up to you as the DM to award them to the PCs and this can be done with the xp command. Some fightMake sure your party is loaded (if you haven't any, take mine by typing load p.xml p). Type fight to enter combat mode (it enables the opponents set). Then load monsters.xml and inst goblin 10 gob to instantiate 10 goblins named gob1 to gob10. Type init to automatically roll initiative for the goblins. Dgsh will then ask you the result of yours PC rolls (My player love to add themselves their initiative modifiers, so dgsh doesn't add this modifier to the result you type). next will tell you 'in detail' who's the next to play. When the fight is over, it's time to relax. Scripted triggersTriggers are pieces of code called at given times. A good example of trigger is the regeneration trigger, which allows creatures like trolls to regenerate. The barbarian rage script also contains a trigger which applies at the end of the rage and inits the barbarian's depression. Spells have a trigger : some code that is called when they are cast. I haven't much worked on implementing a trigger for each spell that diserves it, but I might do it one day or the other. For the moment, only 'Magic Missile' has a trigger, but a dummy demo one. If you are interested in writing spell triggers, study the barbarian rage script... And don't hesitate to contact me The regeneration script doesn't strictly match the rules for regeneration for the moment. It is sufficient though. JavaDocIt's rather terse now, but it could improve. Anyway, you can take a look at it. The data files of dgshDgsh uses XML and Java 1.4.x XML bean externalization. you can have a look at the data files. Classes and races are the dnd standards, the Monk class has not been included : there is no monk in my campaign so. Also not included are prestige classes, I haven't thought about it, but they should match the current data model for character classes. If you want to add your own data files (do it !), add them somewhere and then modify etc/dsh-config.xml to add an entry that should read like : <void method="add"> <string>c:/dnd/campaign/dgsh/my_campaign_races.xml</string> </void> under the 'dataFileNames' property of the file. Note that the my_campaign_races.xml file is referred with its absolute path in this example : relative paths are also allowed (They are relative to the working directory from which you launched dgsh). Mailing lists
Missing featuresI will implement these features sooner or later :
Some ideas in my head (why_nots) :
Ideas you won't find anywhere in my head (nots) :
Some linksLinks to tools close to dgsh :
ContactYou are welcome to use the SourceForge facilities for requesting features, support or patches. CreditsD20 and Dungeons and Dragons are registered trademarks of Wizards of the Coast. Java is a registered trademark of Sun Microsystems. DownloadMake sure to download the latest release (the highest on the page). You can download dgsh either packed as a zipfile or a tar.gz archive. Remember that dgsh requires a Java Virtual Machine, which you can download at http://java.sun.com/j2se/1.4/download.html. A Java Runtime Environment (JRE) should suffice. |
$Id: index.shtml,v 1.6 2002/09/08 08:18:14 jmettraux Exp $
hosted on | and |