How to use scripts in Rpgmaker XP VX ACE
This page will teach you how to easily put scripts into your RM game projects, and create your own. You can also find tutorials, scripting resources (programming help), and links to communities to visit if you run into any problems. I'll be linking to it from all the ones I release - so please leave a comment at the bottom if it isn't helpful enough.
Here's a couple short quizzes you can take to test your Rpgmaker script knowledge. You can skip ahead as well if you're not in a mood for those.
Easy and Hard.
Three questions each.
Follow the instructions! Most scripts for the Rpgmaker programs are inserted in the same way - but not all of them. The following is what's usually expected if there aren't any instructions.
That big 1 to the right, below the number 2, is where you'll likely be told to install your script. Left click in that area, then right click with your mouse. You should get a popup window like the one below this paragraph. Hit insert.
Rpg Maker XP user? There is no materials section, but there's still the empty area above Main you should use. I recommend inserting a few extra empty areas to make it neater.
Confused? There's also this tutorial on official blog covering the same thing.
Was this short 'How to insert a script' good enough?
Some scripts for Rpg Maker XP will ask you to edit the other files. I don't recommend using them - stick with the ones you can copy and paste into your projects.
Every script is used in a different way.
Refer to the instrucitons wherever you found the Rpgmaker script.
It's a good idea to read through them all before you put it into your project.
Many also have demos you can play through, with examples.
Some are considered Plug and Play, creating their effects automatically.
Some use Notetags or Terraintags to determine their effects.
Some use Filenames or Comments to determine their effects.
... and so on.
Others require you to have some programming knowledge.
This is usually basic (hashes, arrays), but not always!
You might be required to edit the script itself to customize it. This is generally done in the top area, before any of the actual Ruby script. All of the ones I post can be edited there. This also lets you upgrade the scripts (if they have bugfixes) without losing your changes.
I recommend putting the script's site address there as well (if it's not included), incase you have problems. You can comment out any line by putting a # in front of it. This will turn it green and the Rpgmaker program will ignore any of that ruby code.
I can't understand the script instructions. Help?
Respond on the forum threads about it. The creators usually help people use theirs.
No forum thread, or an inactive one? Try posting at any of the Rpgmaker communities listed below in the Troubleshooting area. These are filled with helpful folks who'd like to give you advice, if you're nice and polite. Link to wherever you found the script with your request. Don't simply paste the whole thing there. People need to see the entire page and author's comments to understand how it is supposed to be used.
A list of rpgmaker script tutorial websites
Look at them all! I can't recommend just one, we all figure out things differently. :)
- Chaos Project's Scripting School
A section of a RpgMaker community's message boards with lessons.
- Gubid's RGSS3 youtube video series
Video tutorials for Rpg Maker VX Ace only. He's made a lot of others, which I've linked in a section of their own below this.
- RpgRpgRevolution RGSS tutorials
A collection of 23 that you might find useful. Includes several titled "RGSS for Dummies".
- Dubealex's tutorials
Possibly old and outdated, these were made around 6 years ago for RMXP.
Gubid's Ruby Scripting Tutorial youtube series
These are narrated. You would need to be able to hear them.
- 1: Hiding the save option in a menu
- 2: Understand variables
- 3: Ruby basics (Classes, methods, etc.)
- 4: Class changing system
- 5: Stealing command
- 6: Special shop script
- 7: Cooking system
- 8: Script commenting
- 9: Animation system
- 10: Larger party menu
- 11: FF Tactics menu
- 12: Cursor for the FF Tactics menu
- 13: Command menu
- 14: Attack with weapons
- 15: Dragonquest save system
- 16: Battle system like Chrono Trigger
- 17: Levels for skills
- 18: Larger events
Are scripts too hard and confusing to make?
RGSS and Ruby programming resources
I do not personally recommend any of these (haven't read them), but many people prefer books over a website. There's quite a few more about Ruby out there. Click any below if you're interested, read their reviews, and see what other related programming books Amazon carries.
Your local library might also have some available. You can browse the first chapters of many of the books below for free on the Amazon website, and there are also kindle/ebook versions.
- RGSS3 Doc
Documentation & references for the RGSS3 (Rpgmaker VXAce) systems.
- Learning Ruby and RGSSx (Rpgmakerweb)
A section of the official forums dedicated to helping people learn how to program scripts.
- Learn ruby the hard way
A website teaching the programming language.
- Pragmatic Programmer's Guide
An extremely helpful site for looking up various commands, what they do, and how to use them.
- The Ruby Monk
Lessons and problems... however, only the first sections are free.
- Poignant guide to Ruby
A strangely presented, yet interesting, learning website.
- Language documentation
Official resource for the Ruby programming language. Boring, but useful. This is for the Rpg Maker VX ACE version. XP & RMVX use previous editions.
- RGSS References
This was made back in the Rpg Maker XP days, may be outdated.
- Graphics for Noobs
by Khatharr. It's a tutorial about Sprites / Images.
Do you prefer books or websites?
- RGSSx in Development (Rpgmaker Web)
A section of the official forums where aspiring scripters can have their works looked at.
Not every script works perfectly, or plays together with others.
These message boards will help you figure out what's wrong.
- Rpgmakerweb: RGSSx Support
The official website's support area for problems you might have using scripts. There isn't a big community here, but the people seem to be knowledgeable.
- HBGames support area
Homebrew games site covering many different engines. The site is currently down, so I can't say how much help is available here.
- Chaos Project's Script Troubleshooting
A small RPGMaker community's message board.
- RpgMakerVX.net support area
This site's community is only for the RMVX edition of the program.