Pip-Boy Apps

A forked repository of the official Mod Tool from The Wand Company to house all the great apps and games made by fellow vault-dwellers for the Pip-Boy 3000 Mk V device. Apps are hosted on pip-boy.com and are open-source for all to enjoy.

Pip-Boy.com  |  Discord Community

Bethesda Store  |  The Wand Company  |  Official Mod Tool

Espruino Reference  |  Bangle Apps  |  Bangle Images

• Getting Started
• Mod Tool
• App List
• Minification
• Contributing

If you put a JS file in the USER folder, Pip-Boy will show it in a list of apps in the INV screen.

• g is a graphics instance that writes direct to the screen.

• bC is a graphics instance that writes to a 2 bit offscreen buffer, and calling bC.flip() will flip that buffer to the screen with a scanline effect.

More details here: API.md

1. Clone the repository and its submodules:

   git clone https://github.com/CodyTolene/pip-boy-apps.git
   git submodule update --init --recursive

2. Install dependencies:

   npm install

3. Start the local server:

   npm run serve

   The app will be available at http://localhost:8080.

1. With Node.js installed, open a new terminal at the root of this repo. Install the required Node.js packages:

   npm install

2. Run the app generation script:

   npm run build

   This will generate a file called apps.local.json in the root of the repository.

   You can also use jekyll to generate the apps.local.json file by running jekyll build.

   Do not commit this file to the repository, it is generated automatically and should not be tracked by Git.

Sometimes the built in minification and tokenization doesn't work as expected, in this case you can run the Espruino minification manually using the following steps:

1. With Node.js installed, open a new terminal at the root of this repo. Install the required Node.js packages:

   npm install

2. Run the minification script:

   npm run min

   OR for live updates:

   npm run min:watch

   Press CTRL+C to stop the live update script.

1. Make sure to run the following commands before committing any changes:

   npm run prettier

   This will format all files in the repository according to the Prettier configuration.

2. Add and commit your changes:

   git add .
   git commit -m "Your commit message"

3. Push your changes and create a pull request.

4. Further details on contributing can be found in the CONTRIBUTING.md file.