More HUD Faces - Extension for Moghunter's Battle, Party, and Actor HUD

じ☆ve冰风

More Hud Faces (Moghunter Extension) v1.2.2
LadyBaskerville​

Note: This plugin is most likely outdated and unfortunately, I currently cannot offer any support for it. You may still use the versions provided here as-is, but I cannot guarantee that they will work. As with all my plugins, you are welcome to both edit and repost the code to make it compatible with current plugin/engine versions or add onto it. (See post #54 in this thread for a suggested edit for compatability with v5.04 of MOG_BattleHud.)

Introduction
Moghunter / Atelier Rgss provides visually impressive plugins to show your actors' faces on the screen, be it in battle or on the map. However, the MV plugins do not provide an easy way to change the graphic assigned to an actor mid-game. This extension now adds this functionality.

Features
This plugin is an extension to the following Moghunter plugins:
RMV - Battle Hud
RMV - Actor Hud
RMV - Party Hud
You can use this extension with any combinations of those plugins.

The current version of this extension plugin is made for the plugin versions Battle Hud 3.7, Actor Hud 1.9, and Party Hud 1.3. It will probably not work with older versions. (Version 1.0.1 of this extension is still available for download, if you are using older versions of Moghunter's plugins and cannot / do not want to update them.)

This extension plugin provides Plugin Commands and Script Calls to change the face graphics used in Moghunter's Battle HUD, Party HUD and/or Actor HUD mid-game. You can also specify a different default face file for each actor using notetags.

Apart from manually changing the HUD face graphic during the game, you can now assign face graphics for different states to an actor, and the graphic will change automatically when the actor is afflicted by the respective states. You can set these up with notetags in the actor notebox, or change them during the game with Plugin Commands and Script Calls. The state with the highest priority will determine the face graphic used. If there is no face graphic assigned to the actor for this state, the state with the next highest priority will determine the face graphic. If there is no face graphic assigned for ANY of the actor's states, the default face graphic will be used instead.

How to use
To use this plugin, place it below Moghunter's plugins in your plugin list.

Plugin Commands
Change HUD faces immediately:
                Code:       

1. change_ahud_face ACTOR_ID FILENAME
2. change_bhud_face ACTOR_ID FILENAME
3. change_phud_face ACTOR_ID FILENAME

复制代码

Immediately change the face file used in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud). This also changes the face file used by default when the actor is not afflicted by any states.

Example:
                Code:       

1. change_ahud_face 1 HaroldFace12

复制代码

will change the Actor HUD face for Actor #1 to the file "HaroldFace12.png" in the folder img/actorhud.

Set faces to show based on state:
                Code:       

1. set_ahud_face ACTOR_ID STATE_ID FILENAME
2. set_bhud_face ACTOR_ID STATE_ID FILENAME
3. set_phud_face ACTOR_ID STATE_ID FILENAME

复制代码

Set the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Enter 0 as the state ID to change the face file used by default when the actor is not afflicted by any states.

Example:
                Code:       

1. set_ahud_face 1 4 HaroldFacePoison

复制代码

will set the face that is for Actor #1 in the Actor HUD when Actor #1 is afflicted by state #4 to the file "HaroldFacePoison.png" in img/actorhud.


Clear state faces assigned to the actor:
                Code:       

1. clear_ahud_face ACTOR_ID STATE_ID
2. clear_bhud_face ACTOR_ID STATE_ID
3. clear_phud_face ACTOR_ID STATE_ID

复制代码

Clear the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. If the actor is afflicted by this state, the face graphic will no longer automatically change.

Script Calls (advanced)
The following functions have been added to Game_Actor:

Change HUD faces immediately:
                Code:       

1. changeAhudFace(FILENAME)
2. changeBhudFace(FILENAME)
3. changePhudFace(FILENAME)

复制代码

Immediately change the face file used in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
This also changes the face file used by default when the actor is not afflicted by any states.

Example:
                Code:       

1. $gameActors.actor(1).changeAhudFace("HaroldFace12")

复制代码

will change the Actor HUD face for Actor #1 to the file "HaroldFace12.png" in the folder img/actorhud.

Set faces to show based on state:
                Code:       

1. setAhudFace(STATE_ID, FILENAME)
2. setBhudFace(STATE_ID, FILENAME)
3. setPhudFace(STATE_ID, FILENAME)

复制代码

Set the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).
Enter 0 as the state ID to change the face file used by default when the actor is not afflicted by any states.

Example:
                Code:       

1. $gameActors.actor(1).setAhudFace(4, "HaroldFacePoison")

复制代码

will set the face that is for Actor #1 in the Actor HUD when Actor #1 is afflicted by state #4 to the file "HaroldFacePoison.png" in img/actorhud.

Clear state faces assigned to the actor:
                Code:       

1. clearAhudFace(STATE_ID)
2. clearBhudFace(STATE_ID)
3. clearPhudFace(STATE_ID)

复制代码

Clear the face file that is automatically used for the state in the Actor, Battle, or Party HUD, respectively. If the actor is afflicted by this state, the face graphic will no longer automatically change.

Notetags
You can specify a different face file to be used at the start of the game with the following notetags in the Actor tab:

                Code:       

1. <AHudFace: FILENAME>
2. <BHudFace: FILENAME>
3. <PHudFace: FILENAME>

复制代码

Use the file FILENAME.png to represent this actor in the Actor, Battle, or Party HUD by default. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).

                Code:       

1. <AHudFace State STATE_ID: FILENAME>
2. <BHudFace State STATE_ID: FILENAME>
3. <PHudFace State STATE_ID: FILENAME>

复制代码

Automatically change the actor's face graphic in the Actor, Battle, or Party HUD to FILENAME.png when the actor is afflicted with the state. The file must be located in the respective HUD folder (img/actorhud, img/battlehud, or img/partyhud).

Plugin
Download it here: MOG_X_MoreHudFaces.js
(If you are using older versions of Moghunter's HUD plugins and cannot / do not want to update them, you can still download version 1.0.1 of the extension here: MOG_X_MoreHudFaces_v101.js

Credit and Thanks
- LadyBaskerville (optional)
- Moghunter

Terms of Use
- Free for use in both non-commercial and commercial games.
- You may repost and edit this plugin.

Spoiler: Changelog

Version 1.2.2
- Fixed a bug where animated faces would not display properly when the face graphic was changed in battle.
Version 1.2.1
- Fixed a bug with Party and Battle HUD when there were less than 4 members.
Version 1.2.0
- Added notetags, plugin commands and script calls to set up automatic state faces: The face graphic can be changed based on the states the actor is afflicted with.
- Cleaned up the documentation.
Version 1.1.1
- Fixed a bug where changing the battle HUD image would try to load an image from the actor HUD folder.
Version 1.1.0
- Reworked the plugin to work with Moghunter's updated plugins.
- Added script calls.
- Faces are now changed without refreshing the entire HUD.
Version 1.0.1
- Only refresh the HUDs when the face graphic has changed.
Version 1.0.0
- Finished the plugin.

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