dbc editor vscode extentsion

2026-08-23 00:35:32 +04:00
parent 8b13588294
commit 8340b2c84f
23 changed files with 6735 additions and 0 deletions
@@ -0,0 +1,55 @@
+# MoonWell DBC Editor
+
+A VS Code Custom Editor for World of Warcraft 3.3.5a `WDBC` files, targeting client
+build `12340`.
+
+## Features
+
+- Opens `.dbc` files as a paged table instead of loading the whole grid into the Webview.
+- Includes 246 build-specific schemas with named and typed columns.
+- Edits signed/unsigned integers, floats, UTF-8 strings, arrays and localized strings.
+- Supports add, duplicate and delete row operations.
+- Integrates with VS Code undo/redo, Save, Save As, Revert and hot-exit backups.
+- Rebuilds and deduplicates the WDBC string block when saving.
+- Creates `<file>.dbc.bak` before an in-place save by default.
+- Falls back to raw 32-bit columns when a schema is missing or its record size differs.
+
+The editor intentionally supports `WDBC` only. Later `DB2`, `WDB` and cache formats are
+outside the current build-12340 scope.
+
+## Development
+
+```powershell
+cd vscode-dbc-editor
+npm install
+npm run check
+```
+
+Open this directory in VS Code and press `F5` to launch an Extension Development Host.
+Open any `.dbc` file there; the custom editor is registered as the default editor.
+
+To produce an installable VSIX:
+
+```powershell
+npm run package
+code --install-extension .\moonwell-dbc-editor-0.1.0.vsix
+```
+
+## Editing notes
+
+- Click a row number to select it for duplicate/delete operations.
+- Cell values can be edited inline. The lower text area is useful for long strings;
+  press `Ctrl+Enter` or click **Apply cell**.
+- Search is performed on the ID plus ordinary, `enUS`, and `ruRU` string columns.
+- An unknown or structurally different table opens in raw mode to avoid applying the
+  wrong string offsets or field types.
+- ID edits are rejected when they would create a duplicate key.
+
+## Schema provenance
+
+The schema bundle is derived from WoWDBDefs under CC BY-SA 4.0. See
+`THIRD_PARTY_NOTICES.md` and `schemas/README.md`.
+
+WDBXEditor was used as a behavioral reference only. Its source and XML definitions are
+not redistributed here.
+