Advanced GameOver MZ

This is the documentation for the “Advanced GameOver” plugin for RPG Maker MZ. Here you’ll get all the information needed on how to use its functions.

Advanced GameOver Settings

Use Gameover Screen

Command Menu Settings

Permadeath Settings

Teleport & Skip Settings

General Info

This plugin provides several ways of customizing the gameover scene and overall experience regarding “losing”.

Some settings might take a few attempts to get positionings and animation timings right. But it is still a lot easier than doing those things with regular eventing.

If you’re receiving JSON Errors, you can always check the Console by pressing F12. The plugin is written in a way that it will hint at the setting that contains the faulty JSON.

This plugin has a lot of nested structures. To avoid confusion these have their own part in the documentation. You can find them here.

All pictures used for the gameover display have to be stored inside the “img/system” folder.

Back to top

Gameover Screen

The plugin lets you customize the gameover screen in many different ways. Since it is quite feature heavy, it is split into several parts.

Sample Gameover Screen

Settings

The first part of the gameover screen settings covers the overall display of the screen, as well as the menu type and commands used.

Screen Settings
  • Use Gameover Screen:

    Set if you want to use the gameover screen at all. When set to “OFF” the following settings are being ignored and some of the “Special Options” become available

  • Command Menu Type:

    Set which menu type you want to use for the gameover screen. You can choose between “Window“, “Text“, “Picture” and “OFF”. The last one will disable the command window alltogether and make the gameover screen work like in the vanilla engine

Back to top

The “Allowed Commands” can be used to set up which commands are available for the player during the gameover screen display. These only work when “Use Gameover Screen” IS set to “ON” AND the “Command Menu Type” is NOT set to “OFF”

Screen Settings
  • Continue:

    Set if you want to use the Continue command. It will be used if the “Command Menu Type” is set to any other setting than “OFF”. This command will be greyed out when it is enabled, but there is no savefile available to load from

  • To Title:

    Set if you want to use the To Title command. It will be used if the “Command Menu Type” is set to any other setting than “OFF”

  • Quit

    Set if you want to use the Quit command. It will be used if the “Command Menu Type” is set to any other setting than “OFF”. This command fully closes the game

Back to top
Screen Settings
  • Command Window Settings:

    Set up a command window with the regular RPG Maker MZ window style. More info can be found here

  • Text Menu Settings:

    Set up a text based menu using generated text and fonts. More info can be found here

  • Picture Menu Settings:

    Set up a picture based menu where you use your own  pictures as menu options. More info can be found here

Back to top

When customizing the background, make sure to check all settings according to the background mode you’re using.

Background Settings
  • Background Mode:

    Pic between a static background image (“Static”) or a random picture every time a gameover occurs (“Random”)

  • Static Background:

    Set up a static background image for the scene. It has to be located inside the “img/system” folder of your project

  • Random Backgrounds:

    Set as many background images as you want. A random picture will be picked on every gameover when the “Background Mode” is set to “Random”. All pictures have to be located inside the “img/system” folder of your project

  • Custom Gameover Label:

    The custom label is a text/line that you can freely set up. Pick between “Text”, a picture that you can set up, or simply disable it by picking “OFF”. When picking anything else than “OFF”, the “Label Settings” below have to be filled

  • Label Settings:

    Set up your custom label accordig to your above setting. more info can be found here

Back to top

Command Window Settings

Fill out these settings when your “Command Menu Type” is set to “Window”. 

Sample Command Window

Settings

If you set “Command Window X” and “Command Window Y” both to 0, the command window will center on the same position as the title screen command window.

Command Window Settings
  • Command Window X:

    Set the x position of the window on the screen

  • Command Window Y:

    Set the y position of the window on the screen

  • Window Wait Timer:

    Set an optional wait timer in frames that hast to finish off before the command window shows up. (1 second = 60 frames)

  • Window Style:

    Pick between “Standard” window style, which looks like any normal window in the engine, or “Transparent”, which has its borders removed

Back to top
Gameover Screen – Menu Settings

Text Menu Settings

Fill out these settings when your “Command Menu Type” is set to “Text”.

Sample Command Window

Settings

Make sure to check all of the font settings to avoid any errors. If you are wondering why all the settings are basically doubled: This is because you need a setup for when the option is not selected with the cursor and one for when it is selected.

Font Settings
  • Font:

    The name of the font you want to use for the normal display (Case sensitive!). More info about how to set up fonts can be found here

  • Font Selected:

    The name of the font you want to use when the item is selected (Case sensitive!). More info about how to set up fonts can be found here

  • Font Color:

    The color for the font for the normal display. This has to be of hex-value, starting with a #. You can find a color picker with hex-value output here

  • Font Color Selected:

    The color for the font for when the item is selected. This has to be of hex-value, starting with a #. You can find a color picker with hex-value output here

  • Font Size:

    Size of the font for the normal display (Varies depending on the font you use)

  • Font Size Selected:

    Size of the font when the item is selected (Varies depending on the font you use)

  • Font Decoration:

    Allows to set certain font decorations such as bold, italic and an outline border. More info can be found here

  • Font Decoration Selected:

    Allows to set certain font decorations such as bold, italic and an outline border. More info can be found here

  • Font Animation:

    Set the animation for the normal display. More info can be found here

  • Font Animation Selected:

    Set the animation for when the item is selected. More info can be found here

Back to top

The next part is going to deal with the positions of the menu items. As you may have noticed, there is only one set of coordinates for each possible item to make sure they are at the same position. All positions are set based on the center pixel of the text

Position Settings
  • Continue Position X:

    The x position of the “Continue” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Continue Position Y:

    The y position of the “Continue” command. Only takes effect when the command is enabled at “Allowed Commands”

  • To Title Position X:

    The x position of the “To Title” command. Only takes effect when the command is enabled at “Allowed Commands”

  • To Title Position Y:

    The y position of the “To Title” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Quit Position X:

    The x position of the “Quit” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Quit Position Y:

    The y position of the “Quit” command. Only takes effect when the command is enabled at “Allowed Commands”

Back to top
Gameover Screen – Menu Settings

Picture Menu Settings

Fill out these settings when your “Command Menu Type” is set to “Picture”.

Sample Picture Menu

Settings

Make sure to check all of the font settings to avoid any errors. If you are wondering why all the settings are basically doubled: This is because you need a setup for when the option is not selected with the cursor and one for when it is selected.

  • Continue:

    Set the image for the normal display of the “Continue” command. It has to be located inside the “img/system” folder of your project

  • Continue Selected:

    Set the image for when the “Continue” command is selected. It has to be located inside the “img/system” folder of your project

  • To Title:

    Set the image for the normal display of the “To Title” command. It has to be located inside the “img/system” folder of your project

  • To Title Selected:

    Set the image for when the “To Title” command is selected. It has to be located inside the “img/system” folder of your project

  • Quit:

    Set the image for the normal display of the “Quit” command. It has to be located inside the “img/system” folder of your project

  • Quit Selected:

    Set the image for when the “Quit” command is selected. It has to be located inside the “img/system” folder of your project

Back to top

Like in the “Text Menu Settings” you can set an animation that is played for when the items are not selected and when they are selected.

Animation Settings
  • Animation:

    Set the animation for the normal item display. More info can can be found here

  • Animation Selected:

    Set the animation for when the item is selected. More info can can be found here

Back to top

The next part is going to deal with the positions of the menu items. As you may have noticed, there is only one set of coordinates for each possible item to make sure they are at the same position. All positions are set based on the center pixel of the image

Position Settings
  • Continue Position X:

    The x position of the “Continue” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Continue Position Y:

    The y position of the “Continue” command. Only takes effect when the command is enabled at “Allowed Commands”

  • To Title Position X:

    The x position of the “To Title” command. Only takes effect when the command is enabled at “Allowed Commands”

  • To Title Position Y:

    The y position of the “To Title” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Quit Position X:

    The x position of the “Quit” command. Only takes effect when the command is enabled at “Allowed Commands”

  • Quit Position Y:

    The y position of the “Quit” command. Only takes effect when the command is enabled at “Allowed Commands”

Back to top
Gameover Screen – Menu Settings

Background Settings

These settings let you customize the apperance of the gameover screen background and add new features to it.

Background Settings
  • Background Mode:

    Choose between “Static” and “Random” to set either a fixed background image that will be used on all gameovers, or a random one that might change on every game over screen

  • Static Background:

    Set the static background image for the screen. It has to be located inside the “img/system” folder of your project

  • Random Backgrounds:

    Set up as many backgrounds as you want. If the “Background Mode” is set to “Random” a random image will be picked from the list every time a gameover happens. They have to be located inside the “img/system” folder of your project

  • Custom Gameover Label:

    If you want to display an extra text/image you can set the option to “Text” or “Picture” and configure the setting below accordingly

  • Label Settings:

    Set up your custom label according to the above setting. More info on how this works can be found here

Back to top
Gameover Screen

Special Options

These options allow you to extend the basic gameover with new features and functionalities. You do not have to use any of them. Like the general gameover screen settings, everything is fully optional.

Please make sure to properly read all the instructions as some of the settings in this section only work when previous settings have a certain value.

Back to top

Permadeath

These settings are related to managing savefiles aswell as triggering certain actions upon gameover.

Settings

Permadeath Settings
  • Use Permadeath:

    Set if you want to use permadeath features at all or not

  • Permadeath Mode:

    Set how you want to handle savefiles. You can pick between keeping them, deleting all saves, deleting only the most recent save and deleting specific saves that can  be set below

  • Savefiles To Delete:

    Set the indexes of the savefiles you want to delete. Only works when the above setting is “Delete Certain Saves”

  • Handler:

    Set if you want to use an extra ingame switch handler or not

  • Switch ID:

    Set the ID of the switch you want to trigger. The trigger will reverse the current state of the switch, no matter what it is. Example: When it’s on it will turn it off and vice versa

  • Trigger:

    Set when the switch should be triggered. You can either trigger it immediately when the gameover happens or upon the next new game. The new game options only takes effect when the game does not get closed in between

Back to top

Teleport & Skips

The following settings only work when “Use Gameover Screen” is set to “OFF”

Settings

Teleport & Skip Settings
  • Skip To Scene

    Lets you skip to Scene_Title or Scene_Load. Optionally you can also pick “Teleport” if you want to use the below teleport settings. Use “Disable” if you don’t want any skips

  • Teleport Coordinates:

    Set the Map ID and the xy coordinates of the teleport destination upon gameover. The teleport will happen as soon as the gameover is triggered. This only works when the above setting is set to “Teleport”

  • Autoload:

    Set if you want to automatically load the last save or a certain slot. The loading will be instantly after the gameover is triggered. This setting only works when “Skip To Scene” is set to “Disabled”

  • Autoload Slot:

    Pick the save slot to be automatically loaded when the above setting is set to “Certain Slot”

Back to top

Commands

This plugin provides a few commands that can be used ingame at any time as long as they can be run in an event.

The commands feature the extra phrase “(Active)” or  (“Active Command!)” which is due to a custom system that I built to expand the usability of commands.

For more info about active and passive commands, please check the core manual.

Back to top

Change Allowed Commands (Active)

This command allows you to adjust the usable commands for the gameover screen. This command only works when the gameover sceen is in use and the “Command Menu Type” is not set to “OFF”

Change Allowed Commands
  • Continue:

    Set if you want to enable, disable the command or keep the Plugin Manager setting

  • To Title:

    Set if you want to enable, disable the command or keep the Plugin Manager setting

  • Quit:

    Set if you want to enable, disable the command or keep the Plugin Manager setting

Back to top
Commands

Change Background (Active)

This command lets you change all of the background settings during the game

Change Background
  • Background Mode:

    Pic between a static background image (“Static”) or a random picture every time a gameover occurs (“Random”), or keep the Plugin Manager settings

  • Static Background:

    Set up a new static background image for the scene. Leave it empty to keep the old one. It has to be located inside the “img/system” folder of your project

  • Random Backgrounds:

    Set as many background images as you want. A random picture will be picked on every gameover when the “Background Mode” is set to “Random”. All pictures have to be located inside the “img/system” folder of your project

  • Random Background Handler:

    Pick if you want to add the above set backgrounds to the list of random backgrounds, or override the list. When picking “Keep” the above setting is ignored

  • Custom Gameover Label:

    The custom label is a text/line that you can freely set up. Pick between “Text”, a picture that you can set up, or simply disable it by picking “OFF”. If you pick “Keep” or “OFF” the below settings will be ignored

  • Label Settings:

    Set up your custom label accordig to your above setting. more info can be found here

Back to top
Commands

Change Permadeath (Active)

This command allows you to change the permadeath settings. Keep in mind that changing these settings will NOT revert any previous savefile deletions

Change Permadeath Settings
  • Use Permadeath:

    Set if you want to use permadeath features at all or not, or keep the Plugin Manager settings

  • Permadeath Mode:

    Set how you want to handle savefiles. You can pick between keeping them, deleting all saves, deleting only the most recent save and deleting specific saves that can  be set below. You can also choose to keep the Plugin Manager Settings

  • Savefiles To Delete:

    Set the indexes of the savefiles you want to delete. Only works when the above setting is “Delete Certain Saves”

  • Handler:

    Set if you want to use an extra ingame switch handler or not. Or you can keep the Plugin Manager setting

  • Switch ID:

    Set the ID of the switch you want to trigger. The trigger will reverse the current state of the switch, no matter what it is. Example: When it’s on it will turn it off and vice versa

  • Trigger:

    Set when the switch should be triggered. You can either trigger it immediately when the gameover happens or upon the next new game. The new game options only takes effect when the game does not get closed in between

Back to top
Commands

Change Teleport & Skips (Active)

This command lets you alter the Teleport & Skip settings. The command only works when the gameover screen is disabled!

Change Teleport & Skip
  • Skip To Scene

    Lets you skip to Scene_Title or Scene_Load. Optionally you can also pick “Teleport” if you want to use the below teleport settings. Use “Disable” if you don’t want any skips or “Keep” if you want to keep the Plugin Manager settings

  • Teleport Coordinates:

    Set the Map ID and the xy coordinates of the teleport destination upon gameover. The teleport will happen as soon as the gameover is triggered. This only works when the above setting is set to “Teleport”

  • Autoload:

    Set if you want to automatically load the last save or a certain slot. The loading will be instantly after the gameover is triggered. This setting only works when “Skip To Scene” is set to “Disabled”

  • Autoload Slot:

    Pick the save slot to be automatically loaded when the above setting is set to “Certain Slot”

Back to top
Commands

Structure Settings

This section is going to explain the nested structure settings of the plugin. There are quite a few which will be explained in detail.

Back to top

Font Decoration

Font Decoration

You can combine the settings inside this window in any way you want as long as the font you are using supports them.

  • Bold:

    Sets the font to bold/normal

  • Italic:

    Sets the font to italic or normal

  • Outline Color:

    Defines the RGBA color value for the outline. More info can be found here

  • Outline Width:

    Sets the width of the outline in pixels. It will create a even border around the text

Back to top
Structure Settings

RGBA Color Settings

RGBA Color Settings

This structure provides basic RGBA settings for certain options in the plugin

  • Red:

    Define the red color value from 0 – 255

  • Green:

    Define the green color value from 0 – 255

  • Blue:

    Define the blue color value from 0 – 255

  • Alpha:

    Define the Alpha value from 0.00 to 1

Back to top
Structure Settings

Position Settings

Position Settings

This structure simply deals with x and y coordinates.

  • X:

    Set the x-coordinates based on the top left pixel of the window/scene you’re in

  • Y:

    Set the y-coordinates based on the top left pixel of the window/scene you’re in

Back to top
Structure Settings

Animation Settings

Animation Settings

This structure is able to easily set up different animations that can be applied to certain texts and pictures. There are 5 different animations which are listed here

  • Animation Type:

    Sets none or one of the 6 different animations featured in the plugin. More info about these can be found here

  • Linear Movement:

    Sets the direction coordinates for the linear movement animation. The element will move as many pixels per frame as you set in the directions. For example setting it to x = 2 and y = 4 will make it move 2 pixels on the x-axis nd 4 pixels on the y-axis every frame. However, it will not stop moving. This setting gets ignored unless the “Animation Type” is set to “Linear Movement”. Keep in mind that using this for menu options may result in them floating off screen. More info about coordinates can be found here

  • Boost Scale Min:

    Sets the minimum scale for the element for the “Boost” animation. The minimum value is 0.01 (1% size). 1 equals 100% size. Please keep in mind that if you’re using a sizeable picture, it will not adjust to the size you’ve set there. This setting gets ignored unless “Animation Type” is set to “Boost”

  • Boost Scale Max:

    Sets the maximum scale for the element for the “Boost” animation. The minimum value is 0.01 (1% size). 1 equals 100% size. Please keep in mind that if you’re using a sizeable picture, it will not adjust to the size you’ve set there. This setting gets ignored unless “Animation Type” is set to “Boost”

  • Max Movement:

    Define the maximum movement in pixels for the animations “Bounce” and “Sway” in pixels. This setting gets ignored unless “Animation Type” is set to either “Bounce” or “Sway”

  • Animation Speed:

    Sets the speed for the selected animation. 1 is the minimum speed. Going for a higher speed will increase it in a linear way

  • Animation Delay:

    Sets a delay in frames between the animation cycles. 1 second equals 60 frames. A delay of 0 will continuously run the animation

Back to top
Structure Settings

Label Settings

The “Label Text” settings take effect when the “Custom Gameover Label” is set to “Text”

Label Settings
  • Label:

    The text the label is going to display

  • Text Font:

    The name of the font you want to use (Case sensitive!). More info about how to set up fonts can be found here

  • Font Color:

    The color for the font. This has to be of hex-value, starting with a #. You can find a color picker with hex-value output here

  • Font Size:

    Size of the font (Varies depending on the font you use)

  • Font Decoration:

    Allows to set certain font decorations such as bold, italic and an outline border. More info can be found here

The “Label Picture Settings” take effect when the “Custom Gameover Label” is set to “Picture”

Label Settings
  • Label Picture:

    Set the picture for the label. It has to be located inside the “img/system” folder of your project

The “Label Postion/Animation” settings have to be filled for both “Text” and “Picture” label

Label Settings
  • Label Animation:

    Set up an animation for the label that will play constantly during the screen display. More info can be found here

  • Label X:

    Set the x position of the label on the screen based on its center pixel

  • Label Y:

    Set the y position of the label on the screen based on its center pixel

Back to top
Structure Settings

Animation Types

All of the animation types are influenced by the “Animation Speed” and “Animation Delay” settings. All previews were taken with “Animation Speed” set to 1 and “Animation Delay” set to 0. However due to the gif format it is slightly slowed down. Please note that these are sample animations.

Bounce

Bounce Animation

Bounces the element up and back down depending on the “Max Movement” setting in the animation settings.

Sway

Sway Animation

Sways the element to the left and right depending on the “Max Movement” setting in the animation settings. It will go from the center to each side until it reaches the maximum distance before returning to complete the cycle.

Pulse

Pulse Animation

Reduces the opacity of the element until it reaches 0 and then it goes back all the way to 255 to complete the cycle.

Boost

Boost

Resizes the element based on the “Boost Scale Min” and “Boost Scale Max” settings for each cycle.

Linear

Linear

Moves the element x-amount of pixels on the x and y axis each frame, based on the “Linear Movement” setting.

Back to top

Tipps & Tricks

  • You can use the “Teleport & Skips” mand the “Permadeath” mechanics in combination. For example if you’re building an aracade style game you can use the teleport to get back to the hub and use the permadeath switch trigger to activate certain events/dialogues upon returning.

  • You can copy single settings or even a whole bulk setting to another similar setting. Simply click on the setting you want to copy, hit CTRL + C, go to the corresponding setting you want to copy the values to and hit CTRL + V.

  • Playing around with image scalings and the “Boost” animation can create some pretty nice effects

  • Keep in mind that all texts/pictures that use coordintes are being aligned via their center pixel. So 0,0 corresponds to the very midle of the text/picture. Sometimes it might take a few attempts to align them properly.

Back to top