bdbuilder

library1.2.6-preview.4jsnpmunverified

A specialized build tool and transpiler for BetterDiscord plugins that allows developers to write plugins using multiple files, TypeScript, or modern JavaScript, then bundles them into a single plugin file compatible with BetterDiscord. Currently at version 1.2.6-preview.4, it's in preview stage and not yet released on the official npm registry. It provides features like production builds, watch mode for development, and automatic copying to the BetterDiscord plugins folder. Compared to alternatives like Ittai, BDBuilder is a simpler, dedicated solution for BetterDiscord plugin development, focusing on ease of use and essential functionality.

devops

npm install bdbuilder

github ↗package ↗

INSTALL

IMPORT

SIG · BDBUILDER

bdbuilder

devopsjavascriptv1.2.6-preview.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

bdbuilder

✓ import { bdbuilder } from '@betterdiscordbuilder/bdbuilder'

✗ const bdbuilder = require('@betterdiscordbuilder/bdbuilder')

Package is distributed as ESM only. CommonJS require will fail.

default

✓ import bdbuilder from '@betterdiscordbuilder/bdbuilder'

✗ import { bdbuilder } from '@betterdiscordbuilder/bdbuilder'

Default export is the main build function. Named export bdbuilder is also available for named usage.

PluginConfig

✓ import { PluginConfig } from '@betterdiscordbuilder/bdbuilder'

Type import for TypeScript users to define plugin configuration.

Shows configuration-based and CLI ways to build a BetterDiscord plugin with BDBuilder, including watch mode and copy destination.

// bdbuilder.config.ts import { defineConfig } from '@betterdiscordbuilder/bdbuilder'; export default defineConfig({ plugin: './src/index.ts', copy: 'C:/Users/Username/AppData/Roaming/BetterDiscord/plugins', watch: true, production: false, }); // Or CLI usage: // npx @betterdiscordbuilder/bdbuilder --plugin="./src/index.ts" --copy="./plugins" --watch --production

bdbuilder --version

Debug

Known issues

breakingPackage is not yet published on official npm registry; only available via GitHub Packages.

fix

Set up .npmrc file with @betterdiscordbuilder:registry=https://npm.pkg.github.com and authenticate with a GitHub token.

affects: all

deprecatedThe 'ittai' package is considered legacy; BDBuilder is the simpler successor.

fix

Migrate from ittai to @betterdiscordbuilder/bdbuilder for BetterDiscord plugin development.

affects: N/A

gotchaWatch mode may not automatically rebuild if new files are added to the plugin directory; only changes to existing files trigger rebuilds.

fix

Manually restart the watch process after adding new source files.

affects: all

gotchaThe package requires Node.js version >=14 due to ESM and async/await usage.

fix

Update Node.js to a version >=14.

affects: >=1

Errors

Common errors & fixes

Error: Cannot find module '@betterdiscordbuilder/bdbuilder'

Package not installed because .npmrc or authentication is missing.

fix

Create .npmrc with 'registry', authenticate with GitHub token, then reinstall.

ERR_REQUIRE_ESM

Using CommonJS require() on an ESM-only package.

fix

Use import statement instead of require().

Upgrade

Version history

1.2.6-preview.4latest on npm

Audit

Dependencies

typescriptoptionalOptional peer dependency for source code transformation when using TypeScript

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/BetterDiscordBuilder/bdbuilder ↗

packagehttps://www.npmjs.com/package/bdbuilder ↗