Git Product home page Git Product logo

swade-npc-importer's Introduction

SWADE Stat Block Importer

(formerly SWADE NPC Importer)

A Savage Worlds Adventure Edition stat block importer for Foundry VTT

If you like what you see and find it uself, you can buy me a beer

ko-fi


Please Note

  1. If you are running Foundry as self-hosted, and with the HTTP protocol, then the Importer will not be able to read the data from the clipboard (this is security realted stuff). It will usually be represented by the following error in the browser console: Cannot read property 'readText' of undefined.

    To solve this either:

    • Set your hosted Foundry to work with HTTPS, or
    • Set the Insecure origins treated as secure flag in your browser (or equivalent) appropriatly (see here for an explanation)
  2. Firefox does not support the clipboard.readText() API, and I found no way around this.

😃 The Solution: The Actor Importer dialog has a text-box into which you may paste the statblock. This will by-pass both of these problems.


Just a heads up about statsblocks

The SWADE Stat Block Importer works with the official statblock as seen in any Pinnacle products (SWADE Core, Deadlands, etc..) and defined in the Pinnacle Style Guide

The Importer basically searches for patterns in the text, so that means paying attention to commas, colons, etc...

How to use it...

  1. Go to Settings and look around:

    • Under Select Item Compendiums mark any Compendium you wish NPC Importer to use (not selecting anyting will cycle through all compendiums and use the first relevant entry)
    • Set up any other default values you might want
  2. Copy the desired statblock (ctr/cmd + c, into the clipboard)

  3. Click on the NPC Importer button at the buttom of the Actors Directory

    NPC Importer Button

  4. Choose desired options & Click Import!

    NPC Importer Dialogue

  5. In case an Actor with the same name already exists, then you have some options NPC Importer Dialogue

Some configurations

On first use (or, you know, whenever), it is recommended to look at the default settings

NPC Importer Settings

It is highly recommended to choose the Package and/or Item Compendiums you wish NPC Importer to use while importing

Compendiums Selector

Some Prototype Token options may be set by default

Compendiums Selector


How it does it and what's supported

  1. The statblock is prased by searching for all supported attributes/traits/items/etc..
    • Any Additional Stats (Actors) which were added through the SWADE System Settings are: searched for, added, and enabled
    • Traits/Item means: skills, Edges, Hindrances, Special Abilities, Gear, Powers, etc..
  2. Every trait/item is searched for throughout all Item Compendiums in the selected Package (See NPC Importer Settings)
  3. If the triat/item is found in a Compendium then it is copied and updated to the Actor; If not found, then a new one will be created for the Actor only (no new compendium entry is created)

What's supported:

  • Attributes

  • Skills

    • Core Skills are set according to the SWADE System Settings -> Setting Configurator
  • Hindrances

  • Edges

    • Initiative Edges are checked in the tweaks sections of the Actor
  • Powers & Power Points

  • Pace

  • Parry

  • Toughness

    • Set Auto-calculate to false by default
  • Bennies

    • Bennies are set according to the table below.
    • Note: Edges/Hindrances affecting bennies are not taken into account
    Actor Type Wild Card Max/Current Bennies
    NPC No 0/0
    NPC Yes 2/2
    Character No 0/0
    Character Yes 3/3
  • Gear

    • Equipped by default
    • Weapons (melee & ranged)
      • If weapon does not have Range, then related skill will be Fighting
      • If weapon has range, then related skill will be Shooting
    • Armors
    • Shields
    • Gear
  • Special Abilities

    • Search for "Armor" and/or any damage attack (lines with Str., Str+d*, or dice formulas).

      • You may select from the settings to not search for these special items, and then they will all be listed as Special Abilities Items
    • Lists all others as Special Abilities Items

    • Size

      • Size influences the tokens' size (bigger than medium) and scale (for smaller than medium)
      • Add additional wounds as per the Size Table (SWADE Core)
    • Ignore wounds & Unshake bonuses for: construct, undead, elemental, combat reflexes

    • List them all in the actors' description with links to Compendium rules (if using the core-swade Compendium pack)

    • See NPC Importer Settings for further manipulation of the statblock.

      • This options allows users who have set Special Abilities as Eges in their World to link them, as well as

      • Forcing the Importer to consider some Spcial Abilities as specific Items => For example: this means that you can add a @a to force the Importer to consider the special ability as Armor. The existing options are:

        • @e => Edge;

        • @h => Hinrance;

        • @w => Weapom;

        • @a => Armor;

        • @sa => listed as Special Ability item"

        • For example:

          Some Monster
          Stuff about the monster. Lots of it..
          Attributes: Agility d8, Smarts d6, Spirit d6,
          Strength d10, Vigor d10
          Skills: Athletics d6, Fighting d8, Notice d6,
          Shooting d8, Stealth d8
          Pace: 6; Parry: 6; Toughness: 7
          Edges: Combat Reflexes
          Special Abilities:
          @sa Aquatic: Pace 12″.
          @e Burrow (10″): Some Monsters can meld
          into and out of the ground
          @w Slam: Str+d6, nonlethal damage.
          @a Armor +2
          @h Weakness(dirt): Some Monster hate being dirty
          @sa SpecialAbs: this is a ver special Abilitiy
          

Supported Languages

Support is for both the UI and parsing of statblock

  • English
  • Español (thanks @Montver)
  • Português (Brasil) (thanks @lipefl)
  • Deutsch (thanks @Razortide)

Please Note: I work mainly with English sources, and I do try to test with the supported languages, but, due to the few non-English stat-blocks I have and due to translation quirks, there will be more issus with the non-English. My Apologies for that :)

Adding More Languages: If you wish to add support for more languages, please don't hesitate to create a pull request or open an issue with the file attached.

swade-npc-importer's People

Contributors

arnonram avatar kristianserrano avatar leratierbretonnien avatar ludobermejoes avatar razortide avatar salieric avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.