NAME

mktreasure - Treasure generator based on the d20 SRD role playing game system


SYNOPSIS

  mktreasure [options]
  Options:
        -h or --help            Brief help text
       --man                    Print manual
        -v or --verbose         Turn on verbose output
        --count N               Print N sets of results
        -c or --cr or
        --challenge-rating N    Treasure for CR N (default=1)
        --cursed                Include cursed items (5%)
        --dragon                Include Dragon Magazine items
        --force TYPE            Print out a random TYPE item
        --large-items           Include large items too
        -n or --non-standard    Include non-standard items
        --only-cursed           Do not include non-cursed magical items
        --only-psionics         Do not include normal magical items
        --pct-psionics N        Include N% psionic items
        --psionics              Include psionic items (10%)
        --save-random           Print the random number seed used
        --random-seed N         Use N as the seed for random numbers


DESCRIPTION

The d20 System is a role playing system introduced by Wizards of the Coast and distributed under the Open Gaming License (OGL). This program generates random treasure hordes according to the d20 System Reference Document (SRD) version 3.5 with only minor variations from the core rules where the default rules would not provide useful programatic results or would be impossible for a program to reasonably generate (e.g. some of the tables list a ``select an item'' entry).

While I am not a lawyer, and this is a free program, you may wish to consult the Open Game License and the d20 System Trademark License which may or may not limit the use and modification of this software.

This software is not meant to be used on its own. d20 core reference materials are required for actual game play.


OPTIONS

-h or --help
Produce a short options summary and exit.

--man
Produce this manual and exit.

-v or --verbose
Turn on verbose output (this is only intended for debugging).

--count
Provide a repeat count for items to output.

-c, --cr or --challenge-rating
Provide a challenge rating. This challenge rating can be between 1 and 25, inclusive. The treasure generated will be appropriate for a creature of the given challenge rating.

Default is 1.

--cursed
Include cursed items in results 5% of the time.

--dragon
Include Dragon magazine items in the output. Only the name, issue number and price are included. For further information, you must have access to the Dragon magazine issue referenced.

--force
This option changes the output of the program radically. Instead of generating a treasure horde, a single item type is output. The following are valid values to pass to the --force option:

coin, gem, art, mundane, armor, weapon, potion, ring, rod, scroll, staff, wand, rod, wonder

Each of these values can be preceded by ``minor-'', ``major-'' or ``medium-'' to request the given ``level'' of item.

If the --psionics option is given, the following items are also available:

cognizance, dorje, power-stone, psicrown, tatoo, universal

-l or --large-items
By default items that have a sizing are generated 10% small and 80% medium. This option changes that ratio to 10% small, 10% large and 80% medium.

-n or <--non-standard>
Include non-standard items in gems and art results. These items just add more variety, but do not change the gold piece value of the treasure.

This also changes the odds of gems, art and minor items at CR 5 in a way that appears to have been intended. This is done on the assumption that the values given for CR5 in the SRD are a (minor) mistake.

--only-cursed
Curse all magical items that are generated (this does not include magic items with charges or doses).

--only-psionics
Use only the random item table from the psionics section. The only time magic loot will be generated is if a weapon or armor item gets the ``specific item'' result (for which there are no psionic equivalents.

--pct-psionics
Given a percentage, generate that percentage psionic items and the rest magical. Example:
  mktreasure --pct-psionics 50

would generate a psionic item half of the time a magical item would be called for.

--psionics
Include psionic items in treasure.

The --psionics option reduces the chance of normal magical items by 10%, and instead produces a random psionic item.

Thus, there is a fairly small chance that psionic items will be generated, but this tends to be in-line with the ratio of magic to psionics in most campaigns. If you run a campaign with a more even mix of psionics and magic, consider generating some of your treasure hordes with the --only-psionics option instead.


AUTHOR

This program was written by Aaron Sherman. It is (c) 2005 by Aaron Sherman <ajs@ajs.com>. This program is distributed under the terms of the Open Gaming License version 1.0a (see http://www.wizards.com/default.asp).

All item names, spells, abilities, descriptions and powers are the copyrighted work of Wizards of the Coast, and derive from the d20 SRD version 3.5.

It's not at all clear to the author of this program how to procede with respect to the d20 license vs. the OGL. What I can say is this: I'll submit to whatever Wizards thinks is best, but this tool is meant to meet the spirit of this item from their FAQ:

Q: Why can't I use those things in my program?

A: No d20 System Product can include rules for character creation or applying experience. In exchange for using the d20 logo you are prohibited from making a product that replaces the core rulebooks. Covered Products supplement the core rulebooks; they may not replace them. That is why all Covered Products must state that they require the use of the core rules.

This program does not attempt to replace core rules in any way, and in fact acts only as an electronic index without descriptions, explanations or the expanded text provided even in the OGL sources.

One exception is that the items added by the --dragon command-line flag are from Paizo Publishing's Dragon Magazine, but the copyright for Dragon is owned by Wizards of the Coast, as well. These items are NOT OGL content, and are used here without permission in the hops that Wizards and Paizo recognize the spirit in which they are referenced, again as an index and without the required material which would make them useful in a gaming context without the original source material.


BUGS

There is really only one major bug that I'm aware of: the tables in this program NEED to be ripped out and put in an external file format. I'm considering YAML for this purpose, but XML is a close second.