lbo

Luau Bundler and Obfuscator

Installation

bun add -D @ihatenodejs/lbo

Usage

CLI Commands

bunx lbo bundle    # Bundle Lua source files
bunx lbo obfuscate # Obfuscate bundled Lua
bunx lbo build     # Bundle + obfuscate (with optional --watch)
bunx lbo init      # Scaffold lbo.config.ts

Configuration

Create lbo.config.ts:

import { defineConfig } from "@ihatenodejs/lbo";

export default defineConfig({
  bundle: {
    srcDir: "src",
    outputFile: "dist/main.bundle.lua",
    manifestPath: "scripts/bundle.manifest.json",
    externals: {
      WindUI: "https://github.com/Footagesus/WindUI/releases/latest/download/main.lua",
    },
    stripComments: true,
  },
  obfuscate: {
    inputFile: "dist/main.bundle.lua",
    outputFile: "dist/main.lua",
    chunkSize: 180,
    minify: false,
  },
});

package.json Scripts

{
  "scripts": {
    "bundle": "bunx lbo bundle",
    "obfuscate": "bunx lbo obfuscate",
    "build": "bunx lbo build"
  }
}

API

import { bundle, obfuscate, minifyLua, defineConfig } from "@ihatenodejs/lbo";

Development

bun install
bun test
bun build src/cli.ts --outdir dist --target node