[Updated!] Using RGSS3 with RPG Maker VX

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
WARNING – Read carefully!


LEGAL ISSUES


If you want to distribute a game with Ace game player, it's advised and recommended to own both VX and VX Ace legally licensed in the computer you use, otherwise is illegal to share or sell a game containing any resources, scripts, or executable files of a RPG maker you don't own.

RGSS3 CAN’T RECOGNIZE VX RTP!


In order to convert your game to RGSS3 successfully you will need to make it independent from default graphics and songs from default RTP. If you REALLY want to use this, export the files needed to yours project folder. Doing this, you won’t need to copy the entire RTP folder.

Otherwise, and mainly for testing purposes, you can let it use some Ace RTP resources. For this, copy some basic resources from RTP folder ‘Graphics\System\’ and blank “Cursor”, “Cancel”, “Evasion” and “Game Over” sounds on database, as it doesn’t have equivalent resources with the EXACT same name.

Observe that when you go to test the game in RGSS3 mode, all resources that aren’t in project folder will “blanked” in VX Editor; they’ll not appear on Resource Manager or any other place. When the game is running, Ace resources will be used automatically, instead. You will manage to change between VX and RGSS3 modes freely and easily, in order to edit or play the game, but it’s advised the best option is to remove all RTP dependencies anyway.

IT’S A WORK IN PROGRESS (W.I.P.) METHOD, SO IT’S INCOMPLET YET!


The method isn’t perfected, and has some known issues to solve before it could be used for a complete game. It will need a lot of polishing before become perfectly usable. It would be incompatible with various custom scripts and systems, and there's not I can do at this moment. Fixing for the basic engine (that doesn't use every function of RGSS2) is priority, after I can put it to work in any scenarios, making avaliable again all RGSS2 functions.

NO GUARANTEES! TEST AT YOUR OWN RISK!


I’m not responsible for any damage caused direct or indirectly by this. I don’t have any guarantee that it can work with encrypted games. Don’t forget: it’s another Ruby version; lots of scripts besides the default one would need proper conversion. Again, no guarantees that these scripts will work. I recommend to backup your project files before doing this.
Introduction


The title of the topic says everything. What would be the advantages of transplanting RGSS3 onto a RPG Maker VX game? Maybe to speed up your game, taking advantage of the new and improved Ruby version, or maybe due the improved default built-in “hidden” classes like AudioFile, creation of Bitmaps greater than 2048x2048, using a exclusive layer to put autoshadows, or even to have a better debugging option, etcetera...

Whatever the motives, and since VX and Ace are so similar in various aspects, especially in the “hidden” classes’ working, why don’t try to do this? This was my motivation to do this project so far. I expect to accomplish this, as it could be useful for some peoples here.

Well, I had the idea sometime after they launched Ace, when I remembered something similar was done to run XP with RGSS2. But I only decided to make it only after I saw a topic here, [using RGSS3 with RPG Maker XP], by a PK8.

What is needed to begin?


  • RPG Maker VX installed, obviously, as this will be our only editor here;
  • (optional) VX and/or Ace RTP, if your game need some of the default resources;
  • RGSS300.dll or RGSS301.dll, create a 'System' folder and put it on;
  • RPG Maker VX Ace's Game.exe, just replace the VX old one;
  • Ace and VX’s Game.ini, just rename them conveniently to Game_VX.ini and Game_Ace.ini, respectively and put on the project folder too;
  • Some scripts, presented here (follow the instructions below carefully!);



What to do now?


Prepare you game folder, with the required files cited above. Remembering: (1)RGSS301.dll, in da 'System' folder exactly as it is set on a normal Ace project. (2)Game_VX.ini and Game_Ace.ini, came from RPG Maker VX and RPG Maker VX Ace projects; don’t forget to edit your game title, and other things, in these files. (3) A Game.exe from a RPG Maker VX Ace project (the one with a red dragon).

We will need a grand total of 3 .INI files, because every time you save your project in VX, they change back the Game.ini file, and we need a modified in order to run the project in RGSS3. To avoid the boring part, we will create 2 batch files (.bat) to copy the files needed and run the game automatically.

Creating the batch files


Open the Notepad or other similar editor. (You know how to do it, so I’ll not say how to. If you REALLY don’t know how to do it, get off, this tutorial is not for you, start learning about Windows’n’Computers all over again). Create a file named something like “Convert to Ace.bat” and put it directly on the project root directory. In the file, write this:



Code:
@echo off
COPY Game_Ace.ini Game.ini
COPY Data\Scripts.rvdata Data\Scripts.rvdata2
START Game.exe
Explainin’: The first line, well… I like this one in .BAT files, let it there =D. The second will copy the correct .INI file in order to run the RGSS3’s Game player. The third line is optional, use this if your Game.exe refuses to open the VX script file. The fourth, well, you know. Create another file named “Convert to VX.bat” and put it on the project root too. In the file, write this:



Code:
@echo off
COPY Game_VX.ini Game.ini
This second file is purely optional, only needed only to convert the .INI back to VX mode, in order to edit your game in VX, if you are using VX RTP. It’s only a convenience to edit the line back to “RTP=RPGVX”, because even saving on VX editor, the line isn’t reverted from “RTP=RPGVXAce”, and VX can't recognize Ace RTP too.

To run test your game, save the project, and run the first .BAT file. To go back to edit your game (IF AND ONLY IF you’re using the RTP) run the second file we created. BUT WAIT! Before testing we need to insert some scripts in Editor!

Inserting scripts in editor


Actually, there are need to insert 2 scripts in your game: One before the Game engine, to redefine the “hidden” classes. And another one after, to fix some functionalities. Oh, yeah, I almost forgot, you will need to edit the Main script too.

The first script is this: [RGSS2 Data Structure for Ace], it redefines all classes on RPG module, and make RGSS3 capable of reading data from VX. It’s a bit adapted from VX to run on RGSS3. A thing to observe is I’ve put the ENTIRE data structure, and it’s REALLY unneeded all of this, only a few adaptations. I’ll do this soon, when I go compare Data Structure from both makers…

The second script is this: [RGSS2 to RGSS3 Fixes], the name says what it does. Even with all Data Structure, we need some little adjusts to everything work. Most of this is to change small details on engine, as they’re identical. See? Is not easy to run VX on RGSS3? Oh, just don't forget to check the Known Issues, it's important.

Edit your Main script. It would look like this, in the useful part(excluding the commentaries):



Code:
rgss_main{
Graphics.freeze
$scene = Scene_Title.new
$scene.main while $scene != nil
Graphics.transition(30)
}
Now we're ready to start! Run the batch file (only the first time after every edit on VX editor), and watch your game run smoothly on RGSS3. (After this, you can run normally from .EXE, trying to run it from VX Editor doesn't works.) Good luck!

NOTES: if you prefer to don't overwrite your Game.exe, just do the following: You can use the Game.ini you want, without necessity of Batch files to replace these. Just use a different name for the Ace's Game.exe (like Game_Ace.exe) and a .INI file with the respective name too (here, Game_Ace.ini). Doing this, this game player with a different name will read the .INI with the same name and will execute the game without problems. Hurray!

Unfortunately the game cannot run in the VX Editor this manner. But I'm thinking I'll do a launcher to solve this issue (only if there's sufficient demand, so let me know if you gonna want to use it). The launcher would include support for $TEST and $BTEST modes.



FAQ/Issues


  • Question: I only need this to put it to work? I don't believe!
    Answer: Yes, and I don't too. VX and Ace are practically identical, the conversion was easy. It wasn't needed to rewrite drastically any of the default built-in classes, it remained almost the same.Too easy, but it's for testing purposes, this isn't the final code.

  • Question: Why my hero is walking above the tops of trees?
    Answer: No, he's not the Spiderman. The priority on showing tilesets were not corrected yet. In help files, it says that the priority is the same, so I need a little piece of code, and RGSS3 could interpret the priorites correctly. Bug already corrected in v2.

  • Question: It's not working here! What should I do?
    Answer: Re-check if you done the steps previously cited correctly. One letter out of place and it couldn't work! Or couldn't work in either way, who knows... It's only a experimental procedure.



Special Thanks


  • Dargor, a PK8 and Migetman12;
  • RPG Maker Web Staff and Community, specially Lunarea and TouchFuzzy;
  • Enterbrain and Degica.



And it’s all, folks! Have fun!

 
Last edited by a moderator:

Tsukihime

Veteran
Veteran
Joined
Jun 30, 2012
Messages
8,564
Reaction score
3,846
First Language
English
Does it actually "speed up" the game?
 

Touchfuzzy

Rantagonist
Staff member
Lead Eagle
Joined
Feb 28, 2012
Messages
7,295
Reaction score
8,904
First Language
English
Primarily Uses
RMMZ
Also keep in mind that to do this legally, you must legally own both VX and Ace.
 
  • Like
Reactions: PK8

amerk

Veteran
Veteran
Joined
Mar 13, 2012
Messages
1,433
Reaction score
495
First Language
English
Primarily Uses
And by the time you spend the $150 to own both VX and Ace, you might as well just keep to Ace and do everything there. Of course, if you own both VX and Ace, and by converting RGSS3 to VX allows you to also continue using VX RGSS2 scripts, that could be a definite win.
 

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
Does it actually "speed up" the game?
In my old Pentium 4 it clearly saved some FPS compared to VX, the Ruby present in RGSS3 is excellent indeed.

Moved to Tutorials and edited tags. :)
Oh, sorry for the problems I caused, eventually I'll learn the place of everything here. Thanks, Lunarea!
Also keep in mind that to do this legally, you must legally own both VX and Ace.
I was commenting about this on a PK 8's topic, I personally don't see the necessity of this, but this would be the best pratice anyway.Err... Only to ask...Hmm, there's a problem if I post a demo here? Thanks, mr. Fuzzy!

And by the time you spend the $150 to own both VX and Ace, you might as well just keep to Ace and do everything there. Of course, if you own both VX and Ace, and by converting RGSS3 to VX allows you to also continue using VX RGSS2 scripts, that could be a definite win.
This was originally made to the ones who have only VX and want to use some features from RGSS3. The scripts may need some adaptation, it's a different Ruby.
 

amerk

Veteran
Veteran
Joined
Mar 13, 2012
Messages
1,433
Reaction score
495
First Language
English
Primarily Uses
Naturally, you'd have to own both copies of VX and Ace, otherwise EB would be losing out on money for people who want some of Ace's features, but don't want to spend the extra cost. What would be the point of selling Ace if people can just buy VX, convert to RGSS3a, and save the extra $30?
 

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
Naturally, you'd have to own both copies of VX and Ace, otherwise EB would be losing out on money for people who want some of Ace's features, but don't want to spend the extra cost. What would be the point of selling Ace if people can just buy VX, convert to RGSS3a, and save the extra $30?
Hey, hey, hey... It's the POV of the users we're commenting, not Enterbrain. Enterbrain don't cares if we want to convert our games to Ace, it wants we pay more and more money buying the softwares (actually I like so much their softwares!).It's not wrong in any manner, I know, I'll not blame it. But let's be honests with ourselves. We should use the things the way it's more convenient to us (since we don't break any laws), not give $$$ for every lil' piece of thing Enterbrain does. (Yeah! Power to the peoples!)

You don't need to pay Enterbrain, for example, if you want to make a XP/VX port of TP system, or a kind of notetag-like Traits, or a caterpillar system (already done by users years before Eb!). And I can guarantee, if it's to pay to use, the extra $30 is far more vantage, as Ace is really lotta better than VX in various other aspects, and all here know this. In any manner, we will pay Enterbrain, VX isn't a free software, until the last time I saw it in stores.

Here we're only some improved Classes and a improved Ruby, not more than this. If I have a game already done in my licensed VX, why would I pay $90 again only to do this (a small update/upgrade)? No way, I think it's not a good idea. Anyway, if someone want to sell a game bundled with any resources from VX and ACE RTP, or need to use the two softwares simultaneously, two licenses are needed, obviously.

Got my point? I think we're not escaping from paying anything here, Enterbrain will get its money honestly selling VX or Ace, and we will use the software and advantages available at its best.
 
Last edited by a moderator:

Lunarea

Artist
Global Mod
Joined
Mar 1, 2012
Messages
8,840
Reaction score
7,797
Here's the deal ... This is the official RPG Maker forum. We are working with Enterbrain, not against them. This means that we encourage people to buy RPG Maker products instead of trying to find ways to cheat them out of business.

I was willing to keep this thread open because it was informational. I know several people who own multiple RPG Makers and I imagine some of them may be interested in trying to integrate RGSS3 into one of the older makers they own. However, you have made it abundantly clear that your intention with this thread is to get the Ace features without paying for the software. This is illegal and in no way appropriate in this forum.

I'm editing the first post and closing this thread. You will also be issued a warn. Do not promote piracy again! Piracy is a bannable offense.
 
  • Like
Reactions: PK8

Touchfuzzy

Rantagonist
Staff member
Lead Eagle
Joined
Feb 28, 2012
Messages
7,295
Reaction score
8,904
First Language
English
Primarily Uses
RMMZ
Here we're only some improved Classes and a improved Ruby, not more than this. If I have a game already done in my licensed VX, why would I pay $90 again only to do this (a small update/upgrade)? No way, I think it's not a good idea. Anyway, if someone want to sell a game bundled with any resources from VX and ACE RTP, or need to use the two softwares simultaneously, two licenses are needed, obviously.

Got my point? I think we're not escaping from paying anything here, Enterbrain will get its money honestly selling VX or Ace, and we will use the software and advantages available at its best.
I'm going to reopen this to explain something really basic, that I cannot believe that you actually don't get.

RGSS3 is a part of Ace. Without owning Ace, YOU DO NOT HAVE THE RIGHTS TO DISTRIBUTE IT WITH YOUR GAME.

This isn't about what is best for Enterbrain, its about the ACTUAL LEGAL LINES. Without buying Ace, you have no legal standing to use any portion of it in a distributed game. Part of what you get when you buy RPG Maker products is the license to distribute. Just because you can freely grab RGSS3 from a trial download, does not mean that you have free reign to use it. Actually READ THE EULAs.

That is why you have to buy both to do this legally. Its not an opinion, its a fact. So stop treating it otherwise.

And actually, I see no reason to not leave this open, its fine if people want to discuss it. Just no more discussion of the legalities of it when its been spelled out for you.
 
Last edited by a moderator:

Tsukihime

Veteran
Veteran
Joined
Jun 30, 2012
Messages
8,564
Reaction score
3,846
First Language
English
You don't need to pay Enterbrain, for example, if you want to make a XP/VX port of TP system, or a kind of notetag-like Traits, or a caterpillar system (already done by users years before Eb!).
That argument only works if you're writing your own rgss library from scratch and distributing it with your projects. From a coding POV anyways.

There's probably something silly that says you're not allowed to use any dll's that didn't come with the product.
 
Last edited by a moderator:

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
I'm going to reopen this to explain something really basic, that I cannot believe that you actually don't get.

RGSS3 is a part of Ace. Without owning Ace, YOU DO NOT HAVE THE RIGHTS TO DISTRIBUTE IT WITH YOUR GAME.

This isn't about what is best for Enterbrain, its about the ACTUAL LEGAL LINES. Without buying Ace, you have no legal standing to use any portion of it in a distributed game. Part of what you get when you buy RPG Maker products is the license to distribute. Just because you can freely grab RGSS3 from a trial download, does not mean that you have free reign to use it. Actually READ THE EULAs.

That is why you have to buy both to do this legally. Its not an opinion, its a fact. So stop treating it otherwise.

And actually, I see no reason to not leave this open, its fine if people want to discuss it. Just no more discussion of the legalities of it when its been spelled out for you.
Hmm, OK then... No problems for me.Thanks for the clarifying the things up, Mr. Fuzzy. Hopefully here no one was doing anything like this, it was an experimental scripting project and I don't distributed any files except the scripts I made, that are perfectly legal. I'll add a disclaimer on the initial post to say this, as the EULA isn't clear on this specific subject.

[...]

There's probably something silly that says you're not allowed to use any dll's that didn't come with the product.
Changing a little the subject, I want to know if, hipotetically, someone executes her/him game data (clearly don't containing any Enterbrain RTP, script, resource, game player or any executable/DLL files provided with RPG Maker) with another game player not provided by Enterbrain, a custom one, I'd say.Is it legally acceptable? These days I remembered that I saw some player for MacOs or something like, and I want to know how "legal" it was. Well, it's only a question...
 

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
News!

These days I worked a bit on the development of this idea, and now I brought some revisions of the scripts and more. Tomorrow I will edit the OP to include these links and modifications as well. Here:

1. To start, a major overhaul on the [RGSS2 Data Structure for Ace]. I cleaned everything that was unnecessary, and now the script does exactly the same, but with less 542 lines. Oh yeah, the script was pratically halved, it's speciality now is to reuse parameters already found in RGSS3 engine. It only kept the ones exclusively found in VX codes. Cool, eh?

2. And the priority on Tileset exibition was corrected too, now your hero will not be the SpiderMan anymore, it will be shown below tops of trees. Update now your version of the [RGSS2 to RGSS3 Fixes], and throw away this frustating bug. Now I didn't found more bugs besides that I corrected. It's a good oportunity to test this method with a full game and find some. ;-)

3. And to someone who preferred to don't overwrite your Game.exe, the hint is the following: You can use the Game.ini you want, without necessity of Batch files to replace these. Just use a different name for the Ace's Game.exe (like Game_Ace.exe) and a .INI file with the respective name too (here, Game_Ace.ini). Doing this, this game player with a different name will read the .INI with the same name and will execute the game without problems. The sad part is that unfortunately the game cannot run in the Editor this manner too. But I'm thinking I'll do a launcher to solve this issue. The launcher will include support for $TEST and $BTEST modes.

And this is all for now! See ya, guys and girls!
 

d_a_renoir

Veteran
Veteran
Joined
Jun 12, 2012
Messages
237
Reaction score
27
First Language
English
Primarily Uses
Some questions.

Otherwise, and mainly for testing purposes, you can let it use some Ace RTP resources. For this, copy some basic resources from RTP folder ‘Graphics\System\’ and blank “Cursor”, “Cancel”, “Evasion” and “Game Over” sounds on database, as it doesn’t have equivalent resources with the EXACT same name.
Do I copy these from the Ace folder and put it in MY game folder? Or do I copy these from the VX stuff?

Does this game over-write RGSS2 with RGSS3 so that I can't use RGSS2 scripts anymore on the VX?
 

d_a_renoir

Veteran
Veteran
Joined
Jun 12, 2012
Messages
237
Reaction score
27
First Language
English
Primarily Uses
I don't quite get how the resource/RTP work. Do I need to have all my resources into the appropriate game folders or will this tampered-VX be able to detect Ace's RTP?
 

Rafael_Sol_Maker

Almighty God Jabu
Veteran
Joined
May 8, 2012
Messages
129
Reaction score
56
First Language
Portuguese
Primarily Uses
RMMV
No, this "tampered-VX" can't detect VX-RTP. RPG Maker generally can't detect any other RTP it wasn't designed for. Your game was made on VX, right?

So, you need to copy the resources you use from VX-RTP, or let it use the Ace equivalents. The Game.exe from Ace detects perfectly ACE-RTP, so these resorces you don't need to copy.

If you're gonna making a game, the best option would be to copy all the VX resources you use after all (VX, not Ace), so the final user don't need to install 2 RTP package in order to play the game.

Wrong!The scripts? Well, it's hard to guess. Letting VX run in RGSS3 will NOT make it compatible with ACE scripts. Oh, and it doesn't means every RGSS2 scripts will be rendered useless too. The game system is the same of the old VX after all, so, most of the RGSS2 scripts will work again if you adapt them to the Ruby 1.9 standard (some even don't need adaptations).

------

Edit: News from post #13 merged into the OP!

Edit2: Clarified the things just a little... ( I wrote something controversal here, sorry.)
 
Last edited by a moderator:

drawer

Warper
Member
Joined
Jul 16, 2013
Messages
1
Reaction score
0
First Language
Japanese
Primarily Uses
Oh,I can't use the script in the event!

1.png2.png
 

Users Who Are Viewing This Thread (Users: 0, Guests: 1)

Latest Threads

Latest Posts

Latest Profile Posts

People3_5 and People3_8 added!

so hopefully tomorrow i get to go home from the hospital i've been here for 5 days already and it's driving me mad. I miss my family like crazy but at least I get to use my own toiletries and my own clothes. My mom is coming to visit soon i can't wait to see her cause i miss her the most. :kaojoy:
Couple hours of work. Might use in my game as a secret find or something. Not sure. Fancy though no? :D
Holy stink, where have I been? Well, I started my temporary job this week. So less time to spend on game design... :(
Cartoonier cloud cover that better fits the art style, as well as (slightly) improved blending/fading... fading clouds when there are larger patterns is still somewhat abrupt for some reason.

Forum statistics

Threads
105,868
Messages
1,017,085
Members
137,583
Latest member
write2dgray
Top