Trackers

CHANGELOG.md

@@ -5,6 +5,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2023-11-24
+
+### Changed
+
+-   Trackers (HP, XP) are now created in ddb2alchemy instead of in Alchemy itself.
+
 ## [0.1.8] - 2023-10-12
 
 ### Fixed

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ddb2alchemy",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Convert D&D Beyond characters for use with the Alchemy VTT.",
   "main": "src/index.ts",
   "license": "MIT",

src/alchemy.d.ts

@@ -4,9 +4,7 @@ export interface AlchemyCharacter {
     armorClass: number;
     copper?: number;
     classes: AlchemyClass[];
-    currentHp: number;
     electrum?: number;
-    exp: number;
     eyes?: string;
     gold?: number;
     hair?: string;
@@ -16,7 +14,6 @@ export interface AlchemyCharacter {
     items: AlchemyItem[];
     isNPC: boolean;
     isSpellcaster: Boolean;
-    maxHp: number;
     movementModes: AlchemyMovementMode[];
     name: string;
     platinum?: number;
@@ -34,6 +31,7 @@ export interface AlchemyCharacter {
     spells: AlchemySpell[];
     textBlocks: AlchemyTextBlockSection[];
     weight?: string;
+    trackers?: AlchemyTracker[];
 }
 
 interface AlchemyStat {
@@ -138,3 +136,21 @@ interface AlchemyMovementMode {
     mode: string;
     distance: number;
 }
+
+interface AlchemyTracker {
+    name: string;
+    value: number;
+    max: number;
+    color:
+        | 'Blue'
+        | 'Green'
+        | 'Orange'
+        | 'Purple'
+        | 'Red'
+        | 'Theme Accent'
+        | 'Yellow';
+    type: 'Bar' | 'Pip';
+    category: 'health' | 'experience' | null;
+    sortOrder?: number;
+    readOnly?: boolean;
+}

src/convert.ts

@@ -12,7 +12,8 @@ import {
     AlchemySpellSlot,
     AlchemyStat,
     AlchemyTextBlockSection,
-} from './alchemy';
+    AlchemyTracker,
+} from './alchemy.d';
 import {
     DDB_SPEED_EQUALS_RE,
     DDB_SPEED_IS_RE,
@@ -191,14 +192,11 @@ export const DEFAULT_ALCHEMY_CHARACTER: AlchemyCharacter = {
     abilityScores: [],
     armorClass: 0,
     classes: [],
-    currentHp: 0,
-    exp: 0,
     imageUri: '',
     initiativeBonus: 0,
     isNPC: false,
     isSpellcaster: false,
     items: [],
-    maxHp: 0,
     movementModes: [],
     name: '',
     proficiencies: [],
@@ -251,9 +249,7 @@ export const convertCharacter = (
     ...shouldConvert(options, 'armorClass', () => getArmorClass(ddbCharacter)),
     ...shouldConvert(options, 'copper', () => ddbCharacter.currencies.cp),
     ...shouldConvert(options, 'classes', () => convertClasses(ddbCharacter)),
-    ...shouldConvert(options, 'currentHp', () => getCurrentHp(ddbCharacter)),
     ...shouldConvert(options, 'electrum', () => ddbCharacter.currencies.ep),
-    ...shouldConvert(options, 'exp', () => ddbCharacter.currentXp),
     ...shouldConvert(options, 'eyes', () => ddbCharacter.eyes),
     ...shouldConvert(options, 'gold', () => ddbCharacter.currencies.gp),
     ...shouldConvert(options, 'hair', () => ddbCharacter.hair),
@@ -270,7 +266,6 @@ export const convertCharacter = (
         isSpellcaster(ddbCharacter),
     ),
     ...shouldConvert(options, 'items', () => convertItems(ddbCharacter)),
-    ...shouldConvert(options, 'maxHp', () => getMaxHp(ddbCharacter)),
     ...shouldConvert(options, 'movementModes', () =>
         getMovementModes(ddbCharacter),
     ),
@@ -303,6 +298,7 @@ export const convertCharacter = (
     ...shouldConvert(options, 'weight', () =>
         ddbCharacter.weight ? ddbCharacter.weight.toString() : '',
     ),
+    ...shouldConvert(options, 'trackers', () => convertTrackers(ddbCharacter)),
 });
 
 // Convert D&D Beyond style stat arrays to Alchemy style stat arrays
@@ -317,7 +313,7 @@ const convertStatArray = (ddbCharacter: DdbCharacter): AlchemyStat[] => {
 const getStatValue = (ddbCharacter: DdbCharacter, statId: number): number => {
     // Start with whatever the base stat is at level 1
     const baseStatValue =
-        ddbCharacter.stats.find((stat) => stat.id === statId)?.value ||
+        ddbCharacter.stats?.find((stat) => stat.id === statId)?.value ||
         BASE_STAT;
 
     // If there are any overrides, use the highest of those instead of the base value
@@ -345,7 +341,7 @@ const getModifiers = (
     ddbCharacter: DdbCharacter,
     options: object,
 ): DdbModifier[] => {
-    return Object.values(ddbCharacter.modifiers)
+    return Object.values(ddbCharacter.modifiers || {})
         .flat()
         .filter((modifier) =>
             Object.keys(options).every((key) => modifier[key] === options[key]),
@@ -354,15 +350,15 @@ const getModifiers = (
 
 // Find all applicable modifiers based on keys/values in `options` and sum them
 const sumModifiers = (ddbCharacter: DdbCharacter, options: object): number => {
-    return getModifiers(ddbCharacter, options).reduce(
+    return getModifiers(ddbCharacter, options)?.reduce(
         (total, modifier) => total + modifier.value,
         0,
     );
 };
 
 // Find all applicable modifiers based on keys/values in `options` and take the highest
 const maxModifier = (ddbCharacter: DdbCharacter, options: object): number => {
-    return getModifiers(ddbCharacter, options).reduce(
+    return getModifiers(ddbCharacter, options)?.reduce(
         (max, modifier) => Math.max(max, modifier.value),
         0,
     );
@@ -430,7 +426,7 @@ const getArmorClass = (ddbCharacter: DdbCharacter): number => {
 // Calculate the base HP of the character, inclusive of bonus from CON modifier.
 const getBaseHp = (ddbCharacter: DdbCharacter): number => {
     const conBonus = getStatBonus(ddbCharacter, CON);
-    const levels = ddbCharacter.classes.reduce(
+    const levels = ddbCharacter.classes?.reduce(
         (total, c) => total + c.level,
         0,
     );
@@ -1042,3 +1038,26 @@ const convertSpellHigherLevels = (ddbSpell: DdbSpell): AlchemySpellAtHigherLevel
   }
 }
 */
+
+const convertTrackers = (ddbCharacter: DdbCharacter): AlchemyTracker[] => {
+    return [
+        {
+            name: 'XP',
+            category: 'experience',
+            color: 'Yellow',
+            max: 355000,
+            value: ddbCharacter.currentXp,
+            type: 'Bar',
+            sortOrder: 0,
+        },
+        {
+            name: 'HP',
+            category: 'health',
+            color: 'Green',
+            max: getMaxHp(ddbCharacter),
+            value: getCurrentHp(ddbCharacter),
+            type: 'Bar',
+            sortOrder: 0,
+        },
+    ];
+};

src/ddb.ts

@@ -49,8 +49,8 @@ export interface DdbCharacter {
         gp: number;
         pp: number;
     };
-    classes: DdbClass[];
-    modifiers: {
+    classes?: DdbClass[];
+    modifiers?: {
         race: DdbModifier[];
         class: DdbModifier[];
         item: DdbModifier[];

test/convert.currentHp.test.ts

@@ -34,10 +34,12 @@ describe('Convert DDB current HP to Alchemy current HP', () => {
         ddbChar.overrideHitPoints = overrideHitPoints;
 
         const converted = convertCharacter(ddbChar as DdbCharacter, {
-            currentHp: true,
+            trackers: true,
         });
 
-        expect(converted.currentHp).toEqual(overrideHitPoints);
+        expect(
+            converted.trackers?.find((t) => t.category === 'health')?.value,
+        ).toEqual(overrideHitPoints);
     });
 
     test.each`
@@ -74,10 +76,12 @@ describe('Convert DDB current HP to Alchemy current HP', () => {
                 con;
 
             const converted = convertCharacter(ddbChar as DdbCharacter, {
-                currentHp: true,
+                trackers: true,
             });
 
-            expect(converted.currentHp).toEqual(expected);
+            expect(
+                converted.trackers?.find((t) => t.category === 'health')?.value,
+            ).toEqual(expected);
         },
     );
 
@@ -91,9 +95,11 @@ describe('Convert DDB current HP to Alchemy current HP', () => {
         ddbChar.classes.push({ level: 1 });
 
         const converted = convertCharacter(ddbChar as DdbCharacter, {
-            currentHp: true,
+            trackers: true,
         });
 
-        expect(converted.currentHp).toEqual(2);
+        expect(
+            converted.trackers?.find((t) => t.category === 'health')?.value,
+        ).toEqual(2);
     });
 });

test/convert.exp.test.ts

@@ -1,25 +1,31 @@
 import { describe, expect, test } from '@jest/globals';
 import { convertCharacter } from '../src';
+
 import { DdbCharacter } from '../src/ddb';
 import { DeepPartial } from './test-helpers';
 
-describe('Convert DDB currentXp to Alchemy exp', () => {
+describe('Convert DDB currentXp to Alchemy tracker', () => {
     test.each`
         currentXp | expected
         ${10}     | ${10}
         ${0}      | ${0}
     `(
-        'returns exp=$expected when currentXp=$currentXp',
+        'returns tracker.value=$expected when currentXp=$currentXp',
         ({ currentXp, expected }) => {
             const ddbChar: DeepPartial<DdbCharacter> = {
                 currentXp,
             };
 
             const converted = convertCharacter(ddbChar as DdbCharacter, {
-                exp: true,
+                trackers: true,
             });
 
-            expect(converted.exp).toEqual(expected);
+            const expTracker = converted.trackers?.find(
+                (t) => t.category === 'experience',
+            );
+
+            expect(expTracker.value).toEqual(expected);
+            expect(expTracker.max).toEqual(355000);
         },
     );
 });

test/convert.maxHp.test.ts

@@ -48,10 +48,12 @@ describe('Convert DDB maxHP to Alchemy maxHP', () => {
                 con;
 
             const converted = convertCharacter(ddbChar as DdbCharacter, {
-                maxHp: true,
+                trackers: true,
             });
 
-            expect(converted.maxHp).toEqual(expected);
+            expect(
+                converted.trackers?.find((t) => t.category === 'health')?.max,
+            ).toEqual(expected);
         },
     );
 });