- Joined
- Sep 12, 2016
- Messages
- 645
- Reaction score
- 530
- First Language
- German
- Primarily Uses
- RMMV
Extra Status v1.1.3
LadyBaskerville
LadyBaskerville
Introduction
This plugin creates a highly customizable status screen that can be accessed from the main menu. It is mainly focused on displaying numeric values ranging between a minimum and a maximum value, like the alignment on a good--evil scale, relationships between characters, or progress within a "Find X amount of Y!" quest. However, it can also display text and images.
You can now switch between a Party and an Actor mode. On Party mode, one Extra Status screen for the entire party will be shown by the menu command. On Actor mode, the menu command will let you select an actor first, like the skill, status and equip commands. (The selected actor is referred to by this._actor in all Javascript parameters. On Party mode, this._actor refers to the party leader instead.)
A word of warning: This plugin requires some Javascript code in its configuration. If you don't know where to start with it, you can find a small list of the most important commands for this plugin at the very bottom of this post. There will also a be link to a demo project where you can see some of those commands in action.
This plugin also requires the RMMV editor to be updated to 1.5.0.
Features
- Creates a customizable status screen that can be accessed from the main menu or via a plugin command.
- Lets you add (mostly) static text and images to the new status screen.
- Lets you display variables, or any values you can access with a line of Javascript, as text, a gauge, or a slider.
- Lets you dynamically show and hide entries on the new status screen.
Screenshot
This is an example screen from the demo linked below.
How to Use
In the plugin parameters, you will some general settings for the Extra Status screen and, most importanly, a list of entries. Those will make up the actual contents of the screen. Each entry can be dynamically shown and hidden, and can contain one of each of the following elements:
- Text: Pure text.
- Image: An image from the img/exstatus folder.
- Value: A value returned by a Javascript evaluation.
It can be displayed in the following ways:
- as text (the only option for non-numeric values)
- as a gauge
- as a slider image
All of this can be configured in the plugin parameters. For more details, have a look into the Help file or the spoilers below.
Plugin Parameters
Show in Main Menu:
Choose whether a command to open the Extra Status screen will be added to the main menu.
Menu Command Name:
If you want to show a command in the main menu, enter its name here.
Actor / Party Mode:
When set to Party, one Extra Status screen for the entire party will be shown by the menu command. When set to Actor, the menu command will let you select an actor first, like the skill, status and equip commands. The selected actor is referred to by this._actor in all Javascript parameters.
Examples:
- Enter the condition this._actor._actorId === 3 to only display the entry when actor #3 was chosen.
- Use this._actor.hp as a value to get the chosen actor's hp.
On Party Mode, this._actor will refer to the party leader.
Window Width:
The width of the Extra Status window. Can be a number or a Javascript eval.
Window Height:
The height of the Extra Status window. Can be a number or a Javascript eval.
Window X Position:
The X Position of the Extra Status window. Can be a number or a Javascript eval.
Window Y Position:
The Y Position of the Extra Status window. Can be a number or a Javascript eval.
Window Colums:
The number of colums for the entries in the Extra Status window.
Window Rows:
The number of rows for the entries in the Extra Status window.
Entries:
A list of the entries shown in the Extra Status window. Details below.
Choose whether a command to open the Extra Status screen will be added to the main menu.
Menu Command Name:
If you want to show a command in the main menu, enter its name here.
Actor / Party Mode:
When set to Party, one Extra Status screen for the entire party will be shown by the menu command. When set to Actor, the menu command will let you select an actor first, like the skill, status and equip commands. The selected actor is referred to by this._actor in all Javascript parameters.
Examples:
- Enter the condition this._actor._actorId === 3 to only display the entry when actor #3 was chosen.
- Use this._actor.hp as a value to get the chosen actor's hp.
On Party Mode, this._actor will refer to the party leader.
Window Width:
The width of the Extra Status window. Can be a number or a Javascript eval.
Window Height:
The height of the Extra Status window. Can be a number or a Javascript eval.
Window X Position:
The X Position of the Extra Status window. Can be a number or a Javascript eval.
Window Y Position:
The Y Position of the Extra Status window. Can be a number or a Javascript eval.
Window Colums:
The number of colums for the entries in the Extra Status window.
Window Rows:
The number of rows for the entries in the Extra Status window.
Entries:
A list of the entries shown in the Extra Status window. Details below.
General
Column:
The column in which the entry is displayed. Note that the columns are counted beginning from 0. For example, four columns would be addressed as 0, 1, 2 and 3, respectively.
Row:
The column in which the entry is displayed. The rows are counted beginning from 0, as well.
Condition:
A line of Javascript. When it evaluates to true, the entry will be show, otherwise it will be hidden. If you always want to show an entry, type "true".
Text
Show Text:
Choose if this entry should contain text.
Text:
If you decide to show some text, this is the text that will be shown. You can use text codes here.
Text X Offset:
The horizontal offset of the text within the entry. You can enter a number or a Javascript eval here.
Text Y Offset:
The vertical offset of the text within the entry. You can enter a number or a Javascript eval here.
Value
Value:
A line of Javascript code. It can return a number or a string, but if it is a string, you cannot display it as a gauge or a slider.
Minimum Value:
The smallest number "Value" can become. This is only applicable if Value returns a number, otherwise you can ignore this setting. You can enter a number or a Javascript eval here.
Maximum Value:
The largest number "Value" can become. This is only applicable if Value returns a number, otherwise you can ignore this setting. You can enter a number or a Javascript eval here.
Show Value Text:
If you select "Yes", the value will be shown as a line of text.
Show Current/Max:
If you choose to show the value as text, specify whether it will be shown as a single value or in the format CURRENT/MAX. This is only really applicable if Value returns a number, but using it with a string will not give an error - in case you want to display something like "Harold/100" for whatever reason.
Value X Offset:
The horizontal offset for the value text within the entry. You can enter a number or a Javascript eval here.
Value Y Offset:
The vertical offset for the value text within the entry. You can enter a number or a Javascript eval here.
Value Prefix:
Text to be displayed directly before the value. You can use text codes here.
Value Postfix:
Text to be displayed directly after the value. You can use text codes here.
Show Value Gauge:
If you select "Yes", the value will be shown as a gauge. This is only applicable if Value returns a number. If you try to display a gauge for a non-numeric value, it will not be drawn and an error message will appear in the console.
Gauge X Offset:
The horizontal offset for the gauge within the entry. You can enter a number or a Javascript eval here.
Gauge Y Offset:
The vertical offset for the gauge within the entry. You can enter a number or a Javascript eval here.
Gauge Direction:
The direction from which the gauge will start to fill.
Gauge Width:
The width of the gauge. You can enter a number or a Javascript eval here.
Gauge Height:
The height of the gauge. You can enter a number or a Javascript eval here.
Gauge Color 1:
The gauge will be drawn with a gradient. Enter the first color of the gauge here as a hex color code (e.g. #ff0000). You can find color pickers that display hex color codes in most image editing programs, or online.
Gauge Color 2:
The second color of the gauge in hex format.
Background Gauge Color:
The backgound color of the gauge in hex format.
Show Slider:
If you select "Yes", the value will be shown as a slider. This is only applicable if Value returns a number. If you try to display a slider for a non-numeric value, it will not be drawn and an error message will appear in the console.
Slider Bar Image:
The image for the slider bar. This will be drawn as a background to the marker. The image must be located in the img/exstatus folder.
Marker Image:
The image for the actual slider, or the marker, that shows at which point between minimum and maximum the value currently is. The image must be located in the img/exstatus folder.
Slider X Offset:
The horizontal offset for the entire slider bar within the entry. You can enter a number or a Javascript eval here.
Slider Y Offset:
The vertical offset for the entire slider within the entry. You can enter a number or a Javascript eval here.
Starting X Position:
The horizontal starting position for the marker relative to the bar. You can enter a number or a Javascript eval here.
End X Position:
The horizontal end position for the marker relative to the bar. You can enter a number or a Javascript eval here.
Starting Y Position:
The vertival starting position for the marker relative to the bar. You can enter a number or a Javascript eval here.
End Y Position:
The vertical end position for the marker relative to the bar. You can enter a number or a Javascript eval here.
Image
Show Image:
Choose if this entry should contain an image.
Image File:
If you choose to show an image, this is the image file that will be shown. It must be located in the img/exstatus folder. Images will be drawn below everything else.
Image X Offset:
The horizontal offset for the image within the entry. You can enter a number or a Javascript eval here.
Image Y Offset:
The vertical offset for the image within the entry. You can enter a number or a Javascript eval here.
Column:
The column in which the entry is displayed. Note that the columns are counted beginning from 0. For example, four columns would be addressed as 0, 1, 2 and 3, respectively.
Row:
The column in which the entry is displayed. The rows are counted beginning from 0, as well.
Condition:
A line of Javascript. When it evaluates to true, the entry will be show, otherwise it will be hidden. If you always want to show an entry, type "true".
Text
Show Text:
Choose if this entry should contain text.
Text:
If you decide to show some text, this is the text that will be shown. You can use text codes here.
Text X Offset:
The horizontal offset of the text within the entry. You can enter a number or a Javascript eval here.
Text Y Offset:
The vertical offset of the text within the entry. You can enter a number or a Javascript eval here.
Value
Value:
A line of Javascript code. It can return a number or a string, but if it is a string, you cannot display it as a gauge or a slider.
Minimum Value:
The smallest number "Value" can become. This is only applicable if Value returns a number, otherwise you can ignore this setting. You can enter a number or a Javascript eval here.
Maximum Value:
The largest number "Value" can become. This is only applicable if Value returns a number, otherwise you can ignore this setting. You can enter a number or a Javascript eval here.
Show Value Text:
If you select "Yes", the value will be shown as a line of text.
Show Current/Max:
If you choose to show the value as text, specify whether it will be shown as a single value or in the format CURRENT/MAX. This is only really applicable if Value returns a number, but using it with a string will not give an error - in case you want to display something like "Harold/100" for whatever reason.
Value X Offset:
The horizontal offset for the value text within the entry. You can enter a number or a Javascript eval here.
Value Y Offset:
The vertical offset for the value text within the entry. You can enter a number or a Javascript eval here.
Value Prefix:
Text to be displayed directly before the value. You can use text codes here.
Value Postfix:
Text to be displayed directly after the value. You can use text codes here.
Show Value Gauge:
If you select "Yes", the value will be shown as a gauge. This is only applicable if Value returns a number. If you try to display a gauge for a non-numeric value, it will not be drawn and an error message will appear in the console.
Gauge X Offset:
The horizontal offset for the gauge within the entry. You can enter a number or a Javascript eval here.
Gauge Y Offset:
The vertical offset for the gauge within the entry. You can enter a number or a Javascript eval here.
Gauge Direction:
The direction from which the gauge will start to fill.
Gauge Width:
The width of the gauge. You can enter a number or a Javascript eval here.
Gauge Height:
The height of the gauge. You can enter a number or a Javascript eval here.
Gauge Color 1:
The gauge will be drawn with a gradient. Enter the first color of the gauge here as a hex color code (e.g. #ff0000). You can find color pickers that display hex color codes in most image editing programs, or online.
Gauge Color 2:
The second color of the gauge in hex format.
Background Gauge Color:
The backgound color of the gauge in hex format.
Show Slider:
If you select "Yes", the value will be shown as a slider. This is only applicable if Value returns a number. If you try to display a slider for a non-numeric value, it will not be drawn and an error message will appear in the console.
Slider Bar Image:
The image for the slider bar. This will be drawn as a background to the marker. The image must be located in the img/exstatus folder.
Marker Image:
The image for the actual slider, or the marker, that shows at which point between minimum and maximum the value currently is. The image must be located in the img/exstatus folder.
Slider X Offset:
The horizontal offset for the entire slider bar within the entry. You can enter a number or a Javascript eval here.
Slider Y Offset:
The vertical offset for the entire slider within the entry. You can enter a number or a Javascript eval here.
Starting X Position:
The horizontal starting position for the marker relative to the bar. You can enter a number or a Javascript eval here.
End X Position:
The horizontal end position for the marker relative to the bar. You can enter a number or a Javascript eval here.
Starting Y Position:
The vertival starting position for the marker relative to the bar. You can enter a number or a Javascript eval here.
End Y Position:
The vertical end position for the marker relative to the bar. You can enter a number or a Javascript eval here.
Image
Show Image:
Choose if this entry should contain an image.
Image File:
If you choose to show an image, this is the image file that will be shown. It must be located in the img/exstatus folder. Images will be drawn below everything else.
Image X Offset:
The horizontal offset for the image within the entry. You can enter a number or a Javascript eval here.
Image Y Offset:
The vertical offset for the image within the entry. You can enter a number or a Javascript eval here.
Plugin Command
To manually open the Extra Status window, use this plugin command:
Code:
OpenExtraStatus
Compatability
This plugin is compatible with Yanfly's Main Menu Manager. It should be placed above Yanfly's Main Menu Manager.
The exact parameters for Yanfly's Main Menu Manager depend on whether you are using Party or Actor mode. In any case, you can use LB.ExStatus.commandName to get the name specified in this plugin's parameters.
For Party mode:
Main Bind: this.commandExStatus.bind(this)
Leave the Actor Bind parameter empty.
For Actor mode:
Main Bind: this.commandPersonal.bind(this)
Actor Bind: SceneManager.push(Scene_ExStatus)
The Symbol, Show and Enabled parameters can be set to any value you want. This plugin does not use a command extension.
If you encounter any compatability issues between this plugin and others, try changing the plugin order and starting a new game afterwards. If the issue persists, let me know about it and I will try to make this plugin compatible.
Credit
- LadyBaskerville
Terms of Use
- Free for use in both non-commercial and commercial games.
- You may edit this plugin.
- You may redistribute this plugin and edits of it. In that case, please give credit and, if possible, link back to this plugin thread.
Download
Download the Plugin (make sure to save it as LB_ExtraStatus.js)
Download the Demo ( ~ 8 MB )
Author's Note
If you find any issues with this plugin, first make sure that you have named the plugin file correctly (LB_ExtraStatus.js), and started a new game after installing the plugin and not loaded the game from a savefile. Then feel free to leave a bug report in this topic or send me a PM.
Also, if you have any suggestions for additional features, or questions about setting up the plugin, let me know!
Version 1.1.3
- Fixed gauge background color
Version 1.1.2
- Fixed a bug with the slider markers in actor mode.
- Corrected an example in the Help file.
Version 1.1.1
- Fixed a bug with gauges for a maximum value of 0.
Version 1.1.0
- Added Actor Mode.
Version 1.0.0
- Finished the plugin.
- Fixed gauge background color
Version 1.1.2
- Fixed a bug with the slider markers in actor mode.
- Corrected an example in the Help file.
Version 1.1.1
- Fixed a bug with gauges for a maximum value of 0.
Version 1.1.0
- Added Actor Mode.
Version 1.0.0
- Finished the plugin.
Getting Values
Returns the value of variable #12.
Returns the number of times the game has been saved.
Returns the number of battles the player has fought.
Returns the time played in seconds.
Returns the time played as a text (string) in the format "HH:MM:SS".
The current HP of actor #1 in the database.
The current HP of the chosen actor (party leader on Party mode).
The name of the chosen actor (party leader on Party mode).
The amount of gold the party has collected.
Checking Conditions
Is switch #7 on? (This is the same as writing $gameSwitches.value(1) === true)
Is the value of variable #14 smaller than 3?
Is the value of variable #14 smaller or equal than 3?
Is the value of variable #14 equal to 3?
Is the value of variable #14 larger or equal than 3?
Is the value of variable #14 larger than 3?
Linking Conditions
Are both conditions A and B fulfilled?
Is condition A or condition B fulfilled?
Inverts condition: Is condition not fulfilled?
Code:
$gameVariables.value(12)
Code:
$gameSystem._saveCount
Code:
$gameSystem._battleCount
Code:
$gameSystem.playtime()
Code:
$gameSystem.playtimeText()
Code:
$gameActors.actor(1).hp
Code:
this._actor.hp
Code:
this._actor.name()
Code:
$gameParty._gold
Checking Conditions
Code:
$gameSwitches.value(7)
Code:
$gameVariables.value(14) < 3
Code:
$gameVariables.value(14) <= 3
Code:
$gameVariables.value(14) === 3
Code:
$gameVariables.value(14) >= 3
Code:
$gameVariables.value(14) > 3
Linking Conditions
Code:
CONDITION A && CONDITION B
Code:
CONDITION A || CONDITION B
Code:
!CONDITION
Last edited: