More Hud Faces (Moghunter Extension) v1.2.2
LadyBaskerville
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:
change_ahud_face ACTOR_ID FILENAME
change_bhud_face ACTOR_ID FILENAME
change_phud_face ACTOR_ID FILENAMEImmediately 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:
will change the Actor HUD face for Actor #1 to the file "HaroldFace12.png" in the folder img/actorhud.change_ahud_face 1 HaroldFace12Set faces to show based on state:
Code:
set_ahud_face ACTOR_ID STATE_ID FILENAME
set_bhud_face ACTOR_ID STATE_ID FILENAME
set_phud_face ACTOR_ID STATE_ID FILENAMESet 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:
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.set_ahud_face 1 4 HaroldFacePoisonClear state faces assigned to the actor:
Code:
clear_ahud_face ACTOR_ID STATE_ID
clear_bhud_face ACTOR_ID STATE_ID
clear_phud_face ACTOR_ID STATE_IDClear 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:
changeAhudFace(FILENAME)
changeBhudFace(FILENAME)
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:
will change the Actor HUD face for Actor #1 to the file "HaroldFace12.png" in the folder img/actorhud.$gameActors.actor(1).changeAhudFace("HaroldFace12")Set faces to show based on state:
Code:
setAhudFace(STATE_ID, FILENAME)
setBhudFace(STATE_ID, FILENAME)
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:
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.$gameActors.actor(1).setAhudFace(4, "HaroldFacePoison")Clear state faces assigned to the actor:
Code:
clearAhudFace(STATE_ID)
clearBhudFace(STATE_ID)
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:
<AHudFace: FILENAME>
<BHudFace: FILENAME>
<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:
<AHudFace State STATE_ID: FILENAME>
<BHudFace State STATE_ID: FILENAME>
<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.
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.
- 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.