Bitcraft TypeScript Bindings

TypeScript bindings and test harness for the Spacetime DB module (Bitcraft).

Setup

Before running the test script, complete these steps:

1. Navigate to the folder for your version of stdb

   Each version has its own directory (e.g. ts-1-12-0/). cd into the one that matches your Bitcraft/stdb version.

2. Verify your Spacetime CLI version

   Run spacetime --version in your terminal and confirm it matches the folder version you're using.

3. Install dependencies

   npm install

4. Update the bindings (also included as a .sh file in ./scripts)

   npm run update-bindings

5. Configure environment Create a .env file in the project root and add your Bitcraft auth token:

   BITCRAFT_AUTH_TOKEN=eyJ0...
   

   Replace eyJ0... with your actual token value.

Running the tests

After setup is complete:

npm test

Or:

npm start

Both commands run the test script at scripts/test.ts, which exercises the global and region modules against the Spacetime DB bindings.

Instant Disconnects

If you aren't getting an error, but you are instantly getting disconnected - try running the test while you are logged into the game (via the unity client)