{"id":32127700,"url":"https://github.com/snowszn/rgss-script-editor","last_synced_at":"2026-02-19T08:01:29.496Z","repository":{"id":215683394,"uuid":"715280641","full_name":"SnowSzn/rgss-script-editor","owner":"SnowSzn","description":"RGSS Script Editor is a Visual Studio Code extension for RPG Maker XP, RPG Maker VX and RPG Maker VX Ace","archived":false,"fork":false,"pushed_at":"2025-10-18T20:19:20.000Z","size":7707,"stargazers_count":23,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-21T00:35:58.811Z","etag":null,"topics":["developer-tools","rgss","rpg-maker-vx","rpg-maker-vxace","rpg-maker-xp","rpgmaker","rpgmakervx","rpgmakervxace","rpgmakerxp","script-loader","typescript","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SnowSzn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-06T20:32:39.000Z","updated_at":"2025-10-18T20:19:25.000Z","dependencies_parsed_at":"2024-06-22T12:25:25.954Z","dependency_job_id":"8c7b1bb3-2321-46cb-b539-3cbde04eeec9","html_url":"https://github.com/SnowSzn/rgss-script-editor","commit_stats":null,"previous_names":["snowszn/rgss-script-editor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SnowSzn/rgss-script-editor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SnowSzn%2Frgss-script-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SnowSzn%2Frgss-script-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SnowSzn%2Frgss-script-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SnowSzn%2Frgss-script-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SnowSzn","download_url":"https://codeload.github.com/SnowSzn/rgss-script-editor/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SnowSzn%2Frgss-script-editor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29608152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T06:47:36.664Z","status":"ssl_error","status_checked_at":"2026-02-19T06:45:47.551Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["developer-tools","rgss","rpg-maker-vx","rpg-maker-vxace","rpg-maker-xp","rpgmaker","rpgmakervx","rpgmakervxace","rpgmakerxp","script-loader","typescript","vscode-extension"],"created_at":"2025-10-21T00:29:55.526Z","updated_at":"2026-02-19T08:01:29.491Z","avatar_url":"https://github.com/SnowSzn.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src='./icons/logo.png'\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eRGSS Script Editor\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003eAn advanced script editor for RPG Maker XP/VX/VX Ace inside VSCode\u003c/h3\u003e\n\n## 📋 Table of Contents\n\n- [📋 Table of Contents](#-table-of-contents)\n- [✨ Features](#-features)\n- [🖼️ Screenshots](#️-screenshots)\n- [🛠️ Requirements](#️-requirements)\n  - [Windows](#windows)\n  - [Linux](#linux)\n  - [macOS](#macos)\n- [📦 Download](#-download)\n- [🚀 Getting Started](#-getting-started)\n  - [1. Open Your Project Folder](#1-open-your-project-folder)\n  - [2. Extract Scripts](#2-extract-scripts)\n  - [3. Use the Script Editor View](#3-use-the-script-editor-view)\n  - [4. Run Your Game](#4-run-your-game)\n- [🐞 Known Issues](#-known-issues)\n  - [\\[SyntaxError\\] Invalid Multibyte char (US-ASCII)](#syntaxerror-invalid-multibyte-char-us-ascii)\n  - [\\[LoadError\\] no such file to load -- \\[Errno::EINVAL\\] Invalid argument](#loaderror-no-such-file-to-load----errnoeinval-invalid-argument)\n    - [File Doesn’t Exist](#file-doesnt-exist)\n    - [File Exists but Crashes](#file-exists-but-crashes)\n  - [\\[SystemStackError\\] stack level too deep](#systemstackerror-stack-level-too-deep)\n- [🙏 Contributors](#-contributors)\n\n## ✨ Features\n\n- Seamlessly extract and manage RPG Maker scripts as individual Ruby files.\n- Edit the game scripts in VSCode while the RPG Maker editor is open and the game is running.\n- Organize your scripts in a tree view: folders and separators with drag \u0026 drop support.\n- Copy, cut and paste scripts and folders anywhere in the tree view.\n- Enable/disable scripts and folders to load or skip them when running the game.\n- Run the game directly from VSCode with lots of customizable options.\n- Process game exceptions with detailed backtrace visualization inside VSCode.\n- RPG Maker default script list hierarchy has been replaced with a tree hierarchy.\n- Backup and compile script bundles for distribution.\n- Seamlessly change between active folders in the VSCode current workspace.\n- File system watcher tracking your project's script folder for changes outside VSCode.\n- Use version control software (Git) to track script changes visually on the script editor.\n\n## 🖼️ Screenshots\n\n![Editor View Collapsed](./images/feature-editor-collapsed.jpg)\n\n![Editor View](./images/feature-editor.gif)\n\n![Editor View 2](./images/feature-editor-2.gif)\n\n![Run Game](./images/feature-run-game.gif)\n\n![Game Exception](./images/feature-game-exception.gif)\n\n## 🛠️ Requirements\n\n### Windows\n\n- [Visual Studio Code](https://code.visualstudio.com/)\n\n### Linux\n\n- [Visual Studio Code](https://code.visualstudio.com/)\n- [Wine](https://www.winehq.org/) (preferably the latest version)\n  - Wine should available on your system, which will be used to run the Windows game executable.\n  - You can check if Wine is installed in your system with: `wine --version`\n  - **IMPORTANT: If you use MKXP-Z for Linux you won't need to install Wine.**\n    - Wine is only required for RPG Maker Windows executables.\n  - You can also use any other Wine fork with this extension.\n\n### macOS\n\n- [Visual Studio Code](https://code.visualstudio.com/)\n- **⚠️ Not officially tested ⚠️**\n\n## 📦 Download\n\n- [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=SnowSzn.rgss-script-editor)\n- [Open VSX Marketplace](https://open-vsx.org/extension/SnowSzn/rgss-script-editor)\n\n## 🚀 Getting Started\n\n### 1. Open Your Project Folder\n\nOpen the **root folder** of your RPG Maker project in VS Code (the one containing `Game.exe`). The extension will attempt to detect your RPG Maker version by checking for one of the following files in the data folder:\n\n- `Data/Scripts.rxdata` (XP)\n- `Data/Scripts.rvdata` (VX)\n- `Data/Scripts.rvdata2` (VX Ace)\n\n**If this data file is missing the extension won't work!**\n\n### 2. Extract Scripts\n\nWhen opening the project for the first time, the extension will prompt you to extract all scripts from the bundled file into individual Ruby `.rb` files. A **backup** of the original file is automatically created.\n\nYou can change the script output folder in the extension settings.\n\nFrom now on, you should get rid of the RPG Maker script editor and create and manage scripts using the extension's editor in VS Code.\n\nIf you create new scripts using the native RPG Maker editor, that's still possible—but you'll need to extract them again before the extension can work with them properly.\n\n### 3. Use the Script Editor View\n\nA new icon will appear in the VS Code activity bar (usually at the left of the editor): \u003cimg src=\"./icons/logo.png\" width=\"25\"/\u003e\n\nThis opens the **Script Editor View**, where you can manage scripts using folders, separators, drag-and-drop, enable/disable sections, rename, and more.\n\nThis view also determines the **load order** of the scripts when running the game.\n\nYou can toggle any section load status with each item checkbox.\n\nIf an item checkbox is not checked it won't be loaded when the game is executed.\n\n### 4. Run Your Game\n\nPress `F12` or use the button in the UI to launch your game. You can customize arguments and execution behavior (e.g., restart running instances) via the extension settings.\n\n## 🐞 Known Issues\n\n### \\[SyntaxError] Invalid Multibyte char (US-ASCII)\n\n**Applies only to extension versions before v1.5.0**\n\nRuby cannot determine file encoding without a magic comment. If you see this error, make sure the script starts with:\n\n```ruby\n# encoding: utf-8\n```\n\nEnable the setting `rgssScriptEditor.extension.insertEncodingComment` to have this added automatically.\n\n---\n\n### \\[LoadError] no such file to load -- \\[Errno::EINVAL] Invalid argument\n\n#### File Doesn’t Exist\n\nEnsure the file exists and is correctly listed in `load_order.txt`. Scripts can be skipped using `#` at the start of the line.\n\n#### File Exists but Crashes\n\nOlder RPG Maker versions using Ruby \u003c1.9 cannot handle special characters in file paths.\n\nAvoid using characters like `■` or `▼` in filenames, also wide characters like japanese or chinese causes this error too.\n\nThe versions of RPG Maker affected are:\n\n- RPG Maker XP\n- RPG Maker VX\n\nValid script names should only contain ASCII letters:\n\n```\nGood: Script_1.rb, My-Script.rb\nBad: ▼ Script.rb, スクリプト.rb\n```\n\n**If you use MKXP-Z or any other implementation that is based in Ruby v1.9+ (RPG Maker VX Ace), this restriction doesn’t apply.**\n\nPlease set the setting `rgssScriptEditor.extension.scriptNameValidation` to `auto` or `enabled` to let the extension remove invalid characters from script names. Only disable this setting if you are sure the Ruby version you are using is safe using wide characters.\n\n---\n\n### \\[SystemStackError] stack level too deep\n\nOccurs when reloading the script loader at runtime, usually due to aliasing methods repeatedly.\n\nExample problematic code:\n\n```ruby\nclass Scene_Base\n  alias reset_script_loader update\n  def update\n    reset_script_loader\n    raise ScriptLoader::ResetLoader if Input.press?(:F5)\n  end\nend\n```\n\nUse a check before aliasing:\n\n```ruby\nclass Scene_Base\n  alias reset_script_loader update unless method_defined?(:reset_script_loader)\n  def update\n    reset_script_loader\n    raise ScriptLoader::ResetLoader if Input.press?(:F5)\n  end\nend\n```\n\n**This feature is very experimental and can lead to undefined behavior. Use with caution.**\n\n## 🙏 Contributors\n\n- [marshal](https://github.com/hyrious/marshal)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowszn%2Frgss-script-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnowszn%2Frgss-script-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnowszn%2Frgss-script-editor/lists"}