Skip to main content

Generate 5th edition Dungeons & Dragons characters.

Project description

Y.A.R.I - "Yet Another RPG Implement"

"Yari is the term for a traditionally-made Japanese blade in the form of a spear, or more specifically, the straight-headed spear. - From Wikipedia, the free encyclopedia

DESCRIPTION

Yari generates quick and easy 5th edition Dungeons & Dragons characters. Currently the software supports content from the following rulebooks: Player's Handbook, Volo's Guide to Monsters and Xanatar's Guide to Everything (partially).

This project was originally known as personaednd and later dndpersona.

REQUIREMENTS

  • aiohttp ~= 3.6.2
  • beautifulsoup4 ~= 4.9.1
  • click ~= 7.1.2
  • lxml ~= 4.5.2
  • PyYAML ~= 5.3.1

INSTALLATION

To install Yari directly from Github (usually the latest version):

pip install git+git://github.com/taylormarcus/Yari or pip3 install git+git://github.com/taylormarcus/Yari

To install Yari from PYPI, run the following command:

pip install Yari or pip3 install Yari

USAGE

Usage: yari [OPTIONS]

Options:
  -race TEXT        Character's chosen race. Available races are: Aasimar,
                    Bugbear, Dragonborn, Dwarf, Elf, Firbolg, Gith, Gnome,
                    Goblin, Goliath, HalfElf, HalfOrc, Halfling, Hobgoblin,
                    Human, Kenku, Kobold, Lizardfolk, Orc, Tabaxi, Tiefling,
                    Triton and Yuanti. Default value is 'Human'.

  -subrace TEXT     Character's chosen subrace. Available subraces are based
                    upon the chosen race: Aasimar (Fallen, Protector,
                    Scourge), Dwarf (Duergar, Hill, Mountain), Elf (Drow,
                    Eladrin, High, Sea, Shadar-kai, Wood), Gith (Githyanki,
                    Githzerai), Gnome (Deep, Forest, Rock), Halfling
                    (Lightfoot, Stout), Tiefling (Asmodeus, Baalzebub,
                    Dispater, Fierna, Glasya, Levistus, Mammon,
                    Mephistopheles, Zariel).

  -sex TEXT         Character's chosen gender.
  -alignment TEXT   Character's chosen alignment. Available alignments are:
                    CE, CG, CN, LE, LG, LN, NE, NG, N. Default value is 'N'.

  -background TEXT  Character's chosen background. Available backgrounds are:
                    Acolyte, Charlatan, Criminal, Entertainer, Folk Hero,
                    Guild Artisan, Hermit, Noble, Outlander, Sage, Sailor,
                    Soldier, Urchin.

  -klass TEXT       Character's chosen class. Available classes are:
                    Barbarian, Bard, Cleric, Druid, Fighter, Monk, Paladin,
                    Ranger, Rogue, Sorcerer, Warlock, and Wizard. Default
                    value is 'Fighter'.

  -subclass TEXT    Character's chosen subclass (archetype, domain, path,
                    etc). Available subclasses are based upon the chosen
                    class: Barbarian (Path of the Ancestral Guardian, Path of
                    the Berserker, Path of the Storm Herald, Path of the Totem
                    Warrior, Path of the Zealot), Bard (College of Glamour,
                    College of Lore, College of Swords, College of Valor,
                    College of Whispers), Cleric (Forge Domain, Grave Domain,
                    Knowledge Domain, Life Domain, Light Domain, Nature
                    Domain, Tempest Domain, Trickery Domain, War Domain),
                    Druid (Circle of the Arctic, Circle of the Coast, Circle
                    of the Desert, Circle of Dreams, Circle of the Forest,
                    Circle of the Grassland, Circle of the Moon, Circle of the
                    Mountain, Circle of the Shepherd, Circle of the Swamp,
                    Circle of the Underdark), Fighter (Arcane Archer, Battle
                    Master, Cavalier, Champion, Eldritch Knight, Samurai),
                    Monk (Way of Shadow, Way of the Four Elements, Way of the
                    Open Hand), Paladin (Oath of the Ancients, Oath of
                    Devotion, Oath of Vengeance), Ranger (Beast Master,
                    Hunter), Rogue (Arcane Trickster, Assassin, Thief),
                    Sorcerer (Draconic Bloodline, Wild Magic), Warlock (The
                    Archfey, The Fiend, The Great Old One), and Wizard (School
                    of Abjuration, School of Conjuration, School of
                    Divination, School of Enchantment, School of Evocation,
                    School of Illusion, School of Necromancy, School of
                    Transmutation).

  -level INTEGER    Character's class level. Must be between 1-20. Default
                    value is 1.

  -ratio INTEGER    Character's 'ability to feat' upgrade ratio. Must be
                    between 0-10. This value will determine the percentage of
                    level upgrades allocated to the character's ability
                    scores. The difference between this value from 100 will
                    then be allocated to the percentage of chosen feats (i.e:
                    So if this value is 2 or 20%, 80 percent will
                    automatically be allocated to feats). Default value is 5.

  -port INTEGER     Character server's chosen port. Default value is 8080.
  --version         Show the version and exit.
  --help            Show this message and exit.

To run Yari with minimal arguments, type the following in your terminal:

yari

If Yari is run with just the bare minimum arguments as shown above, a character will be generated using the previously mentioned default values where applicable and randomly generate those values that have no defined default values.

DISCLAIMER

This software is not affiliated with, endorsed, sponsored, or specifically approved by Wizards of the Coast LLC. This software is a fan made tool.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Yari-20.10b6.tar.gz (36.3 kB view details)

Uploaded Source

Built Distribution

Yari-20.10b6-py3-none-any.whl (44.0 kB view details)

Uploaded Python 3

File details

Details for the file Yari-20.10b6.tar.gz.

File metadata

  • Download URL: Yari-20.10b6.tar.gz
  • Upload date:
  • Size: 36.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for Yari-20.10b6.tar.gz
Algorithm Hash digest
SHA256 1c4cf787b8511e5b891ca1a7c166f356fbac7f1e51c29be14bf46d8371b9efac
MD5 f9b821f014008533890c03255e7d028e
BLAKE2b-256 537d6ff5d8eb4968b8e5633459cab4c32c5558ffba30a5290e675efa28fcb34a

See more details on using hashes here.

File details

Details for the file Yari-20.10b6-py3-none-any.whl.

File metadata

  • Download URL: Yari-20.10b6-py3-none-any.whl
  • Upload date:
  • Size: 44.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for Yari-20.10b6-py3-none-any.whl
Algorithm Hash digest
SHA256 bb49b8d93d61b98b2d397f3384f8335913c7d31057ba88a7001ed2b5a8290650
MD5 83484cebd89d81aa4848d30db1e388b4
BLAKE2b-256 1a9d14b24ecb8dd7c8e7a8c4f8d7b11afeae6e6db20cf508131b33a538003b09

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page