Grade Victory Screen Script v2.1a

What is it?
This script adds a fancy little information screen at the end of all battles that displays a certain amount of information.  This script will also record the amount of damage you do during battle, the amount of damage you take during battle, the number of turns taken, and other information to grade the player at the end of battle.  The user can then define increases an decreases in the amount of gold, exp, and loot gained at the end of battle!  As an added bonus, you can also define additional drop items per monster.

How can I use it?
Simply place this script above main and below the default scripts.  This script works automatically.  There are two interesting things to note that you can do with this script.
Line 122 by default defines a switch that causes the system to skip music changes in and after battle.  While this switch is on, the battle music and victory musics will not play, and instead the map music or whatever music is currently playing will play into battle and into the victory screen.
The script also have a few notebox tags that can be added for numerous effects.  They are as follows:

  • drop[w:1:2] -or- drop[w:1:2:100] – This tag adds a drop to the monster.  All three options must be defined and are used in the following order: The first option, “w” in this case, is the type of item to drop, either “w” for weapon, “a” for armour, or “i” for item.  The next option, 1 in this case, is the database id of the item to drop, for example, in this case the item would be a hand axe.  The third option, 2 in this case, is the odds for the item to drop, in this case 1:2.  And the final option is the grade required to even allow the item to be dropped.  In this case if the final grade in battle is 100 or higher, the item will drop.
  • score[x] – Place this in a monster’s notebox and your score will increase by “x” when the monster is killed.
  • onehit[x] – Place this in a monster’s notebox and your score will increase by “x” when the monster is one hit killed.
  • score[+x] – Place this in a skill or item’s notebox and your score will increase or decrease by “x” when the skill or item is used.  Both “+x” and “-x” are acceptable.

What does it look like?

What does it work with?
It’s likely that this script will not work with systems that modify the BattleManager too much.  If you would like to use this script with any battle system and find any compatibility issues, post them here and I will gladly add compatibility to it.

How can I get the code?
Version 2.1a (base script, 11.16.2012) is available from my pastebin account here.

I would like to use this code.
Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.
Permissions beyond the scope of this license may be available at https://cphouseset.wordpress.com/liscense-and-terms-of-use/.

Author’s Disclaimer:
I always like being able to view all the info at the end of battle, and I like rewarding the player for doing better in battle, so I started working on a victory screen that would show all the normal info at the end of battle while recording information and increasing rewards if the player does well in the battle.  You can pretty easily define the increases to exp, gold, and drops based on the rank at the end of battle, and you can define the points you get for certain things done in battle.  This victory screen was inspired by the victory screen in Ar Tonelico II, to be quite honest.

I would LOVE to add other ways to add points, so if you have any ideas for other ways to get or lose points in battle, please just ask.

This script has an option to use graphics for the grades.  If you choose to use this, Slaq has provided me with several images that work great for the system and has allowed me to share them here.  Select the ones you want and follow the instructions in the script to use them.  Enjoy!






  1. It would be cool if you could set a score requirement for getting certain items.
    IE: Enemy: Worth 10k points Drops Elixer of health at 8000 points and 9000 points otherwise it does not drop them. If you use healing abilities you loose X points (already included) would be really cool.

    • That’ll probably happen when I upgrade the points system (again). I was going to change how items get dropped in the first place, though it will be a little bit because I have quite a few projects going on at the moment.

  2. Is it possible to use it for an action battle system.
    Like if you go through a whole level and then at the end it will add up everything you found and enemies you’ve killed. Then give you a grade on how you did. maybe win some rewards or something.?

  3. I keep gadding an error code, this is the error code that keeps coming out. Script ‘Victory Ranking script’ line 750 NoMethodError occurred. Undefined method ‘[]’ for nil:Nilclass. How can i use this script can you please help. Need Help =^-^=

  4. Eschaton

    If it’s compatible with VE or YEA ATB systems, perhaps a ‘time’ factor can replace ‘turns.’ Maybe, even a ‘Target Time’ factor can be added (based on cumulative target times for enemies and character level or whatever), and the best grade can be gotten when reached.

  5. Hello there.
    I have an issue while using this script just when a battle ends (victory).

    http://vvcap.net/db/YBjQ-lWVIfwOApcl35DJ.htp

    Thanks in advance!

    PD: Btw, can only the rank system be disabled?

  6. Tambourin

    Hi,
    First of all thank you for this great script.
    Would it be possible to make it compatible with Victor’s Active Time Battle script?
    http://victorscripts.wordpress.com/rpg-maker-vx-ace/battle-scripts/active-time-battle/

  7. Same with the posts above, i too, need a patch of some sorts with Victor’s ABS script, since whenever I start a battle the ATB bar doesn’t move so nothing happens unless I remove your script, which is a shame because I have been looking for this for ages.

  8. WCouillard

    It would also be fantastic if compatibility could be added for Victor Sant’s SFonts script. Pleeeeeeeeeease? :D

  9. Same thought here with Eschaton’s comment above on 3rd June 2013. I guess it might be better if “the times of attack by all party members” is counted instead of the turns, which might aviod the turns counting problems with different ATB systems.

    By the way, I am also using Victor’s ATB system.

  10. I’m having problems with this script and getting this error:

    Script ‘Game_Actor’ line 67: NoMethodError occurred.

    undefined method ’round’ for (-20.0-0.0i):Complex

  11. For some reason, if I change the font the arrows dissapear leaving these empty boxes:
    http://i1309.photobucket.com/albums/s632/TheFroMofo/Bug_zpsdd8c0545.png Does anyone know how to fix this?

  12. For the images, there doesn’t seem to be a a Green ‘A’ image, but instead there is another B.

    This is annoying because I wanted A to be green..

  1. Pingback: Still Here « CP House Set

Reply to this post

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: