dndbeyond-json-exporter

Export your character sheets into JSON.

当前为 2025-01-15 提交的版本,查看 最新版本

您需要先安装一个扩展,例如 篡改猴Greasemonkey暴力猴,之后才能安装此脚本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安装一个扩展,例如 篡改猴暴力猴,之后才能安装此脚本。

您需要先安装一个扩展,例如 篡改猴Userscripts ,之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey,才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

(我已经安装了用户脚本管理器,让我安装!)

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

(我已经安装了用户样式管理器,让我安装!)

// ==UserScript==
// @name        dndbeyond-json-exporter
// @license     GNU GPLv3
// @namespace   Violentmonkey Scripts
// @match       https://www.dndbeyond.com/characters*
// @require     http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js
// @grant       GM_addStyle
// @grant       GM_download
// @version     1.1
// @author      buhbbl
// @description Export your character sheets into JSON.
// ==/UserScript==

const API_URL = 'https://character-service.dndbeyond.com/character/v5/character/';

// =========== All Characters Page =============
// div config
const DDB_CHARACTER_LISTING = 'ddb-characters-listing';
const CHARACTER_CARDS_CLASS = 'ddb-campaigns-character-card-footer-links';

// "a"/link config
const LINK_TEXT = 'Export';

// ============= Character Sheet ===============
// div config
const CHARACTER_SHEET_CLASS = 'ddbc-character-tidbits__menu-callout';

// button config
const SMALL_BUTTON_CLASS = 'character-button-small';
const MEDIUM_BUTTON_CLASS = 'character-button-medium';
const CLASSES_TO_REMOVE = ["character-button", "ddbc-button"];
const BUTTON_CSS = "margin-left: 5px;"

// span config
const BUTTON_CONTENT_SPAN_CLASS = 'ct-button__content';
const EXPORT_BUTTON_TEXT = 'Export to JSON';
const SPAN_CSS = "color: #fff;"

waitForKeyElements(`div.${CHARACTER_SHEET_CLASS},div.${DDB_CHARACTER_LISTING}`, Main);

function Main () {
  if (IsCharacterCardPage()) {
    CreateCardExportButtons();
    return
  }

  if (IsCharacterSheet()) {
    EnlargeSheetManageButton();
    CreateSheetExportButton();
    return
  }

  console.error("export-character-json: Can't find any element.");
}

function IsCharacterCardPage () {
  return (document.getElementsByClassName(CHARACTER_CARDS_CLASS)[0] != null);
}

function IsCharacterSheet () {
  return (document.getElementsByClassName(CHARACTER_SHEET_CLASS)[0] != null);
}

function DownloadOnClick () {
  GM_download(API_URL + this.characterID, this.characterID + '.json')
}

function AppendExportButton (character_card) {
  let characterID = character_card.children[0].href.split("/")[4];

  let link = document.createElement("a");
  link.classList = character_card.firstElementChild.classList;
  link.innerHTML = LINK_TEXT;
  link.href = "javascript:;";
  link.onclick = DownloadOnClick;
  link.characterID = characterID;

  character_card.insertBefore(link, character_card.children[2]);
  return true;
}

function CreateCardExportButtons () {
  let containers = document.getElementsByClassName(CHARACTER_CARDS_CLASS);

  for (let container of containers) {
    AppendExportButton(container);
  }

  return true;
}

function EnlargeSheetManageButton () {
  let container = document.getElementsByClassName(CHARACTER_SHEET_CLASS)[0];
  container.firstElementChild.classList.replace("character-button-small", "character-button-medium");
  return true;
}

function CreateSheetExportButton () {
  let characterID = window.location.pathname.split("/")[2];

  let container = document.getElementsByClassName(CHARACTER_SHEET_CLASS)[0];

  let btn = document.createElement("button");
  btn.classList = container.firstElementChild.classList;
  btn.onclick = DownloadOnClick;
  btn.characterID = characterID;
  btn.style.cssText = BUTTON_CSS;

  CLASSES_TO_REMOVE.forEach(element => {btn.classList.remove(element)});

  let span = document.createElement("span");
  span.classList = [BUTTON_CONTENT_SPAN_CLASS];
  span.innerHTML = EXPORT_BUTTON_TEXT;

  btn.appendChild(span);
  container.appendChild(btn);
  return true;
}

// Author: BrockA (https://github.com/BrockA)
// Source: https://gist.github.com/BrockA/2625891
function waitForKeyElements (
    selectorTxt,    /* Required: The jQuery selector string that
                        specifies the desired element(s).
                    */
    actionFunction, /* Required: The code to run when elements are
                        found. It is passed a jNode to the matched
                        element.
                    */
    bWaitOnce,      /* Optional: If false, will continue to scan for
                        new elements even after the first match is
                        found.
                    */
    iframeSelector  /* Optional: If set, identifies the iframe to
                        search.
                    */
) {
    var targetNodes, btargetsFound;

    if (typeof iframeSelector == "undefined")
        targetNodes     = $(selectorTxt);
    else
        targetNodes     = $(iframeSelector).contents ()
                                           .find (selectorTxt);

    if (targetNodes  &&  targetNodes.length > 0) {
        btargetsFound   = true;
        /*--- Found target node(s).  Go through each and act if they
            are new.
        */
        targetNodes.each ( function () {
            var jThis        = $(this);
            var alreadyFound = jThis.data ('alreadyFound')  ||  false;

            if (!alreadyFound) {
                //--- Call the payload function.
                var cancelFound     = actionFunction (jThis);
                if (cancelFound)
                    btargetsFound   = false;
                else
                    jThis.data ('alreadyFound', true);
            }
        } );
    }
    else {
        btargetsFound   = false;
    }

    //--- Get the timer-control variable for this selector.
    var controlObj      = waitForKeyElements.controlObj  ||  {};
    var controlKey      = selectorTxt.replace (/[^\w]/g, "_");
    var timeControl     = controlObj [controlKey];

    //--- Now set or clear the timer as appropriate.
    if (btargetsFound  &&  bWaitOnce  &&  timeControl) {
        //--- The only condition where we need to clear the timer.
        clearInterval (timeControl);
        delete controlObj [controlKey]
    }
    else {
        //--- Set a timer, if needed.
        if ( ! timeControl) {
            timeControl = setInterval ( function () {
                    waitForKeyElements (    selectorTxt,
                                            actionFunction,
                                            bWaitOnce,
                                            iframeSelector
                                        );
                },
                300
            );
            controlObj [controlKey] = timeControl;
        }
    }
    waitForKeyElements.controlObj   = controlObj;
}