The official template for synchronizing Typescript/Javascript from your computer to the game.
This template uses the Typescript compiler and the Remote File API system to synchronize Typescript to your game. Due to the usage of the RFA system, it works with Web and Electron versions of the game.
Node.js is needed for compiling typescript and installing dependencies
See here for step by step installation if you'd like help with installing Node and/or connecting to the game.
Download the template to your computer and install everything it requires:
git clone https://github.com/bitburner-official/typescript-template
cd typescript-template
npm i
Write all your typescript source code in the /src
directory
To autocompile as you save, run npm run transpile
in a terminal.
To send changed files as you save, run npm run watch
in a terminal.
Have them both running simultaneously so that it all happens automatically.
For Bitburner to receive any files, you need to enter the port npm run watch
logs to the terminal
in the Remote API section of the game settings, and press the connect button.
See here for step by step installation if you'd like help with installing Node and/or connecting to the game.
To ensure both the game and typescript have no issues with import paths, your import statements should follow a few formatting rules:
- Paths must be absolute from the root of
src/
, which will be equivalent to the root directory of your home drive - Paths must contain no leading slash
- Paths must end with no file extension
To import helperFunction
from the file helpers.ts
located in the directory src/lib/
:
import { helperFunction } from "lib/helpers";
To import all functions from the file helpers.ts
located in the src/lib/
directory as the namespace helpers
:
import * as helpers from "lib/helpers";
To import someFunction
from the file main.ts
located in the src/
directory:
import { someFunction } from "main";
For debugging bitburner on Steam you will need to enable a remote debugging port. This can be done by rightclicking bitburner in your Steam library and selecting properties. There you need to add --remote-debugging-port=9222
[Thanks @DarkMio]