Extra Status Window (Additional window for showing party's alignment, p

じ☆ve冰风

Extra Status v1.1.3

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.
Spoiler: Image

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
Spoiler: General 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.

Spoiler: Entry Parameters

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.

Plugin Command
To manually open the Extra Status window, use this plugin command:
                Code:       

1. OpenExtraStatus

复制代码

Compatibility
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 compatibility issues between this plugin and others, try changing the plugin order and starting a new game afterwards. Unfortunately, I currently have only limited time to work on compatibility patches, but feel free to let me know if the issue persists after changing the plugin order. If I have time, I may try to make this plugin compatible; however, I cannot offer compatibility support for any paid plugins.

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!

Spoiler: Changelog

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.

Spoiler: Appendix: Mini Javascript reference

Getting Values
                Code:       

1. $gameVariables.value(12)

复制代码

Returns the value of variable #12.
                Code:       

1. $gameSystem._saveCount

复制代码

Returns the number of times the game has been saved.
                Code:       

1. $gameSystem._battleCount

复制代码

Returns the number of battles the player has fought.
                Code:       

1. $gameSystem.playtime()

复制代码

Returns the time played in seconds.
                Code:       

1. $gameSystem.playtimeText()

复制代码

Returns the time played as a text (string) in the format "HH:MM:SS".
                Code:       

1. $gameActors.actor(1).hp

复制代码

The current HP of actor #1 in the database.
                Code:       

1. this._actor.hp

复制代码

The current HP of the chosen actor (party leader on Party mode).
                Code:       

1. this._actor.name()

复制代码

The name of the chosen actor (party leader on Party mode).
                Code:       

1. $gameParty._gold

复制代码

The amount of gold the party has collected.

Checking Conditions
                Code:       

1. $gameSwitches.value(7)

复制代码

Is switch #7 on? (This is the same as writing $gameSwitches.value(7) === true)
                Code:       

1. $gameVariables.value(14) < 3

复制代码

Is the value of variable #14 smaller than 3?
                Code:       

1. $gameVariables.value(14) <= 3

复制代码

Is the value of variable #14 smaller or equal than 3?
                Code:       

1. $gameVariables.value(14) === 3

复制代码

Is the value of variable #14 equal to 3?
                Code:       

1. $gameVariables.value(14) >= 3

复制代码

Is the value of variable #14 larger or equal than 3?
                Code:       

1. $gameVariables.value(14) > 3

复制代码

Is the value of variable #14 larger than 3?

Linking Conditions
                Code:       

1. CONDITION A && CONDITION B

复制代码

Are both conditions A and B fulfilled?
                Code:       

1. CONDITION A || CONDITION B

复制代码

Is condition A or condition B fulfilled?
                Code:       

1. !CONDITION

复制代码

Inverts condition: Is condition not fulfilled?

本贴来自国际rpgmaker官方论坛作者:LadyBaskerville处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/extra-status-window-additional-window-for-showing-partys-alignment-progress-and-more.81789/