Build exports

After ready, exportBuild() returns the Blizzard in-game format. All exports describe the mount’s current allocation; partial builds can be exported too. Use state.complete or the submit event when every point must be spent.

const calculator = WarcraftForever.Talents.mount('#talents', {
  class: 'paladin', maxLevel: 30
});
await calculator.ready;

const inGame = calculator.exportBuild(); // same as exportBuild('blizzard')
const compact = calculator.exportBuild('compact');
const structured = calculator.exportBuild('structured');

calculator.on('submit', (state) => {
  const saved = {
    class: state.class,
    revision: state.revision,
    code: calculator.exportBuild('blizzard')
  };
  // Send saved to your own backend.
});

In-game strings

The encoder uses the Blizzard V2 trait-loadout bit stream: class specialization, tree hash, complete client node order, selected ranks and entry selection. The Forever client accepts a zero tree hash. Supported definitions have one entry per visible node. Imports reject unsupported versions, another class, unsupported selected/granted nodes, invalid ranks and allocations over the level cap.

The codec follows the Forever build 1.60.1.70124 client Lua. The numeric version is V2; a live client import/re-export has not yet been verified. An archived revision without client serialization metadata throws when requesting this export; its compact and structured exports remain available.

Pass the string back as build: { code, revision }. For a site link use /talents/paladin/?v=2&build= followed by encodeURIComponent(code). The query parameter preserves + and / characters in the in-game alphabet. The site still generates compact share URLs for compatibility.

Structured data

exportBuild('structured') returns { class, revision, pointsSpent, trees }. Trees retain their published ID, localized name, point total and talents array. Every selected talent includes:

• id, name, rank, maxRanks and zero-based row / column.
• An absolute Warcraft Forever icon URL.
• The selected rank’s spellId, description and details, when available.

Empty trees remain in the result with an empty talents array. Unselected talents are omitted. Talent IDs remain distinct even when spells are shared. Returned data is detached from the mount; changing it does not edit the calculator.

Deprecated compact format

Compact digit strings (including old hyphen-separated links) continue to load. Existing state.code, state.shareUrl, saved builds and archived revision URLs retain their meaning. There is no automatic rewrite of persisted values and no removal date.

For new integrations, request the in-game export explicitly. Store class and revision beside either string: the layout revision is independent of the JavaScript library release. Structured data is an output for custom rendering or analysis, not a replacement persisted build format.