Giter Club home page Giter Club logo

ddb-importer's Introduction

D&D Beyond Importer

Import your dndbeyond.com characters into Foundry Virtual Tabletop.

This module:

  • Import your DDB characters into Foundry, and sync changes back!
  • Import a characters extras such as Wildshapes or beast companions.
  • Bulk import spells.
  • Bulk import items.
  • Patreon supporters can bulk import monsters.
  • Can bulk import simple class, race and feat descriptions.
  • When you import a Cleric or Druid it will import all your spells.*

In addition you can:

  • Use the built in dictionary to get a large icon coverage during import.
  • Use supplied SRD items where available.
  • Choose to use matching SRD icons.
  • Apply effects from DAE or DAE SRD.
  • Attempt to auto-generate effects for items.

Examples

What's the catch?

Calls to dndbeyond are proxied to provide authentication and to bypass CORS checks.

The proxy calls dndbeyond with your credentials to fetch your data.

To get all your spells and do bulk importing you need to set the Cobalt Cookie setting to the value of your D&DBeyond CobaltSession cookie. See my helper Chrome extension to help.

Do NOT give your cookie to other people, this is like handing out a password to your dndbeyond account.

We do not store your cobalt cookie on the server.

To logout/invalidate these credentials log out of your D&DBeyond Session.

Notes

You CAN use this alongside the vtta-dndbeyond extension.

Support

Where can you support me? See my Patreon.

You can log bugs here, or mention them in the Discord channel.

Pre-requisites and recommendations

I'd recommend installing:

SRD Import Notes

Some detail will be lost:

  • Any auto configuration of Magic Item spells
  • Any custom damage modifications from things like Fighting Styles and Improved Divine Smite

Some details are updated, if applicable:

  • number of uses
  • quantity of items
  • attuned status
  • equipped status
  • resource tracking
  • spell preparation status
  • proficiency

Configuration

Avatar upload directory

Sets the icon directory where you are storing your avatar image uploads. It's relative to the Foundry /Data directory, please do not add a leading or trailing slash to this path.

Examples:

  • img/uploads references to [Foundry]/Data/img/uploads
  • uploads references to [Foundry]/Data/uploads
  • `` references to [Foundry]/Data - not recommended

FAQ

Why do my compendium features not get updated on import?

This is a different feature to vtta-dndbeyond, use the bulk import tool to import features, spells and items.

The import buttons are greyed out!

They require the cobalt token setting to be set. Remember don't share this token with anyone, it can be used to access your DDB account.

Clerics and Druids don't get their un-prepared spells

You need to have the cobalt token set to get these spells.

Known Issues

Magic Items don't have spells attached

When you use the Magic Items module and Munch Items the spells are not attached to the Item. This is a tricky issue and parsing these things out of the item text takes time as they are not exposed as an attached object to the item.

ddb-importer's People

Contributors

amlozano1 avatar bekriebel avatar captain-yoshi avatar devnagui avatar ivangirderboot avatar laquasicinque avatar mrprimate avatar nat212 avatar steven-beasley 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.