Skip to content

stellar-forge-helper

Audience: Agent

npm: @howfe/stellar-forge-helper — Elite Dangerous id64 body addresses and ProcGen/boxel coordinate decoding.

Not Frontier’s Stellar Forge game engine; the name reflects community usage for 64-bit system/body identifiers.

Stack

TypeScript, tsup → dist/, Vitest.

Exports

  • StellarForgeSystem — decode/encode id64, PG names, sector/boxel metadata
  • createBodyAddress(systemAddress, bodyIndex) / extractSystemAddress(id64)

Run / build

cd stellar-forge-helper
npm ci
npm run build
npm test

Publish

GitLab CI (.gitlab-ci.yml): verify on every push; publish-npm on git tags (v1.0.0 → package version 1.0.0). Registry: project npm packages under @howfe (group install URL in README).

Publish before elite-dangerous-surface-map and elite-dangerous-planet-analyser switch off file: links.

Consumers

  • elite-dangerous-surface-map/ui — @howfe/stellar-forge-helper (file/workspace link)
  • elite-dangerous-planet-analyser/api

Agent notes

  • Prefer this package over copying StellarForgeSystem.ts into app repos.
  • SectorNames.ts is large; keep it only in this library.