omegga 1.8.1 → 1.9.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@
 
 - Future features go here
 
+## 1.9.0 - 2026-07-05
+
+Wire graph log events and a brs-js 3.0.0 upgrade for native brdb/brz reading.
+
+- Plugins: Add `wirelog` event, emitted for each `[Wire Graph]` console log with the raw text
+- Plugins: Add `wirecmd:command` event, emitted when a `[Wire Graph]` log starts with a command word (lowercased) followed by space-separated args
+- Update brs-js to 3.2.1 and expose brdb/brz features on `OMEGGA_UTIL.brdb`
+- World revisions are now read directly from the `.brdb` file instead of the game console, so `getWorldRevisions` no longer requires the server to be running
+- Plugins: Add `OMEGGA_UTIL.Sqlite` for opening sqlite files (or brdb files)
+- Plugins: `loadSaveData`/`loadSaveDataOnPlayer`/`getSaveData` are back using `brs-js` 3
+- Fix `clearRegion`, `clearAllBricks`, `loadSaveData`, `getSaveData`, in safe plugins
+
 ## 1.8.1 - 2026-07-03
 
 Prefab support for EA3, replacing the removed `.brs` bricks commands.

package/README.md

@@ -891,7 +891,9 @@ Register custom `/commands` by returning `{registeredCommands: ['foo', 'bar']}`
 | `event:NAME`         | [>player from click<, ...args]                                                                                             | Runs when an interact component has `event:NAME: arg1,arg2,arg\,3,                                                                                                                   |          |
 | `mapchange`          | \[{map}\]                                                                                                                        | Runs when the map changes                                                                                                                                                            |          |
 | `autorestart`        | [autorestart config]                                                                                                             | Runs server has an autorestart scheduled                                                                                                                                             |          |
-| `minigamejoin`       | {player: {name, id}; minigameName: string}                                                                                       | Runs when a player joins a minigame. Note that minigameName is not unique between minigames. minigameName will be null if player leaves all minigames. This will run before `join`   |          |
+| `minigamejoin`       | {player: {name, id}; minigameName: string}                                                                                       | **Deprecated as of EA3.** Runs when a player joins a minigame. Note that minigameName is not unique between minigames. minigameName will be null if player leaves all minigames. This will run before `join` |          |
+| `wirelog`            | [raw string]                                                                                                                     | Runs when a `[Wire Graph]` log line is emitted. `raw` is the text after the `[Wire Graph] ` prefix                                                                                    |          |
+| `wirecmd:command`    | [...args]                                                                                                                        | Runs when a `[Wire Graph]` log starts with `command args`. `command` is lowercased; args are the remaining space-separated words                                                     |          |
 
 ### Folder Structure
 

package/dist/omegga/matchers/index.js

@@ -11,6 +11,7 @@ const init = require("./init.js");
 const mapChange = require("./mapChange.js");
 const interact = require("./interact.js");
 const minigameJoin = require("./minigameJoin.js");
+const wire = require("./wire.js");
 const MATCHERS = [
   join.default,
   leave.default,
@@ -22,7 +23,8 @@ const MATCHERS = [
   init.default,
   mapChange.default,
   interact.default,
-  minigameJoin.default
+  minigameJoin.default,
+  wire.default
 ];
 exports.default = MATCHERS;
 //# sourceMappingURL=index.js.map

package/dist/omegga/matchers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/omegga/matchers/index.ts"],"sourcesContent":["import { MatchGenerator } from './types';\n\nimport join from './join';\n// 'join' event => { name, id, state, controller }\n\nimport leave from './leave';\n// 'leave' event => { name, id, state, controller }\n\nimport chat from './chat';\n// 'chat' event => name, message; 'chatcmd:command' event => name, [...args]\n// 'kick' event => name, kicker, reason\n\nimport command from './command';\n// 'cmd:command' event => name, args (string)\n\nimport auth from './auth';\n// assigns host, 'host' event, 'start' event, 'unauthorized' event\n\nimport exit from './exit';\n// 'exit' event\n\nimport version from './version';\n// 'version' event, check game version\n\nimport init from './init';\n// watch loginit for any funny business\n\nimport mapChange from './mapChange';\n// 'mapchange' event\n\n// interaction event\nimport interact from './interact';\n\n// minigame join event\nimport minigameJoin from './minigameJoin';\n\nexport default [\n  join,\n  leave,\n  chat,\n  command,\n  auth,\n  exit,\n  version,\n  init,\n  mapChange,\n  interact,\n  minigameJoin,\n] as MatchGenerator<any>[];\n"],"names":["join","leave","chat","command","auth","exit","version","init","mapChange","interact","minigameJoin"],"mappings":";;;;;;;;;;;;;AAoCA,MAAA,WAAe;AAAA,EACbA,KAAAA;AAAAA,EACAC,MAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,aAAAA;AACF;;"}
+{"version":3,"file":"index.js","sources":["../../../src/omegga/matchers/index.ts"],"sourcesContent":["import { MatchGenerator } from './types';\n\nimport join from './join';\n// 'join' event => { name, id, state, controller }\n\nimport leave from './leave';\n// 'leave' event => { name, id, state, controller }\n\nimport chat from './chat';\n// 'chat' event => name, message; 'chatcmd:command' event => name, [...args]\n// 'kick' event => name, kicker, reason\n\nimport command from './command';\n// 'cmd:command' event => name, args (string)\n\nimport auth from './auth';\n// assigns host, 'host' event, 'start' event, 'unauthorized' event\n\nimport exit from './exit';\n// 'exit' event\n\nimport version from './version';\n// 'version' event, check game version\n\nimport init from './init';\n// watch loginit for any funny business\n\nimport mapChange from './mapChange';\n// 'mapchange' event\n\n// interaction event\nimport interact from './interact';\n\n// minigame join event\nimport minigameJoin from './minigameJoin';\n\nimport wire from './wire';\n// 'wirelog' event => raw; 'wirecmd:command' event => [...args]\n\nexport default [\n  join,\n  leave,\n  chat,\n  command,\n  auth,\n  exit,\n  version,\n  init,\n  mapChange,\n  interact,\n  minigameJoin,\n  wire,\n] as MatchGenerator<any>[];\n"],"names":["join","leave","chat","command","auth","exit","version","init","mapChange","interact","minigameJoin","wire"],"mappings":";;;;;;;;;;;;;;AAuCA,MAAA,WAAe;AAAA,EACbA,KAAAA;AAAAA,EACAC,MAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,KAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,aAAAA;AAAAA,EACAC,KAAAA;AACF;;"}

package/dist/omegga/matchers/wire.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const wire = (omegga) => {
+  const wireRegExp = /^\[Wire Graph\] (?<raw>.*)$/;
+  return {
+    // listen for wire graph messages
+    pattern(_line, logMatch) {
+      if (!logMatch) return;
+      const { generator, data } = logMatch.groups;
+      if (generator !== "LogBrickadia") return;
+      const match = data.match(wireRegExp);
+      if (!match) return;
+      return { raw: match.groups.raw };
+    },
+    // when there's a match, emit the wire log event
+    callback({ raw }) {
+      omegga.emit("wirelog", raw);
+      const [cmd, ...args] = raw.split(" ");
+      if (cmd.length > 0) {
+        omegga.emit("wirecmd:" + cmd.toLowerCase(), ...args);
+        omegga.emit("wirecmd", cmd.toLowerCase(), ...args);
+      }
+    }
+  };
+};
+exports.default = wire;
+//# sourceMappingURL=wire.js.map

package/dist/omegga/matchers/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sources":["../../../src/omegga/matchers/wire.ts"],"sourcesContent":["import { MatchGenerator } from './types';\n\nconst wire: MatchGenerator<{ raw: string }> = omegga => {\n  // pattern to match wire graph log messages\n  // e.g. `LogBrickadia: [Wire Graph] test`\n  const wireRegExp = /^\\[Wire Graph\\] (?<raw>.*)$/;\n\n  return {\n    // listen for wire graph messages\n    pattern(_line, logMatch) {\n      // line is not generic console log\n      if (!logMatch) return;\n\n      const { generator, data } = logMatch.groups;\n      // check if log is a brickadia log\n      if (generator !== 'LogBrickadia') return;\n\n      // match the wire graph log pattern\n      const match = data.match(wireRegExp);\n      if (!match) return;\n\n      return { raw: match.groups.raw };\n    },\n    // when there's a match, emit the wire log event\n    callback({ raw }) {\n      omegga.emit('wirelog', raw);\n\n      // wire command parsing, emit `wirecmd:test` when `test ...` is logged\n      const [cmd, ...args] = raw.split(' ');\n      if (cmd.length > 0) {\n        omegga.emit('wirecmd:' + cmd.toLowerCase(), ...args);\n        omegga.emit('wirecmd', cmd.toLowerCase(), ...args);\n      }\n    },\n  };\n};\n\nexport default wire;\n"],"names":[],"mappings":";;AAEA,MAAM,OAAwC,CAAA,WAAU;AAGtD,QAAM,aAAa;AAEnB,SAAO;AAAA;AAAA,IAEL,QAAQ,OAAO,UAAU;AAEvB,UAAI,CAAC,SAAU;AAEf,YAAM,EAAE,WAAW,KAAA,IAAS,SAAS;AAErC,UAAI,cAAc,eAAgB;AAGlC,YAAM,QAAQ,KAAK,MAAM,UAAU;AACnC,UAAI,CAAC,MAAO;AAEZ,aAAO,EAAE,KAAK,MAAM,OAAO,IAAA;AAAA,IAC7B;AAAA;AAAA,IAEA,SAAS,EAAE,OAAO;AAChB,aAAO,KAAK,WAAW,GAAG;AAG1B,YAAM,CAAC,KAAK,GAAG,IAAI,IAAI,IAAI,MAAM,GAAG;AACpC,UAAI,IAAI,SAAS,GAAG;AAClB,eAAO,KAAK,aAAa,IAAI,YAAA,GAAe,GAAG,IAAI;AACnD,eAAO,KAAK,WAAW,IAAI,YAAA,GAAe,GAAG,IAAI;AAAA,MACnD;AAAA,IACF;AAAA,EAAA;AAEJ;;"}

package/dist/omegga/server.js

@@ -4,6 +4,7 @@ const logger = require("../logger.js");
 const softconfig = require("../softconfig.js");
 const version = require("../version.js");
 const index$2 = require("../util/index.js");
+const brdb = require("../util/brdb.js");
 const file = require("../util/file.js");
 const index = require("../webserver/backend/index.js");
 const brs = require("brs-js");
@@ -18,6 +19,25 @@ const plugin = require("./plugin.js");
 const wrapper = require("./wrapper.js");
 const MISSING_CMD = '"Command not found. Type <color=\\"ffff00\\">/help</> for a list of commands or <color=\\"ffff00\\">/plugins</> for plugin information."';
 const WHOLE_WORLD_EXTENT = 1e9;
+function brsRemoved(version2) {
+  return version2 > 0 && version2 >= commands.PREFAB_VERSION;
+}
+function warnRemoved(version2, method, since, release, replacement) {
+  if (!(version2 > 0 && version2 >= since)) return false;
+  logger.default.warnp(
+    `omegga.${method}() uses a console command removed in Brickadia ${release}. This call has no effect - use ${replacement} instead.`
+  );
+  return true;
+}
+function writeTempPrefab(omegga, saveData) {
+  const ref = omegga._tempSavePrefix + Date.now() + "_" + omegga._tempCounter.save++;
+  const file$1 = path.join(omegga.prefabPath, ref + ".brz");
+  if (!file$1.startsWith(omegga.prefabPath))
+    throw "prefab file not in Saved/Prefabs directory";
+  file.mkdir(omegga.prefabPath);
+  fs.writeFileSync(file$1, new Uint8Array(brs.writeBrzLegacy(saveData)));
+  return { ref, file: file$1 };
+}
 class Omegga extends wrapper.default {
   /**
    * Omegga instance
@@ -446,30 +466,6 @@ class Omegga extends wrapper.default {
     const presetPath = path.join(this.presetPath, "Environment");
     return fs.existsSync(presetPath) ? glob.sync(presetPath + "/**/*.bp").map((f) => path.basename(f).replace(/\.bp$/, "")) : [];
   }
-  /**
-   * Whether the running game version has removed the legacy .brs bricks console
-   * commands (Bricks.Save/Load/ClearAll/ClearRegion, World.LoadAdditive) in
-   * favor of the prefab (`br.Prefab.*`) and world (`br.World.Clear*`) commands.
-   * Removed at Brickadia CL{@link PREFAB_VERSION}.
-   */
-  #brsRemoved() {
-    return this.version > 0 && this.version >= commands.PREFAB_VERSION;
-  }
-  /**
-   * Warn that a method backed by a removed console command is a no-op on the
-   * running game version, and return whether the caller should bail.
-   * @param method the omegga method being called (for the message)
-   * @param since CL version the underlying command was removed at
-   * @param release human release name for that version (e.g. `EA2`, `EA3`)
-   * @param replacement suggested replacement method/API
-   */
-  #warnRemoved(method, since, release, replacement) {
-    if (!(this.version > 0 && this.version >= since)) return false;
-    logger.default.warnp(
-      `omegga.${method}() uses a console command removed in Brickadia ${release}. This call has no effect - use ${replacement} instead.`
-    );
-    return true;
-  }
   clearBricks(target, quiet = false) {
     if (typeof target === "object" && target.id) target = target.id;
     else if (typeof target === "string" && !index$2.uuid.match(target)) {
@@ -489,7 +485,7 @@ class Omegga extends wrapper.default {
     }
     const center = region.center.join(" ");
     const extent = region.extent.join(" ");
-    if (this.#brsRemoved()) {
+    if (brsRemoved(this.version)) {
       const bricks = options?.bricks ?? true ? 1 : 0;
       const entities = options?.entities ?? false ? 1 : 0;
       this.writeln(
@@ -507,7 +503,7 @@ class Omegga extends wrapper.default {
       bricks = true,
       entities = false
     } = typeof options === "boolean" ? { quiet: options } : options;
-    if (this.#brsRemoved()) {
+    if (brsRemoved(this.version)) {
       this.writeln(
         `${this.Console.World.ClearAll} ${bricks ? 1 : 0} ${entities ? 1 : 0} ${quiet ? 1 : 0}`
       );
@@ -516,7 +512,13 @@ class Omegga extends wrapper.default {
     this.writeln(`${this.Console.Bricks.ClearAll} ${quiet ? 1 : ""}`);
   }
   saveBricks(saveName, region) {
-    if (this.#warnRemoved("saveBricks", commands.PREFAB_VERSION, "EA3", "savePrefab"))
+    if (warnRemoved(
+      this.version,
+      "saveBricks",
+      commands.PREFAB_VERSION,
+      "EA3",
+      "savePrefab"
+    ))
       return;
     if (!saveName) return;
     if (!(saveName.startsWith('"') && saveName.endsWith('"')))
@@ -530,7 +532,8 @@ class Omegga extends wrapper.default {
     else this.writeln(`${this.Console.Bricks.Save} ${saveName}`);
   }
   async saveBricksAsync(saveName, region) {
-    if (this.#warnRemoved(
+    if (warnRemoved(
+      this.version,
       "saveBricksAsync",
       commands.PREFAB_VERSION,
       "EA3",
@@ -563,7 +566,13 @@ class Omegga extends wrapper.default {
     correctPalette = false,
     correctCustom = false
   } = {}) {
-    if (this.#warnRemoved("loadBricks", commands.PREFAB_VERSION, "EA3", "loadPrefab"))
+    if (warnRemoved(
+      this.version,
+      "loadBricks",
+      commands.PREFAB_VERSION,
+      "EA3",
+      "loadPrefab"
+    ))
       return;
     if (!(saveName.startsWith('"') && saveName.endsWith('"')))
       saveName = `"${saveName}"`;
@@ -578,7 +587,8 @@ class Omegga extends wrapper.default {
     correctPalette = false,
     correctCustom = false
   } = {}) {
-    if (this.#warnRemoved(
+    if (warnRemoved(
+      this.version,
       "loadBricksOnPlayer",
       commands.EA2_VERSION,
       "EA2",
@@ -617,42 +627,12 @@ class Omegga extends wrapper.default {
     return fs.existsSync(file2) ? file2 : void 0;
   }
   async getWorldRevisions(worldName) {
-    if (!this.started || this.starting || this.stopping) {
-      throw new Error("Server is not started");
-    }
     worldName = worldName.replace(/\.brdb$/i, "");
-    if (!worldName || !this.getWorldPath(worldName)) {
+    const path2 = this.getWorldPath(worldName);
+    if (!worldName || !path2) {
       throw new Error(`World "${worldName}" does not exist`);
     }
-    let numRevisions = 0;
-    const revisionsRaw = await this.watchLogChunk(
-      `${this.Console.World.ListRevisions} "${worldName}"`,
-      /^LogBRBundleManager: (There are (?<numRevisions>\d+) revisions|Revision (?<revision>\d+) - (?<date>[\d.-]+): (?<note>.+))$/,
-      {
-        last: (match) => Number(match.groups.reverse) === numRevisions,
-        first: (match) => {
-          if (match.groups?.numRevisions !== void 0) {
-            numRevisions = Number(match.groups.numRevisions);
-            return true;
-          }
-          return false;
-        }
-      }
-    );
-    if (!revisionsRaw) return [];
-    return revisionsRaw.map((match) => {
-      if (match.groups?.numRevisions !== void 0) {
-        return null;
-      }
-      const revision = match.groups.revision ? Number(match.groups.revision) : 0;
-      const dateStr = match.groups.date.replace(
-        /(\d{4})\.(\d{2})\.(\d{2})-(\d{2})\.(\d{2})\.(\d{2})/,
-        "$1-$2-$3T$4:$5:$6Z"
-      );
-      const date = new Date(dateStr);
-      const note = match.groups.note || "";
-      return { index: revision, date, note };
-    }).filter(Boolean);
+    return brdb.readBrdbRevisions(path2) ?? [];
   }
   async loadWorld(worldName) {
     worldName = worldName.replace(/\.brdb$/i, "");
@@ -799,8 +779,14 @@ class Omegga extends wrapper.default {
     correctPalette = false,
     correctCustom = false
   } = {}) {
-    if (this.#warnRemoved("loadSaveData", commands.PREFAB_VERSION, "EA3", "loadPrefab"))
+    if (brsRemoved(this.version)) {
+      const { ref, file: file2 } = writeTempPrefab(this, saveData);
+      this.loadPrefab(ref, { offX, offY, offZ });
+      setTimeout(() => {
+        if (fs.existsSync(file2)) fs.unlinkSync(file2);
+      }, 5e3);
       return;
+    }
     const saveFile = this._tempSavePrefix + Date.now() + "_" + this._tempCounter.save++;
     this.writeSaveData(saveFile, saveData);
     await this.watchLogChunk(
@@ -825,15 +811,24 @@ class Omegga extends wrapper.default {
     correctPalette = false,
     correctCustom = false
   } = {}) {
-    if (this.#warnRemoved(
+    player = typeof player === "string" ? this.getPlayer(player) : player;
+    if (!player) return;
+    if (brsRemoved(this.version)) {
+      const { ref, file: file2 } = writeTempPrefab(this, saveData);
+      this.givePrefabToPlayer(ref, player);
+      setTimeout(() => {
+        if (fs.existsSync(file2)) fs.unlinkSync(file2);
+      }, 5e3);
+      return;
+    }
+    if (warnRemoved(
+      this.version,
       "loadSaveDataOnPlayer",
       commands.EA2_VERSION,
       "EA2",
       "loadPrefabOnPlayer"
     ))
       return;
-    player = typeof player === "string" ? this.getPlayer(player) : player;
-    if (!player) return;
     const saveFile = this._tempSavePrefix + Date.now() + "_" + this._tempCounter.save++;
     this.writeSaveData(saveFile, saveData);
     await this.watchLogChunk(
@@ -852,8 +847,54 @@ class Omegga extends wrapper.default {
     }
   }
   async getSaveData(region) {
-    if (this.#warnRemoved("getSaveData", commands.PREFAB_VERSION, "EA3", "the prefab API"))
-      return void 0;
+    if (brsRemoved(this.version)) {
+      const ref = this._tempSavePrefix + Date.now() + "_" + this._tempCounter.save++;
+      const file2 = await this.savePrefabAsync(ref, { region });
+      if (!file2) return void 0;
+      try {
+        const MAIN_GRID = 1;
+        const reader = brs.WorldReader.from(new Uint8Array(fs.readFileSync(file2)));
+        const bricks = [...reader.bricks(MAIN_GRID)].map((b) => ({
+          ...b,
+          physical_index: 0,
+          components: {}
+        }));
+        let brickOffset = 0;
+        for (const chunk of reader.brickChunkIndex(MAIN_GRID)) {
+          if (chunk.numComponents > 0) {
+            const { components } = reader.componentChunk(
+              MAIN_GRID,
+              chunk.index
+            );
+            for (const c of components) {
+              const brick = bricks[brickOffset + c.brickIndex];
+              if (brick) brick.components[c.typeName] = c.data ?? {};
+            }
+          }
+          brickOffset += chunk.numBricks;
+        }
+        return {
+          version: 10,
+          map: this.currentMap ?? "Unknown",
+          author: { id: this.host?.id ?? "", name: this.host?.name ?? "" },
+          host: { id: this.host?.id ?? "", name: this.host?.name ?? "" },
+          description: "",
+          brick_count: bricks.length,
+          mods: [],
+          brick_assets: reader.brickAssets(),
+          colors: [],
+          materials: reader.materials(),
+          physical_materials: [],
+          brick_owners: reader.brickOwners(),
+          game_version: this.version,
+          save_time: new Uint8Array(),
+          bricks,
+          components: {}
+        };
+      } finally {
+        if (fs.existsSync(file2)) fs.unlinkSync(file2);
+      }
+    }
     const saveFile = this._tempSavePrefix + Date.now() + "_" + this._tempCounter.save++;
     await this.saveBricksAsync(saveFile, region);
     const savePath = this.getSavePath(saveFile);
@@ -881,8 +922,9 @@ class Omegga extends wrapper.default {
     overrideUserId = ""
   } = {}) {
     if (!path2) return;
+    const rootPart = rootEntityPersistentIndex >= 0 ? ` ${rootEntityPersistentIndex} ${mirrorAxes}${overrideUserId ? ` "${overrideUserId}"` : ""}` : "";
     this.writeln(
-      `${this.Console.Prefab.Load} "${path2}" ${offX} ${offY} ${offZ} ${atOriginalPosition ? 1 : 0} ${orientation} ${rootEntityPersistentIndex} ${mirrorAxes}${overrideUserId ? ` "${overrideUserId}"` : ""}`
+      `${this.Console.Prefab.Load} "${path2}" ${offX} ${offY} ${offZ} ${atOriginalPosition ? 1 : 0} ${orientation}${rootPart}`
     );
   }
   /**