Skip to main content

"KRCG Command Line Interface for VTES",

Project description

KRCG CLI

PyPI version Validation Python version License Code Style

CLI tool for V:tES, using the VEKN official card texts, the Tournament Winning Deck Archive (TWDA) and KRCG rulings list.

Portions of the materials are the copyrights and trademarks of Paradox Interactive AB, and are used with permission. All rights reserved. For more information please visit white-wolf.com.

Dark Pack

Usage

An internet connection is required to initialize krcg with official VEKN data (cards list and TWDA).

Use the help command for a full documentation of the tool:

krcg --help

And also extensive help on each sub-command:

krcg [COMMAND] --help

Contribute

Contributions are welcome !

This CLI is an offspring of the KRCG python package, so please refer to that repository for issues, discussions and contributions guidelines.

Examples

Get a card text (case is not relevant, some abbreviations / misspellings are understood):

$ krcg card krcg
KRCG News Radio
[Master][2P] -- (#101067)
Unique location.
Lock to give a minion you control +1 intercept.
Lock and burn 1 pool to give a minion controlled by another Methuselah +1 intercept.

This provides rulings, if any:

$ krcg card ".44 magnum"
.44 Magnum
[Equipment][2P] -- (#100001)
Weapon: gun.
Strike: 2R damage, with 1 optional maneuver each combat.

-- Rulings
Provides only ony maneuver each combat, even if the bearer changes. [LSJ 19980302-2]
The optional maneuver cannot be used if the strike cannot be used (eg. {Hidden Lurker}). [LSJ 20021028]

Use the -l option to get ruling links:

$ krcg card -l ".44 magnum"
.44 Magnum
[Equipment][2P] -- (#100001)
Weapon: gun.
Strike: 2R damage, with 1 optional maneuver each combat.

-- Rulings
Provides only ony maneuver each combat, even if the bearer changes. [LSJ 19980302-2]
The optional maneuver cannot be used if the strike cannot be used (eg. {Hidden Lurker}). [LSJ 20021028]
[LSJ 19980302-2]: https://groups.google.com/d/msg/rec.games.trading-cards.jyhad/9YVFkeiL3Js/4UZXMyicluwJ
[LSJ 20021028]: https://groups.google.com/g/rec.games.trading-cards.jyhad/c/g0GGiVIxyis/m/35WA-O9XrroJ

Search for cards matching a number of criteria

$ krcg search --type reaction --trait "Black Hand"
Follow the Blood
Ministry
Truth in Ink
Watch Commander

Search for specific card text

$ krcg search --text "this equipment card represents a location"
Catacombs
Dartmoor, England
Inveraray, Scotland
Living Manse
Local 1111
Lyndhurst Estate, New York
Palatial Estate
Pier 13, Port of Baltimore
Ruins of Ceoris
Ruins of Villers Abbey, Belgium
...

Search cards by artist

$ krcg search --artist "Ron Spencer"
Antediluvian Awakening
Arcanum Investigator
Bang Nakh  Tiger's Claws
Bauble
Blessing of Durga Syn
Blood Agony
Blood Shield
Blood Tears of Kephran
Bonecraft
Brass Knuckles
...

Search cards by set

$ krcg search --set "Black Hand"
Abyssal Hunter
Acrobatics
Alpha Glint
Amaranth
Ambush
Ana Rita Montaña
Animal Magnetism
...

List TWDA decks containing a card:

$ krcg deck "Fame"
-- 572 decks --
[steveholmer] Weenies with Blazing Guns
[portoct99] None
[rtpa2] " I'll be your dog"
[rtpa2k] ' I'll be your dog !'
[valentine] None
[normbsl] Who sez guns don't win?
[kotb] Kiss of the Brujah
...

Display any TWDA deck:

$ krcg deck 2016gncbg
[2016gncbg      ]===================================================
German NC 2016
Bochum, Germany
December 3rd 2016
3R+F
19 players
Bram van Stappen

-- 2gw6.5 + 1.5vp in the final

Deck Name: weenie animalism minimal: "Ich bin eine von wir"

played (untested) at the German Nationals 03.12.2016, Bochum

Crypt (12 cards, min=8, max=21, avg=3.75)
-----------------------------------------
2x Stick                3 ANI                      Nosferatu antitribu:4
1x Janey Pickman        6 ANI PRO for              Gangrel antitribu:4
1x Céleste Lamontagne   5 ANI PRO for              Gangrel antitribu:4
1x Effie Lowery         5 ANI SPI obf              Ahrimane:4
1x Sahana               5 ANI pre pro spi          Ahrimane:4
1x Yuri Kerezenski      5 ANI aus for vic  bishop  Tzimisce:4
1x Beetleman            4 ANI obf                  Nosferatu:4
1x Bobby Lemon          4 ANI pro                  Gangrel:3
1x Mouse                2 ani                      Nosferatu:3
1x Zip                  2 ani                      Ravnos:3
1x Lisa Noble           1 ani                      Caitiff:3

Library (90 cards)
Master (12)
5x Blood Doll
1x Direct Intervention
1x Fame
1x KRCG News Radio
1x Pentex(TM) Subversion
2x Powerbase: Montreal
1x Rack, The

Action (14)
2x Abbot
1x Aranthebes, The Immortal
1x Army of Rats
10x Deep Song

Equipment (1)
1x Sniper Rifle

Retainer (7)
1x Mr. Winthrop
6x Raven Spy

Reaction (18)
5x Cats' Guidance
3x Delaying Tactics
4x Forced Awakening
5x On the Qui Vive
1x Wake with Evening's Freshness

Combat (38)
16x Aid from Bats
2x Canine Horde
11x Carrion Crows
1x Pack Alpha
6x Taste of Vitae
2x Terror Frenzy

Display all decks that won a tournament of 50 players or more in 2018:

$ krcg deck --players 50 --from 2018 --to 2019
-- 5 decks --
[2018igpadhs] None
[2018eclcqwp] Dear diary, today I feel like a wraith.. Liquidation
[2018ecday1wp] MMA.MPA (EC 2018)
[2018ecday2wp] EC 2018 win
[2018pncwp] Deadly kittens

Display all winning decks for a given player:

krcg deck "Ben Peal"
-- 35 decks --
[dragoncon99] None
[benrcp2k] Wonderwall
[newjerseycc] Short Leash Bleed
[aftermath] None
...

List cards most associated with a given card in TWD:

$ krcg affinity "Fame"
Taste of Vitae                 (in 57% of decks, typically 3-6 copies)
Delaying Tactics               (in 33% of decks, typically 1-3 copies)
Dragonbound                    (in 32% of decks, typically 1 copy)
Powerbase: Montreal            (in 31% of decks, typically 1 copy)
Immortal Grapple               (in 28% of decks, typically 6-11 copies)
Carrion Crows                  (in 28% of decks, typically 6-11 copies)
Haven Uncovered                (in 27% of decks, typically 1-4 copies)
Carlton Van Wyk                (in 27% of decks, typically 1 copy)
Bum's Rush                     (in 27% of decks, typically 1-8 copies)

List most played cards of a given type, clan or discipline:

$ krcg top -d ani
Carrion Crows                  (played in 346 decks, typically 5-10 copies)
Cats' Guidance                 (played in 328 decks, typically 2-6 copies)
Raven Spy                      (played in 279 decks, typically 1-6 copies)
Canine Horde                   (played in 247 decks, typically 1-3 copies)
Army of Rats                   (played in 211 decks, typically 1-2 copies)
Aid from Bats                  (played in 204 decks, typically 5-14 copies)
Deep Song                      (played in 195 decks, typically 3-10 copies)
Sense the Savage Way           (played in 171 decks, typically 2-6 copies)
Guard Dogs                     (played in 119 decks, typically 1-4 copies)
Nana Buruku                    (played in 93 decks, typically 2-4 copies)

Build a deck from any given cards based on TWDA:

$ krcg build "Fame" "Carrion Crows"
Created by: KRCG

Inspired by:
 - 2020mdmlf            Nanarch Buruku
 - 2019r6vh             Aksinya+Nana+Anarch+Ani 4.0
 - 2019bncfb            Resistência Anarch
...

Crypt (12 cards, min=4, max=29, avg=4.08)
-----------------------------------------
1x Stick                3 ANI            Nosferatu antitribu:4
1x Beetleman            4 ANI obf        Nosferatu:4
1x Bobby Lemon          4 ANI pro        Gangrel:3
3x Nana Buruku          8 ANI POT PRE    Guruhi:4
1x Céleste Lamontagne   5 ANI PRO for    Gangrel antitribu:4
1x Petra                5 ANI OBF aus    Nosferatu:4
4x Anarch Convert       1 -none-         Caitiff:ANY

Library (90 cards)
Master (30; 4 trifle)
7x Anarch Revolt
1x Archon Investigation
8x Ashur Tablets
1x Direct Intervention
2x Dreams of the Sphinx
1x Fame
2x Haven Uncovered
3x Liquidation
1x Pentex(TM) Subversion
3x Vessel
1x Wider View

Action (11)
1x Army of Rats
10x Deep Song

Retainer (4)
4x Raven Spy

Reaction (9)
4x Cats' Guidance
2x Delaying Tactics
3x On the Qui Vive

Combat (36)
13x Aid from Bats
2x Canine Horde
10x Carrion Crows
4x Target Vitals
4x Taste of Vitae
3x Terror Frenzy

Fornat a decklist into another format - also not that krcg commands can be piped.

krcg deck 2016gncbg | krcg format -f lackey > 2016gncbg.txt

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

krcg-cli-2.1.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

krcg_cli-2.1-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

File details

Details for the file krcg-cli-2.1.tar.gz.

File metadata

  • Download URL: krcg-cli-2.1.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.2

File hashes

Hashes for krcg-cli-2.1.tar.gz
Algorithm Hash digest
SHA256 440c32b01065269a96c3a2f553323a45cf3da0d981a93590d0a08f674d334807
MD5 35d21e61aebb38c0245f22c09da2e3e1
BLAKE2b-256 e38fde381f5a8e94cfe2fd6410a1b31baddc6b4be354decc504f79a619202f48

See more details on using hashes here.

File details

Details for the file krcg_cli-2.1-py3-none-any.whl.

File metadata

  • Download URL: krcg_cli-2.1-py3-none-any.whl
  • Upload date:
  • Size: 15.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.2

File hashes

Hashes for krcg_cli-2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6284c8807f71cbcee502bd058cbd14a107f85f128de136ad93c7f07bd8a8234b
MD5 eb417f4df744ee65ca18e0f179835c70
BLAKE2b-256 1451aa647aaa77403f71e7e22f8eb594e2187a0f3dda633307a3ff249fda5cdb

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