본문 바로가기
RPG Maker VX Ace/Tools

RGSS Script Compiler - Visual Studio Code Extension

by biud436 2022. 3. 23.

Introduction

This extension allows you to edit scripts directly in Visual Studio Code without using the script editor of RPG Maker VX Ace or RPG Maker XP.

 

 

You can use a few useful keyboard shortcut during editing ruby files.

 

## F5
Test Play (Windows Only)

## CTRL + s (CMD + s)
Save script file and Compile bundle.

 

https://youtu.be/_pJOx74hEFA

 

https://youtu.be/0uqOVCvXC-E

 

This extension is a beta version that has not been tested elaborately. We have secured stability by correcting problems such as third-party scripts, but please back up the scripts in advance.

 

Marketplace Link

https://marketplace.visualstudio.com/items?itemName=biud436.rgss-script-compiler 

 

RGSS Script Compiler - Visual Studio Marketplace

Extension for Visual Studio Code - This extension allows you to compile script files as a bundle file called 'Scripts.rvdata2'

marketplace.visualstudio.com

 

 

Caution

- There must be only one parent folder in the workspace (if there are more than one, the top folder is recognized only)
- The workspace is not automatically set to the initial game folder(This is because workspace and game folders may be different)
- This extension is not always active. Game.ini file must be in the root game folder to be activated.
- This extension activates the rest of the buttons only when selecting the game folder. However, if the rgss-compiler.json file exists, it is automatically activated. When VS Code is started up, the Import or Compile button is automatically activated when this file is existed.
- You should not compile scripts while RPG Maker XP or RPG Maker VX Ace is on. the script information in RPG Maker exists in the state of a global variable in memory based on the initial imported file content (Scripts.rvdata2), and does not detect that the file has been changed. To manipulate memory based on the contents of the file, it is beyond this extension because it requires heap memory manipulation in the tool, such as CreateRemoteThread or DLL Injection to directly penetrate the target process and implement a kind of Hack, such as the RPG Maker tool's Virtual Memory. When loaded with RGSS301.dll, etc. using CreateRemoteThread, one thread is executed, and if you hang a specific script at that time, you can implement Hack like as cheat engine.

 

Known Issues

 

This is a list of bugs that we know but have not solved.

 

- In some cases, the rest of the buttons are activated only when the game folder setting button is pressed more than once. (In some cases, RGSS version identification and game folder setting information are reflected in the setting file are executed separately.

 

This bug occurred by changing the synchronization function to an asynchronous function.

 

 

Supported tools

 

  • RPG Maker XP
  • RPG Maker VX Ace

 

Usage

This extension is designed for use in macOS and Windows 11. Before starting this extension, first up, Please you must install Ruby v2.6.8 or above on you local machine. Here's how to check if Ruby is installed on your computer.

To run this extension, Ruby must be installed on your computer (Mac is in the default installation state, so you can ignore it). 

 

I tried using a node module such as marshal or a WASM-based ruby.

 

because I don't want a ruby installation. but they were not stable.

Try this command on your terminal or command prompt.

 

ruby -v

 

You call the command above to see if the ruby version is output normally like as v2.6.8 or more.

 

 

New Features

- Added a feature that can execute game when pressing the key called F5 (#3)

- Added a feature that can compile ruby files automatically when pressing the key called ctrl + s (#2)

 

Change Log

https://marketplace.visualstudio.com/items/biud436.rgss-script-compiler/changelog

 

Changelog | Visual Studio Marketplace

 

marketplace.visualstudio.com