updating docs

This commit is contained in:
evilchili 2023-12-29 22:15:16 -08:00
parent 825e1953a4
commit c830eb165b

View File

@ -2,48 +2,28 @@
**WIP!** **WIP!**
This package includes a library and CLI for generating randomized weapons, items, and loot for This package includes a library and CLI for generating randomized weapons, items, and loot for Dungeons & Dragons, 5th edition.
Dungeons & Dragons, 5th edition.
## Usage ## Usage
The `dnd-item` command-line utility supports several comments: The `dnd-item` command-line utility supports several comments:
* **item**: Generate a random item (the default) * **weapon**: Generate weapons
* **weapon**: Generate a basic, non-magical weapon * **roll-table**: Generate roll tables of random items
* **magical-weapon**: Generate a weapon with an added magical damage type
### Examples: ### Examples:
```shell ```shell
% dnd-item weapon % dnd-item weapon
Pike **Freezing +3 Longbow Of Mighty Strikes**
* type.category: martial * very rare martial weapon (ammunition, enchanted, heavy, magical, two-handed)
* type.damage: Piercing * +3 to hit, 150/600 ft., 1 tgts. 1d8+3 Piercing + 1d8 cold
* type.die: 1d10
* type.properties: heavy, reach, two-handed **Ammunition.** You can use a weapon that has the ammunition property to make a ranged attack only if you have ammunition to fire from the weapon. Each time you attack with the weapon, you expend one piece of ammunition.
* type.range: None Drawing the ammunition from a quiver, case, or other container is part of the attack (you need a free hand to load a one-handed weapon).
* type.reload: **Enchanted.** Attacks made with this magical weapon do an extra 1d8 cold damage.
* type.type: Martial **Heavy.** Small creatures have disadvantage on attack rolls with heavy weapons. A heavy weapons size and bulk make it too large for a Small creature to use effectively.
* type.value: 500 **Magical.** This magical weapon grants +3 to attack and damage rolls.
* type.weight: 18 **Two-Handed.** This weapon requires two hands when you attack with it.
``` ```
```shell
% dnd-item magic-weapon
Shortsword Of Thunder
* magic.adjective: booming
* magic.die: 1d4
* magic.noun: thunder
* type.category: martial
* type.damage: Piercing
* type.die: 1d6
* type.properties: finesse, light
* type.range: None
* type.reload:
* type.type: Martial
* type.value: 1000
* type.weight: 2
```