{"id":17001653,"url":"https://github.com/shresht7/vscode-bg3-modding","last_synced_at":"2025-07-16T03:33:11.525Z","repository":{"id":213804140,"uuid":"734970646","full_name":"Shresht7/vscode-bg3-modding","owner":"Shresht7","description":"A VSCode extension with tools, snippets and helpers for modding Baldur's Gate 3","archived":false,"fork":false,"pushed_at":"2025-02-18T14:19:18.000Z","size":272,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-27T18:11:52.089Z","etag":null,"topics":["baldurs-gate-3","bg3","modding"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Shresht7.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-12-23T07:40:29.000Z","updated_at":"2023-12-24T11:39:23.000Z","dependencies_parsed_at":"2023-12-31T16:23:26.462Z","dependency_job_id":"e94aae18-f15a-43ac-9206-fed041e7eb9d","html_url":"https://github.com/Shresht7/vscode-bg3-modding","commit_stats":null,"previous_names":["shresht7/vscode-bg3-modding"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Shresht7/vscode-bg3-modding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shresht7%2Fvscode-bg3-modding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shresht7%2Fvscode-bg3-modding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shresht7%2Fvscode-bg3-modding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shresht7%2Fvscode-bg3-modding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Shresht7","download_url":"https://codeload.github.com/Shresht7/vscode-bg3-modding/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Shresht7%2Fvscode-bg3-modding/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265479400,"owners_count":23773530,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["baldurs-gate-3","bg3","modding"],"created_at":"2024-10-14T04:25:40.531Z","updated_at":"2025-07-16T03:33:11.480Z","avatar_url":"https://github.com/Shresht7.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `BG3 Modding` support for Visual Studio Code\n\nThis VS Code extension contains useful tools, snippets and helpers for creating mods for [**Baldur's Gate 3**](https://baldursgate3.game/).\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n    \u003cb\u003eTable of Contents\u003c/b\u003e\n\u003c/summary\u003e\n\n- [⚡ Activation Events](#-activation-events)\n- [⭐ Features](#-features)\n  - [📄 Snippets](#-snippets)\n  - [⌨️ Commands](#️-commands)\n    - [`Generate UUID`](#generate-uuid)\n    - [`Generate Handle`](#generate-handle)\n    - [`Copy Mod UUID`](#copy-mod-uuid)\n    - [`Convert Version Number`](#convert-version-number)\n    - [`Bump Version Number`](#bump-version-number)\n  - [✅ JSON Validation](#-json-validation)\n  - [⚙️ Default Configurations](#️-default-configurations)\n    - [`files.associations`](#filesassociations)\n    - [`search.exclude`](#searchexclude)\n- [⚙️ Extension Settings](#️-extension-settings)\n- [📄 License](#-license)\n\n\u003c/details\u003e\n\n\n## ⚡ Activation Events\n\n- `workspaceContains:/**/meta.lsx`\n  \n  The extension activates for a workspace that contains the `meta.lsx` file.\n\n## ⭐ Features\n\n\u003c!-- no toc --\u003e\n- [📄 Snippets](#-snippets)\n- [⌨️ Commands](#️-commands)\n- [✅ JSON Validation](#-json-validation)\n- [⚙️ Default Configurations](#️-default-configurations)\n\n\u003c!-- \n`TODO`\n\nDescribe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.\n\nFor example if there is an image subfolder under your extension project workspace:\n\n\\!\\[feature X\\]\\(images/feature-x.png\\)\n\n\u003e Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow.\n--\u003e\n\n### 📄 Snippets\n\nThe extension contributes the following snippets:\n\n| Name                            |           Activation | Description                                               |\n| ------------------------------- | -------------------: | --------------------------------------------------------- |\n| BG3 UUID                        |               `uuid` | Generate a random UUID                                    |\n| BG3 Handle                      |             `handle` | Generates a random UUID handle used in localization files |\n| `Ext.Utils.Print()`             |       `print`, `eup` | `Ext.Utils.Print()`                                       |\n| `Ext.Osiris.RegisterListener()` |  `rl`, `orl`, `eorl` | `Ext.Osiris.RegisterListener()`                           |\n| Override Stat Entry             |    `new`, `override` | Create an override for an existing Stat Entry             |\n| Script-Extender Config          | `cfg`, `Config.json` | Generates the boilerplate Script-Extender `Config.json`   |\n| `meta.lsx`                      |               `meta` | Generates the boilerplate template for `meta.lsx`         |\n\n\u003cdiv align=\"right\"\u003e\n\n  [Back to Top ⬆️](#bg3-modding-support-for-visual-studio-code)\n\n\u003c/div\u003e\n\n### ⌨️ Commands\n\nThe extension contributes the following commands:\n\n\u003c!-- no toc --\u003e\n- [`Generate UUID`](#generate-uuid)\n- [`Generate Handle`](#generate-handle)\n- [`Copy Mod UUID`](#copy-mod-uuid)\n- [`Convert Version Number`](#convert-version-number)\n- [`Bump Version Number`](#bump-version-number)\n\n#### `Generate UUID`\n\nGenerate a random UUID and insert at the current selection.\n\n```\nb7b98e25-ff34-40dd-b019-ab25521ae5a0\n```\n\n#### `Generate Handle`\n\nGenerate Handle and insert at the current selection.\n\n```\nhb7b98e25gff34g40ddgb019gab25521ae5a0\n```\n\n#### `Copy Mod UUID`\n\nCopies the Mod's UUID to the clipboard.\n\n#### `Convert Version Number`\n\nConvert between BG3 version numbers.\n\n```\n1.0.0.0 --\u003e 36028797018963968\n36028797018963968 --\u003e 1.0.0.0\n```\n\n##### Input: Version Number\n\nTakes the version number as input in either the string format (e.g. `1.0.0.0`) or bigint format (e.g. `36028797018963968`).\n\n#### `Bump Version Number`\n\nBumps the version number in the `meta.lsx` by the specified type.\n\n```\n1.0.0.0 --- Bump Minor Version --\u003e 1.1.0.0\n1.2.0.7 --- Bump Major Version --\u003e 2.0.0.0\n```\n\n##### Input: Kind\n\n- `Major`\n- `Minor`\n- `Revision`\n- `Build`\n\n\u003cdiv align=\"right\"\u003e\n\n  [Back to Top ⬆️](#bg3-modding-support-for-visual-studio-code)\n\n\u003c/div\u003e\n\n### ✅ JSON Validation\n\nThe extension contributes JSON validation schemas for:\n- [`ScriptExtender/Config.json`](./schema/Config.schema.json)\n- [`ScriptExtenderSettings.json`](./schema/ScriptExtenderSettings.schema.json)\n\nThis will enable intellisense and provide validation for these files.\n\n\u003cdiv align=\"right\"\u003e\n\n  [Back to Top ⬆️](#bg3-modding-support-for-visual-studio-code)\n\n\u003c/div\u003e\n\n### ⚙️ Default Configurations\n\nThe extension provides default configuration settings for:\n\n#### `files.associations`\n\n```json\n\"files.associations\": {\n    \"*.lsx\": \"xml\",\n    \"*.lsj\": \"json\"\n},\n```\n\n#### `search.exclude`\n\n```json\n\"search.exclude\": {\n    \"**/*.raw\": true,\n    \"**/Story/*.div\": true,\n    \"**/*.osi\": true,\n    \"**/*.dat\": true\n}\n```\n\n\u003cdiv align=\"right\"\u003e\n\n  [Back to Top ⬆️](#bg3-modding-support-for-visual-studio-code)\n\n\u003c/div\u003e\n\n---\n\n## ⚙️ Extension Settings\n\nInclude if your extension adds any VS Code settings through the `contributes.configuration` extension point.\n\nFor example:\n\nThis extension contributes the following settings:\n\n* `myExtension.enable`: Enable/disable this extension.\n* `myExtension.thing`: Set to `blah` to do something.\n\n\u003cdiv align=\"right\"\u003e\n\n  [Back to Top ⬆️](#bg3-modding-support-for-visual-studio-code)\n\n\u003c/div\u003e\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshresht7%2Fvscode-bg3-modding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshresht7%2Fvscode-bg3-modding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshresht7%2Fvscode-bg3-modding/lists"}